uCosminexus DocumentBroker Version 3 オブジェクト操作ツール
![[目次]](figure/content.gif)
![[用語]](figure/gloss.gif)
![[索引]](figure/index.gif)
![[前へ]](figure/front.gif)
dbrdeldoc(文書の削除)
機能
文書を削除します。OIIDファイルに複数のOIIDを指定すると,複数の文書を一括して削除できます。
操作クラス
- CdbrDocumentクラス
- CdbrVersionableDocumentクラス
形式
dbrdeldoc 〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕
〔 -k Reference
〔 -a { RELATIVE | NONE } 〕
〔 -b コンテント格納先ベースパス 〕
〔 -y 削除ディレクトリのルートパス 〕〕
{ OIID | OIIDファイル }
オプション
- -v { バージョン識別子 | バージョン識別子ファイル }
- バージョン付き文書の場合,削除するバージョンのバージョン識別子を指定します。このオプションを省略した場合は,すべてのバージョンおよびバージョン付き文書自身が削除されます。
- バージョンなし文書の場合にこのオプションを指定するとエラーになります。
- バージョン識別子
- 削除するバージョンのバージョン識別子を指定します。
- バージョン識別子ファイル
- 削除するバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは,絶対パスまたは相対パスのどちらでも指定できます。ただし,「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお,バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。
- -k Reference
- リファレンスファイル文書を削除します。
- 実行環境制御ファイルのReferenceセクションでContentDeleteModeエントリの指定がSpecifyの場合,このオプションを省略するとエラーになります。
- リファレンスファイル文書を,シングルファイル文書,マルチファイル文書やFileLink文書と混在して使用する場合,このオプションの指定を省略してリファレンスファイル文書を削除するには,実行環境制御ファイルのReferenceセクションで,ContentDeleteModeエントリにAutoを指定してください。ContentDeleteModeエントリにAutoを指定することで,自動的にリファレンスファイル文書かどうかを判別して,リファレンスファイル文書を削除します。ただし,ContentDeleteModeエントリの指定がAutoの場合でも,実行環境制御ファイルにリファレンス情報として,リファレンス種別,コンテント格納先ベースパスおよび削除ディレクトリのルートパスを指定してください。
- このオプションを指定した場合も,シングルファイル文書,マルチファイル文書,またはFile Link文書を削除できます。
- -a { RELATIVE | NONE }
- 削除するリファレンスファイル文書のリファレンス種別を指定します。
- -kオプションの指定を省略して,このオプションを指定するとエラーになります。このオプションを省略した場合,実行環境制御ファイルの,ReferenceセクションのDefaultReferenceTypeエントリの指定を使用します。
- RELATIVE
- コンテントの格納先をファイルシステム上の領域とし,コンテントロケーションを相対パスで管理するオブジェクトです。
- NONE
- コンテントがなく,コンテントロケーションを管理しないオブジェクトです。
- RELATIVEを指定すると,リファレンス種別がNONEのリファレンスファイル文書も削除できます。
- -b コンテント格納先ベースパス
- リファレンスファイル文書を削除する場合に,コンテント格納先ベースパスを指定します。このオプションは,実行環境制御ファイルまたは-aオプションで,リファレンス種別の指定がRELATIVEの場合に有効です。
- オプション引数には,コンテントが格納されているディレクトリの基点となるパスを指定します。例えば,削除するリファレンスファイル文書の基点となるパスが「/drv01/dir01/userdir」ディレクトリの場合,このオプションに「/drv01/dir01/userdir」を指定します。このオプションの指定の末尾に,パスのデリミタ「/」(UNIXの場合)または「\」(Windowsの場合)を記述する必要はありません。
- -kオプションの指定を省略して,このオプションを指定するとエラーになります。このオプションの指定を省略した場合,実行環境制御ファイルの,ReferenceセクションのDefaultContentBasePathエントリの指定を使用します。
- 複数のリファレンスファイル文書を一括して削除する場合は,同一のコンテント格納先ベースパスのリファレンスファイル文書に絞り込んだあと,このコマンドを実行してください。
- このオプションに指定したコンテント格納先ベースパスは,ContentLocationプロパティに格納されたコンテント格納先を示す相対パスと結合して,絶対パスとして使用されます。
- Windowsの場合,コンテント格納先ベースパスにUNC形式のパスを使用することもできます。例えば,「server01」というマシンのネットワーク上で共有しているフォルダ「share」をコンテント格納先ベースパスに指定する場合は,このオプションに「\\server01\share」を指定します。
- -y 削除ディレクトリのルートパス
- リファレンスファイル文書を削除する場合,リファレンスファイル文書とリファレンスファイル文書が格納されているディレクトリを同時に削除するときは,削除ディレクトリのルートパスを指定します。ただし,コンテント格納先ベースパスの上位のディレクトリは指定できません。
- このオプションは,実行環境制御ファイルまたは-aオプションで,リファレンス種別の指定がRELATIVEの場合に有効です。
- オプション引数には,削除するディレクトリのルートパスを指定します。例えば,「/drv01/dir01/userdir/user01/<DocumentBrokerがコンテントを管理するためのディレクトリ>/<登録ファイル名>」のディレクトリ中の「user01」ディレクトリ以下を削除する場合は,「user01」ディレクトリのルートパスとして「/drv01/dir01/userdir」を指定します。また,コンテント格納先ベースパスに「/drv01/dir01/userdir」ディレクトリを指定している場合,コンテント格納先ベースパスの上位のディレクトリとなる「/drv01/dir01」は,削除ディレクトリのルートパスに指定できません。なお,このオプションの指定の末尾に,パスのデリミタ「/」(UNIXの場合)または「\」(Windowsの場合)を記述する必要はありません。
- -kオプションの指定を省略して,このオプションを指定するとエラーになります。このオプションを省略した場合,実行環境制御ファイルの,ReferenceセクションのDefaultDeleteRootPathエントリの指定を使用します。
- 複数の文書を一括して削除する場合,削除ディレクトリのルートパスには,削除するすべてのリファレンスファイル文書の,コンテントの絶対パスの基点となるパスを指定します。
- DocumentBrokerがコンテントを管理するためのディレクトリは,このオプションおよび実行環境制御ファイルのReferenceセクションのDefaultDeleteRootPathエントリで,削除ディレクトリのルートパスの指定を省略した場合も,コンテントと同時に削除されます。
- Windowsの場合,削除ディレクトリのルートパスにUNC形式のパスを使用することもできます。例えば,「server01」というマシンのネットワーク上で共有しているフォルダ「share」を削除ディレクトリのルートパスに指定する場合は,このオプションに「\\server01\share」を指定します。
コマンド引数
- OIID
- 削除する文書のOIIDを指定します。
- OIIDファイル
- 削除する文書のOIIDを記述したIDファイルのファイルパスを指定します。OIIDファイルには,複数のOIIDが指定できます。ただし,-vオプションを指定している場合,記述できるOIIDの数は一つだけです。
- OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは,絶対パスまたは相対パスのどちらでも指定できます。ただし,「dma://」で始まるパスは指定できません。
注意事項
- -vオプション指定時には,複数の文書を一括して削除できません。指定したバージョンを削除できる文書は一つだけです。OIIDファイルに複数のOIIDを指定した場合はエラーになります。
- -vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。
- 文書に文書間リレーションが設定されている場合,リレーションは次のように扱われます。
- 削除する文書がリレーション元文書の場合,リレーションも削除されます。
- 削除する文書がリレーション先文書の場合,リレーションは削除されません。
- File Link文書の,ファイルサーバ上のコンテントの削除モードは,クライアントのコンテントを指定して,文書を作成もしくはアップロードされている場合,またはレンディションを追加されている場合と,ファイルサーバ上に登録されているコンテントを指定して,文書を作成もしくはアップロードされている場合,またはレンディションを追加されている場合で異なります。それぞれの場合のコンテントの削除モードを次に示します。
- クライアントのコンテントを指定して,文書を作成もしくはアップロードされている場合,またはレンディションを追加されている場合
文書,文書のレンディション,またはバージョンを削除すると,ファイルサーバ上のコンテントも同期して削除されます。なお,コンテントとしてディレクトリを登録したときは,ディレクトリごと削除されます。
- ファイルサーバ上に登録されているコンテントを指定して,文書を作成もしくはアップロードされている場合,またはレンディションを追加されている場合
文書,文書のレンディション,またはバージョンを削除しても,ファイルサーバ上のコンテントは削除されません。なお,コンテントにディレクトリを使用しているときでも,ディレクトリは削除されません。
コンテントの削除モードを変更する場合は,実行環境制御ファイルのFileLinkセクションの,ClientContentDeleteModeエントリ,またはServerContentDeleteModeエントリの設定を変更してください。
- リファレンスファイル文書の場合,コンテントの格納先には,DocumentBrokerサーバから接続可能であり,かつDocumentBrokerサーバから参照可能なディレクトリを設定してください。
- リファレンスファイル文書を扱うコンテントの操作でエラーになると,オブジェクトとコンテントの状態が不整合となり,メッセージKMBR30201-E(要因コード3,86)が出力される場合があります。この場合は,再度,dbrdeldocコマンド(文書の削除)を実行してオブジェクトを削除してください。メッセージの詳細については,マニュアル「DocumentBroker Version 3 メッセージ」を参照してください。
- リファレンスファイル文書を削除する場合に,誤って異なるリファレンスファイル文書のコンテント格納先ベースパスを指定すると,オブジェクトは削除され,コマンドは正常終了します。ただし,コンテントは削除されないため,必要に応じて手動で削除してください。
- リファレンスファイル文書を削除する場合に,リファレンスファイル文書かどうかを自動的に判別して削除するときは,実行環境制御ファイルのReferenceセクションでContentDeleteModeエントリにAutoを指定します。
また,ContentDeleteModeエントリの指定がSpecifyの場合は,-kオプションの指定に従ってリファレンスファイル文書を削除します。このとき,-kオプションの指定を省略するとエラーになります。
ContentDeleteModeエントリの指定とdbrdeldocコマンド(文書の削除)の実行結果については,「表3-2 ContentDeleteModeエントリの指定とdbrdelcntrコマンド,dbrdeldocコマンドの実行結果」を参照してください。
- リファレンスファイル文書を削除する場合に,指定できるコンテント格納先ベースパスは一つだけです。複数のコンテント格納先ベースパスを管理する運用で,一括して複数の文書を削除したい場合は,同一のコンテント格納先ベースパスのリファレンスファイル文書に絞り込んで,dbrdeldocコマンド(文書の削除)を実行してください。リファレンスファイル文書の削除の詳細については,「表5-8 リファレンスファイル文書を扱う場合のオブジェクトの削除方法」を参照してください。
All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2006, 2013, Hitachi Solutions, Ltd.