ecmRFileMove.vbs
               〔〔/p〕 |
                   /j
                 〔/t:最大実行時間〕
                 〔/i〕
                 〔/d:コンテント格納先パス定義ファイルのパス〕〕

リファレンスファイル文書化指示で作成したジョブ登録情報に基づいて，リファレンスファイル文書化をします。また，定義ファイルを使用することにより，文書のプロパティ値ごとにコンテントの格納先を振り分けることができます。

なお，リファレンスファイル文書化コマンド実行時にごみ箱へ移動している文書は，リファレンスファイル文書化の対象となりません。

次の文書はリファレンスファイル文書化の処理をスキップします。ただし，スキップの対象となる文書に対しても文書の状態をチェックするため，チェックの時間が必要となります。

• 主ファイルに文書の実体（コンテント）ファイルが登録されていない文書
• チェックアウト中の文書
• 改訂中の公開文書
• 全文検索テキストが登録されていない文書で，/i指定を省略している場合
• すでにリファレンスファイル文書化されている文書^※
• PDF形式への変換が終了していない文書
• PDF形式への変換がエラーとなった文書^※
• その他のエラー発生により，リファレンスファイル文書化処理を中断した文書

スキップした文書が，リファレンスファイル文書化指示で作成したジョブ登録情報に含まれている場合は，該当するジョブ登録情報は削除されません。主ファイルと関連ファイルのどちらかがスキップの対象となる文書の場合，すでにリファレンスファイル文書化に成功したファイルも含めて，その文書のステータスはスキップとなります。スキップの要因を取り除いて，再度，リファレンスファイル文書化コマンドを実行してください。ただし，スキップしたファイルのステータスがSKIP5の場合で，その他の主ファイル，関連ファイルのステータスがすべてOKのときには，リファレンスファイル文書化されます。

注※

すでにリファレンスファイル文書化されている文書，およびPDF形式への変換がエラーとなった文書のジョブ登録情報は削除されます。

/p

リファレンスファイル文書化指示画面で登録したジョブ情報の一覧として，リファレンスファイル文書化指示フォルダ情報の一覧を出力します。出力するファイルは，「リファレンスファイル文書化指示フォルダ情報出力ファイル」，「フォルダ情報対応ファイル」です。

コマンド引数の指定を省略してリファレンスファイル文書化コマンドを実行した場合，/pが仮定されて実行されます。

/j

リファレンスファイル文書化指示で作成したジョブ登録情報に基づいて，リファレンスファイル文書化を実行します。実行結果を「フォルダ情報対応ファイル」，「リファレンスファイル文書化実行結果ファイル」，および「文書情報対応ファイル」に出力します。

/t:最大実行時間

リファレンスファイル文書化の実行時間を分単位で指定します。実行時間に指定できる範囲は，半角数字で1〜1440（最大1日）です。

指定を省略した場合，リファレンスファイル文書化が完了するまで処理を続けます。

/i

全文検索テキストが登録されていない文書もリファレンスファイル文書化の対象にします。

/iを指定しない場合，全文検索テキストが登録されていない文書はリファレンスファイル文書化の対象にならないで，ログ情報が出力されます。

/iを指定した場合，全文検索テキストが登録されていない文書についてもリファレンスファイル文書化の対象とします。このため，/iを指定しないでリファレンスファイル文書化コマンドを実行し，出力されたログ情報でスキップした文書がリファレンスファイル文書化の対象として問題がないことを確認してから，/iを指定して再度リファレンスファイル文書化コマンド実行することを推奨します。

/d:コンテント格納先パス定義ファイルのパス

リファレンスファイル文書化対象文書のコンテント格納先を，文書のプロパティ値ごとに振り分ける場合に，振り分けルールの定義ファイルのパスを指定します。

指定を省略した場合，配置ディスクリプタ（web.xml）のapp.ReferenceContentPathパラメタで指定した格納先にコンテントを格納します。

コンテント格納先パス定義ファイルの定義の詳細については，「6.3.3　リファレンスファイル文書化コマンドで使用するファイル」を参照してください。

コマンドの戻り値を取得するときは，コマンドをCSCRIPTから起動してください。

コマンドの戻り値を次の表に示します。

表6-7　ecmRFileMove.vbsコマンドの戻り値

戻り値	意味	備考
0	正常終了	−
1	警告付き正常終了	リファレンスファイル文書化の対象文書が存在しない
2	引数不正エラー	−
3	ファイル入出力エラー	−
4	オブジェクト操作ツールエラー	−
6	環境変数未設定エラー	環境変数%MLD_HOME%が未設定または不正
7	/t指定による中断	/tで指定した最大実行時間に達したため処理を中断
上記以外	そのほかのエラー	−

（凡例）　−：該当しません。

コマンドの実行開始，実行終了，および各種エラー情報はログファイルに出力されます。

リファレンスファイル文書化コマンドは，指定した引数により出力されるログファイルが違います。出力されるログファイルとその内容を次の表に示します。

表6-8　ecmRFileMove.vbsコマンドのログファイル

ログファイル名称	内容
フォルダ情報対応ファイル	リファレンスファイル文書化指示対象フォルダのOIIDとフォルダ名が出力されます。 リファレンスファイル文書化コマンドを実行すると必ず出力されます。
リファレンスファイル文書化指示フォルダ情報出力ファイル	リファレンスファイル文書化指示フォルダの一覧が出力されます。 /pを指定した場合出力されます。
リファレンスファイル文書化実行結果ファイル	リファレンスファイル文書化コマンドを実行した結果が出力されます。主ファイルと関連ファイルの両方が出力されます。 /jを指定した場合出力されます。
文書情報対応ファイル	リファレンスファイル文書化指示対象文書の主ファイルのOIIDと文書名が出力されます。 /jを指定した場合出力されます。

ログファイルは，コマンドを実行するごとに情報が蓄積され，ファイルサイズが増加します。このため，運用時は，定期的にバックアップを取得したあとにログファイルを削除するなどして，ファイルサイズが大きくなり過ぎないようにしてください。

各ログファイルについて，出力先，出力形式，および出力例を説明します。

フォルダ情報対応ファイル

• 出力先
  

  {DocumentBroker Standard GUIのインストールフォルダ} \tools\log\ecmRFFolInfo.log

• 出力形式
  

  開始日時 リファレンスファイル文書化指示フォルダのOIID,対象フォルダの名前 ： ： 空行

• 出力例
  

  2007/09/10 20:30:26 dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000038AC,フォルダＡ dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000038AD,フォルダＢ

リファレンスファイル文書化指示フォルダ情報出力ファイル

• 出力先
  

  {DocumentBroker Standard GUIのインストールフォルダ} \tools\log\ecmRFFolPrint.log

• 出力形式
  

  開始日時 △ 開始メッセージ リファレンスファイル文書化指示フォルダのOIID ▲リファレンスファイル文書化指示画面で指定した最終更新日付 リファレンスファイル文書化指示フォルダのOIID ▲リファレンスファイル文書化指示画面で指定した最終更新日付 　　　　　　： 　　　　　　： 終了日時 △ 終了メッセージ

• 出力例
  

  2007/09/10 20:30:26 リファレンスファイル文書化指示フォルダの情報出力を開始します。 dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000038AC　2005/12/31 dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000038AD　2004/12/31 2007/09/10 20:35:26 リファレンスファイル文書化指示フォルダの情報出力を終了します。

リファレンスファイル文書化実行結果ファイル

• 出力先
  

  {DocumentBroker Standard GUIのインストールフォルダ} \tools\log\ecmRFFileMove.log

• 出力形式
  

  開始日時 △ 開始メッセージ リファレンスファイル文書化指示フォルダのOIID リファレンスファイル文書化ステータス ▲リファレンスファイル文書化対象文書のOIID▲リファレンスファイル文書化を実施した際のコンテント格納先パス リファレンスファイル文書化ステータス ▲リファレンスファイル文書化対象文書のOIID▲リファレンスファイル文書化を実施した際のコンテント格納先パス 　　　　　　： 空行 リファレンスファイル文書化指示フォルダのOIID リファレンスファイル文書化ステータス ▲リファレンスファイル文書化対象文書のOIID▲リファレンスファイル文書化を実施した際のコンテント格納先パス リファレンスファイル文書化ステータス ▲リファレンスファイル文書化対象文書のOIID▲リファレンスファイル文書化を実施した際のコンテント格納先パス 　　　　　　： 空行 終了日時 △ 終了メッセージ

• 出力例
  

  2007/09/10 20:30:26 KARI14301-I リファレンスファイル文書化を開始します。 dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000038AC OK　　　dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000012A1　　DocB1 OK_S　　　dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000012A2　　DocB2 OK_S　　　dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000012A3　　DocB2 SKIP_1　　　dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000012B1　　DocB2 SKIP_1_S　　　dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000012B2　　 DocB2 2007/09/10 20:35:26 KARI14302-I リファレンスファイル文書化を終了します。 [EXIT-CODE:0 TOTAL-COUNT:2 OK-COUNT:1 SKIP-COUNT:1 ERR-COUNT:0]

  更新履歴が複数存在する文書の場合，最新の文書のOIIDだけが出力されます。なお，文書情報対応ファイルは，主ファイルのOIIDと文書名しか出力されません。関連ファイルでスキップとなった場合は，対応する主ファイルのOIIDから主ファイルを特定し，スキップとなった関連ファイルを特定してください。

  
  

ステータスの意味を次の表に示します。関連ファイルに発行されるステータスには，それぞれのステータスの末尾に「_S」が付加されます。

ステータス	意味
OK	リファレンスファイル文書化に成功しました
SKIP_1	主ファイルに文書の実体（コンテント）ファイルが登録されていないためスキップしました
SKIP_2	チェックアウト中のためスキップしました
SKIP_3	改訂中の公開文書のためスキップしました
SKIP_4	全文検索テキストが登録されていないためスキップしました
	全文検索テキストは登録されていませんが，すでにリファレンスファイル文書化を実行済みのためスキップしました
SKIP_5	すでにリファレンスファイル文書化を実行済みのためスキップしました
SKIP_6	PDF形式への変換が終了していない文書のためスキップしました
SKIP_7	PDF形式への変換がエラーとなった文書のためスキップしました
ERR	リファレンスファイル文書化でエラーが発生しました

文書情報対応ファイル

• 出力先
  

  {DocumentBroker Standard GUIのインストールフォルダ} \tools\log\ecmRFFileInfo.log

• 出力形式
  

  開始日時 リファレンスファイル文書化対象文書のOIID,対象文書の名前 ： ： 空行

• 出力例
  

  2007/09/10 20:30:26 dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000012A1,文書1 dma:///07a17522-a626-11d0-b11f-002・・・・a00000000000012A2,文書2

  主ファイルのOIIDが出力されます。また，更新履歴が複数存在する文書の場合，最新の文書のOIIDだけが出力されます。

  
  

• DocumentBrokerが使用できる環境を，事前に準備しておいてください。
• リファレンスファイル文書化コマンドの実行中は，リファレンスファイル文書化対象に指定したフォルダ下の文書に対して，チェックアウト操作を実行しないでください。
• DocumentBroker Version 5と連携する場合，コマンドの処理に時間が掛かります。