ecmOutputDocuments.bat(文書一覧CSV出力)
形式
ecmOutputDocuments.bat -d 文書空間識別子
-u ユーザID
-p パスワード
〔-s 検索条件ファイルのフルパス名〕
〔-b 検索対象のフォルダパス名〕
〔-f フォルダパスの区切り文字〕
〔-r〕
〔-v〕
〔-a〕
〔-utf8〕
〔-?〕
機能
指定した検索条件を基に検索を実行し,ヒットした文書の一覧および属性情報をCSV形式で出力します。
コマンド引数
-d 文書空間識別子
処理対象となる文書空間の文書空間識別子を指定します。
この引数は必ず指定してください。
-u ユーザID
システム管理者のIDを指定します。
この引数は必ず指定してください。
-p パスワード
システム管理者のパスワードを指定します。
この引数は必ず指定してください。
-s 検索条件ファイルのフルパス名
検索条件ファイルのフルパス名を指定します。検索条件ファイルには,出力対象となる文書の検索条件を記述します。検索条件ファイルの詳細は,「6.3.5 文書一覧CSV出力コマンドで使用するファイル」を参照してください。
指定を省略した場合は,検索条件を追加しないで検索します。
-b 検索対象のフォルダパス名
検索対象のフォルダパス名を指定します。
フォルダのパスは「/」で区切って指定します。なお,区切り文字は引数「-f」で指定することもできます。
この引数の指定を省略した場合,最上位の階層の「文書フォルダ」が指定されたと判断されます。
引数「-b」の指定例を次に示します。
-b△部門/営業部/東京営業部 |
(凡例) △:半角スペース
-f フォルダパスの区切り文字
引数「-b」で指定した検索対象のフォルダパスの区切り文字を1文字で指定します。この引数の指定を省略すると,区切り文字を「/」とします。
-r
引数「-b」で指定したフォルダパス以下の下位フォルダも再帰的に検索して,CSVファイルを出力する場合に指定します。
引数「-r」を指定した場合に,CSVファイルに出力される順序を以下に示します。
-v
文書のすべてのバージョンを出力する場合に指定します。
この引数の指定を省略すると,最新のバージョンの情報だけが出力されます。
-a
CSVファイルの出力結果に,文書のバージョンのOIIDなどを含める場合に指定します。このオプションを指定した場合は,CSVファイルの最後の列に文書のOIIDを出力します。
-utf8
文書管理サーバの文字コード種別がUTF-8の場合に指定します。この引数の指定を省略した場合は,Shift-JISとして処理されます。文書管理サーバの文字コード種別がUTF-8の場合にこの引数の指定を省略すると,ログファイルの出力内容で文字化けが発生することがあります。
この引数を指定した場合,入力する検索条件ファイルの文字コード種別,および出力するCSVファイルの文字コード種別はUTF-8となります。CSVファイルにはBOMコードを含みます。
-?
このコマンドの使用方法を出力します。
この引数を指定すると,コマンドの使用方法の出力だけが行われ,文書一覧のCSV出力はされません。
戻り値
コマンドの戻り値を次の表に示します。
表6-12 文書一覧CSV出力コマンドの戻り値
戻り値 | 意味 |
---|---|
0 | 検索条件を満たす文書がすべてCSV出力されました。 |
1 | 警告が発生しましたが,エラーなく最後までCSV出力されました。 |
-1 | 続行不可のエラーが発生しました。 |
実行例
このコマンドの実行例を次に示します。
ecmOutputDocuments.bat△-d△2f44eb5e-e211-44f1-b8c0-b589b6fafa0d△-u△admin△-p△pass△-s△C:¥work¥search.txt△-utf8 |
(凡例)△:半角スペース
文書一覧CSV出力ファイル
文書一覧CSV出力ファイルの格納フォルダとファイル名を次に示します。
文書一覧CSV出力ファイルのフォーマット
文書一覧CSV出力ファイルの出力形式と実行結果の例を次に示します。
ヘッダ行とレコード行の出力形式
カラム名およびデータの出力内容とカラム番号の対応を次の表に示します。
表6-13 カラム名およびデータの出力内容とカラム番号の対応(文書一覧CSV出力コマンド)
カラム番号 | カラム名※1 | データの出力内容 |
---|---|---|
1 | 登録結果 | なし |
2~11 | フォルダ名_<n>※2 | 1階層目から10階層目までのファイル名が出力されます。 |
12 | 空文字 | 空文字が出力されます。 |
13 | 所有者ID | 文書の所有者のIDが出力されます。 |
14 | ユーザの表示名称 | 文書の所有者の名称が出力されます。 |
15 | 採番結果 | 文書の登録時に文書番号を採番した場合に,採番した文書番号が出力されます。 文書番号を採番しない場合は,何も出力されません。 |
16 | ファイル名 | 主ファイルのファイル名が出力されます。 |
17 | 文書名 | 文書名が出力されます。 |
18 | コメント | 文書のコメントが出力されます。 |
19 | 文書種別 | 文書種別名が出力されます。 |
20 | 全てのユーザに対するアクセス権限 | アクセス権限方式が「個別に設定」の文書フォルダに文書が登録されている場合に,「全てのユーザ」に設定されたアクセス権の値が出力されます。
公開フォルダの場合で「全員に公開」のときは,「FULL_CONTROL」が出力されます。 |
21 | アクセス権限リスト | アクセス権限方式が「個別に設定」の文書の場合に,文書に設定されたアクセス権の値が出力されます。 「同じ権限を共有」,または公開フォルダの場合で「公開範囲を限定」のときは,共有元となるフォルダのアクセス権が出力されます。公開フォルダの場合で「全員に公開」のときは,何も出力されません。
「設定対象ID」,「種別」,「アクセス権」を「:(コロン)」で区切って出力します。
|
22 | 更新者ID | 文書の更新者のIDが出力されます。 |
23 | 更新者名 | 文書の更新者の名称が出力されます。 |
24 | 更新日時 | 文書の更新日時がYYYY/MM/DD-hh:mm:ss形式で出力されます。 |
25 | 空文字 | 空文字が出力されます。 |
26 | 関連ファイル | 関連ファイルのファイル名が出力されます。 関連ファイルを複数持つ文書の場合は「|」区切りで,複数の関連ファイルが出力されます。 関連ファイルがない場合は,何も出力されません。 |
27 | 継続行フラグ | -vオプションを指定した場合,文書の履歴情報が出力されます。
-vオプションを指定しない場合は,最新バージョンの1行だけを出力するため,空文字が出力されます。 |
28 | 作成日時 | 文書の作成日時がYYYY/MM/DD-hh:mm:ss形式で出力されます。 |
29~30 | 空文字 | 空文字が出力されます。 |
31~35 | ecmProp_UserInt1~ecmProp_UserInt5 | データベースの値がそのまま出力されます。 日付型の場合でも,20140120のように「/」の区切り文字が無いYYYYMMDD形式で出力されます。 |
36~40 | ecmProp_UserStr1~ecmProp_UserStr5 | データベースの値がそのまま出力されます。 |
41~50 | ecmProp_DocTypePropInt1~ecmProp_DocTypePropInt10 | データベースの値がそのまま出力されます。 日付型の場合でも,20140120のように「/」の区切り文字が無いYYYYMMDD形式で出力されます。 |
51~60 | ecmProp_DocTypePropStr1~ecmProp_DocTypePropStr10 | データベースの値がそのまま出力されます。 マスタ型の場合,文書種別の属性値マスタに設定されている属性値コードを,階層が上位の属性値コードから順番に半角の「-(ハイフン)」で区切って出力されます。 例:00023-000294-00338 |
61~65 | ecmProp_DocTypePropLongStr1~ecmProp_DocTypePropLongStr5 | データベースの値がそのまま出力されます。 |
66 | OIID | -aオプションを指定した場合だけ出力されます。 文書のバージョンのOIIDを「dma:///~」から始まる133バイトの文字列の形式で出力します。 |
67 | 作成者ID | -aオプションを指定した場合だけ出力されます。 データベースの値をそのまま出力します。 |
68 | ファイルサイズ | -aオプションを指定した場合だけ出力されます。データベースの値をそのまま出力します。 |
69 | 全文検索 | -aオプションを指定した場合だけ出力されます。 主ファイルの情報を,次に示す値で出力します。
|
70 | チェックアウト中ユーザID | -aオプションを指定した場合だけ出力されます。 チェックアウト中ユーザのユーザIDが出力されます。チェックアウト中のユーザがいない場合,公開文書の場合は,空文字が出力されます。 |
71 | チェックアウト中ユーザ名 | -aオプションを指定した場合だけ出力されます。 チェックアウト中ユーザのユーザ名が出力されます。チェックアウト中のユーザがいない場合,公開文書の場合は,空文字が出力されます。 |
72 | 案件番号 | -aオプションを指定した場合だけ出力されます。 公開文書の場合に,案件番号が出力されます。公開文書以外の場合は,空文字が出力されます。 |
73 | 公開開始日 | -aオプションを指定した場合だけ出力されます。 公開開始日が出力されます。20140120のように「/」の区切り文字が無いYYYYMMDD形式で出力されます。 一般文書の場合,最新のバージョンの場合は0が,旧バージョンの場合は99991231が出力されます。 |
74 | 公開終了日 | -aオプションを指定した場合だけ出力されます。 公開終了日が出力されます。20140120のように「/」の区切り文字が無いYYYYMMDD形式で出力されます。 一般文書の場合,最新のバージョンの場合は99991231が,旧バージョンの場合は0が出力されます。 |
登録結果,フォルダ名_1,フォルダ名_2,フォルダ名_3,フォルダ名_4,フォルダ名_5,フォルダ名_6,フォルダ名_7,フォルダ名_8,フォルダ名_9,フォルダ名_10,,所有者ID,ユーザの表示名称,採番結果,ファイル名,文書名,コメント,文書種別,全てのユーザに対するアクセス権限,アクセス権限リスト,更新者ID,更新者名,更新日時,,関連ファイル,継続行フラグ,作成日時,,,ecmProp_UserInt1,ecmProp_UserInt2,ecmProp_UserInt3,ecmProp_UserInt4,ecmProp_UserInt5,ecmProp_UserStr1,ecmProp_UserStr2,ecmProp_UserStr3,ecmProp_UserStr4,ecmProp_UserStr5,ecmProp_DocTypePropInt1,ecmProp_DocTypePropInt2,ecmProp_DocTypePropInt3,ecmProp_DocTypePropInt4,ecmProp_DocTypePropInt5,ecmProp_DocTypePropInt6,ecmProp_DocTypePropInt7,ecmProp_DocTypePropInt8,ecmProp_DocTypePropInt9,ecmProp_DocTypePropInt10,ecmProp_DocTypePropStr1,ecmProp_DocTypePropStr2,ecmProp_DocTypePropStr3,ecmProp_DocTypePropStr4,ecmProp_DocTypePropStr5,ecmProp_DocTypePropStr6,ecmProp_DocTypePropStr7,ecmProp_DocTypePropStr8,ecmProp_DocTypePropStr9,ecmProp_DocTypePropStr10,ecmProp_DocTypePropLongStr1,ecmProp_DocTypePropLongStr2,ecmProp_DocTypePropLongStr3,ecmProp_DocTypePropLongStr4,ecmProp_DocTypePropLongStr5(,OIID,作成者ID,ファイルサイズ,全文検索,チェックアウト中ユーザID,チェックアウト中ユーザ名,案件番号,公開開始日,公開終了日) |
登録結果,フォルダ名_1,フォルダ名_2,フォルダ名_3,フォルダ名_4,フォルダ名_5,フォルダ名_6,フォルダ名_7,フォルダ名_8,フォルダ名_9,フォルダ名_10,,所有者ID,ユーザの表示名称,採番結果,ファイル名,文書名,コメント,文書種別,全てのユーザに対するアクセス権限,アクセス権限リスト,更新者ID,更新者名,更新日時,,関連ファイル,継続行フラグ,作成日時,,,ecmProp_UserInt1,ecmProp_UserInt2,ecmProp_UserInt3,ecmProp_UserInt4,ecmProp_UserInt5,ecmProp_UserStr1,ecmProp_UserStr2,ecmProp_UserStr3,ecmProp_UserStr4,ecmProp_UserStr5,ecmProp_DocTypePropInt1,ecmProp_DocTypePropInt2,ecmProp_DocTypePropInt3,ecmProp_DocTypePropInt4,ecmProp_DocTypePropInt5,ecmProp_DocTypePropInt6,ecmProp_DocTypePropInt7,ecmProp_DocTypePropInt8,ecmProp_DocTypePropInt9,ecmProp_DocTypePropInt10,ecmProp_DocTypePropStr1,ecmProp_DocTypePropStr2,ecmProp_DocTypePropStr3,ecmProp_DocTypePropStr4,ecmProp_DocTypePropStr5,ecmProp_DocTypePropStr6,ecmProp_DocTypePropStr7,ecmProp_DocTypePropStr8,ecmProp_DocTypePropStr9,ecmProp_DocTypePropStr10,ecmProp_DocTypePropLongStr1,ecmProp_DocTypePropLongStr2,ecmProp_DocTypePropLongStr3,ecmProp_DocTypePropLongStr4,ecmProp_DocTypePropLongStr5,OIID,作成者ID,ファイルサイズ,全文検索,チェックアウト中ユーザID,チェックアウト中ユーザ名,案件番号,公開開始日,公開終了日 "","1","21","","","","","","","","","","admin","セキュリティ管理者(admin)","","1main改造.txt","1main改造","","","NONE","","admin","セキュリティ管理者(admin)","2014/05/08-20:03:25","","","","2014/05/08-20:03:25","","","0","0","0","0","0","","","","","","0","0","0","0","0","0","0","0","0","0","","","","","","","","","","","","","","","","dma:///07a17522-a626-11d0-b11f-0020af27a837/673d2be0-d1fd-11d0-ab59-08002be29e1d/13f4c4cf-5acd-45cf-acc6-3674c81dce070000000000001A86","admin","94","1","" "","1","21","","","","","","","","","","admin","セキュリティ管理者(admin)","","2sub.txt","2sub","","","NONE","","admin","セキュリティ管理者(admin)","2014/05/08-20:03:18","","","","2014/05/08-20:03:18","","","0","0","0","0","0","","","","","","0","0","0","0","0","0","0","0","0","0","","","","","","","","","","","","","","","","dma:///07a17522-a626-11d0-b11f-0020af27a837/673d2be0-d1fd-11d0-ab59-08002be29e1d/13f4c4cf-5acd-45cf-acc6-3674c81dce070000000000001A7A","admin","106","1","" "","1","21","","","","","","","","","","admin","セキュリティ管理者(admin)","","3sub.txt","3sub","","","NONE","","admin","セキュリティ管理者(admin)","2014/05/08-20:03:11","","","","2014/05/08-20:03:11","","","0","0","0","0","0","","","","","","0","0","0","0","0","0","0","0","0","0","","","","","","","","","","","","","","","","dma:///07a17522-a626-11d0-b11f-0020af27a837/673d2be0-d1fd-11d0-ab59-08002be29e1d/13f4c4cf-5acd-45cf-acc6-3674c81dce070000000000001A6E","admin","51","1","" "","1","21","2131","","","","","","","","","admin","セキュリティ管理者(admin)","","1main改造.txt","1main改造","","","NONE","","admin","セキュリティ管理者(admin)","2014/05/08-20:04:10","","","","2014/05/08-20:04:10","","","0","0","0","0","0","","","","","","0","0","0","0","0","0","0","0","0","0","","","","","","","","","","","","","","","","dma:///07a17522-a626-11d0-b11f-0020af27a837/673d2be0-d1fd-11d0-ab59-08002be29e1d/13f4c4cf-5acd-45cf-acc6-3674c81dce070000000000001AB6","admin","94","1","" "","1","21","2131","","","","","","","","","admin","セキュリティ管理者(admin)","","2sub.txt","2sub","","","NONE","","admin","セキュリティ管理者(admin)","2014/05/08-20:04:27","","","","2014/05/08-20:04:27","","","0","0","0","0","0","","","","","","0","0","0","0","0","0","0","0","0","0","","","","","","","","","","","","","","","","dma:///07a17522-a626-11d0-b11f-0020af27a837/673d2be0-d1fd-11d0-ab59-08002be29e1d/13f4c4cf-5acd-45cf-acc6-3674c81dce070000000000001AD0","admin","106","1","" : : |
ログファイル
コマンドの実行経過はログファイルに出力されます。
YYYY/MM/DD hh:mm:ss message |
ログファイルは,コマンドを実行するごとに情報が蓄積され,ファイルサイズが増加します。このため,運用時は,定期的にバックアップを取得したあとにログファイルを削除するなどして,ファイルサイズが大きくなり過ぎないようにしてください。
注意事項