uCosminexus DocumentBroker Version 3　オブジェクト操作ツール

文法書

3000-3-F15-20

目　　次

前書き

変更内容

はじめに

1.　オブジェクト操作ツールの概要

1.1　オブジェクト操作ツールとは

1.1.1　オブジェクト操作ツールとは

1.1.2　オブジェクト操作ツールの使用例

1.2　オブジェクト操作ツールの機能

1.3　システム構成およびクラスライブラリとの関係

1.3.1　システム構成

1.3.2　クラスライブラリとの関係

1.4　オブジェクト操作ツールで使用できる文字コード種別

2.　実行環境の設定

2.1　実行環境設定の流れ

2.2　実行環境設定の詳細

2.2.1　実行ユーザについて

2.2.2　環境変数の設定

2.2.3　実行環境のセットアップ

2.2.4　実行環境制御ファイルの編集

2.2.5　クラス定義情報ファイルの取得

2.2.6　実行環境の更新

2.3　ファイル転送機能の使用

3.　オブジェクト操作ツールで使用するファイル

3.1　オブジェクト操作ツールで使用するファイル一覧

3.2　実行環境制御ファイル

3.2.1　記述規則

3.2.2　記述形式

3.2.3　実行環境制御ファイルの記述例

3.3　クラス定義情報ファイル

3.3.1　ファイル名の規則

3.3.2　記述規則

3.3.3　記述形式

3.3.4　クラス定義情報ファイルの記述例

3.4　IDファイル

3.4.1　記述規則

3.4.2　記述形式

3.4.3　IDファイルの記述例

3.5　プロパティ情報ファイル

3.5.1　記述規則

3.5.2　記述形式

3.5.3　実行するコマンドと指定するエントリの対応

3.5.4　プロパティ情報ファイルの記述例

3.5.5　複数オブジェクトを一括作成する場合のプロパティ情報ファイル

3.6　問い合わせファイル

3.6.1　記述規則

3.6.2　基本項目

3.6.3　記述形式

3.6.4　問い合わせファイルの記述例

3.7　アップロード情報ファイル

3.7.1　記述規則

3.7.2　記述形式

3.7.3　アップロード情報ファイルの記述例

3.8　リファレンス情報ファイル

3.8.1　記述規則

3.8.2　記述形式

3.8.3　リファレンス情報ファイルの記述例

4.　コマンド実行ログと障害対策

4.1　コマンド実行ログ

4.1.1　コマンド実行ログの制御

4.1.2　出力レベル

4.1.3　出力先ディレクトリおよびファイル

4.1.4　ログの出力形式と出力ログ情報

4.1.5　出力例

4.2　障害対策

4.2.1　エラーが発生したときのオブジェクト操作ツールの動作

4.2.2　メッセージ

4.2.3　トレースファイル

4.2.4　詳細エラーログファイル

5.　コマンドリファレンス

実行コマンド一覧

コマンド形式

コマンド実行結果

dbrbind（パブリックACLのバインド）

dbrcrtacl（パブリックACLの作成）

dbrcrtcntr（コンテナの作成）

dbrcrtdata（独立データの作成）

dbrcrtdoc（文書の作成）

dbrcrtidx（全文検索インデクスの作成）

dbrdelacl（パブリックACLの削除）

dbrdelcntr（コンテナの削除）

dbrdeldata（独立データの削除）

dbrdeldoc（文書の削除）

dbrdelidx（全文検索インデクスの削除）

dbrdowndoc（文書のダウンロード）

dbrexquery（問い合わせの実行）

dbrgetprop（プロパティの取得）

dbrlink（オブジェクト間の関連づけ）

dbrlsacl（バインドしているパブリックACL一覧またはバインドされているオブジェクト一覧の取得）

dbrlschild（コンテナに包含されるオブジェクト一覧の取得）

dbrlscompo（マルチファイル文書のコンテント情報一覧の取得）

dbrlsparent（オブジェクトを包含するコンテナ一覧の取得）

dbrlsversion（バージョン一覧の取得）

dbrlsversionable（バージョン管理情報一覧の取得）

dbrrndrdoc（文書のレンディション操作）

dbrsetmode（構成管理モードの設定）

dbrsetprop（プロパティの設定）

dbrtoolsetup（実行環境のセットアップ）

dbrunbind（パブリックACLのアンバインド）

dbrunlink（オブジェクト間の関連づけの解除）

dbrupcntr（コンテナのバージョンアップ）

dbrupdoc（文書のアップロード）

リファレンスファイル管理機能を使用する場合のオブジェクトの削除

付録

付録A　OIID指定時のURLの文法

付録B　文書空間で使用する文字コード種別がUTF-8の場合のサポート範囲

付録C　用語解説

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2006, 2013, Hitachi Solutions, Ltd.

前書き

■ 対象製品

R-1M95D-43※　 uCosminexus DocumentBroker Development Kit Version 3　 03-60（適用OS：AIX 5L V5.1，AIX 5L V5.2，AIX 5L V5.3）
R-1595D-43　 uCosminexus DocumentBroker Development Kit Version 3　 03-70（適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003 R2 x64 Edition，Windows Server 2008 x86，Windows Server 2008 R2，Windows Server 2012，Windows XP，Windows Vista，Windows 7，Windows 8）
R-1M95D-53※　 uCosminexus DocumentBroker Runtime Version 3　 03-60（適用OS：AIX 5L V5.1，AIX 5L V5.2，AIX 5L V5.3）
R-1595D-53　 uCosminexus DocumentBroker Runtime Version 3　 03-70（適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003 R2 x64 Edition，Windows Server 2008 x86，Windows Server 2008 R2，Windows Server 2012，Windows XP，Windows Vista，Windows 7，Windows 8）

これらのプログラムプロダクトのほかにもこのマニュアルをご利用になれる場合があります。詳細は「リリースノート」でご確認ください。
※印の製品については，サポート時期をご確認ください。

■ 輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。
なお、不明な場合は、弊社担当営業にお問い合わせください。

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Office Wordは，米国Microsoft Corporationの商品名称です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。Microsoft Wordは，米国Microsoft Corporationの商品名称です。
OLEは，米国Microsoft Corporationが開発したソフトウェア名称です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
TIFFは，米国Aldus Corp.が開発したフォーマットの名称です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
VisualAgeは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
活文，PDFstaffは，株式会社日立ソリューションズの登録商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。

■ 発行

2013年9月 (第2版) 3000-3-F15-20

■ 著作権

All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2006, 2013, Hitachi Solutions, Ltd.

変更内容

変更内容（3000-3-F15-20）　DocumentBroker Development Kit Version 3　03-70（適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003 R2 x64 Edition，Windows Server 2008 x86，Windows Server 2008 R2，Windows Server 2012，Windows XP，Windows Vista，Windows 7，Windows 8），DocumentBroker Runtime Version 3　03-70（適用OS：Windows Server 2003，Windows Server 2003 R2，Windows Server 2003 R2 x64 Edition，Windows Server 2008 x86，Windows Server 2008 R2，Windows Server 2012，Windows XP，Windows Vista，Windows 7，Windows 8）

追加・変更内容
変更個所

次の前提OSをサポートしました。

Windows Server 2012

Windows 8

1.2

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，次に示すプログラムプロダクトで提供するオブジェクト操作ツールの機能と使い方について説明したものです。

R-1M95D-43　uCosminexus DocumentBroker Development Kit Version 3

R-1595D-43　uCosminexus DocumentBroker Development Kit Version 3

R-1M95D-53　uCosminexus DocumentBroker Runtime Version 3

R-1595D-53　uCosminexus DocumentBroker Runtime Version 3

対象読者

このマニュアルは，uCosminexus DocumentBroker Development Kit Version 3またはuCosminexus DocumentBroker Runtime Version 3で提供するオブジェクト操作ツールを利用して，クライアントアプリケーションで作成したオブジェクトを操作する方を対象にしています。なお，次の内容を理解されていることを前提としています。

UNIXまたはWindowsに関する知識

SQL言語に関する知識

分散オブジェクト技術に関する知識

マニュアルの構成

このマニュアルは，次に示す章と付録から構成されています。

第1章　オブジェクト操作ツールの概要

オブジェクト操作ツールの概要と機能について説明しています。

第2章　実行環境の設定

オブジェクト操作ツールを実行するための実行環境の設定方法について説明しています。

第3章　オブジェクト操作ツールで使用するファイル

オブジェクト操作ツールで使用するファイルについて説明しています。

第4章　コマンド実行ログと障害対策

コマンド実行ログと障害対策について説明しています。

第5章　コマンドリファレンス

オブジェクト操作ツールの実行コマンドの文法について説明しています。

付録A　OIID指定時のURLの文法

OIIDの形式およびOIIDを指定するときのURLの文法について説明しています。

付録B　文書空間で使用する文字コード種別がUTF-8の場合のサポート範囲

文書空間で使用する文字コード種別がUTF-8の場合にサポートする範囲について説明しています。

付録C　用語解説

uCosminexus DocumentBrokerで使用する用語について説明しています。

関連マニュアル

このマニュアルは次のマニュアルと関連がありますので，必要に応じてお読みください。なお，本文に記載のマニュアル名称は，「uCosminexus DocumentBroker」を「DocumentBroker」と表記しています。

uCosminexus DocumentBrokerのマニュアル

DocumentBroker Version 3　システム導入・運用ガイド（3000-3-D01）

uCosminexus DocumentBroker Version 3　システム導入・運用ガイド（3020-3-U71）

uCosminexus DocumentBrokerを使用する環境を定義，管理および運用する場合に参照してください。

UNIXの場合は，資料番号が3000-3-D01のマニュアルを参照してください。

Windowsの場合は，資料番号が3020-3-U71のマニュアルを参照してください。

uCosminexus DocumentBroker Version 3　クラスライブラリ　C++　解説（3000-3-F13）

クラスライブラリの機能と，クラスライブラリを使用するために必要なオブジェクトモデルについて知りたい場合に参照してください。

uCosminexus DocumentBroker Version 3　クラスライブラリ　C++　リファレンス　基本機能編（3000-3-F14）

クラスライブラリのクラスの詳細とメソッドの文法について知りたい場合に参照してください。

uCosminexus DocumentBroker Version 3　メッセージ（3000-3-F12）

uCosminexus DocumentBrokerが出力するメッセージについて知りたい場合に参照してください。

uCosminexus DocumentBroker Text Search Index Loader Version 3（3020-3-U72）

uCosminexus DocumentBrokerに格納されている文書からテキスト情報を抽出して，全文検索用のインデクスファイルを作成し，これを全文検索インデクスに登録するユティリティについて知りたい場合に参照してください。

関連製品のマニュアル

HiRDBデジタルコンテンツアクセスプラグイン　HiRDB File Link（UNIX(R)用）（3000-6-253）※

HiRDBデジタルコンテンツアクセスプラグイン　HiRDB File Link（Windows(R)用）（3020-6-141）※

注※

このマニュアルでは，これらのマニュアルを「HiRDB File Link」と表記しています。

読書手順

このマニュアルは，利用目的に合わせて章を選択してお読みいただけます。利用目的別の流れに従ってお読みいただくことをお勧めします。

このマニュアルでの表記

このマニュアルでは，製品名称を次に示す略称で表記しています。

製品名称 | 略称
AIX 5L V5.1 | AIX
AIX 5L V5.2
AIX 5L V5.3
uCosminexus DocumentBroker Development Kit Version 3 | DocumentBroker
uCosminexus DocumentBroker Runtime Version 3
uCosminexus DocumentBroker Server Version 3
uCosminexus DocumentBroker Development Kit Version 3 | DocumentBroker Development Kit
uCosminexus DocumentBroker Runtime Version 3 | DocumentBroker Runtime
uCosminexus DocumentBroker Server Version 3 | DocumentBrokerサーバ
HiRDB/Single Server Version 6 | HiRDB
HiRDB/Single Server Version 7
HiRDB/Single Server Version 8
HiRDB/Parallel Server Version 6
HiRDB/Parallel Server Version 7
HiRDB/Parallel Server Version 8
IBM VisualAge C++ Professional for AIX V5 | VisualAge C++ Professional for AIX
IBM VisualAge C++ Professional for AIX V6
IBM XL C/C++ Enterprise Edition V7 for AIX | IBM XL C/C++ Enterprise Edition for AIX
IBM XL C/C++ Enterprise Edition V8 for AIX
Microsoft(R) Active Directory(R) | Active Directory
Microsoft(R) Windows Server(R) 2003, Enterprise Edition 日本語版 | Windows Server 2003
Microsoft(R) Windows Server(R) 2003, Standard Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition 日本語版 | Windows Server 2003 R2
Microsoft(R) Windows Server(R) 2003 R2, Standard Edition 日本語版
Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition日本語版 | Windows Server 2003 R2またはWindows Server 2003 R2 x64 Edition
Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition 日本語版
Microsoft(R) Windows Server(R) 2008 Enterprise 32-bit 日本語版 | Windows Server 2008 またはWindows Server 2008 x86
Microsoft(R) Windows Server(R) 2008 Standard 32-bit 日本語版
Microsoft(R) Windows Server(R) 2008 R2 Enterprise 日本語版 | Windows Server 2008 R2
Microsoft(R) Windows Server(R) 2008 R2 Standard 日本語版
Microsoft(R) Windows Server(R) 2012 Standard 日本語版 | Windows Server 2012
Microsoft(R) Windows Server(R) 2012 Datacenter 日本語版
Microsoft(R) Windows(R) XP Professional Operating System | Windows XP
Microsoft(R) Windows Vista(R) Ultimate 日本語版 | Windows Vista
Microsoft(R) Windows Vista(R) Business 日本語版
Microsoft(R) Windows Vista(R) Enterprise 日本語版
Microsoft(R) Windows(R) 7 Professional 日本語版 (32ビット版) | Windows 7
Microsoft(R) Windows(R) 7 Enterprise 日本語版 (32ビット版)
Microsoft(R) Windows(R) 7 Ultimate 日本語版 (32ビット版)
Microsoft(R) Windows(R) 7 Professional 日本語版 (64ビット版)
Microsoft(R) Windows(R) 7 Enterprise 日本語版 (64ビット版)
Microsoft(R) Windows(R) 7 Ultimate 日本語版 (64ビット版)
Windows(R) 8 Pro 日本語版（32ビット版） | Windows 8
Windows(R) 8 Pro 日本語版（64ビット版）
Windows(R) 8 Enterprise 日本語版（32ビット版）
Windows(R) 8 Enterprise 日本語版（64ビット版）
Microsoft(R) Office Word | Word
Microsoft(R) Windows Vista(R) Ultimate 日本語版 | Windows Vista
Microsoft(R) Windows Vista(R) Business 日本語版
Microsoft(R) Windows Vista(R) Enterprise 日本語版
Microsoft(R) Windows(R) 7 Professional 日本語版 (32ビット版) | Windows 7
Microsoft(R) Windows(R) 7 Enterprise 日本語版 (32ビット版)
Microsoft(R) Windows(R) 7 Ultimate 日本語版 (32ビット版)
Microsoft(R) Windows(R) 7 Professional 日本語版 (64ビット版)
Microsoft(R) Windows(R) 7 Enterprise 日本語版 (64ビット版)
Microsoft(R) Windows(R) 7 Ultimate 日本語版 (64ビット版)
Sun Java(TM) System Directory Server 5.1 | Sun Java System Directory Server
Sun Java(TM) System Directory Server 5.2
Sun Java(TM) System Directory Server 6.3
TPBroker Developer for C++ | TPBroker V3
TPBroker for C++
TPBroker | TPBroker V5

このほか，このマニュアルでは，次に示す表記方法を使用しています。

DocumentBroker Development Kitの01-21以前のバージョンについては，Version 1と表記します。

uCosminexus DocumentBroker Development Kit Version 3で提供するC++ クラスライブラリをクラスライブラリと表記します。

AIXをUNIXと表記することがあります。

TPBroker V3およびTPBroker V5を合わせてTPBrokerと表記することがあります。

Windows Server 2003，Windows Server 2003 R2，Windows Server 2003 R2 x64 Edition，Windows Server 2008 x86，Windows Server 2008 R2，Windows Server 2012，Windows XP，Windows Vista，Windows 7，およびWindows 8を合わせてWindowsと表記することがあります。

uCosminexus DocumentBrokerrのマニュアルで使用する略語

uCosminexus DocumentBrokerのマニュアルで使用する英略語を次に示します。

英略語 | 英字での表記
ACE | Access Control Element
ACFlag | Access Control Flag
ACL | Access Control List
AIIM | Association for Information and Image Management International
API | Application Programming Interface
ASCII | American Standard Code for Information Interchange
BES | Back End Server
BLOB | Binary Large Object
BMP | Bit Map
BNF | Backus Normal Form
BOA | Basic Object Adapter
BOM | Byte Order Mark
CD-ROM | Compact Disc Read Only Memory
CGI | Common Gateway Interface
CORBA | Common Object Request Broker Architecture
CPU | Central Processing Unit
CR | Carriage Return
CSV | Comma Separated Value
DAP | Directory Access Protocol
DAT | Digital Audio Tape
DB | Database
DBMS | Database Management System
DDE | Dynamic Data Exchange
DIT | Directory Information Tree
DLL | Dynamic Linking Library
DMA | Document Management Alliance
DN | Distinguished Name
EOF | End of File
ESIS-B | Element Structure Information Set-Binary Format
EUC | Extended UNIX Code
FAM | File Access Module
GIF | Graphics Interchange Format
GUI | Graphical User Interface
GUID | Globally Unique Identifier
HTML | Hypertext Markup Language
HTTP | Hypertext Transfer Protocol
IANA | Internet Assigned Numbers Authority
ID | Identifier
IPF | Itanium(R) Processor Family
ISO | International Organization for Standardization
JIS | Japanese Industrial Standards
JPEG | Joint Photographic Expert Group
LAN | Local Area Network
LDAP | Lightweight Directory Access Protocol
LF | Line Feed
MFC | Microsoft Foundation Class
MIME | Multipurpose Internet Mail Extensions
OCR | Optical Character Reader
OIID | Object Instance Identifier
OLE | Object Linking and Embedding
OMG | Object Management Group
ORB | Object Request Broker
ORDB | Object Relational Database
OS | Operating System
OTS | Object Transaction Service
PC | Personal Computer
PDF | Portable Document Format
RDB | Relational Database
RDN | Relative Distinguished Name
RFC | Request for Comment
RTF | Rich Text Format
SGML | Standard Generalized Markup Language
SQL | Structured Query Language
TCP/IP | Transmission Control Protocol/Internet Protocol
TIFF | Tag Image File Format
UCS-2 | Universal Character Set coded in 2 octets
UCS-4 | Universal Character Set coded in 4 octets
UNC | Universal Naming Convention
UOC | User Own Coding
URL | Uniform Resource Locator
UTC | Universal Time Coordinated
UTF-8 | 8-bit UCS Transformation Format
W3C | World Wide Web Consortium
WWW | World Wide Web
XML | Extensible Markup Language

このマニュアルで使用する記号

このマニュアルで使用する記号を次に示します。

記号
意味

　｜
横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。
（例）　A｜B
　AまたはBを指定することを示します。

　＿
括弧で囲まれた複数項目のうち1項目に対し使用され，括弧内のすべてを省略したときシステムが取る標準値を示します。
（例）　〔A｜B〕
　「何も指定しない」か「AまたはBを指定する」ことを示します。何も指定しない場合はAが仮定されます。

｛　｝
この記号で囲まれている複数の項目のうちから一つを選択することを示します。項目が横に並べられ，記号｜で区切られている場合は，そのうちの一つを選択します。
（例）　｛A｜B｜C｝
　A，BまたはCのどれかを指定することを示します。

〔　〕
この記号で囲まれている項目は省略してもよいことを示します。複数の項目が横に並べて記述されている場合には，すべてを省略するか，記号｛ ｝と同じくどれか一つを選択します。
（例１）　〔A〕
　「何も指定しない」か「Aを指定する」ことを示します。
（例２）　〔B｜C〕
　「何も指定しない」か「BまたはCを指定する」ことを示します。

：：＝
この記号の左にあるものを右にあるもので定義することを示します。
（例）　A：：＝B
　「AとはBである」と定義することを示します。

　…
記述が省略されていることを示します。
（例）　ABC…
　ABCの後ろに記述があり，その記述が省略されていることを示します。

<　>
この記号で囲まれている項目は，該当する要素を指定することを示します。
（例）　<プロパティ>
　プロパティを記述します。

(　)
この記号で囲まれている項目を省略しないで記述することを示します。
（例）　(<プロパティ>)
　項目<プロパティ>は省略しないで記述します。

　...
この記号の直前に示す記号を繰り返し，複数個指定できることを示します。
（例）　(<プロパティ>)...
　プロパティは一つ以上で複数個，繰り返して指定できます。

このマニュアルで使用する構文要素

このマニュアルで使用する構文要素の種類を次に示します。

種類 | 定義
英字 | A～Z　a～z
英小文字 | a～z
英大文字 | A～Z
数字 | 0～9
英数字 | A～Z　a～z　0～9
記号 | !　"　#　$　%　&　'　(　)　+　,　_　・　.　/　:　;　<　=　>　@　[　]　^　－　｛　｝　￣　タブ　空白

注　すべて半角文字を使用してください。

このマニュアルの図中で使用する記号

このマニュアルの図中で使用する記号を，次のように定義します。

常用漢字以外の漢字の使用について

このマニュアルでは，常用漢字を使用することを基本としていますが，次に示す用語については，常用漢字以外の漢字を使用しています。

個所（かしょ）

KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

DocumentBroker Version 2とuCosminexus DocumentBroker Version 3の製品体系の違い

uCosminexus DocumentBroker Version 3では次のように製品の統合を行いました。

DocumentBroker RepositoryをuCosminexus DocumentBroker Serverに統合しました。

DocumentBroker Web ComponentをuCosminexus DocumentBroker Development KitおよびuCosminexus DocumentBroker Runtimeに統合しました。

DocumentBroker Version 2とuCosminexus DocumentBroker Version 3の製品体系の違いを次に示します。

DocumentBroker Version 2とuCosminexus DocumentBroker Version 3のマニュアルの対応

バージョンアップおよび製品体系の変更に伴い，uCosminexus DocumentBroker Version 3では次に示すようにマニュアル名称を変更しました。

Version 2のマニュアル名称 | Version 3のマニュアル名称
DocumentBroker Version 2　システム導入・運用ガイド | uCosminexus DocumentBroker Version 3　システム導入・運用ガイド
DocumentBroker Version 2　クラスライブラリ　解説 | uCosminexus DocumentBroker Version 3　クラスライブラリ　C++　解説
DocumentBroker Version 2　クラスライブラリ　リファレンス　基本機能編 | uCosminexus DocumentBroker Version 3　クラスライブラリ　C++　リファレンス　基本機能編
DocumentBroker Version 2　クラスライブラリ　リファレンス　概念SGML文書管理機能編 | 廃版
DocumentBroker Version 2　オブジェクト操作ツール | uCosminexus DocumentBroker Version 3　オブジェクト操作ツール
DocumentBroker Version 2　統計解析ツール | uCosminexus DocumentBroker Version 3　統計解析ツール
DocumentBroker Version 2　メッセージ | uCosminexus DocumentBroker Version 3　メッセージ
DocumentBroker Web Component Version 2　解説 | uCosminexus DocumentBroker Version 3　クラスライブラリ　Java　解説
DocumentBroker Web Component Version 2　リファレンス | uCosminexus DocumentBroker Version 3　クラスライブラリ　Java　リファレンス
DocumentBroker Web Component Version 2　サンプルWebアプリケーション | uCosminexus DocumentBroker Version 3　クラスライブラリ　Java　サンプルWebアプリケーション
DocumentBroker Text Search Index Loader Version 2 | uCosminexus DocumentBroker Text Search Index Loader Version 3
DocumentBroker Rendering Option　システム導入・運用ガイド | uCosminexus DocumentBroker Rendering Option Version 3
DocumentBroker Object Loader Version 2 | uCosminexus DocumentBroker Object Loader Version 3

1.　オブジェクト操作ツールの概要

この章では，オブジェクト操作ツールの概要と機能について，クラスライブラリとの関係と合わせて説明します。

＜この章の構成＞

1.1　オブジェクト操作ツールとは

1.2　オブジェクト操作ツールの機能

1.3　システム構成およびクラスライブラリとの関係

1.4　オブジェクト操作ツールで使用できる文字コード種別

1.1　オブジェクト操作ツールとは

ここでは，オブジェクト操作ツールの概要，および使用例について説明します。

＜この節の構成＞

1.1.1　オブジェクト操作ツールとは

1.1.2　オブジェクト操作ツールの使用例

1.1.1　オブジェクト操作ツールとは

オブジェクト操作ツールは，DocumentBroker Development Kitが提供するクラスライブラリを使用したクライアントアプリケーションです。DocumentBrokerでは，クライアントアプリケーションを円滑に開発していただくために必要なクラスライブラリの機能を，コマンド群（オブジェクト操作ツール）として提供しています。

1.1.2　オブジェクト操作ツールの使用例

オブジェクト操作ツールは，クライアントアプリケーションの開発を円滑に進められるように支援することを目的としており，次のような使われ方を想定しています。

クライアントアプリケーションで作成したオブジェクトの設定内容を確認するための，設定確認用プログラムとして使用する。

クライアントアプリケーションの動作確認用に作成したオブジェクトが不要になった場合に，それらのオブジェクトを削除するための削除用プログラムとして使用する。

このように，オブジェクト操作ツールは，クライアントアプリケーションの開発支援を目的としているため，クラスライブラリが提供するすべての機能を備えてはいません。したがって，DocumentBrokerシステムを本格的に運用する場合には，クラスライブラリを使用してクライアントアプリケーションを開発してください。なお，オブジェクト操作ツールは，システム管理者（Administrator）の権限を持つユーザで実行してください。

1.2　オブジェクト操作ツールの機能

オブジェクト操作ツールは，クラスライブラリが提供する機能をコマンド形式で提供しています。提供するコマンドの種類と各コマンドの文法については，「5.　コマンドリファレンス」を参照してください。

なお，クラスライブラリが提供する機能のうち，次に示す機能については現在サポートしていません。

バージョン付き文書またはバージョン付き構成管理コンテナのチェックアウト状態の取得

文書間リレーション管理に関する操作

XML文書管理機能

File Link連携機能※

注※

TPBroker V5を使用する場合，Windows Server 2003 R2 x64 Edition，Windows Server 2008，Windows Server 2008 R2，Windows Server 2012，Windows XP，Windows Vista，およびWindows 7を使用する場合となります。

これらの機能についての動作確認には，クラスライブラリを使用して作成したクライアントアプリケーションを使用してください。

1.3　システム構成およびクラスライブラリとの関係

ここでは，オブジェクト操作ツールを使用する場合のシステム構成について説明します。また，オブジェクト操作ツールの対象となるオブジェクトと，クラスライブラリのクラスとの関係について説明します。

＜この節の構成＞

1.3.1　システム構成

1.3.2　クラスライブラリとの関係

1.3.1　システム構成

オブジェクト操作ツールを使用するためのシステム構成を次の図に示します。

図1-1　オブジェクト操作ツールのシステム構成

オブジェクト操作ツールは，DocumentBroker Development Kitで提供されているクラスライブラリを使用したクライアントアプリケーションです。したがって，データベースに格納されているオブジェクトを，DocumentBrokerサーバの文書空間上で操作します。

1.3.2　クラスライブラリとの関係

オブジェクト操作ツールの操作対象となるオブジェクトの種別とクラスライブラリのクラスとの関係を，表1-1に示します。

表1-1　クラスライブラリとの関係

オブジェクト種別
クラスライブラリのクラス

独立データ
CdbrIndependentPersistence

バージョンなし文書
CdbrDocument

バージョン付き文書
CdbrVersionableDocument

文書
CdbrDocument
CdbrVersionableDocument

バージョンなしコンテナ
CdbrReferentialContainer

バージョンなし構成管理コンテナ
CdbrVersionTraceableContainer

バージョン付き構成管理コンテナ
CdbrConfiguratedReferentialContainer

コンテナ
CdbrReferentialContainer
CdbrVersionTraceableContainer
CdbrConfiguratedReferentialContainer

構成管理コンテナ
CdbrVersionTraceableContainer
CdbrConfiguratedReferentialContainer

パブリックACL
CdbrPublicACL

また，表1-1に示したクラスライブラリのクラスは，オブジェクト操作ツールのオプション引数に指定する場合や，出力結果およびコマンド実行ログなどに出力される場合には，表1-2に示す記号で表されます。

表1-2　クラスライブラリのクラスを表す記号

クラスライブラリのクラス | オブジェクト操作ツールで使用する記号
CdbrIndependentPersistence | IP
CdbrDocument | D
CdbrVersionableDocument | VD
CdbrReferentialContainer | RC
CdbrVersionTraceableContainer | VTC
CdbrConfiguratedReferentialContainer | CRC
CdbrPublicACL | ACL

1.4　オブジェクト操作ツールで使用できる文字コード種別

ここでは，オブジェクト操作ツールで使用できる文字コード種別について説明します。

オブジェクト操作ツールで使用する文字コード種別は，DocumentBrokerサーバの文書空間で使用する文字コード種別に従います。そのため，オブジェクト操作ツールで文字コード種別を設定する必要はありません。

DocumentBrokerサーバの文書空間で使用できる文字コード種別は次のどちらかです。

Shift-JIS

UTF-8（使用できる文字コードの範囲はUCS-2またはUCS-4です）

DocumentBrokerサーバの文書空間で使用する文字コード種別の設定および運用方法については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

＜この節の構成＞

(1)　文書空間の文字コード種別にUTF-8を設定した場合の注意事項

(1)　文書空間の文字コード種別にUTF-8を設定した場合の注意事項

DocumentBrokerサーバの文書空間の文字コード種別にUTF-8を設定した場合の注意事項を次に示します。

オブジェクト操作ツールで使用できるコマンドに制限があります。コマンドのサポート範囲の詳細については，「付録B　文書空間で使用する文字コード種別がUTF-8の場合のサポート範囲」を参照してください。

ユーザが記述する項目で使用できる文字コード種別に，次の表に示す制限があります。

表1-3　ユーザが記述する項目で使用できる文字コード種別

ユーザが記述する項目
使用できる文字コード種別

コマンド引数に指定する値

コマンド引数に指定するファイルのファイルパス

コマンド引数に指定するファイルのファイル名

コマンド引数に指定するファイルを記述する文字

ASCIIコードだけ使用できます。

プロパティ情報ファイルに記述するプロパティ値

問い合わせファイルに記述する問い合わせ式

UTF-8およびASCIIコードを使用できます。なお，ASCIIコードだけ使用することもできます。

オブジェクト操作ツールが出力する文字コード種別は，UTF-8およびASCIIコード，またはASCIIコードだけのどちらかになります。そのため，オブジェクト操作ツールが出力したデータを参照する場合は，Shift-JISおよびUTF-8の両方に対応したエディタを使用してください。

2.　実行環境の設定

この章では，オブジェクト操作ツールを使用する場合の，実行環境の設定について説明します。

＜この章の構成＞

2.1　実行環境設定の流れ

2.2　実行環境設定の詳細

2.3　ファイル転送機能の使用

2.1　実行環境設定の流れ

オブジェクト操作ツールの実行環境を設定する順序を，次の図に示します。なお，ここでは，オブジェクト操作ツールを使用するための環境設定についてだけ説明します。DocumentBroker Development KitおよびDocumentBroker Runtimeの環境設定については，マニュアル「DocumentBroker Version 3　クラスライブラリ　C++　解説」を参照してください。

図2-1　実行環境設定の流れ

説明：

環境変数を設定します。
オブジェクト操作ツールでは，次の環境変数の設定が必要です。

AIXの場合

LANG

TZ

XDK_HOME

LIBPATH

PATH

DBRTOOLSDIR

PSALLOC

NODISCLAIM

Windowsの場合

PATH

DBRTOOLSDIR

なお，DBR_DETAIL_ERRORLOGは，必要に応じて設定してください。

実行環境のセットアップコマンド（dbrtoolsetup -x CREATEコマンド）を実行します。
このコマンドを実行すると，次のファイルがデフォルトの内容でオブジェクト操作ツールの実行環境にコピーされます。

実行環境制御ファイル

クラス定義情報ファイル

これらのファイルのデフォルトの内容に従って，実行環境が作成されます。
なお，デフォルトのファイルは，オブジェクト操作ツールが動作する最小限の内容になっています。ユーザの実行環境に合わせて，これらのファイルを手順3.以降で示す方法に従って編集してください。

実行環境制御ファイルを編集します。
手順2.でコピーされる実行環境制御ファイルの内容を，使用環境に応じて編集します。ユーザ名とパスワードは，必ず編集してください。

接続先のDocumentBrokerサーバで管理しているクラス定義情報ファイルを取得します。
手順2.でコピーされるクラス定義情報ファイルには，オブジェクト操作ツールが動作するための最小限の情報だけが記述されています。オブジェクト操作ツールを運用する場合には，接続先のDocumentBrokerサーバの情報が記述されているクラス定義情報ファイルを取得する必要があります。
DocumentBrokerサーバが提供しているクラス定義情報ファイル出力コマンド（EDMCrtSimMetaコマンド）によって出力したクラス定義情報ファイルを，オブジェクト操作ツールの実行環境にコピーしてください。EDMCrtSimMetaコマンドについては，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

実行環境のセットアップコマンド（dbrtoolsetup -x UPDATEコマンド）を実行します。
手順3.および手順4.で編集および取得した実行環境制御ファイルおよびクラス定義情報ファイルの内容で，実行環境を更新します。手順3.または手順4.でファイルを編集した場合は，必ず実行してください。

なお，DocumentBroker Development KitまたはDocumentBroker Runtimeをバージョンアップした場合は，手順5.の実行環境のセットアップコマンドを実行して，実行環境を更新してください。

2.2　実行環境設定の詳細

ここでは，オブジェクト操作ツールを使用するために必要な環境設定の詳細について説明します。

＜この節の構成＞

2.2.1　実行ユーザについて

2.2.2　環境変数の設定

2.2.3　実行環境のセットアップ

2.2.4　実行環境制御ファイルの編集

2.2.5　クラス定義情報ファイルの取得

2.2.6　実行環境の更新

2.2.1　実行ユーザについて

オブジェクト操作ツールでは，コマンドを実行するマシンのOSユーザではなく，オブジェクト操作ツールの実行環境を定義するために使用する「実行環境制御ファイル」に記載されているユーザでセッションを確立（ログイン）します。ただし，実行環境制御ファイルに記述する接続ユーザが，DocumentBrokerサーバで使用しているユーザ管理機能に登録されていない場合は，文書空間に接続するときにエラーが発生します。ユーザ管理機能とは，LDAP対応のディレクトリサービスやUNIXのパスワードファイルと連携して，DocumentBrokerを使用するユーザのユーザ情報を管理する機能です。詳細については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

実行環境制御ファイルについては，「3.2　実行環境制御ファイル」を参照してください。

2.2.2　環境変数の設定

オブジェクト操作ツールを使用するためには，環境変数の設定が必要です。

なお，設定する環境変数は，OSごとに異なります。

＜この項の構成＞

(1)　環境変数の設定（AIXの場合）

(2)　環境変数の設定（Windowsの場合）

(1)　環境変数の設定（AIXの場合）

環境変数は，各マシンのログインシェル環境に合わせて次のファイルに設定してください。なお，「$HOME」は，ログインユーザのホームディレクトリを示します。

Bourneシェル環境のとき

$HOME/.profile

Cシェル環境のとき

$HOME/.cshrcまたは$HOME/.login

(a)　LANGの設定

環境変数「LANG」には，使用する文字コードセットを設定します。DocumentBrokerの文書空間で使用する文字コード種別に合わせて値を設定してください。

文書空間で使用する文字コード種別がShift-JISの場合

設定する値は「Ja_JP」です。

文書空間で使用する文字コード種別がUTF-8の場合

使用する言語に合わせて適切な値を設定してください。

ただし，次のときは「C」を設定してください。

文書空間で使用する文字コード種別に関係なく，ASCIIコードのデータだけを扱う英語環境の場合

一つのアプリケーションから文字コード種別の異なる複数の文書空間に接続する場合に，接続先に文字コード種別がUTF-8の文書空間が含まれるとき

なお，この環境変数に設定する値によって，メッセージの言語種別が変わります。「Ja_JP」を設定した場合は，日本語のメッセージが出力されます。「Ja_JP」以外を設定した場合は，英語のメッセージが出力されます。

(b)　TZの設定

環境変数「TZ」には，マシン時間のタイムゾーンを設定します。設定する値は「JST-9」です。

(c)　XDK_HOMEの設定

環境変数「XDK_HOME」には，SystemManagerオブジェクトのレジストリファイルの格納場所を設定します。設定する値は，「/opt/HiEDMS/client/etc」です。

(d)　LIBPATHの設定

関連プログラムのライブラリおよびDocumentBrokerのクライアントライブラリのインストールディレクトリを設定します。次の値を追加してください。

関連プログラムのライブラリのインストールディレクトリ

TPBroker V3を使用する場合

:/opt/hitachi/common/lib
:/usr/vacpp/lib※
:/opt/TPBroker/lib

TPBroker V5を使用する場合

:/opt/hitachi/common/lib
:/usr/vacpp/lib※
:TPBroker V5インストールディレクトリ/lib

注※　VisualAge C++ Professional for AIX，またはIBM XL C/C++ Enterprise Edition for AIXのライブラリの格納ディレクトリを設定します。これは，デフォルトのインストールディレクトリにインストールされている場合の値です。

DocumentBrokerのクライアントライブラリのインストールディレクトリ

TPBroker V3を使用する場合

:/opt/HiEDMS/client/lib
:/opt/HiEDMS/ACLibrary/lib

TPBroker V5を使用する場合

:/opt/HiEDMS/client/lib_tp5
:/opt/HiEDMS/ACLibrary/lib_tp5

(e)　PATHの設定

環境変数「PATH」には，オブジェクト操作ツールのインストールディレクトリを追加します。オブジェクト操作ツールは，「/opt/HiEDMS/client/tools」および「/opt/HiEDMS/client/tools_tp5」ディレクトリにインストールされます。したがって，追加する値は，TPBroker V3を使用する場合は，「:/opt/HiEDMS/client/tools」，TPBroker V5を使用する場合は，「:/opt/HiEDMS/client/tools_tp5」です。

(f)　DBRTOOLSDIRの設定

環境変数「DBRTOOLSDIR」には，オブジェクト操作ツールの実行環境ディレクトリを設定してください。

(g)　DBR_DETAIL_ERRORLOGの設定（詳細メッセージを標準エラー出力に出力する場合）

環境変数「DBR_DETAIL_ERRORLOG」は，詳細メッセージを取得する場合に設定します。詳細メッセージを取得する場合に設定する値は「ON」です。

環境変数「DBR_DETAIL_ERRORLOG」に「ON」が設定されている場合，オブジェクト操作ツール実行時の詳細メッセージが標準エラー出力および詳細エラーログファイルに出力されます。

出力される詳細メッセージは，オブジェクト操作ツールのコマンドが使用している，クラスライブラリのメソッドに関する詳細メッセージです。

この環境変数を省略した場合または値に「ON」以外を設定した場合は，詳細メッセージは標準エラー出力および詳細エラーログファイルのどちらにも出力されません。

出力される詳細メッセージの内容については，マニュアル「DocumentBroker Version 3　メッセージ」を参照してください。

(h)　PSALLOCの設定

環境変数「PSALLOC」には，メモリ領域の確保をメモリ使用時でなく，メモリ領域要求時に行う，早期ページスペース割り当てを実行するための設定をします。設定する値は「early」です。

(i)　NODISCLAIMの設定

環境変数「NODISCLAIM」には，メモリ領域の解放を抑止するための設定をします。設定する値は「true」です。

(j)　注意事項

環境変数「EDMCLASSDEFPATH」が設定されている環境でオブジェクト操作ツールを使用する場合，オブジェクト操作ツールの実行時には，オブジェクト操作ツール実行環境ディレクトリ下に存在するクラス定義情報ファイルではなく，環境変数「EDMCLASSDEFPATH」に設定されたディレクトリに存在するクラス定義情報ファイルが参照されます。

なお，文書空間で使用する文字コード種別がUTF-8の場合，環境変数「EDMCLASSDEFPATH」には，印刷可能なASCIIコードで値を設定してください。

ただし，この場合も，文書空間識別子は，オブジェクト操作ツール実行環境ディレクトリ下の実行環境制御ファイルに記述されているものが使用されます。

(2)　環境変数の設定（Windowsの場合）

環境変数を設定します。

全ユーザで共通の値にする場合は，「システム環境変数」に設定してください。ログインユーザごとに設定する場合は，「ユーザ環境変数」に設定してください。

環境変数は［コントロールパネル］の［システム］の［環境変数］ボタンをクリックして表示される［環境変数］ダイアログで設定します。なお，詳細については，各OSのヘルプで確認してください。

(a)　PATHの設定

環境変数「PATH」には，オブジェクト操作ツールのインストールディレクトリを追加します。オブジェクト操作ツールは，「<インストールディレクトリ>¥tools」ディレクトリにインストールされます。したがって，インストールディレクトリが「C:¥Program Files¥HITACHI¥DocBroker¥Client」の場合，追加する値は，「;C:¥Program Files¥HITACHI¥DocBroker¥Client¥tools」です。

(b)　DBRTOOLSDIRの設定

環境変数「DBRTOOLSDIR」には，オブジェクト操作ツールの実行環境ディレクトリを設定してください。

文書空間で使用する文字コード種別がUTF-8の場合，印刷可能なASCIIコードで値を設定してください。

(c)　DBR_DETAIL_ERRORLOGの設定（詳細メッセージを標準エラー出力に出力する場合）

環境変数「DBR_DETAIL_ERRORLOG」は，詳細メッセージを取得する場合に設定します。詳細メッセージを取得する場合に設定する値は「ON」です。

環境変数「DBR_DETAIL_ERRORLOG」に「ON」が設定されている場合，オブジェクト操作ツール実行時の詳細メッセージが標準エラー出力および詳細エラーログファイルに出力されます。

出力される詳細メッセージは，オブジェクト操作ツールのコマンドが使用している，クラスライブラリのメソッドに関する詳細メッセージです。

この環境変数を省略した場合または値に「ON」以外を設定した場合は，詳細メッセージは標準エラー出力および詳細エラーログファイルのどちらにも出力されません。

出力される詳細メッセージの内容については，マニュアル「DocumentBroker Version 3　メッセージ」を参照してください。

(d)　注意事項

環境変数「EDMCLASSDEFPATH」が設定されている環境でオブジェクト操作ツールを使用する場合，オブジェクト操作ツールの実行時には，オブジェクト操作ツール実行環境ディレクトリ下に存在するクラス定義情報ファイルではなく，環境変数「EDMCLASSDEFPATH」に設定されたディレクトリに存在するクラス定義情報ファイルが参照されます。

なお，文書空間で使用する文字コード種別がUTF-8の場合，環境変数「EDMCLASSDEFPATH」には，印刷可能なASCIIコードで値を設定してください。

ただし，この場合も，文書空間識別子は，オブジェクト操作ツール実行環境ディレクトリ下の実行環境制御ファイルに記述されているものが使用されます。

2.2.3　実行環境のセットアップ

オブジェクト操作ツールが提供している実行環境セットアップコマンド「dbrtoolsetup」を実行します。形式は次のとおりです。

dbrtoolsetup　-x CREATE　実行環境ディレクトリ

実行環境ディレクトリは，環境変数「DBRTOOLSDIR」に設定したディレクトリを指定します。なお，dbrtoolsetupの詳細については，「5.　コマンドリファレンス」の「dbrtoolsetup（実行環境のセットアップ）」を参照してください。

2.2.4　実行環境制御ファイルの編集

実行環境制御ファイルは，オブジェクト操作ツールの実行環境を定義するファイルです。実行環境セットアップコマンドを実行すると，UNIXの場合は「実行環境ディレクトリ/etc」に，Windowsの場合は「実行環境ディレクトリ¥etc」に，サンプルファイルがコピーされます。オブジェクト操作ツールの実行環境に合わせて，このサンプルファイルを編集してください。なお，実行環境制御ファイルの詳細については，「3.2　実行環境制御ファイル」を参照してください。

2.2.5　クラス定義情報ファイルの取得

クラス定義情報ファイルは，DocumentBrokerで定義されているDMAオブジェクトのクラスもしくはそのサブクラスのクラス名，またはプロパティ名からGUID，データ型，基本単位などの情報を取得するために使用します。

実行環境セットアップコマンドを実行した時に，UNIXの場合は「実行環境ディレクトリ/etc」に，Windowsの場合は「実行環境ディレクトリ¥etc」にコピーされるクラス定義情報ファイルには，オブジェクト操作ツールが動作するための最低限の情報だけが記述されています。このため，オブジェクト操作ツールを運用する場合には，接続先のDocumentBrokerサーバの情報が記述されているクラス定義情報ファイルを取得する必要があります。

クラス定義情報ファイルは，DocumentBrokerサーバが提供しているクラス定義情報ファイル出力コマンド（EDMCrtSimMetaコマンド）によって取得してください。このコマンドで取得したクラス定義情報ファイルを，UNIXの場合は「実行環境ディレクトリ/etc」に，Windowsの場合は「実行環境ディレクトリ¥etc」にコピーしてください。

クラス定義情報ファイルの詳細については，「3.3　クラス定義情報ファイル」を参照してください。

2.2.6　実行環境の更新

実行環境制御ファイルおよびクラス定義情報ファイルを編集した場合は，実行環境セットアップコマンドを再実行して，オブジェクト操作ツールの実行環境を更新します。

また，DocumentBroker Development KitまたはDocumentBroker Runtimeをバージョンアップした場合も，必ずセットアップコマンドを再実行して，オブジェクト操作ツールの実行環境を更新してください。

形式は次のとおりです。

dbrtoolsetup　-x UPDATE　実行環境ディレクトリ

実行環境ディレクトリは，環境変数「DBRTOOLSDIR」に設定したディレクトリを指定します。なお，dbrtoolsetupの詳細については，「5.　コマンドリファレンス」の「dbrtoolsetup（実行環境のセットアップ）」を参照してください。

2.3　ファイル転送機能の使用

オブジェクト操作ツールを実行するマシンと異なるマシンに構築されたDocumentBrokerサーバに接続する場合は，ファイル転送機能を使用してください。ファイル転送機能については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

3.　オブジェクト操作ツールで使用するファイル

この章では，オブジェクト操作ツールで使用するファイルについて説明します。

＜この章の構成＞

3.1　オブジェクト操作ツールで使用するファイル一覧

3.2　実行環境制御ファイル

3.3　クラス定義情報ファイル

3.4　IDファイル

3.5　プロパティ情報ファイル

3.6　問い合わせファイル

3.7　アップロード情報ファイル

3.8　リファレンス情報ファイル

3.1　オブジェクト操作ツールで使用するファイル一覧

オブジェクト操作ツールで使用するファイルの一覧を次の表に示します。

表3-1　オブジェクト操作ツールで使用するファイル一覧

名称
説明
作成場所

実行環境制御ファイル
オブジェクト操作ツールの実行環境を定義する

UNIXの場合

実行環境ディレクトリ/etc

Windowsの場合

実行環境ディレクトリ¥etc

クラス定義情報ファイル※
オブジェクト操作ツールで使用するクラスおよびプロパティに関する情報を定義する

UNIXの場合

実行環境ディレクトリ/etc

Windowsの場合

実行環境ディレクトリ¥etc

IDファイル
複数のオブジェクトを一括で操作する場合に，操作対象となるオブジェクトのIDまたは識別子を記述する
任意

プロパティ情報ファイル
操作するオブジェクトのプロパティ情報を記述する
任意

問い合わせファイル
オブジェクトの検索に使用する問い合わせ式を記述する
任意

アップロード情報ファイル
アップロードするマルチファイル文書の情報を記述する
任意

リファレンス情報ファイル
操作するリファレンスファイル文書の情報を記述する
任意

注※

環境変数「EDMCLASSDEFPATH」が設定されている環境では，環境変数「EDMCLASSDEFPATH」に設定されているディレクトリに存在するクラス定義情報ファイルが使用されます。

3.2　実行環境制御ファイル

実行環境制御ファイルは，オブジェクト操作ツールの実行環境を定義するファイルです。-x CREATEオプションを指定して実行環境セットアップコマンド「dbrtoolsetup」を実行すると，UNIXの場合は「実行環境ディレクトリ/etc」に，Windowsの場合は「実行環境ディレクトリ¥etc」に，サンプルファイルがコピーされます。オブジェクト操作ツールの実行環境に合わせて，編集して使用してください。

＜この節の構成＞

3.2.1　記述規則

3.2.2　記述形式

3.2.3　実行環境制御ファイルの記述例

3.2.1　記述規則

実行環境制御ファイルの記述規則は次のとおりです。

ファイル名は「EDMOotCtrl.ini」で固定です。

印刷可能なASCIIコードで記述してください。

セミコロン（;）およびシャープ（#）で始まる行はコメント行として扱います。

空白行は無視します。

行の終端は改行コードまたはEOFです。

改行コードは，UNIXの場合，NL（0x0a）です。Windowsの場合，CR+NL（0x0d + 0x0a）です。

ファイルの終端はEOFです。

3.2.2　記述形式

実行環境制御ファイルは，五つのセクションと各セクションに指定するエントリによって構成されます。

セクションとエントリは，次のように記述します。

セクション名は，角括弧（［　］）で囲んで指定します。一つのセクションは，セクション名を指定してから，次のセクション名を指定するまで，またはファイルの終端までの範囲です。

エントリは，「エントリ名=指定値」の形式で指定します。

記述形式は次のとおりです。

[<セクション名>]
〔<エントリ名>=<値>※〕

注※

エントリの値は，その値が数値か文字列かによって記述方法が異なります。

数値の場合
任意の10進数を-2,147,483,648～2,147,483,647の間で記述します。

文字列の場合
指定できる文字列が限られている場合は，そのうちのどれかの文字列を記述します。任意の文字列を指定する場合は，1,039バイト以内の文字列をシングルクォート（'）で囲んで記述します。

各セクションとセクションごとに指定するエントリについて説明します。

なお，各セクション内でエントリが重複して記述されている場合は，最初に指定されたエントリが有効となります。

＜この項の構成＞

(1)　Sessionセクション

(2)　Logセクション

(3)　Outputセクション

(4)　FileLinkセクション

(5)　Referenceセクション

(1)　Sessionセクション

このセクションには，DocumentBrokerサーバの文書空間に接続するための情報を記述します。セクションを構成するエントリについて，次に説明します。なお，このセクションおよび各エントリの記述は省略できません。省略した場合は，オブジェクト操作ツールの実行時にエラーとなります。

DocSpaceIdエントリ

接続先のDocumentBrokerサーバの文書空間IDをシングルクォート（'）で囲んで記述します。

＜記述例＞

DocSpaceId = '673d2be0-d1fd-11d0-ab59-08002be29e1d'

UserNameエントリ

オブジェクト操作ツールの実行ユーザとして，接続先のDocumentBrokerサーバに登録されているユーザ名をシングルクォート（'）で囲んで記述します。なお，DocumentBrokerサーバで使用しているユーザ管理機能に登録されていないユーザ名を指定した場合は，文書空間に接続するときにエラーが発生します。ユーザ管理機能の詳細については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

＜記述例＞

UserName = 'user01'

Passwordエントリ

UserNameエントリに指定したユーザが，接続先のDocumentBrokerサーバにログインするために使用するパスワードをシングルクォート（'）で囲んで記述します。

＜記述例＞

Password = 'password01'

(2)　Logセクション

このセクションには，オブジェクト操作ツールを実行するときに出力されるコマンド実行ログを制御する情報を記述します。セクションを構成するエントリについて，次に説明します。なお，このセクションを省略した場合，各エントリの値はデフォルト値が仮定されます。

Levelエントリ

コマンド実行ログの出力レベルを指定します。出力レベルには，「None」，「Write」，「Read」または「Error」を記述します。デフォルトは「None」です。省略した場合は，デフォルト値が仮定されます。不正な値が指定されている場合は，オブジェクト操作ツールの実行時にエラーとなります。

指定する値についての詳細は，「4.1.2　出力レベル」を参照してください。

＜記述例＞

Level = Read

FileCountエントリ

コマンド実行ログを出力するファイルサイズの上限を超えた場合に，切り替えるファイルの数を，2～16の間で記述します。デフォルトは2です。省略した場合は，デフォルト値が仮定されます。このエントリで指定できる範囲外の値が指定されている場合は，デフォルト値が仮定されます。なお，数値として指定できる範囲外の値が指定されている場合は，オブジェクト操作ツールの実行時にエラーとなります。

＜記述例＞

FileCount = 4

FileSizeエントリ

コマンド実行ログを出力するファイルサイズを4,096～2,147,483,647（単位はバイト）の間で記述します。デフォルトは1,048,576です。省略した場合は，デフォルト値が仮定されます。このエントリで指定できる範囲外の値が指定されている場合は，デフォルト値が仮定されます。なお，数値として指定できる範囲外の値が指定されている場合は，オブジェクト操作ツールの実行時にエラーとなります。

＜記述例＞

FileSize = 8192

Directoryエントリ

コマンド実行ログの出力先ディレクトリを，シングルクォート（'）で囲んで記述します。デフォルトは，UNIXの場合は「実行環境ディレクトリ/spool/aclog」，Windowsの場合は「実行環境ディレクトリ¥spool¥aclog」です。省略した場合は，デフォルト値が仮定されます。不正な値が指定されている場合は，オブジェクト操作ツールの実行時にエラーとなります。

＜記述例＞

Directory = 'c:¥home¥user01¥aclog'

Prefixエントリ

コマンド実行ログを出力するファイル名として使用するプリフィックスを，シングルクォート（'）で囲んで記述します。デフォルトは「EDMOotAccess」です。省略した場合は，デフォルト値が仮定されます。不正な値が指定されている場合は，オブジェクト操作ツールの実行時にエラーとなります。

＜記述例＞

Prefix= 'Tool'

(3)　Outputセクション

このセクションには，コマンドの実行結果の出力を制御するための情報を記述します。セクションを構成するエントリについて，次に説明します。なお，このセクションを省略した場合，各エントリの値はデフォルト値が仮定されます。

LineSizeエントリ

コマンドの実行結果を出力するときに，1行当たりの出力サイズを記述します。1,022～2,147,483,645（単位はバイト）で記述します。デフォルトは8,190です。省略した場合は，デフォルト値が仮定されます。このエントリで指定できる範囲外の値が指定されている場合は，デフォルト値が仮定されます。なお，数値として指定できる範囲外の値が指定されている場合は，オブジェクト操作ツールの実行時にエラーとなります。

＜記述例＞

LineSize = 1048576

Formatエントリ

一覧取得コマンドの出力形式を選択します。「VR0200」または「VR0112」を指定します。「VR0200」を指定すると，一覧取得コマンドの出力情報として，リンク識別子なども出力されます。「VR0112」を指定すると，Version 1の出力形式と同じ形式で出力します。この場合，リンク識別子は出力されません。デフォルトは，「VR0200」です。

指定する値についての詳細は，「5.　コマンドリファレンス」の「コマンド実行結果」および各コマンドの実行例を参照してください。

＜記述例＞

Format = VR0200

(4)　FileLinkセクション

このセクションには，File Link連携機能を使用する場合の情報を記述します。

セクションを構成するエントリについて，次に説明します。なお，このセクションを省略した場合，各エントリの値はデフォルト値が仮定されます。

DefaultFAMNameエントリ

コンテントの登録先となるファイルサーバのFAM名を，シングルクォート（'）で囲んで記述します。

このエントリの指定は次の場合に有効になります。

プロパティ情報ファイルのfilelink_famnameエントリの指定を省略して，dbrcrtdocコマンド（文書の作成）を実行した場合

-jオプションを省略して，dbrrndrdocコマンド（文書のレンディション操作），またはdbrupdocコマンド（文書のアップロード）を実行した場合

なお，ファイルサーバのFAM名の詳細については，マニュアル「HiRDB File Link」を参照してください。

＜記述例＞

DefaultFAMName = 'fam01'

DefaultContentPathエントリ

コンテントの登録先となるファイルサーバ上のディレクトリのパスを，シングルクォート（'）で囲んで記述します。ディレクトリのパスの末尾にはデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述します。

このエントリの指定は次の場合に有効になります。

プロパティ情報ファイルのfilelink_contentpathエントリの指定を省略して，dbrcrtdocコマンド（文書の作成）を実行した場合

-gオプションを省略して，dbrrndrdocコマンド（文書のレンディション操作），またはdbrupdocコマンド（文書のアップロード）を実行した場合

エントリに指定したディレクトリが存在しない場合，ディレクトリが作成され，コンテントが登録されます。ただし，ディレクトリのパスの末尾にデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述しない場合，コンテント名称の自動生成を行わない（FileNamingModeエントリに「Specify」を指定している）環境で，このエントリに指定したディレクトリがファイルサーバ上に存在するとエラーになり，存在しないとこのエントリに指定した名称でコンテントが登録されます。

なお，コンテントの登録先ディレクトリの詳細については，マニュアル「HiRDB File Link」を参照してください。

＜記述例＞

UNIXの場合に，コンテントの登録先ディレクトリが，「/dir01/data」の下位にある「area1」ディレクトリのときの記述例を次に示します。

指定形式の種別
指定例

フルパス指定
DefaultContentPath = '/dir01/data/area1/'

エイリアス指定
DefaultContentPath = 'DATA/area1/'
（「/dir01/data」のエイリアス名が「DATA」のとき）

Windowsの場合に，コンテントの登録先ディレクトリが，「c:¥dir01¥data」の下位にある「area1」ディレクトリのときの記述例を次に示します。

指定形式の種別
指定例

フルパス指定
DefaultContentPath = 'c:¥dir01¥data¥area1¥'

エイリアス指定
DefaultContentPath = 'DATA¥area1¥'
（「c:¥dir01¥data」のエイリアス名が「DATA」のとき）

FileNamingModeエントリ

ファイルサーバに登録されるコンテントの名称付与モードを指定します。名称付与モードには，「Auto」または「Specify」を指定します。

「Auto」を指定した場合，HiRDB File Linkのコンテントの名称を自動生成する機能を使用して，登録するコンテントの名称を自動生成します。

「Specify」を指定した場合，プロパティ情報ファイルのurlエントリに指定されたファイルパスのファイル名が，ファイルサーバに登録されるコンテントの名称となります。

デフォルトは「Specify」です。省略した場合は，デフォルト値が仮定されます。なお，HiRDB File Linkのコンテントの名称を自動生成する機能の詳細については，マニュアル「HiRDB File Link」を参照してください。

＜記述例＞

FileNamingMode = Specify

ClientContentDeleteModeエントリ

クライアントのコンテントを指定して，文書を作成もしくはアップロードする場合，またはレンディションを追加する場合に設定される，文書，文書のバージョン，または文書のレンディションを削除したときの，ファイルサーバ上のコンテントの削除モードを指定します。コンテントの削除モードには，「Sync」または「Async」を指定します。

「Sync」を 指定した場合，文書，文書のバージョン，またはレンディションの削除と同期してファイルサーバ上のコンテントを削除します。

「Async」を指定した場合，文書，文書のバージョン，またはレンディションを削除してもファイルサーバ上のコンテントは削除されません。

デフォルトは「Sync」です。省略した場合は，デフォルト値が仮定されます。

コンテントの削除モードは，文書を作成またはアップロードした時点，もしくはレンディションを追加した時点の設定が有効になります。文書，文書のバージョン，またはレンディションを削除する時に設定を変更しても有効になりません。

＜記述例＞

ClientContentDeleteMode = Sync

ServerContentDeleteModeエントリ

ファイルサーバ上に登録されているコンテントを指定して，文書を作成もしくはアップロードする場合，またはレンディションを追加する場合に設定される，文書，文書のバージョン，またはレンディションを削除したときの，ファイルサーバ上のコンテントの削除モードを指定します。コンテントの削除モードには，「Sync」または「Async」を指定します。

「Sync」を指定した場合，文書，文書のバージョン，またはレンディションの削除と同期してファイルサーバ上のコンテントを削除します。

「Async」を指定した場合，文書，文書のバージョン，またはレンディションを削除してもファイルサーバ上のコンテントは削除されません。

デフォルトは「Async」です。省略した場合は， デフォルト値が仮定されます。

コンテントの削除モードは，文書を作成またはアップロードした時点，もしくはレンディションを追加した時点の設定が有効になります。文書，文書のバージョン，またはレンディションを削除する時に設定を変更しても有効になりません。

なお，コンテントを多重登録する場合（すでにFile Link連携機能を使用してファイルサーバ上に登録されたコンテントを指定して文書を作成もしくはアップロードする場合，またはレンディションを追加する場合）は，このエントリの設定を，前回コンテントを使用した時と同じ設定にする必要があります。

＜記述例＞

ServerContentDeleteMode = Async

(5)　Referenceセクション

このセクションには，リファレンスファイル管理機能を使用する場合の情報を記述します。セクションを構成するエントリについて，次に説明します。

DefaultReferenceTypeエントリ

デフォルトの，コンテントの格納先とリファレンス種別を指定します。リファレンス種別には「Relative」を指定してください。

このエントリの指定は次の場合に有効になります。

プロパティ情報ファイルのreference_typeエントリの指定を省略して，dbrcrtdocコマンド（文書の作成）を実行した場合

-aオプションを省略して，dbrdelcntrコマンド（コンテナの削除），dbrdeldocコマンド（文書の削除），dbrdowndocコマンド（文書のダウンロード），またはdbrupdocコマンド（文書のアップロード）を実行した場合

「Relative」を指定した場合，コンテントの格納先をファイルシステム上の領域とし，コンテントロケーションを相対パスで管理します。

＜記述例＞

DefaultReferenceType = Relative

DefaultContentBasePathエントリ

リファレンスファイル文書のリファレンス種別が「Relative」の場合，デフォルトのコンテント格納先ベースパスをシングルクォート（'）で囲んで記述します。

このエントリの指定は次の場合に有効になります。

プロパティ情報ファイルのreference_contentbasepathエントリの指定を省略して，dbrcrtdocコマンド（文書の作成）を実行した場合

リファレンス情報ファイルのreference_contentbasepathエントリの指定を省略して，dbrdelcntrコマンド（コンテナの削除）を実行した場合

-bオプションを省略して，dbrdelcntrコマンド（コンテナの削除），dbrdeldocコマンド（文書の削除），dbrdowndocコマンド（文書のダウンロード），またはdbrupdocコマンド（文書のアップロード）を実行した場合

このエントリには，リファレンスファイル文書の格納先となるディレクトリの基点となるパスを指定します。例えば，コンテントを「/drv01/dir01/userdir」ディレクトリの下位にある「user01」ディレクトリに格納する場合，「user01」ディレクトリの基点となるパスとして，「/drv01/dir01/userdir」をシングルクォート（'）で囲んで指定します。このエントリの指定の末尾に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。

このエントリに指定したコンテント格納先ベースパスは，コンテント格納先パスと結合して絶対パスとして使用されます。ContentLocationプロパティには次に示すパスが格納されます。

aaaa/bbbb/cccc

aaaa：コンテント格納先パス

bbbb：DocumentBrokerがコンテントを管理するためのディレクトリ

cccc：ファイル名※

注※

次に示すどちらかのファイル名が設定されます。

登録ファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにOriginを指定した場合）

DocumentBrokerが指定するファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにDivideを指定した場合）

Windowsの場合，デフォルトのコンテント格納先ベースパスにUNC形式のパスを使用することもできます。例えば，「server01」というマシンのネットワーク上で共有しているフォルダ「share」をコンテント格納先ベースパスに指定する場合は，「¥¥server01¥share」をシングルクォート（'）で囲んで指定します。

＜記述例＞

DefaultContentBasePath = '/drv01/dir01/userdir'

DefaultDeleteRootPathエントリ

リファレンスファイル文書と，リファレンスファイル文書が格納されているディレクトリを同時に削除する場合，デフォルトの削除ディレクトリのルートパスをシングルクォート（'）で囲んで記述します。

このエントリの指定は次の場合に有効になります。

リファレンス情報ファイルのreference_deleterootpathエントリの指定を省略して，dbrdelcntrコマンド（コンテナの削除）を実行した場合

-yオプションを省略して，dbrdelcntrコマンド（コンテナの削除）またはdbrdeldocコマンド（文書の削除）を実行した場合

このエントリには，削除するディレクトリのルートパスを指定します。例えば，「/drv01/dir01/userdir/user01/<DocumentBrokerがコンテントを管理するためのディレクトリ>/<登録ファイル名>」のディレクトリ中の「user01」ディレクトリ以下のディレクトリを削除する場合は，「user01」ディレクトリのルートパスとして，「/drv01/dir01/userdir」をシングルクォート（'）で囲んで指定します。ただし，コンテント格納先べースパスの上位のディレクトリは指定できません。また，エントリの指定の末尾に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。

DocumentBrokerがコンテントを管理するためのディレクトリは，このエントリまたはコマンドオプションで削除ディレクトリのルートパスの指定を省略した場合も，コンテントと同時に削除されます。

Windowsの場合，デフォルトの削除ディレクトリのルートパスにUNC形式のパスを使用することもできます。例えば，「server01」というマシンがネットワーク上で共有しているフォルダ「share」を削除ディレクトリのルートパスに指定する場合は，「¥¥server01¥share」をシングルクォート（'）で囲んで指定します。

＜記述例＞

DefaultDeleteRootPath = '/drv01/dir01/userdir'

ContentDeleteModeエントリ

リファレンスファイル文書を削除する場合の削除モードを指定します。削除モードには，「Auto」または「Specify」を指定します。デフォルト値は「Specify」です。

「Auto」を指定した場合，DocumentBrokerが自動的にリファレンスファイル文書かどうかを判別して，リファレンスファイル文書を削除します。

「Specify」を指定した場合，dbrdelcntrコマンド（コンテナの削除）またはdbrdeldocコマンド（文書の削除）の，-kオプションの指定に従って文書を削除します。このとき，-kオプションを省略すると，エラーになります。ContentDeleteModeエントリの指定とdbrdelcntrコマンド（コンテナの削除）およびdbrdeldocコマンド（文書の削除）の実行結果の対応を次の表に示します。

表3-2　ContentDeleteModeエントリの指定とdbrdelcntrコマンド，dbrdeldocコマンドの実行結果

削除する文書の種類 | ContentDeleteModeエントリの指定 | -kオプションの指定 | 実行結果
リファレンスファイル文書 | Auto | Reference | ○
－ | ○
Specify | Reference | ○
－ | ×
リファレンスファイル文書以外 | Auto | Reference | ○
－ | ○
Specify | Reference | ○
－ | ○

（凡例）

－：指定しません。

○：削除されます。

×：エラーになるため，削除されません。

＜記述例＞

ContentDeleteMode = Auto

3.2.3　実行環境制御ファイルの記述例

-x CREATEオプションを指定して実行環境セットアップコマンドを実行した場合にコピーされる実行環境制御ファイルは次のとおりです。

;; Session
[Session]
DocSpaceId = '673d2be0-d1fd-11d0-ab59-08002be29e1d'
UserName = 'user'
Password = 'passwd'

これは，オブジェクト操作ツールが動作する最小限の内容です。

このファイルを，それぞれのオブジェクト操作ツールの実行環境に合わせて編集します。「UserName」と「Password」は必ず編集してください。

Windowsの場合の記述例を次に示します。UNIXの場合は，[FileLink]セクションのDirectoryエントリを，「'/home/user01/aclog'」のように指定し，DefaultContentPathエントリを「'/dir01/data/area1/'」のように指定してください。また，[Reference]セクションのDefaultContentBasePathエントリを「'/drv01/dir01/userdir'」のように指定し，DefaultDeleteRootPathエントリを「'/drv01/dir01/userdir'」のように指定してください。

＜記述例＞

;; Session
[Session]
DocSpaceId = '673d2be0-d1fd-11d0-ab59-08002be29e1d'
UserName = 'user01'
Password = 'passwd01'

;; Log
[Log]
Level = Read
FileCount = 4
FileSize = 8192
Directory = 'c:¥home¥user01¥aclog'
Prefix = 'Tool'

;; Output
[Output]
LineSize = 1048576
Format = VR0200

;; FileLink
[FileLink]
DefaultFAMName = 'fam01'
DefaultContentPath = 'c:¥dir01¥data¥area1¥'

;; Reference
[Reference]
DefaultReferenceType = Relative
DefaultContentBasePath = 'c:¥dir01¥userdir'
DefaultDeleteRootPath = 'c:¥dir01¥userdir'
ContentDeleteMode = Auto

3.3　クラス定義情報ファイル

クラス定義情報ファイルは，DocumentBrokerサーバで定義されているDMAオブジェクトのクラスもしくはそのサブクラスのクラス名，またはプロパティ名からGUID，データ型，基本単位などの情報を取得するために使用するファイルです。したがって，オブジェクト操作ツールで使用するクラス定義情報ファイルの内容は，接続するDocumentBrokerサーバで実際に定義されている情報と一致している必要があります。

-x CREATEオプションを指定して実行環境セットアップコマンドを実行した時に，UNIXの場合は「実行環境ディレクトリ/etc」に，Windowsの場合は「実行環境ディレクトリ¥etc」にコピーされたサンプルファイルには，オブジェクト操作ツールが動作するための最小限の情報だけが記述されています。このため，オブジェクト操作ツールを運用する時には，DocumentBrokerサーバが提供しているクラス定義情報ファイル出力コマンド「EDMCrtSimMeta」を実行して，接続先のDocumentBrokerサーバの情報が記述されているクラス定義情報ファイルを取得してください。取得したクラス定義情報ファイルを，UNIXの場合は「実行環境ディレクトリ/etc」に，Windowsの場合は「実行環境ディレクトリ¥etc」にコピーして，再度実行環境セットアップコマンドを実行して，実行環境を更新してください。

クラス定義情報ファイル出力コマンドの文法については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

注意

環境変数「EDMCLASSDEFPATH」が設定されている環境では，実行環境ディレクトリ/etcまたは実行環境ディレクトリ¥etcのクラス定義情報ファイルではなく，環境変数「EDMCLASSDEFPATH」に設定されているディレクトリに存在するクラス定義情報ファイルが使用されます。

＜この節の構成＞

3.3.1　ファイル名の規則

3.3.2　記述規則

3.3.3　記述形式

3.3.4　クラス定義情報ファイルの記述例

3.3.1　ファイル名の規則

クラス定義情報ファイル名は，実行環境制御ファイルのDocSpaceIdエントリに指定した接続文書空間IDにサフィックス「.ini」を付与した名前にしてください。ファイル名のプリフィックスとして使用するGUIDは，実行環境制御ファイルのDocSpaceIdエントリに指定した接続先文書空間IDと一致するようにしてください。

3.3.2　記述規則

クラス定義情報ファイルの記述規則は次のとおりです。

印刷可能なASCIIコードで記述してください。

セミコロン（;）で始まる行はコメント行として扱われます。なお，シャープ（#）で始まる行はコメント行として扱われません。

空白行は無視します。

行の終端は改行コードまたはEOFです。

改行コードは，UNIXの場合，NL（0x0a）です。Windowsの場合，CR + NL（0x0d + 0x0a）です。

ファイルの終端はEOFです。

3.3.3　記述形式

クラス定義情報ファイルは，クラスの定義情報を記述するセクションとプロパティの定義情報を記述するセクションで構成されます。

セクションとエントリは，次のように記述します。

セクション名は，角括弧（［　］）で囲んで指定します。一つのセクションは，セクション名を指定してから，次のセクション名を指定するまで，またはファイルの終端までの範囲です。

エントリは，「エントリ名=指定値」の形式で指定します。

記述形式は次のとおりです。

[<クラス名>]
ClassId=guid=<クラス識別子>
SuperClass=text=<スーパークラス名>
(<プロパティ名>=guid=<プロパティ識別子>)...
(
[<プロパティ識別子>]
dmaProp_DataType=int=｛ DMA_DATATYPE_BOOLEAN ｜
                       DMA_DATATYPE_INTEGER32 ｜
                       DMA_DATATYPE_OBJECT ｜
                       DMA_DATATYPE_STRING ｝
dmaProp_Cardinality=int=｛ DMA_CARDINALITY_SINGLE ｜
                         DMA_CARDINALITY_LIST ｜
                         DMA_CARDINALITY_ENUM ｜
                         255 ｝
〔 dmaProp_RequiredClass=obj=<クラス名> 〕
)...

次に，各セクションとエントリについて説明します。

＜この項の構成＞

(1)　クラスの定義情報を記述するセクション

(2)　プロパティの定義情報を記述するセクション

(1)　クラスの定義情報を記述するセクション

クラスの定義情報を記述します。

クラス名

DocumentBrokerサーバのメタ情報ファイル（edms.ini）でdmaProp_DisplayNameプロパティに指定する値で，スラント（/）の後ろに記述するクラスの名前をセクション名に記述してください。

＜記述例＞

[usrClass_DocVersion]

クラス識別子

DocumentBrokerサーバのメタ情報ファイル（edms.ini）でdmaProp_Idsプロパティに指定するクラスのクラス識別子（GUID）を，ClassIdエントリに「=guid=」を区切り文字として記述してください。

GUIDは，次の形式で指定してください。Xは0～9およびa～f（小文字）で表される16進数の値です。

「XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX」（8けた-4けた-4けた-4けた-12けた）

＜記述例＞

ClassId=guid=01a3a891-7aec-11d1-a31b-0020af9fbb1c

スーパークラス名

DocumentBrokerサーバのメタ情報ファイル（edms.ini）でdmaProp_DisplayNameプロパティに指定する値のうち，スラント（/）の前に記述するスーパークラスの名前を，SuperClassエントリに「=text=」を区切り文字として記述してください。

＜記述例＞

SuperClass=text=dmaClass_DocVersion

プロパティ名

DocumentBrokerサーバのメタ情報ファイル（edms.ini）でプロパティのdmaProp_DisplayNameプロパティに指定する値をエントリ名として指定してください。指定したエントリに「=guid=」を区切り文字として，プロパティの識別子（GUID）を記述してください。オブジェクト操作ツールで使用するプロパティが複数ある場合は，すべて記述してください。

＜記述例＞

usrProp_Title=guid=01234567-0123-0123-0123-012345678901

プロパティ識別子

「(2)プロパティの定義情報を記述するセクション」の「プロパティ識別子」を参照してください。

(2)　プロパティの定義情報を記述するセクション

プロパティの定義情報を記述します。クラス定義情報ファイル中に同じプロパティの情報を定義するセクションが記述されていてもチェックしません。ファイル中で先に指定されたプロパティの記述を有効とします。ただし，重複してプロパティの定義情報を記述すると，クラス定義情報ファイルのデータ量が増加して，プロパティ定義情報の探索処理性能が劣化することがあります。

プロパティ識別子

DocumentBrokerサーバのメタ情報ファイル（edms.ini）でプロパティのdmaProp_Idsプロパティに指定するプロパティ識別子（GUID）をセクション名に記述してください。

GUIDは，次の形式で指定してください。Xは0～9およびa～f（小文字）で表される16進数の値です。

「XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX」（8けた-4けた-4けた-4けた-12けた）

＜記述例＞

[01234567-0123-0123-0123-012345678901]

dmaProp_DataType（データ型）

DocumentBrokerサーバのメタ情報ファイル（edms.ini）でプロパティのdmaProp_DataTypeプロパティに指定するプロパティのデータ型をdmaProp_DataTypeエントリに「=int=」を区切り文字として記述してください。指定できるデータ型は次のとおりです。（　）内は，指定する文字列です。

Boolean型（DMA_DATATYPE_BOOLEAN）

Integer32型（DMA_DATATYPE_INTEGER32）

Object型（DMA_DATATYPE_OBJECT）

String型（DMA_DATATYPE_STRING）

＜記述例＞

dmaProp_DataType=int=DMA_DATATYPE_STRING

dmaProp_Cardinality（基本単位）

DocumentBrokerサーバのメタ情報ファイル（edms.ini）でプロパティのdmaProp_Cardinalityプロパティに指定するプロパティの基本単位をdmaProp_Cardinalityエントリに「=int=」を区切り文字として記述してください。指定できる基本単位は次のとおりです。（　）内は，指定する文字列です。

Scalar型（DMA_CARDINALITY_SINGLE）

List型（DMA_CARDINALITY_LIST）

Enumeration型（DMA_CARDINALITY_ENUM）

VariableArray型（255）

＜記述例＞

dmaProp_Cardinality=int=DMA_CARDINALITY_SINGLE

dmaProp_RequiredClass（配布オブジェクトクラス）

このエントリは，dmaProp_DataTypeエントリの値に「DMA_DATATYPE_OBJECT」を指定するときだけ記述してください。DocumentBrokerサーバのメタ情報ファイル（edms.ini）で，dmaProp_DataTypeプロパティがObject型で，dmaProp_CardinalityがVariableArray型の場合には，dmaProp_RequiredClassエントリに「=obj=」を区切り文字としてdmaProp_RequiredClassプロパティに指定する値のクラス名を記述してください。DocumentBrokerサーバのメタ情報ファイルでファイルの指定がある場合は，単価記号（@）の後ろに指定する値を記述してください。

＜記述例＞

dmaProp_RequiredClass=obj=usrClass_Author

3.3.4　クラス定義情報ファイルの記述例

クラス定義情報ファイルの記述例を次に示します。記述例は，次の条件に従って記述しています。

dmaClass_DocVersionクラスのサブクラスとしてusrClass_DocVersionクラスを定義する

usrClass_DocVersionクラスには次のプロパティを追加する

usrProp_Titleプロパティ
データ型はString型，基本単位はScalar型のプロパティ

usrProp_Authorsプロパティ
データ型はObject型，基本単位はVariableArray型のプロパティ

usrProp_Authorsプロパティの構成要素を定義するクラスはusrClass_Authorクラスである

;; usrClass_DocVersion
[usrClass_DocVersion]
ClassId=guid=01a3a891-7aec-11d1-a31b-0020af9fbb1c
SuperClass=text=dmaClass_DocVersion
usrProp_Title=guid=01234567-0123-0123-0123-012345678901
usrProp_Authors=guid=01234567-abcd-abcd-abcd-012345678901

;; usrProp_Title
[01234567-0123-0123-0123-012345678901]
dmaProp_DataType=int=DMA_DATATYPE_STRING
dmaProp_Cardinality=int=DMA_CARDINALITY_SINGLE

;; usrProp_Authors
[01234567-efab-efab-efab-012345678901]
dmaProp_DataType=int=DMA_DATATYPE_OBJECT
dmaProp_Cardinality=int=255
dmaProp_RequiredClass=obj=usrClass_Author

;; usrClass_Author
[usrClass_Author]
ClassId=guid=80ff3500-88b6-11d2-963f-00c04fbc3de9
SuperClass=text=edmClass_Struct
usrProp_Name=guid=01234567-8901-8901-8901-012345678901
usrProp_Age=guid=01234567-abcd-efab-cdef-012345678901

3.4　IDファイル

IDファイルは複数のオブジェクトを一括して操作する場合に，操作対象となるオブジェクトのOIID，バージョン識別子またはリンク識別子を記述するファイルです。

＜この節の構成＞

3.4.1　記述規則

3.4.2　記述形式

3.4.3　IDファイルの記述例

3.4.1　記述規則

IDファイルの記述規則を次に示します。

ファイル名は任意です。

印刷可能なASCIIコードで記述してください。

セミコロン（;）およびシャープ（#）で始まる行はコメント行として扱います。

空白行は無視します。

改行コードは，UNIXの場合，NL（0x0a）です。Windowsの場合，CR + NL（0x0d + 0x0a）です。

ファイルの終端はEOFです。

3.4.2　記述形式

IDファイルの記述形式を以下に示します。

IDまたは識別子は1行に一つずつ記述します。

IDまたは識別子の前後の空白およびタブは無視します。

IDまたは識別子が一つも記述されていない場合はエラーになります。

シングルクォート（'）で囲んだIDまたは識別子も指定できます。

記述可能なIDまたは識別子は次のとおりです。

OIID
OIIDの記述形式については，「付録A　OIID指定時のURLの文法」を参照してください。
なお，OIIDを指定したIDファイルをOIIDファイルといいます。

バージョン識別子
この識別子は，バージョン一覧取得コマンド（dbrlsversionコマンド）によって取得してください。
なお，バージョン識別子を指定したIDファイルをバージョン識別子ファイルといいます。

リンク識別子
この識別子は，コンテインメントを設定した時に出力されます。コンテインメントの設定後に取得する場合は，下位オブジェクト一覧取得コマンド（dbrlschildコマンド）または上位コンテナ一覧取得コマンド（dbrlsparentコマンド）によって取得してください。ただし，実行環境制御ファイルのOutputセクションのFormatエントリに「VR0112」を指定している場合は，リンク識別子を取得できません。
なお，リンク識別子を指定したIDファイルをリンク識別子ファイルといいます。

3.4.3　IDファイルの記述例

三つのオブジェクトを一括して操作する場合に指定するIDファイルの記述例を次に示します。この例では，三つのオブジェクトのOIIDを記述しています。なお，記述例中の「…」は，途中の省略を示します。

dma:///07a17522-a626-11d0-b11f-0020af27a837/…00000000001
dma:///07a17522-a626-11d0-b11f-0020af27a837/…00000000002
dma:///07a17522-a626-11d0-b11f-0020af27a837/…00000000003

また，次のようにシングルクォート（'）で囲んで指定することもできます。

'dma:///07a17522-a626-11d0-b11f-0020af27a837/…00000000001'
'dma:///07a17522-a626-11d0-b11f-0020af27a837/…00000000002'
'dma:///07a17522-a626-11d0-b11f-0020af27a837/…00000000003'

3.5　プロパティ情報ファイル

プロパティ情報ファイルは，次のようにプロパティを設定，参照または更新する場合に記述するファイルです。

オブジェクトを作成する時にプロパティの初期値を設定する場合

オブジェクトに設定されているプロパティを参照する場合

オブジェクトに設定されているプロパティを更新する場合

＜この節の構成＞

3.5.1　記述規則

3.5.2　記述形式

3.5.3　実行するコマンドと指定するエントリの対応

3.5.4　プロパティ情報ファイルの記述例

3.5.5　複数オブジェクトを一括作成する場合のプロパティ情報ファイル

3.5.1　記述規則

プロパティ情報ファイルの記述規則を次に示します。

ファイル名は任意です。

文書空間で使用する文字コード種別※，または印刷可能なASCIIコードで記述してください。

セミコロン（;）およびシャープ（#）で始まる行はコメント行として扱います。

空白行は無視します。

改行コードは，UNIXの場合，NL（0x0a）です。Windowsの場合，CR + NL（0x0d + 0x0a）です。

ファイルの終端はEOFです。

注※

文字コード種別にUTF-8を使用する場合は，Windowsのメモ帳を使わないでください。UTF-8を前提とするテキストファイルを編集して保存する場合は，「BOM」制御コードが付加されないテキストエディタを使用してください。

Windowsのメモ帳で編集して保存すると，ファイルの先頭に「BOM」と呼ばれる数バイトの制御コードが付加され，オブジェクト操作ツールが提供する機能やコマンドでエラーとなることがあります。

3.5.2　記述形式

プロパティ情報ファイルは複数のセクションから構成されます。各セクションは複数のエントリで構成されます。プロパティ情報ファイル中に同じエントリが指定されていてもチェックしません。

セクション内に同一のプロパティに対する記述が複数ある場合，プロパティの取得はできますが，オブジェクトを作成するときおよびプロパティを設定するときには実行メソッドでエラーになります。プロパティ以外のエントリの場合は，最初に記述されているエントリを有効とします。

セクションとエントリは，次のように記述します。

セクション名は，角括弧（［　］）で囲んで指定します。一つのセクションは，セクション名を指定してから，次のセクション名を指定するまで，またはファイルの終端までの範囲です。

エントリは，「エントリ名=指定値」の形式で指定します。ただし，プロパティを取得する場合に使用するプロパティ情報ファイルでは，エントリ名だけを指定して，指定値を省略できます。この場合，指定値を指定しても無視されます。

記述形式は次のとおりです。

[<セクション名>]
(
 (<プロパティ>)...
 〔 link=<コンテインメントの種別> 〕
 〔 mode=<構成管理モード種別> 〕
 〔 { url=<ファイルパス指定>
   ｜ directory= <ディレクトリパス指定>
            〔 files[<ファイル数>]={ <ファイル指定> } 〕 } 〕
 〔 mime='<MIME名>' 〕
 〔 filelink_famname= <コンテント登録先FAM名> 〕
 〔 filelink_contentpath= <コンテント登録先パス指定> 〕
 〔 reference_type= <リファレンス種別> 〕
 〔 reference_contentbasepath= <コンテント格納先ベースパス指定> 〕
 〔 reference_contentpath= <コンテント格納先パス指定> 〕
)

<プロパティ> ::= ｛ <プロパティ設定> ｜ <プロパティ取得> ｝
<プロパティ設定> ::= ｛ <Scalar型プロパティ設定> ｜
                       <VariableArray型プロパティ設定> ｝
<Scalar型プロパティ設定> ::= <プロパティ名>=<値>
<VariableArray型プロパティ設定> ::=
                   <プロパティ名>[<配列数>][<構成要素プロパティ数>]=
                   { <構成要素プロパティ設定> }
<構成要素プロパティ設定> ::=
   { <構成要素プロパティ名>=<値>〔,<構成要素プロパティ名>=<値>〕 }
<プロパティ取得> ::= <プロパティ名>
<値> ::= ｛ <Boolean型プロパティ値> ｜
           <Integer32型プロパティ値> ｜
           <String型プロパティ値> ｝
<Boolean型プロパティ値> ::= { TRUE ｜ FALSE ｜ UNKNOWN }
<Integer32型プロパティ値> ::= <任意の10進数>
<String型プロパティ値> ::= '<任意の文字列>'
<コンテインメントの種別> ::= ｛ DCR ｜ RCR ｜ VCR ｝
<構成管理モード種別> ::= { FLOATING ｜ FIX }

<サブジェクト種別用プロパティ>※ ::=
 <サブジェクト種別用プロパティ名>※=｛ USR ｜ GRP ｜ SYS ｝
<サブジェクト種別用プロパティ名>※ ::= dbrProp_SubjectType
<パーミッション種別用プロパティ設定> ::=
 <パーミッション種別用プロパティ名>=<パーミッション>
<パーミッション> ::=｛ NONE ｜ CP ｜ <パーミッション論理和> ｝
<パーミッション論理和> ::=
 ｛ <パーミッション種別> ｜ <パーミッション論理和> ｜
    <パーミッション種別> ｝
<パーミッション種別用プロパティ名> ::=｛ dbrProp_EveryonePermission ｜
                                        dbrProp_OwnerPermission ｜
                                        dbrProp_PrimaryGroupPermission ｜
                                        dbrProp_UserPermission ｜
                                        dbrProp_Permission※｝
<パーミッション種別> ::=｛ PRP ｜ PWP ｜ PRC ｜ PWC ｜ PL ｜ PV ｜ PD ｝

<ファイルパス指定> ::=｛ NONE | DBRSVCONTENT | '<ファイルURL>' ｝
<ファイルURL> ::= <"file:"で始まるURL>
<ディレクトリパス指定> ::=｛ NONE | '<ディレクトリURL>' ｝
<ディレクトリURL> ::= <"file:"で始まるURL>

<ファイル数> ::= <任意の10進数>
<ファイル指定> ::= ｛ edmProp_RetrievalName = '<ファイル名>',
                   〔 edmProp_ComponentType = '<コンポーネント種別>' 〕 ｝, ...
<ファイル名> ::= <任意の文字列>
<コンポーネント種別> ::= <任意の文字列>
<コンテント登録先FAM名> ::='<任意の文字列>'
<コンテント登録先パス指定> ::='<任意の文字列>'
<コンテント格納先ベースパス指定> ::='<任意の文字列>'
<コンテント格納先パス指定> ::='<任意の文字列>'
<リファレンス種別> ::=｛ NONE ｜ RELATIVE ｝

注※　dbrProp_ACLプロパティまたはdbrProp_SACLプロパティの場合だけ指定します。

記述形式に関する注意事項

filesエントリ，<VariableArray型プロパティ設定>，<構成要素プロパティ設定>および<ファイル指定>で示した波括弧（{　}）は文字として記述してください。

また，<パーミッション論理和>で示したストローク（｜）のうち，2番目のストローク（「<パーミッション論理和> ｜ <パーミッション種別>」の「｜」）は，文字として記述してください。

そのほかの波括弧（{　}）は，ストローク（｜）で区切られた項目から一つを選択することを意味します。

次に，セクションと各エントリについて説明します。

＜この項の構成＞

(1)　セクション名

(2)　プロパティエントリ

(3)　linkエントリ

(4)　modeエントリ

(5)　urlエントリ

(6)　directoryエントリ

(7)　filesエントリ

(8)　mimeエントリ

(9)　filelink_famnameエントリ

(10)　filelink_contentpathエントリ

(11)　reference_typeエントリ

(12)　reference_contentbasepathエントリ

(13)　reference_contentpathエントリ

(14)　値の記述方法

(1)　セクション名

プロパティ情報ファイルには，プロパティ値を設定または取得するオブジェクトを構成するDMAオブジェクトの，クラスまたはそのサブクラスのクラス名をセクション名として，128バイト以内の半角文字列で記述します。セクション名として記述するクラス名は，クラス定義情報ファイルに記述されている必要があります。セクションは，一つ以上のエントリで構成されます。セクションを構成するエントリについて次に示します。

(2)　プロパティエントリ

エントリ名には，セクション名に指定したクラスに定義されているプロパティのうち，値を設定または取得するプロパティの名前を128バイト以内の半角文字列で記述します。プロパティの基本単位および種類（用途）によって記述形式が異なります。

(a)　Scalar型プロパティ

プロパティの値を設定する場合と取得する場合とで記述形式が異なります。

Scalar型プロパティの設定
値を設定するプロパティ名と設定する値を，等号（=）を区切り文字として記述します。プロパティのデータ型に対応した値の記述方法については，「(16)値の記述方法」の項目を参照してください。

＜記述例＞

usrProp_IsReadOnly=TRUE（Boolean型のプロパティの場合）

usrProp_State=1（Integer32型のプロパティの場合）

usrProp_Title='Document'（String型のプロパティの場合）

Scalar型プロパティの取得
値を取得するプロパティ名を記述します。

＜記述例＞

usrProp_IsReadOnly

usrProp_State

usrProp_Title

(b)　VariableArray型プロパティ

プロパティの基本単位がVariableArray型でデータ型がObject型のプロパティについても，プロパティの値を設定する場合と取得する場合とで記述形式が異なります。

VariableArray型プロパティの設定
値を設定するプロパティ名に続けて，配列数と構成要素プロパティ数をそれぞれ角括弧（［　］）で囲んで記述します。その後ろに等号（=）を区切り文字として，設定する値を記述します。
例えば，著者の情報を管理するために使用するVariableArray型のプロパティ「usrProp_Authors」は，著者名を管理する「usrProp_Name」と著者の年齢を管理する「usrProp_Age」という二つのプロパティから構成されているとします。この「usrProp_Authors」というプロパティに対して，3人の著者情報を値として設定する場合は，配列数は3，構成要素プロパティ数は2となります。設定する値には，構成要素プロパティ名と値を等号（=）を区切り文字として記述します。なお，指定する構成要素プロパティ名は，クラス定義情報ファイルに記述されている必要があります。
記述例を次に示します。

＜記述例＞

usrProp_Authors[3][2] =

{

{usrProp_Name='suzuki', usrProp_Age=27},

{usrProp_Name='yamada', usrProp_Age=30},

{usrProp_Name='sato', usrProp_Age=32}

}

構成要素プロパティに対する値は，それぞれのプロパティのデータ型によって異なります。プロパティのデータ型に対応した値の記述方法については，「(16)値の記述方法」の項目を参照してください。

VariableArray型プロパティの取得
値を取得するプロパティ名を記述します。

＜記述例＞

usrProp_Authors

(c)　パーミッション種別設定用プロパティ

パーミッション種別用プロパティ名とパーミッションを指定します。

パーミッション種別用プロパティ名
次のどれかを指定してください。

dbrProp_EveryonePermission

dbrProp_OwnerPermission

dbrProp_PrimaryGroupPermission

dbrProp_UserPermission

dbrProp_Permission

ただし，「dbrProp_Permission」を指定するのは，dbrProp_ACLプロパティまたはdbrProp_SACLプロパティの構成要素のプロパティの場合だけです。また，「dmaProp_UserPremission」は，プロパティを取得するときだけに指定できます。
それぞれのプロパティに指定できるパーミッションの値については，マニュアル「DocumentBroker Version 3　クラスライブラリ　C++　解説」を参照してください。

パーミッション
NONE（アクセス権を設定しない場合）またはパーミッション論理和を指定します。パーミッション論理和とは，パーミッション種別をストローク（｜）で組み合わせた値です。
パーミッション種別には，PRP（基本プロパティ参照権），PWP（基本プロパティ更新権），PRC（基本コンテント参照権），PWC（基本コンテント更新権），PL（基本リンク権），PV（基本バージョン管理権），PD（基本オブジェクト削除権），またはCP（アクセス制御情報変更権）のどれかを指定してください。
PRP，PWP，PRC，PWC，PL，PV，PDは，組み合わせて指定できます。組み合わせて指定する場合は，これらのパーミッション種別を，ストローク（｜）でつなげて指定してください。
なお，NONEおよびCPを，ほかのパーミッション種別と組み合わせて指定することはできません。

(d)　サブジェクト種別用プロパティ

アクセス制御機能を使用する場合の，dbrProp_ACLプロパティまたはdbrProp_SACLプロパティを設定するときに記述します。なお，dbrProp_ACLプロパティおよびdbrProp_SACLプロパティの構成要素として指定するdbrProp_Subjectプロパティ，dbrProp_SubjectTypeプロパティおよびdbrProp_Permissionプロパティは，必ず三つ一組で指定してください。

サブジェクト種別用プロパティ名
dbrProp_SubjectTypeを指定してください。

サブジェクト種別
アクセス制御エレメントおよびアクセス制御リストに設定するサブジェクト種別を記述します。USR（ユーザ識別子を指定する場合），GRP（グループ識別子を指定する場合），またはSYS（システムサブジェクトを指定する場合）のどれかを指定してください。

記述例を次に示します。

＜記述例＞

dbrProp_SubjectType=USR

(3)　linkエントリ

オブジェクトを作成するコマンドの実行時に-Tオプションを指定する場合は，設定するコンテインメントの種別を記述します。セクション（クラス）ごとに，DCR（直接型のコンテインメント），RCR（参照型のコンテインメント）またはVCR（構成管理型のコンテインメント）のどれかを記述してください。

＜記述例＞

link=RCR

(4)　modeエントリ

linkエントリにコンテインメントの種別としてVCRを指定した場合に，構成管理モード種別を指定します。FLOATING（FLOATINGモードの場合）またはFIX（FIXモードの場合）のどちらかを記述してください。

＜記述例＞

mode=FLOATING

(5)　urlエントリ

シングルファイル文書またはリファレンスファイル文書を作成する場合は，登録するファイルのファイルパス，または「NONE」を指定します。なお，「NONE」を指定した場合，登録ファイルなしの文書が作成されます。

リファレンスファイル管理機能を使用する場合，このエントリに「NONE」を指定すると，reference_typeエントリは，「NONE」を指定したものと仮定されます。

File Link連携機能を使用する場合，ファイルサーバにファイルまたはディレクトリを登録するときは，登録するファイルまたはディレクトリのパスを指定します。ファイルサーバ上に登録されているコンテントを指定して文書を作成するときは，このエントリに「DBRSVCONTENT」を指定して，filelink_contentpathエントリに，文書の作成に使用するファイルサーバ上のコンテントのパスを指定します。登録ファイルなしの文書を作成するときは，「NONE」を指定します。なお，このエントリに「DBRSVCONTENT」を指定して，filelink_contentpathエントリの指定を省略するとエラーになります。

ファイルパスは，URL形式で記述します。値はシングルクォート（'）で囲んで記述します。例えば，UNIXの場合に「/tmp/create.doc」を文書に登録したいときは，「file:///tmp/create.doc」をシングルクォート（'）で囲んで記述します。Windowsの場合に「c:¥temp¥create.doc」を文書に登録したいときは，「file:///c:¥temp¥create.doc」をシングルクォート（'）で囲んで記述します。

＜記述例＞

シングルファイル文書およびリファレンスファイル文書を作成する場合の記述例を示します。

（UNIXの場合）

url='file:///tmp/create.doc'

（Windowsの場合）

url='file:///c:¥temp¥create.doc'

File Link連携機能でクライアントのコンテント（ファイル）を指定して文書を作成する場合の記述例を示します。

（UNIXの場合）

url='file:///tmp/create.doc'

（Windowsの場合）

url='file:///c:¥temp¥create.doc'

File Link連携機能でクライアントのコンテント（ディレクトリ）を指定して文書を作成する場合の記述例を示します。

（UNIXの場合）

url='file:///tmp'

（Windowsの場合）

url='file:///c:¥temp'

File Link連携機能で，ファイルサーバ上に登録されているコンテントを指定して文書を作成する場合の記述例を示します。

url='DBRSVCONTENT'

(6)　directoryエントリ

マルチファイル文書を作成する場合に，登録するファイルが格納されているディレクトリパス，または「NONE」を指定します。なお，「NONE」を指定した場合，登録ファイルなしのマルチファイル文書が作成され，filesエントリの指定は無効になります。

ディレクトリパスは，URL形式で記述してください。値はシングルクォート（'）で囲んで記述します。例えば，UNIXの場合に「/tmp」にマルチファイル文書として登録するファイルが格納されているときは，「file:///tmp」をシングルクォート（'）で囲んで記述します。Windowsの場合に「c:¥temp」にマルチファイル文書として登録するファイルが格納されているときは，「file:///c:¥temp」をシングルクォート（'）で囲んで記述します。

＜記述例＞

UNIXの場合の記述例を示します。

directory='file:///tmp'

Windowsの場合の記述例を示します。

directory='file:///c:¥temp'

なお，directoryエントリに値を指定して，filesエントリの指定を省略した場合，directoryエントリに指定したディレクトリ下にあるすべてのファイルが，マルチファイル文書の登録対象になります。ただし，この場合は，コンポーネント種別を指定できません。登録対象になるのは，directoryエントリに指定したディレクトリの直下に格納されているファイル，シンボリックリンクおよび隠しファイルです。directoryエントリに指定したディレクトリの下位ディレクトリに格納されたファイルは，登録対象になりません。

(7)　filesエントリ

マルチファイル文書を作成する場合に，マルチファイル文書として登録するファイル数，ファイル名およびコンポーネント種別を指定します。

それぞれの値の記述形式を次に示します。

ファイル数
マルチファイル文書として登録するファイルの数を，1～2,147,483,647の間で記述します。値はエントリ名に続けて角括弧（［　］）で囲んで記述します。ファイル数の後ろに，等号（=）を区切り文字として，ファイル名およびコンポーネント種別を記述します。

ファイル名
マルチファイル文書として登録するファイルの名前を記述します。マルチファイル文書として登録できるのは，directoryエントリで指定したディレクトリ下にあるファイル，シンボリックリンク，および隠しファイルです。値はシングルクォート（'）で囲み，edmProp_RetrievalNameエントリに等号（=）を区切り文字として記述します。

コンポーネント種別
edmProp_RetrievalNameエントリに指定したファイルのコンポーネント種別を，シングルクォート（'）で囲み，edmProp_ComponentTypeエントリに等号（=）を区切り文字として記述します。なお，文書空間で使用する文字コード種別がUTF-8の場合は，印刷可能なASCIIコードで記述してください。

登録するファイルが複数ある場合は，一つのファイルに対するファイル名およびコンポーネント種別の指定ごとにコンマ（,）で区切って記述します。ファイル数に指定した値と，ファイル名およびコンポーネント種別の数が一致しない場合はエラーになります。

記述例を次に示します。

＜記述例＞

記述例では，次に示す二つのファイルを登録することが前提となっています。

ファイル1

ファイル名：foo

コンポーネント種別：body

ファイル2

ファイル名：bar

コンポーネント種別：fig-1

files[2]=

{

｛ edmProp_RetrievalName = 'foo' , edmProp_ComponentType = 'body' ｝ ,

｛ edmProp_RetrievalName = 'bar' , edmProp_ComponentType = 'fig-1' ｝

}

(8)　mimeエントリ

文書を作成する場合に，登録するファイルの表現形式を「クラス/サブクラス」形式のMIME名で記述してください。値はシングルクォート（'）で囲んで記述します。例えば，HTML文書の場合，MIME名には「text/html」をシングルクォート（'）で囲んで指定します。

＜記述例＞

mime='text/html'

(9)　filelink_famnameエントリ

File Link連携機能を使用する場合に，コンテントの登録先となるファイルサーバのFAM名を，シングルクォート（'）で囲んで記述します。

このエントリは次のどちらかの場合に指定してください。

実行環境制御ファイルのFileLinkセクションの，DefaultFAMNameエントリを省略して，dbrcrtdocコマンド（文書の作成）を実行する場合

実行環境制御ファイルのFileLinkセクションの，DefaultFAMNameエントリの指定とは異なるFAM名のファイルサーバを使用して，dbrcrtdocコマンド（文書の作成）を実行する場合

なお，このエントリの指定を省略した場合，実行環境制御ファイルのFileLinkセクションの，DefaultFAMNameエントリに指定されたFAM名のファイルサーバを使用します。

＜記述例＞

filelink_famname='fam01'

(10)　filelink_contentpathエントリ

File Link連携機能を使用する場合に，クライアントのコンテントを指定して文書を作成するときは，ファイルサーバ上の登録先ディレクトリのパスを指定します。また，ファイルサーバ上に登録されているコンテントを指定して文書を作成するときは，使用するファイルサーバ上のコンテントのパスを指定します。

このエントリは次のどちらかの場合に指定してください。

実行環境制御ファイルのFileLinkセクションの，DefaultContentPathエントリを省略して，dbrcrtdocコマンド（文書の作成）を実行する場合

実行環境制御ファイルのFileLinkセクションの，DefaultContentPathエントリの指定とは異なるファイルサーバ上の登録先ディレクトリを使用して，dbrcrtdocコマンド（文書の作成）を実行する場合

クライアントのコンテントを指定して文書を作成するとき，およびファイルサーバ上に登録されているコンテントを指定して文書を作成するときのエントリの指定方法を次に示します。

クライアントのコンテントを指定して文書を作成するとき

ファイルサーバ上の登録先ディレクトリのパスを，シングルクォート（'）で囲んで記述します。ディレクトリの末尾にはデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述します。登録するコンテントは，urlエントリで指定します。

エントリに指定した登録先ディレクトリが存在しない場合，ディレクトリが作成され，コンテントが登録されます。ただし，デリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述しない場合，コンテント名称の自動生成を行わない（実行環境制御ファイルで，FileLinkセクションの FileNamingModeエントリに「Specify」を指定している）環境で，このエントリに指定したディレクトリがファイルサーバ上に存在するとエラーになり，存在しないとディレクトリは作成しないで，このエントリに指定した名称でコンテントが登録されます。

なお，このエントリの指定を省略した場合，実行環境制御ファイルのFileLinkセクションの，DefaultContentPathエントリに指定されたディレクトリにコンテントが登録されます。

＜記述例＞

UNIXの場合に，コンテントの登録先ディレクトリが，「/dir01/data」の下位にある「area1」ディレクトリのときの記述例を次に示します。

指定形式の種別
指定例

フルパス指定
filelink_contentpath = '/dir01/data/area1/'

エイリアス指定
filelink_contentpath = 'DATA/area1/'
（「/dir01/data」のエイリアス名が「DATA」のとき）

Windowsの場合に，コンテントの登録先ディレクトリが，「c:¥dir01¥data」の下位にある「area1」ディレクトリのときの記述例を次に示します。

指定形式の種別
指定例

フルパス指定
filelink_contentpath = 'c:¥dir01¥data¥area1¥'

エイリアス指定
filelink_contentpath = 'DATA¥area1¥'
（「c:¥dir01¥data」のエイリアス名が「DATA」のとき）

ファイルサーバ上に登録されているコンテントを指定して文書を作成するとき

ファイルサーバ上のコンテントのパスを指定します。値はシングルクォート（'）で囲んで記述します。

なお，ファイルサーバ上に登録されているコンテントを指定して文書を作成するとき，このエントリの指定は省略できません。また，このとき，urlエントリに，「DBRSVCONTENT」を指定してください。

＜記述例＞

UNIXの場合に，文書の作成に使用するコンテントが，「/dir01/data/area1」の下位にある「file.jpg」の場合の記述例を次に示します。

指定形式
指定例

フルパス指定
filelink_contentpath = '/dir01/data/area1/file.jpg'

エイリアス指定
filelink_contentpath = 'DATA/area1/file.jpg'
のとき（「/dir01/data」のエイリアス名が「DATA」のとき）

Windowsの場合に，文書の作成に使用するコンテントが，「c:¥dir01¥data¥area1」の下位にある「file.jpg」の場合の記述例を次に示します。

指定形式
指定例

フルパス指定
filelink_contentpath = 'c:¥dir01¥data¥area1¥file.jpg'

エイリアス指定
filelink_contentpath = 'DATA¥area1¥file.jpg'
（「c:¥dir01¥data」のエイリアス名が「DATA」のとき）

(11)　reference_typeエントリ

リファレンスファイル管理機能を使用する場合の，コンテントの格納先とリファレンス種別を指定します。リファレンス種別には，「NONE」または「RELATIVE」を指定してください。ただし，urlエントリの指定が「NONE」の場合，このエントリは「NONE」を指定したものと仮定されます。

このエントリの指定は次の場合に有効になります。

実行環境制御ファイルのReferenceセクションでDefaultReferenceTypeエントリの指定を省略して，dbrcrtdocコマンド（文書の作成）を実行する場合

実行環境制御ファイルのReferenceセクションのDefaultReferenceTypeエントリと異なるリファレンス種別を指定して，dbrcrtdocコマンド（文書の作成）を実行する場合

「NONE」を指定した場合，コンテントがなく，コンテントロケーションを管理しないオブジェクトが作成されます。このエントリの指定が「NONE」で，urlエントリの指定が「NONE」以外のとき，urlエントリの指定は無効となります。

「RELATIVE」を指定した場合，コンテントの格納先をファイルシステム上の領域とし，コンテントロケーションを相対パスで管理するオブジェクトが作成されます。

＜記述例＞

reference_type = RELATIVE

(12)　reference_contentbasepathエントリ

リファレンスファイル管理機能を使用する場合に，コンテント格納先ベースパスをシングルクォート（'）で囲んで記述します。

このエントリの指定は次の場合に有効になります。

実行環境制御ファイルのReferenceセクションでDefaultContentBasePathエントリの指定を省略して，dbrcrtdocコマンド（文書の作成）を実行する場合

実行環境制御ファイルのReferenceセクションのDefaultContentBasePathエントリと異なるコンテント格納先ベースパスを指定して，dbrcrtdocコマンド（文書の作成）を実行する場合

このエントリには，リファレンスファイル文書の格納先となるディレクトリの基点となるパスを指定します。例えば，urlエントリで指定したコンテントを，「/drv01/dir01/userdir」ディレクトリの下位にある「user01」ディレクトリに格納する場合，「user01」ディレクトリの基点となるパスとして，「/drv01/dir01/userdir」をシングルクォート（'）で囲んで指定します。このエントリの指定の末尾に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。

このエントリに指定したコンテント格納先ベースパスは，コンテント格納先パスと結合して絶対パスとして使用されます。ContentLocationプロパティには次に示すパスが格納されます。

aaaa/bbbb/cccc

aaaa：コンテント格納先パス

bbbb：DocumentBrokerがコンテントを管理するためのディレクトリ

cccc：ファイル名※

注※

次に示すどちらかのファイル名が設定されます。

登録ファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにOriginを指定した場合）

DocumentBrokerが指定するファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにDivideを指定した場合）

Windowsの場合，コンテント格納先ベースパスにUNC形式のパスを使用することもできます。例えば，「server01」というマシンのネットワーク上で共有しているフォルダ「share」をコンテント格納先ベースパスに指定する場合は，「¥¥server01¥share」をシングルクォート（'）で囲んで指定します。

＜記述例＞

reference_contentbasepath = '/drv01/dir01/userdir'

(13)　reference_contentpathエントリ

リファレンスファイル管理機能を使用する場合に，コンテント格納先ベースパスからの相対パスで，コンテント格納先パスをシングルクォート（'）で囲んで記述します。

リファレンス種別が「NONE」の場合，このエントリの指定は無効となります。また，このエントリを省略すると，コンテント格納先ベースパスディレクトリの下位にコンテントが格納されます。

このエントリには，reference_contentbasepathで指定したコンテント格納先ベースパスからの相対パスで，コンテントの格納先とするディレクトリを指定します。例えば，urlエントリで指定したコンテントを，reference_contentbasepathで指定した「/drv01/dir01/userdir」ディレクトリの下位にある「user01」ディレクトリに格納する場合，コンテントの格納先とするディレクトリとして，「user01」をシングルクォート（'）で囲んで指定します。このエントリの指定の先頭に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。

このエントリに指定したコンテント格納先パスは，コンテント格納先ベースパスと結合して絶対パスとして使用されます。ContentLocationプロパティには次に示すパスが格納されます。

aaaa/bbbb/cccc

aaaa：コンテント格納先パス

bbbb：DocumentBrokerがコンテントを管理するためのディレクトリ

cccc：ファイル名※

注※

次に示すどちらかのファイル名が設定されます。

登録ファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにOriginを指定した場合）

DocumentBrokerが指定するファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにDivideを指定した場合）

＜記述例＞

reference_contentpath = 'user01'

(14)　値の記述方法

値を設定するプロパティのデータ型によって記述形式が異なります。

(a)　Boolean型プロパティの値

「TRUE」，「FALSE」または「UNKNOWN」のどれかを記述します。

＜記述例＞

usrProp_IsReadOnly=TRUE

(b)　Integer32型プロパティの値

任意の10進数を-2,147,483,648～2,147,483,647の間で記述します。

＜記述例＞

usrProp_State=1

(c)　String型プロパティの値

1,039バイト以内の任意の文字列をシングルクォート（'）で囲んで記述します。

＜記述例＞

usrProp_Title='Document'

空文字列を指定する場合は，シングルクォート（'）を二つ続けて記述します。

＜記述例＞

usrProp_Title=''

シングルクォート（'）を文字列として指定する場合は，文字列を囲むシングルクォート（'）とは別にシングルクォート（'）を二つ続けて記述します。

＜記述例＞

usrProp_Title='user''s container'

3.5.3　実行するコマンドと指定するエントリの対応

実行するコマンド（オプションの指定を含む）ごとに，プロパティ情報ファイルに指定するエントリを示します。なお，各コマンドの詳細については，「5.　コマンドリファレンス」を参照してください。

＜この項の構成＞

(1)　dbrcrtacl（パブリックACLの作成）

(2)　dbrcrtcntr（コンテナの作成）

(3)　dbrcrtdata（独立データの作成）

(4)　dbrcrtdoc（文書の作成）

(5)　dbrgetprop（プロパティの取得）

(6)　dbrsetprop（プロパティの設定）

(1)　dbrcrtacl（パブリックACLの作成）

作成するプロパティ情報ファイル

edmClass_PublicACL用プロパティ情報ファイルを作成します。

セクション名

パブリックACLを作成するために使用するedmClass_PublicACLクラスのクラス名を指定します。

指定するエントリ

プロパティエントリを指定します。

(2)　dbrcrtcntr（コンテナの作成）

作成するプロパティ情報ファイル

次のプロパティ情報ファイルを作成します。

dmaClass_Container用プロパティ情報ファイル
バージョンなしコンテナを作成する場合（-c RCオプションを指定する場合）に必要です。

edmClass_ContainerVersion用プロパティ情報ファイル
構成管理コンテナを作成する場合（-c VTCオプションまたは-c CRCオプションを指定する場合）に必要です。

dmaClass_ConfigurationHistory用プロパティ情報ファイル
バージョン付き構成管理コンテナを作成する場合（-c CRCオプションを指定する場合）に必要です。

セクション名

プロパティ情報ファイルごとに，次のセクション名を指定します。

dmaClass_Container用プロパティ情報ファイル
バージョンなしコンテナを作成するために使用するdmaClass_Containerクラスまたはそのサブクラスのクラス名を指定します。

edmClass_ContainerVersion用プロパティ情報ファイル
構成管理コンテナを作成するために使用するedmClass_ContainerVersionクラスまたはそのサブクラスのクラス名を指定します。

dmaClass_ConfigurationHistory用プロパティ情報ファイル
構成管理コンテナのバージョンを管理するために使用するdmaClass_ConfigurationHistoryクラスまたはそのサブクラスのクラス名を指定します。

指定するエントリ

バージョンなしコンテナを作成する場合

-c RCオプションだけ指定する場合
dmaClass_Container用プロパティ情報ファイルにプロパティエントリを指定します。

-c RCオプションおよび-Tオプションを指定する場合
dmaClass_Container用プロパティ情報ファイルにプロパティエントリおよびlinkエントリを指定します。

バージョンなし構成管理コンテナを作成する場合

-c VTCオプションだけ指定する場合
edmClass_ContainerVersion用プロパティ情報ファイルにプロパティエントリを指定します。

-c VTCオプションおよび-Tオプションを指定する場合
edmClass_ContainerVersion用プロパティ情報ファイルにプロパティエントリおよびlinkエントリを指定します。

バージョン付き構成管理コンテナを作成する場合

-c CRCオプションだけ指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびedmClass_ContainerVersion用プロパティ情報ファイルにプロパティエントリを指定します。

-c CRCオプションおよび-Tオプションを指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびedmClass_ContainerVersion用プロパティ情報ファイルにプロパティエントリを指定します。
linkエントリ，modeエントリ（linkエントリにVCRを指定した場合）は，どちらかのプロパティ情報ファイルに指定します。どちらにも指定されていない場合はエラーになります。両方に指定されている場合は，dmaClass_ConfigurationHistory用プロパティ情報ファイルに指定されているエントリが有効となります。

(3)　dbrcrtdata（独立データの作成）

作成するプロパティ情報ファイル

edmClass_IndependentPersistence用プロパティ情報ファイルを作成します。

セクション名

独立データを作成するために使用するedmClass_IndependentPersistenceクラスまたはそのサブクラスのクラス名を指定します。

指定するエントリ

プロパティエントリを指定します。

(4)　dbrcrtdoc（文書の作成）

作成するプロパティ情報ファイル

次のプロパティ情報ファイルを作成します。

dmaClass_DocVersion用プロパティ情報ファイル

dmaClass_ConfigurationHistory用プロパティ情報ファイル
dmaClass_ConfigurationHistory用プロパティ情報ファイルは，バージョン付き文書を作成する場合（-c VDオプションを指定する場合）に必要です。

セクション名

プロパティ情報ファイルごとに，次のセクション名を指定します。

dmaClass_DocVersion用プロパティ情報ファイル
文書を作成するために使用するdmaClass_DocVersionクラスまたはそのサブクラスのクラス名を指定します。

dmaClass_ConfigurationHistory用プロパティ情報ファイル
文書のバージョンを管理するために使用するdmaClass_ConfigurationHistoryクラスまたはそのサブクラスのクラス名を指定します。

指定するエントリ

次のエントリを指定します。

マルチファイル文書であるバージョンなし文書を作成する場合

-c Dオプションだけ指定する場合
dmaClass_DocVersion用プロパティ情報ファイルにプロパティエントリ，directoryエントリ，filesエントリおよびmimeエントリを指定します。

-c Dオプションおよび-Tオプションを指定する場合
dmaClass_DocVersion用プロパティ情報ファイルにプロパティエントリ，linkエントリ，directoryエントリ，filesエントリおよびmimeエントリを指定します。

シングルファイル文書であるバージョンなし文書を作成する場合

-c Dオプションだけ指定する場合
dmaClass_DocVersion用プロパティ情報ファイルにプロパティエントリ，urlエントリおよびmimeエントリを指定します。

-c Dオプションおよび-Tオプションを指定する場合
dmaClass_DocVersion用プロパティ情報ファイルにプロパティエントリ，linkエントリ，urlエントリおよびmimeエントリを指定します。

マルチファイル文書であるバージョン付き文書を作成する場合

-c VDオプションだけ指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびdmaClass_DocVersion用プロパティ情報ファイルに，プロパティエントリを指定します。
directoryエントリ，filesエントリおよびmimeエントリは，どちらかのプロパティ情報ファイルに指定します。どちらにも指定されていない場合はエラーとなります。両方に指定されている場合は，dmaClass_ConfigurationHistory用プロパティ情報ファイルに指定されているエントリが有効となります。

-c VDオプションおよび-Tオプションを指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびdmaClass_DocVersion用プロパティ情報ファイルに，プロパティエントリを指定します。
linkエントリ，modeエントリ（linkエントリにVCRを指定した場合），directoryエントリ，filesエントリおよびmimeエントリは，どちらかのプロパティ情報ファイルに指定しおよびmimeエントリは，どちらかのプロパティ情報ファイルに指定します。どちらにも指定されていない場合はエラーとなります。両方に指定されている場合は，dmaClass_ConfigurationHistory用プロパティ情報ファイルに指定されているエントリが有効となります。

シングルファイル文書であるバージョン付き文書を作成する場合

-c VDオプションだけ指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびdmaClass_DocVersion用プロパティ情報ファイルに，プロパティエントリを指定します。
urlエントリおよびmimeエントリは，どちらかのプロパティ情報ファイルに指定します。どちらにも指定されていない場合はエラーとなります。両方に指定されている場合は，dmaClass_ConfigurationHistory用プロパティ情報ファイルに指定されているエントリが有効となります。

-c VDオプションおよび-Tオプションを指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびdmaClass_DocVersion用プロパティ情報ファイルに，プロパティエントリを指定します。
linkエントリ，modeエントリ（linkエントリにVCRを指定した場合），urlエントリおよびmimeエントリは，どちらかのプロパティ情報ファイルに指定します。どちらにも指定されていない場合はエラーとなります。両方に指定されている場合は，dmaClass_ConfigurationHistory用プロパティ情報ファイルに指定されているエントリが有効となります。

File Link連携機能を利用したバージョンなし文書を作成する場合

-c Dオプションだけ指定する場合
dmaClass_DocVersion用プロパティ情報ファイルにプロパティエントリ，urlエントリ，mimeエントリ，filelink_famnameエントリおよびfilelink_contentpathエントリを指定します。

-c Dオプションおよび-Tオプションを指定する場合
dmaClass_DocVersion用プロパティ情報ファイルにプロパティエントリ，linkエントリ，urlエントリ，mimeエントリ，filelink_famnameエントリおよびfilelink_contentpathエントリを指定します。

File Link連携機能を利用したバージョン付き文書を作成する場合

-c VDオプションだけ指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびdmaClass_DocVersion用プロパティ情報ファイルに，プロパティエントリを指定します。
urlエントリ，mimeエントリ，filelink_famnameエントリおよびfilelink_contentpathエントリは，どちらかのプロパティ情報ファイルに指定します。両方に指定されている場合は，dmaClass_ConfigurationHistory用プロパティ情報ファイルに指定されているエントリが有効となります。urlエントリおよびmimeエントリがどちらにも指定されていない場合はエラーとなります。

-c VDオプションおよび-Tオプションを指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびdmaClass_DocVersion用プロパティ情報ファイルにプロパティエントリを指定します。
linkエントリ，modeエントリ（linkエントリにVCRを指定した場合），urlエントリ，mimeエントリ，filelink_famnameエントリおよびfilelink_contentpathエントリは，どちらかのプロパティ情報ファイルに指定します。両方に指定されている場合は，dmaClass_ConfigurationHistory用プロパティ情報ファイルに指定されているエントリが有効となります。
linkエントリ，modeエントリ（linkエントリにVCRを指定した場合），urlエントリおよびmimeエントリがどちらにも指定されていない場合はエラーとなります。

リファレンスファイル管理機能を利用したバージョンなし文書を作成する場合

-c Dオプションだけ指定する場合
dmaClass_DocVersion用プロパティ情報ファイルにプロパティエントリ，urlエントリ，mimeエントリ，reference_typeエントリ，reference_contentbasepathエントリ（reference_typeエントリにRELATIVEを指定した場合）およびreference_contentpathエントリ（reference_typeエントリにRELATIVEを指定した場合）を指定します。

-c Dオプションおよび-Tオプションを指定する場合
dmaClass_DocVersion用プロパティ情報ファイルにプロパティエントリ，linkエントリ，urlエントリ，mimeエントリ，reference_typeエントリ，reference_contentbasepathエントリ（reference_typeエントリにRELATIVEを指定した場合）およびreference_contentpathエントリ（reference_typeエントリにRELATIVEを指定した場合）を指定します。

リファレンスファイル管理機能を利用したバージョン付き文書を作成する場合

-c VDオプションだけ指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびdmaClass_DocVersion用プロパティ情報ファイルに，プロパティエントリおよびreference_typeエントリを指定します。
urlエントリ，mimeエントリ，reference_contentbasepathエントリ（reference_typeエントリにRELATIVEを指定した場合）およびreference_contentpathエントリ（reference_typeエントリにRELATIVEを指定した場合）は，どちらかのプロパティ情報ファイルに指定します。両方に指定されている場合は，dmaClass_ConfigurationHistory用プロパティ情報ファイルに指定されているエントリが有効となります。urlエントリおよびmimeエントリがどちらにも指定されていない場合はエラーとなります。

-c VDオプションおよび-Tオプションを指定する場合
dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびdmaClass_DocVersion用プロパティ情報ファイルに，プロパティエントリおよびreference_typeエントリを指定します。
linkエントリ，modeエントリ（linkエントリにVCRを指定した場合），urlエントリ，mimeエントリ，reference_contentbasepathエントリ（reference_typeエントリにRELATIVEを指定した場合）およびreference_contentpathエントリ（reference_typeエントリにRELATIVEを指定した場合）は，どちらかのプロパティ情報ファイルに指定します。両方に指定されている場合は，dmaClass_ConfigurationHistory用プロパティ情報ファイルに指定されているエントリが有効となります。linkエントリ，modeエントリ（linkエントリにVCRを指定した場合），urlエントリおよびmimeエントリがどちらにも指定されていない場合はエラーとなります。

(5)　dbrgetprop（プロパティの取得）

プロパティを取得するオブジェクトに対応するプロパティ情報ファイルを作成します。プロパティ情報ファイルには，セクション名と取得するプロパティ名だけを指定します。

(6)　dbrsetprop（プロパティの設定）

プロパティを設定するオブジェクトに対応するプロパティ情報ファイルを作成します。プロパティ情報ファイルには，値を設定するプロパティエントリを指定します。

3.5.4　プロパティ情報ファイルの記述例

マルチファイル文書であるバージョンなし文書を作成する場合のプロパティ情報ファイルの記述例

バージョンなし文書を作成する場合に指定するdmaClass_DocVersionのサブクラスであるusrClass_DocVersion用プロパティ情報ファイルの記述例を示します。記述していないプロパティはデフォルトの値が設定されます。なお，この例はWindowsの場合です。UNIXの場合は，directoryエントリを，「directory='file:///tmp'」のように指定してください。

usrClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
;; usrProp_IsReadOnly
;;   DataType  : Boolean
;;   Cardinality : Scalar
usrProp_IsReadOnly=TRUE
;; usrProp_State
;;   DataType  : Integer32
;;   Cardinality : Scalar
usrProp_State=1
;; usrProp_Title
;;   DataType  : String
;;   Cardinality : Scalar
usrProp_Title='Document'
;; Link Type
link=RCR
;; Directory Path
directory='file:///c:¥temp'
;;File Specification
files[2]=
{
{edmProp_RetrievalName='foo',edmProp_ComponentType='body'},
{edmProp_RetrievalName='bar',edmProp_ComponentType='fig-1'}
}
;; MIME Name
mime='application/x-edm-undefined'

シングルファイル文書であるバージョン付き文書を作成する場合のプロパティ情報ファイルの記述例

バージョン付き文書を作成する場合に指定するdmaClass_ConfigurationHistoryのサブクラスであるusrClass_ConfigurationHistory用プロパティ情報ファイルとdmaClass_DocVersionのサブクラスであるusrClass_DocVersion用プロパティ情報ファイルの記述例を示します。記述していないプロパティはデフォルトの値が設定されます。なお，この例はWindowsの場合です。UNIXの場合は，urlエントリを，「url='file:///tmp/create.doc'」のように指定してください。

usrClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
;; usrProp_IsReadOnly
;;   DataType  : Boolean
;;   Cardinality : Scalar
usrProp_IsReadOnly=TRUE
;; usrProp_State
;;   DataType  : Integer32
;;   Cardinality : Scalar
usrProp_State=1
;; usrProp_Title
;;   DataType  : String
;;   Cardinality : Scalar
usrProp_Title='Document'
;; usrProp_Authors
;;   DataType  : Object
;;   Cardinality : VariableArray
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
;; Link Type
link=RCR
;; File Path
url='file:///c:¥temp¥create.doc'
;; MIME Name
mime='text/plain'

usrClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
;; usrProp_IsReadOnly
;;   DataType  : Boolean
;;   Cardinality : Scalar
usrProp_IsReadOnly=TRUE
;; usrProp_State
;;   DataType  : Integer32
;;   Cardinality : Scalar
usrProp_State=1
;; usrProp_Title
;;   DataType  : String
;;   Cardinality : Scalar
usrProp_Title='Version'

独立データのプロパティを取得する場合のプロパティ情報ファイルの記述例

独立データのプロパティを取得する場合に指定するedmClass_IndependentPersistenceのサブクラスであるusrClass_IndependentPersistence用プロパティ情報ファイルの記述例を示します。記述していないプロパティは取得しません。

;; usrClass_IndependentPersistence
[usrClass_IndependentPersistence]
;; usrProp_IsReadOnly
;;   DataType  : Boolean
;;   Cardinality : Scalar
usrProp_IsReadOnly
;; usrProp_State
;;   DataType  : Integer32
;;   Cardinality : Scalar
usrProp_State
;; usrProp_Title
;;   DataType  : String
;;   Cardinality : Scalar
usrProp_Title
;; usrProp_Authors
;;   DataType  : Object
;;   Cardinality : VariableArray
usrProp_Authors

アクセス制御情報を設定，取得する場合のプロパティ情報ファイルの記述例

アクセス制御情報を設定または取得する場合の，プロパティ情報ファイルに記述するアクセス制御情報を表すプロパティの記述例を示します。

アクセス制御情報を設定する場合のプロパティ情報ファイルの記述例

この情報は，アクセス制御情報を設定するオブジェクトを作成する場合に指定する，プロパティ情報ファイル内に記述します。

dbrProp_OwnerId='user01'
dbrProp_OwnerPermission=PRP|PWP|PRC|PWC|PV|PL|PD
dbrProp_PrimaryGroupId='group01'
dbrProp_PrimaryGroupPermission=PRP|PWP|PRC|PWC|PV|PL
dbrProp_EveryonePermission=PRP|PRC|PV
dbrProp_ACL[2][3]=
{
 {dbrProp_Subject='user02',
  dbrProp_SubjectType=USR,
  dbrProp_Permission=PRP|PWP|PRC|PWC|PD},
 {dbrProp_Subject='group02',
  dbrProp_SubjectType=GRP,
  dbrProp_Permission=PRP|PRC}
}
dbrProp_SACL[1][3]=
{
  {dbrProp_Subject='user01',
   dbrProp_SubjectType=USR,
   dbrProp_Permission=CP}
}

アクセス制御情報を取得する場合のプロパティ情報ファイルの記述例

dbrProp_OwnerId
dbrProp_OwnerPermission
dbrProp_UserPermission
dbrProp_PrimaryGroupId
dbrProp_PrimaryGroupPermission
dbrProp_EveryonePermission
dbrProp_ACL
dbrProp_SACL

File Link連携機能を使用したバージョンなし文書を作成する場合のプロパティ情報ファイルの記述例

バージョンなし文書を作成する場合に指定するdmaClass_DocVersionのサブクラスであるusrClass_DocVersion用プロパティ情報ファイルの記述例を示します。記述していないプロパティはデフォルトの値が設定されます。なお，この例はWindowsの場合です。UNIXの場合は，urlエントリを，「url='file:///tmp/create.doc'」のように指定し，filelink_contentpathエントリを，「filelink_contentpath='/dir01/data/area1/'」のように指定してください。

usrClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
;; usrProp_IsReadOnly
;;   DataType : Boolean
;;   Cardinality : Scalar
usrProp_IsReadOnly=TRUE
;; usrProp_State
;;   DataType : Integer32
;;   Cardinality : Scalar
usrProp_State=1
;; usrProp_Title
;;   DataType : String
;;   Cardinality : Scalar
usrProp_Title='Version'
;; Link Type
link=RCR
;; File Path
url='file:///c:¥temp¥create.doc'
;; MIME Name
mime='text/plain'
;; FAM Name
filelink_famname='fam01'
;; Content Path
filelink_contentpath='c:¥dir01¥data¥area1¥'

リファレンスファイル管理機能を使用したバージョン付き文書を作成する場合のプロパティ情報ファイルの記述例

バージョン付き文書を作成する場合に指定するdmaClass_ConfigurationHistoryのサブクラスであるusrClass_ConfigurationHistory用プロパティ情報ファイルの記述例と，dmaClass_DocVersionのサブクラスであるusrClass_DocVersion用プロパティ情報ファイルの記述例を示します。記述していないプロパティはデフォルトの値が設定されます。なお，この例はWindowsの場合です。UNIXの場合は，urlエントリを「url='file:///tmp/create.doc'」のように指定し，reference_contentbasepathエントリを「reference_contentbasepath='/drv01/dir01/userdir'」のように指定してください。

usrClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki',  usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',    usrProp_Age=32}
}
url='file:///c:¥temp¥create.doc'
mime='MIME::application/x-edm-undefined'
reference_type=RELATIVE
reference_contentbasepath='c:¥dir01¥data'
reference_contentpath='user01'

usrClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

3.5.5　複数オブジェクトを一括作成する場合のプロパティ情報ファイル

オブジェクトを作成するために使用するプロパティ情報ファイルに，複数のセクションを記述することで，複数のオブジェクトを一括して作成できます。ただし，次の場合はエラーになります。

バージョン付き文書を作成するときに使用するdmaClass_DocVersion用プロパティ情報ファイルとdmaClass_ConfigurationHistory用プロパティ情報ファイルに記述しているセクションの数が一致しない場合

バージョン付き構成管理コンテナを作成するときに使用するedmClass_ContainerVersion用プロパティ情報ファイルとdmaClass_ConfigurationHistory用プロパティ情報ファイルに記述しているセクションの数が一致しない場合

次に，二つのコンテナを一括して作成する場合に指定するdmaClass_ContainerクラスのサブクラスであるusrClass_Container用プロパティ情報ファイルの記述例を示します。記述していないプロパティはデフォルトの値が設定されます。

[usrClass_Container]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='container1'

[usrClass_Container]
usrProp_IsReadOnly=FALSE
usrProp_State=10
usrProp_Title='container2'

3.6　問い合わせファイル

問い合わせファイルは，問い合わせの実行コマンド（dbrexquery）で実行する問い合わせ式を記述するファイルです。

＜この節の構成＞

3.6.1　記述規則

3.6.2　基本項目

3.6.3　記述形式

3.6.4　問い合わせファイルの記述例

3.6.1　記述規則

問い合わせファイルの記述規則を次に示します。

ファイル名は任意です。

文書空間で使用する文字コード種別※，または印刷可能なASCIIコードで記述してください。

セミコロン（;）およびシャープ（#）で始まる行はコメント行として扱います。

改行コードは，UNIXの場合，NL（0x0a）です。Windowsの場合，CR + NL（0x0d + 0x0a）です。

ファイルの終端はEOFです。

記述できる問い合わせ式は一つだけです。

注※

文字コード種別にUTF-8を使用する場合は，Windowsのメモ帳を使わないでください。UTF-8を前提とするテキストファイルを編集して保存する場合は，「BOM」制御コードが付加されないテキストエディタを使用してください。

Windowsのメモ帳で編集して保存すると，ファイルの先頭に「BOM」と呼ばれる数バイトの制御コードが付加され，オブジェクト操作ツールが提供する機能やコマンドでエラーとなることがあります。

3.6.2　基本項目

問い合わせファイルには，edmSQL文を記述します。edmSQLによって実現できる検索については，マニュアル「DocumentBroker Version 3　クラスライブラリ　C++　解説」を参照してください。

注意

オブジェクト操作ツールでは，?パラメタを使用した問い合わせ式を指定した検索は実行できません。

3.6.3　記述形式

edmSQLの文法については，マニュアル「DocumentBroker Version 3　クラスライブラリ　C++　解説」を参照してください。

3.6.4　問い合わせファイルの記述例

問い合わせファイルの記述例を次に示します。

SELECT  ALL
         usrClass_Container.usrProp_IsReadOnly,
         usrClass_Container.usrProp_State,
         usrClass_Container.usrProp_Title,
         usrClass_Container.usrProp_Authors
FROM  usrClass_Container
WHERE  usrClass_Container.usrProp_Title
            LIKE 'container_'  ESCAPE  '¥'
  AND  usrClass_Container.usrProp_Authors[ANY].usrProp_Age <= 30
ORDER BY  usrClass_Container.usrProp_State

3.7　アップロード情報ファイル

アップロード情報ファイルは，アップロードするマルチファイル文書の情報を記述するファイルです。

＜この節の構成＞

3.7.1　記述規則

3.7.2　記述形式

3.7.3　アップロード情報ファイルの記述例

3.7.1　記述規則

アップロード情報ファイルの記述規則を次に示します。

ファイル名は任意です。

印刷可能なASCIIコードで記述してください。

セミコロン（;）およびシャープ（#）で始まる行はコメント行として扱います。

空白行は無視します。

改行コードは，UNIXの場合，NL（0x0a）です。Windowsの場合，CR + NL（0x0d + 0x0a）です。

ファイルの終端はEOFです。

記述できるマルチファイル文書の情報は一つだけです。

3.7.2　記述形式

アップロード情報ファイルは，マルチファイル文書に登録されているファイルの格納場所を記述するエントリと，登録されているファイルの情報を記述するエントリで構成されます。同一のエントリが複数指定されている場合は，最初に記述されているエントリを有効とします。エントリは，「エントリ名=指定値」の形式で指定します。

記述形式は次のとおりです。

(
  ( directory=<ディレクトリパス指定> )
 〔 files[<ファイル数>]={ <ファイル指定> } 〕
)
<ディレクトリパス指定> ::= '<ディレクトリURL>'
<ディレクトリURL> ::=  <"file:"で始まるURL>
<ファイル数> ::= <任意の10進数>
<ファイル指定> ::= ｛ edmProp_RetrievalName='<ファイル名>',
                   〔 edmProp_ComponentType='<コンポーネント種別>' 〕 ｝ , ...
<ファイル名> ::= <任意の文字列>
<コンポーネント種別> ::= <任意の文字列>

記述形式に関する注意事項

この記述形式で示したすべての波括弧（{　}）は文字として記述してください。

次に，各エントリについて説明します。

＜この項の構成＞

(1)　directoryエントリ

(2)　filesエントリ

(1)　directoryエントリ

アップロードするマルチファイル文書として登録するファイルが格納されているディレクトリパスを，URL形式で記述してください。値はシングルクォート（'）で囲んで記述します。例えば，UNIXの場合に「/tmp」にマルチファイル文書として登録するファイルが格納されているときは，「file:///tmp」をシングルクォート（'）で囲んで記述します。Windowsの場合に「c:¥temp」にマルチファイル文書として登録するファイルが格納されているときは，「file:///c:¥temp」をシングルクォート（'）で囲んで記述します。

＜記述例＞

UNIXの場合の記述例を示します。

directory='file:///tmp'

Windowsの場合の記述例を示します。

directory='file:///c:¥temp'

directoryエントリに値を指定して，filesエントリの指定を省略した場合，directoryエントリに指定したディレクトリ下にあるすべてのファイルが，マルチファイル文書の登録対象になります。ただし，この場合は，コンポーネント種別を指定できません。登録対象になるのは，directoryエントリに指定したディレクトリの直下に格納されているファイル，シンボリックリンクおよび隠しファイルです。directoryエントリに指定したディレクトリの下位ディレクトリに格納されたファイルは，登録対象になりません。なお，directoryエントリに指定したディレクトリ下にファイルがないとエラーになります。

(2)　filesエントリ

アップロードするマルチファイル文書として登録するファイル数，ファイル名およびコンポーネント種別を指定します。

それぞれの値の記述形式を次に示します。

ファイル数
マルチファイル文書として登録するファイルの数を，1～2,147,483,647の間で記述します。値はエントリ名に続けて角括弧（［　］）で囲んで記述します。ファイル数の後ろに，等号（=）を区切り文字として，ファイル名およびコンポーネント種別を記述します。

ファイル名
マルチファイル文書として登録するファイルの名前を記述します。マルチファイル文書として登録できるのは，directoryエントリで指定したディレクトリ下にあるファイル，シンボリックリンク，および隠しファイルです。値はシングルクォート（'）で囲み，edmProp_RetrievalNameエントリに等号（=）を区切り文字として記述します。

コンポーネント種別
edmProp_RetrievalNameエントリに指定したファイルのコンポーネント種別を，シングルクォート（'）で囲み，edmProp_ComponentTypeエントリに等号（=）を区切り文字として記述します。

登録するファイルが複数ある場合は，一つのファイルに対するファイル名およびコンポーネント種別の指定ごとにコンマ（,）で区切って記述します。ファイル数に指定した値と，ファイル名およびコンポーネント種別の数が一致しない場合はエラーになります。

記述例を次に示します。

＜記述例＞

記述例では，次に示す二つのファイルを登録することが前提となっています。

ファイル1

ファイル名：foo

コンポーネント種別：body

ファイル2

ファイル名：bar

コンポーネント種別：fig-1

files[2]=

{

｛ edmProp_RetrievalName = 'foo' , edmProp_ComponentType = 'body' ｝ ,

｛ edmProp_RetrievalName = 'bar' , edmProp_ComponentType = 'fig-1' ｝

}

3.7.3　アップロード情報ファイルの記述例

directoryエントリに指定したディレクトリ下にある，すべてのファイルをアップロードする場合のアップロード情報ファイル

directoryエントリに指定したディレクトリ下にある，すべてのファイルをアップロードする場合の，アップロード情報ファイルの記述例を示します。なお，この例はWindowsの場合です。UNIXの場合は，directoryエントリを，「directory='file:///tmp'」のように指定してください。

アップロード情報ファイルの記述例

directory='file:///c:¥temp'

directoryエントリに指定したディレクトリ下にある，特定のファイルをアップロードする場合のアップロード情報ファイル

directoryエントリに指定したディレクトリ下にある，特定のファイルをアップロードする場合の，アップロード情報ファイルの記述例を示します。なお，この例はWindowsの場合です。UNIXの場合は，directoryエントリを，「directory='file:///tmp'」のように指定してください。

アップロード情報ファイルの記述例

directory='file:///c:¥temp'
files[2]=
{
{edmProp_RetrievalName='foo',edmProp_ComponentType='body'},
{edmProp_RetrievalName='bar',edmProp_ComponentType='fig-1'}
}

3.8　リファレンス情報ファイル

リファレンス情報ファイルは，リファレンスファイル管理機能を使用する場合に，リファレンス種別やコンテント格納先ベースパスなどのリファレンス情報を記述するファイルです。

＜この節の構成＞

3.8.1　記述規則

3.8.2　記述形式

3.8.3　リファレンス情報ファイルの記述例

3.8.1　記述規則

リファレンス情報ファイルの記述規則を次に示します。

ファイル名は任意です。

印刷可能なASCIIコードで記述してください。

セミコロン（;）およびシャープ（#）で始まる行はコメント行として扱います。

空白行は無視します。

改行コードは，UNIXの場合，NL（0x0a）です。Windowsの場合，CR + NL（0x0d + 0x0a）です。

ファイルの終端はEOFです。

3.8.2　記述形式

リファレンス情報ファイルは，DMAオブジェクトのクラス名をセクション名とする複数のセクションから構成されます。各セクションは複数のエントリで構成されます。リファレンス情報ファイル中に同一のエントリが複数指定されている場合は，最初に記述されているエントリを有効とします。

記述形式は次のとおりです。

〔 <クラス名> 〕
(
 〔 reference_type=<リファレンス種別> 〕
 〔 reference_contentbasepath=<コンテント格納先ベースパス指定> 〕
 〔 reference_deleterootpath=<削除ディレクトリのルートパス指定> 〕
)
<リファレンス種別> ::= ｛NONE｜RELATIVE｝
<コンテント格納先ベースパス> ::= '<任意の文字列>'
<削除ディレクトリのルートパス指定> ::= '<任意の文字列>'

＜この項の構成＞

(1)　<クラス名>セクション

(2)　reference_typeエントリ

(3)　reference_contentbasepathエントリ

(4)　reference_deleterootpathエントリ

(1)　<クラス名>セクション

リファレンス情報ファイルには，プロパティ値を設定または取得するオブジェクトを構成するDMAオブジェクトの，クラスまたはそのサブクラスのクラス名をセクション名として，128バイト以内の半角文字列で記述します。セクション名として記述するクラス名は，クラス定義情報ファイルに記述されている必要があります。セクションは，一つ以上のエントリで構成されます。セクションを構成するエントリについて次に示します。

(2)　reference_typeエントリ

コンテントの格納先と管理するリファレンス情報を示すリファレンス種別を指定します。リファレンス種別には，「NONE」または「RELATIVE」を指定してください。

このエントリの指定は，-iオプションを指定してdbrdelcntrコマンド（コンテナの削除）を実行する場合に有効になります。

「NONE」を指定した場合，コンテントがなく，コンテントロケーションを管理しないオブジェクトとして扱います。

「RELATIVE」を指定した場合，コンテントの格納先をファイルシステム上の領域とし，コンテントロケーションを相対パスで管理するオブジェクトとして扱います。

＜記述例＞

reference_type = RELATIVE

(3)　reference_contentbasepathエントリ

コンテント格納先ベースパスをシングルクォート（'）で囲んで記述します。

このエントリの指定は，-iオプションを指定し，かつリファレンス種別にRELATIVEを指定して，dbrdelcntrコマンド（コンテナの削除）を実行する場合に有効になります。

このエントリには，コンテントが格納されているディレクトリの基点となるパスを指定します。例えば，コンテナに包含されるリファレンスファイル文書の基点となるパスが「/drv01/dir01/userdir」ディレクトリの場合，このエントリに「/drv01/dir01/userdir」をシングルクォート（'）で囲んで指定します。このエントリの指定の末尾に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。

このエントリに指定したコンテント格納先ベースパスは，ContentLocationプロパティに格納されたコンテント格納先を示す相対パスと結合して，絶対パスとして使用されます。

Windowsの場合，コンテント格納先ベースパスにUNC形式のパスを使用することもできます。例えば，「server01」というマシンのネットワーク上で共有しているフォルダ「share」をコンテント格納先ベースパスに指定する場合は，「¥¥server01¥share」をシングルクォート（'）で囲んで指定します。

＜記述例＞

reference_contentbasepath = '/drv01/dir01/userdir'

(4)　reference_deleterootpathエントリ

リファレンスファイル文書と，リファレンスファイル文書が格納されているディレクトリを同時に削除する場合，削除ディレクトリのルートパスをシングルクォート（'）で囲んで記述します。

このエントリの指定は，-iオプションを指定し，かつリファレンス種別にRELATIVEを指定して，dbrdelcntrコマンド（コンテナの削除）を実行する場合に有効になります。

このエントリには，削除するディレクトリのルートパスを指定します。例えば，「/drv01/dir01/userdir/user01/<DocumentBrokerがコンテントを管理するためのディレクトリ>/<登録ファイル名>」のディレクトリ中の「user01」ディレクトリ以下のディレクトリを削除する場合は，「user01」ディレクトリのルートパスとして，「/drv01/dir01/userdir」をシングルクォート（'）で囲んで指定します。ただし，コンテント格納先べースパスの上位のディレクトリは指定できません。また，エントリの指定の末尾に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。

DocumentBrokerがコンテントを管理するためのディレクトリは，このエントリまたは実行環境制御ファイルで削除ディレクトリのルートパスの指定を省略した場合も，コンテントと同時に削除されます。

Windowsの場合，削除ディレクトリのルートパスにUNC形式のパスを使用することもできます。例えば，「server01」というマシンがネットワーク上で共有しているフォルダ「share」を削除ディレクトリのルートパスに指定する場合は，「¥¥server01¥share」をシングルクォート（'）で囲んで指定します。

＜記述例＞

reference_deleterootpath = '/drv01/dir01/userdir'

3.8.3　リファレンス情報ファイルの記述例

リファレンス情報ファイルの記述例を次に示します。

記述例は，三つのオブジェクトを一括して操作する場合を示しています。なお，この例はWindowsの場合です。UNIXの場合は，reference_contentbasepathエントリを「reference_contentbasepath='/drv01/dir01/data1'」のように指定し，reference_deleterootpathエントリを「reference_deleterootpath='/drv01/dir01/data1'」のように指定してください。

[usrClass_ConfigurationHistory]
reference_type=RELATIVE
reference_contentbasepath='c:¥dir01¥userdir'
reference_deleterootpath='c:¥dir01¥userdir'

[usrClass_ConfigurationHistory]
reference_type=RELATIVE
reference_contentbasepath='C:¥drv01¥dir01¥data2'
reference_deleterootpath='C:¥drv01¥dir01¥data2'

[usrClass_ConfigurationHistory]
reference_type=RELATIVE
reference_contentbasepath='C:¥drv01¥dir01¥data3'
reference_deleterootpath='C:¥drv01¥dir01¥data3'

4.　コマンド実行ログと障害対策

この章では，オブジェクト操作ツールで出力するコマンド実行ログと，オブジェクト操作ツールの障害対策について説明します。

＜この章の構成＞

4.1　コマンド実行ログ

4.2　障害対策

4.1　コマンド実行ログ

オブジェクト操作ツールでは，セッションの確立・切断，およびオブジェクト操作情報をコマンド実行ログとして出力できます。

＜この節の構成＞

4.1.1　コマンド実行ログの制御

4.1.2　出力レベル

4.1.3　出力先ディレクトリおよびファイル

4.1.4　ログの出力形式と出力ログ情報

4.1.5　出力例

4.1.1　コマンド実行ログの制御

コマンド実行ログがどのように出力されるかはオブジェクト操作ツールの実行環境に依存します。オブジェクト操作ツール全体でコマンド実行ログの出力を制御することはできません。コマンド実行ログの出力はオブジェクト操作ツール実行下の実行環境制御ファイルの記述によって制御されます。

4.1.2　出力レベル

実行環境制御ファイルで，LogセクションのLevelエントリに指定した出力レベルによってコマンド実行ログに出力する情報量を調節します。出力レベルによる出力ログ情報を次の表に示します。

表4-1　出力レベルによる出力ログ情報

出力レベル
出力ログ情報

None
出力なし

Write

セッションの確立・切断

オブジェクトの作成・削除

バージョンの削除

全文検索インデクスの作成・削除

プロパティの設定

コンテインメントによるオブジェクト間の関連づけと関連づけの解除

構成管理モードの設定

コンテナのバージョンアップ

ファイルのアップロード

パブリックACLのバインド・アンバインド

レンディションの追加・削除

マスタレンディションの変更

Read

出力レベルが「Write」のときに出力される情報

プロパティの取得

ファイルのダウンロードまたは取得

一覧の取得

問い合わせの実行および結果の取得

レンディション一覧の取得

Error

出力レベルが「Read」のときに出力される情報

エラー

4.1.3　出力先ディレクトリおよびファイル

コマンド実行ログは，実行環境制御ファイルのLogセクションに定義されている内容に従って出力されます。

＜この項の構成＞

(1)　出力先ディレクトリ

(2)　出力先ファイル

(1)　出力先ディレクトリ

Directoryエントリに指定したディレクトリです。コマンド実行ログを出力しようとしたディレクトリが存在しない場合はエラーメッセージが出力されてコマンド実行ログは出力されません。オブジェクト操作ツール実行前にディレクトリが存在することを確認してください。

(2)　出力先ファイル

Prefixエントリに指定したプリフィックスを持つ次のファイルに出力します。

<出力ファイル名プリフィックス>_NO.log

「NO」は出力ファイル通番を示します。出力ファイル通番とは，１～FileCountエントリに指定した数（出力ファイル数）です。

コマンド実行ログは，出力ファイル通番が「1」のファイルから順番に出力されます。あるファイルにコマンド実行ログを出力しようとしたときに，ファイルサイズがLogセクションのFileSizeエントリに指定した出力ファイルサイズより大きくなってしまう場合，出力ファイル通番が一つ大きいファイルに出力します。例えば，出力ファイル通番が「1」であるファイルに出力する場合，このファイルのサイズの最大量を超えてしまう場合は，ファイル出力通番が「2」のファイルにログを出力します。

FileCountエントリに指定したファイル数と等しいファイルにログを出力しようとして，そのファイルのファイルサイズもFileSizeエントリに指定した出力ファイルサイズより大きくなってしまう場合，出力ファイル通番が「1」のファイルを初期化してログの出力を継続します。

4.1.4　ログの出力形式と出力ログ情報

＜この項の構成＞

(1)　実行ログの出力形式

(2)　出力ログ情報

(1)　実行ログの出力形式

コマンド実行ログは，次の形式で出力します。

コマンドの実行日時△コマンド名△プロセスID△ログ情報

コマンドの実行日時
コマンドの実行日時を「YYYY/MM/DD△hh/mm/ss」の形式で出力します。

コマンド名
実行したコマンド名を出力します。

プロセスID
実行したコマンドのプロセスIDを16進数で出力します。

ログ情報
実行した操作に対応するログ情報を出力します。詳細は，「(2)　出力ログ情報」を参照してください。

(2)　出力ログ情報

操作に対応する出力ログ情報を次の表に示します。

表4-2　操作に対応する出力ログ情報

操作
出力ログ情報
出力レベル

エラー
ERROR
E

オブジェクトの作成
CREATE OBJECT <オブジェクト種別> <OIID>
W，R，E

オブジェクトの削除
DELETE OBJECT <オブジェクト種別> <OIID>
W，R，E

オブジェクトを包含するコンテナ一覧の取得
LIST PARENTS <コンテインメントの種別> <オブジェクト種別> <OIID>
R，E

オブジェクト間の関連づけの解除（コンテインメントの解除）
次のどちらかが出力されます。

UNLINK <コンテインメントの種別> <包含するオブジェクト種別> <包含するオブジェクトのOIID> <包含するオブジェクトのバージョン識別子> <包含されるオブジェクト種別> <包含されるオブジェクトのOIID>

UNLINK <リンク識別子> <包含するオブジェクトのOIID>

W，R，E

オブジェクト間の関連づけの設定（コンテインメントの設定）
LINK <コンテインメントの種別> <構成管理モード種別> <包含するオブジェクト種別> <包含するオブジェクトのOIID> <包含するオブジェクトのバージョン識別子> <包含されるオブジェクト種別> <包含されるオブジェクトのOIID> <包含されるオブジェクトのバージョン識別子>
W，R，E

構成管理モードの設定
次のどれかが出力されます。

SET MODE <構成管理モード種別> <包含するオブジェクト種別> <包含するオブジェクトのOIID> <包含するオブジェクトのバージョン識別子> <包含されるオブジェクト種別> <包含されるオブジェクトのOIID> <包含されるオブジェクトのバージョン識別子>

SET MODE <構成管理モード種別> <リンク識別子> <包含するオブジェクト種別> <包含するオブジェクトのOIID> <包含されるオブジェクトのバージョン識別子>

W，R，E

コンテナに包含されるオブジェクト一覧の取得
LIST CHILDREN <コンテインメントの種別> <オブジェクト種別> <OIID><バージョン識別子>
R，E

コンテナのバージョンアップ
VERSION UP <オブジェクト種別> <OIID>
W，R，E

コンテント一覧の取得
LIST CONTENTS <オブジェクト種別> <OIID> <バージョン識別子> <レンディションタイプ>
R，E

セッションの確立
CONNECT <文書空間ID> <ユーザ名>
W，R，E

セッションの切断
DISCONNECT
W，R，E

全文検索インデクスの作成
CREATE INDEX <オブジェクト種別> <OIID> <バージョン識別子>
W，R，E

全文検索インデクスの削除
DELETE INDEX <オブジェクト種別> <OIID> <バージョン識別子>
W，R，E

バージョンの削除
DELETE VERSION <オブジェクト種別> <OIID> <バージョン識別子>
W，R，E

問い合わせの実行
EXECUTE SEARCH
R，E

問い合わせ結果の取得
GET RESULT
R，E

バージョン一覧の取得
LIST VERSIONS <オブジェクト種別> <OIID>
R，E

バージョン管理情報一覧の取得
LIST VERSIONABLES <オブジェクト種別> <OIID>
R，E

バインドされているオブジェクト一覧の取得
LIST OBJECTS <オブジェクト種別> <OIID>
R，E

バインドしているパブリックACL一覧の取得
LIST ACLS <オブジェクト種別> <OIID> <バージョン識別子>
R，E

パブリックACLのアンバインド
UNBIND ACLS <オブジェクト種別> <OIID> <バージョン識別子>
W，R，E

パブリックACLのバインド
BIND ACLS <オブジェクト種別> <OIID> <バージョン識別子>
W，R，E

マスタレンディションの変更
CHANGE MASTER RENDITION <オブジェクト種別> <OIID> <バージョン識別子> <レンディションタイプ>
W，R，E

ファイルのアップロード
UPLOAD CONTENT <オブジェクト種別> <OIID> <バージョン識別子><レンディションタイプ>
W，R，E

ファイルのダウンロード
DOWNLOAD CONTENT <オブジェクト種別> <OIID> <バージョン識別子><レンディションタイプ>
R，E

プロパティの取得
次のどちらかが出力されます。

GET PROPERTIES <オブジェクト種別> <OIID> <バージョン識別子>

GET PROPERTIES <リンク識別子> <オブジェクト種別> <OIID>

R，E

プロパティの設定
次のどちらかが出力されます。

SET PROPERTIES <オブジェクト種別> <OIID> <バージョン識別子>

SET PROPERTIES <リンク識別子> <オブジェクト種別> <OIID>

W，R，E

レンディション一覧の取得
LIST RENDITIONS <オブジェクト種別> <OIID> <バージョン識別子>
R，E

レンディションの削除
DELETE RENDITION <オブジェクト種別> <OIID> <バージョン識別子> <レンディションタイプ>
W，R，E

レンディションの追加
ADD RENDITION <オブジェクト種別> <OIID> <バージョン識別子> <レンディションタイプ>
W，R，E

（凡例）　W：Write　R：Read　E：Error

出力される情報について説明します。

オブジェクト種別

操作したオブジェクトのオブジェクト種別です。オブジェクト種別と出力文字の対応については，「1.3.2　クラスライブラリとの関係」を参照してください。

OIID

操作したオブジェクトのOIIDです。

バージョン識別子

操作対象となったオブジェクトのバージョンに対する情報です。操作対象となったオブジェクトのバージョンと出力文字の対応を次の表に示します。

表4-3　操作対象となったオブジェクトのバージョンと出力文字の対応

操作内容 | 出力文字
最新バージョンに対する操作 | latest
バージョンアップを伴う操作 | versionup
バージョントレースしているオブジェクトに対する操作 | traced
バージョンなしオブジェクトに対する操作 | 出力なし
バージョン全体に対する操作 | 出力なし

コンテインメントの種別

設定，解除したコンテインメントの種別です。コンテインメントの種別と出力文字の対応を次の表に示します。

表4-4　コンテインメントの種別と出力文字の対応

コンテインメントの種別 | 出力文字
直接型のコンテインメント | DCR
参照型のコンテインメント | RCR
構成管理型のコンテインメント | VCR
すべてのコンテインメント | ALL

包含するオブジェクトのOIID

オブジェクト間の関連づけ（コンテインメント）を設定，解除した場合の，オブジェクトを包含するオブジェクト（コンテナ）のOIIDです。

包含されるオブジェクトのOIID

オブジェクト間の関連づけ（コンテインメント）を設定，解除した場合の，オブジェクトに包含されるオブジェクトのOIIDです。

構成管理モード種別

構成管理型のコンテインメントの設定時，または構成管理モードの設定時の構成管理モード種別です。構成管理モードと出力文字の対応を次の表に示します。

表4-5　構成管理モードの種別と出力文字の対応

構成管理モード種別 | 出力文字
FLOATINGモード | FLOATING
FIXモード | FIX
コンテインメント種別が直接型または参照型の場合 | 出力なし

リンク識別子

コンテインメントを解除した，または構成管理モードを設定したコンテインメントのリンク識別子です。

包含するオブジェクトのバージョン識別子

コンテインメントを設定した対象である包含するオブジェクト（コンテナ）のバージョン識別子です。操作に対応する出力文字については，表4-3を参照してください。

包含されるオブジェクトのバージョン識別子

コンテインメントを設定したり，構成管理モードのFIXモードを設定したりした，包含されるオブジェクトのバージョン識別子です。構成管理モードのFLOATINGモードを設定した時には出力されません。操作に対応する出力文字については，表4-3を参照してください。

文書空間ID

実行環境制御ファイルで，SessionセクションのDocSpaceIdエントリに指定した値です。

ユーザ名

実行環境制御ファイルで，SessionセクションのUserNameエントリに指定した値です。

レンディションタイプ

操作したレンディションのレンディションタイプです。レンディションタイプを指定しないで操作した場合は出力されません。

4.1.5　出力例

出力レベルにErrorを指定した場合のコマンド実行ログの出力例を次に示します。セッションを確立するまでにエラーが発生した場合，セッションの確立・切断の情報は出力されません。また，オブジェクトを操作するときの情報は，操作が正常に終了した場合だけ出力されます。エラーが発生すると，オブジェクトを操作したときの情報は，エラー情報に置き換えられて出力されます。

4.2　障害対策

ここでは，オブジェクト操作ツールの障害対策について説明します。

＜この節の構成＞

4.2.1　エラーが発生したときのオブジェクト操作ツールの動作

4.2.2　メッセージ

4.2.3　トレースファイル

4.2.4　詳細エラーログファイル

4.2.1　エラーが発生したときのオブジェクト操作ツールの動作

コマンド実行中にエラーが発生すると，操作が終了していないオブジェクトに対する処理は無効になります。

例として，A，B，Cという三つのバージョンなしコンテナを作成する場合について説明します。三つのバージョンなしコンテナを作成するためには，dmaClass_Container用プロパティ情報ファイルを用意して，dbrcrtcntrを実行します。このとき，Cのコンテナ作成中にエラーが発生するとA，Bのコンテナは作成されますがCのコンテナは作成されません。

三つのバージョンなしコンテナを作成するときのエラーの発生時期と出力情報の例を次の図に示します。なお，この図はWindowsの場合の例です。UNIXの場合の出力情報の例については，図中の注を参照してください。

図4-1　バージョンなしコンテナを作成するときの，エラーの発生時期と出力情報の例（Windowsの場合）

環境変数を表示します。
環境変数「DBR_DETAIL_ERRORLOG」の設定を確認します。この例の場合，「ON」が設定されているため，詳細メッセージが標準エラー出力および詳細エラーログファイルに出力されることがわかります。

プロパティ情報ファイルを表示します。
コンテナを作成するときに指定するプロパティ情報ファイルの内容を表示します。この例で指定するのは，三つのバージョンなしコンテナを作成するためのdmaClass_Container用プロパティ情報ファイルです。ただし，三つ目のコンテナ用のプロパティ情報は，セクション名が正しくありません。

dbrcrtcntrコマンドを実行して，コンテナを作成します。

一つ目のコンテナが作成され，コンテナのOIIDが出力されます。

二つ目のコンテナが作成され，コンテナのOIIDが出力されます。

三つ目のコンテナ作成時に，エラーが発生したため，詳細メッセージが出力されます。

三つ目のコンテナ作成時にエラーが発生したことを示す，オブジェクト操作ツールのエラーメッセージが出力されます。

ファイル内容を確認します。

詳細メッセージが出力された詳細エラーログファイル名が出力されます。この例は，詳細エラーログファイル出力ディレクトリを示す環境変数「DBR_DETAIL_ERRORLOG_DIR」を指定していない場合です。

トレースファイル名が出力されます。この例は，トレースファイルをカレントディレクトリに出力した場合です。トレースファイルの出力先の指定については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

ただし，コマンド実行ログを出力するときにエラーが発生した場合，コマンド実行ログの出力は行われませんが，オブジェクトの操作は完了しているのでコマンドの処理自体は無効になりません。

4.2.2　メッセージ

エラーが発生すると，メッセージを標準エラー出力に出力します。また，環境変数「DBR_DETAIL_ERRORLOG」に「ON」が設定されている場合には，詳細メッセージも標準エラー出力に出力します。発生したエラーには，これらのメッセージの内容に従って対処してください。メッセージの詳細については，マニュアル「DocumentBroker Version 3　メッセージ」を参照してください。

4.2.3　トレースファイル

コマンドの実行ごとにトレースファイルが作成されます。不要なトレースファイルはディスク容量を圧迫するので削除してください。トレースファイルの詳細については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

4.2.4　詳細エラーログファイル

環境変数「DBR_DETAIL_ERRORLOG」に「ON」が設定されている場合，詳細メッセージは詳細エラーログファイルにも出力されます。詳細エラーログファイルについては，マニュアル「DocumentBroker Version 3　クラスライブラリ　C++　解説」を参照してください。

5.　コマンドリファレンス

この章では，オブジェクト操作ツールのコマンドについて説明します。

＜この章の構成＞

実行コマンド一覧

コマンド形式

コマンド実行結果

dbrbind（パブリックACLのバインド）

dbrcrtacl（パブリックACLの作成）

dbrcrtcntr（コンテナの作成）

dbrcrtdata（独立データの作成）

dbrcrtdoc（文書の作成）

dbrcrtidx（全文検索インデクスの作成）

dbrdelacl（パブリックACLの削除）

dbrdelcntr（コンテナの削除）

dbrdeldata（独立データの削除）

dbrdeldoc（文書の削除）

dbrdelidx（全文検索インデクスの削除）

dbrdowndoc（文書のダウンロード）

dbrexquery（問い合わせの実行）

dbrgetprop（プロパティの取得）

dbrlink（オブジェクト間の関連づけ）

dbrlsacl（バインドしているパブリックACL一覧またはバインドされているオブジェクト一覧の取得）

dbrlschild（コンテナに包含されるオブジェクト一覧の取得）

dbrlscompo（マルチファイル文書のコンテント情報一覧の取得）

dbrlsparent（オブジェクトを包含するコンテナ一覧の取得）

dbrlsversion（バージョン一覧の取得）

dbrlsversionable（バージョン管理情報一覧の取得）

dbrrndrdoc（文書のレンディション操作）

dbrsetmode（構成管理モードの設定）

dbrsetprop（プロパティの設定）

dbrtoolsetup（実行環境のセットアップ）

dbrunbind（パブリックACLのアンバインド）

dbrunlink（オブジェクト間の関連づけの解除）

dbrupcntr（コンテナのバージョンアップ）

dbrupdoc（文書のアップロード）

リファレンスファイル管理機能を使用する場合のオブジェクトの削除

実行コマンド一覧

ここでは，オブジェクト操作ツールが提供する実行コマンドの一覧を示します。

実行コマンド一覧

オブジェクト操作ツールが提供する実行コマンドの一覧を次の表に示します。

なお，文書空間の文字コード種別にUTF-8を指定している場合，使用できるコマンドに制限があります。詳細については，「付録B　文書空間で使用する文字コード種別がUTF-8の場合のサポート範囲」を参照してください。

表5-1　オブジェクト操作ツールが提供する実行コマンドの一覧

コマンド名 | 機能
dbrbind | パブリックACLのバインド
dbrcrtacl | パブリックACLの作成
dbrcrtcntr | コンテナの作成
dbrcrtdata | 独立データの作成
dbrcrtdoc | 文書の作成
dbrcrtidx | 全文検索インデクスの作成
dbrdelacl | パブリックACLの削除
dbrdelcntr | コンテナの削除
dbrdeldata | 独立データの削除
dbrdeldoc | 文書の削除
dbrdelidx | 全文検索インデクスの削除
dbrdowndoc | 文書のダウンロード
dbrexquery | 問い合わせの実行
dbrgetprop | プロパティの取得
dbrlink | オブジェクト間の関連づけ
dbrlsacl | バインドしているパブリックACL一覧またはバインドされているオブジェクト一覧の取得
dbrlschild | コンテナに包含されるオブジェクト一覧の取得
dbrlscompo | マルチファイル文書のコンテント情報一覧の取得
dbrlsparent | オブジェクトを包含するコンテナ一覧の取得
dbrlsversion | バージョン一覧の取得
dbrlsversionable | バージョン管理情報一覧の取得
dbrrndrdoc | 文書のレンディション操作
dbrsetmode | 構成管理モードの設定
dbrsetprop | プロパティの設定
dbrtoolsetup | 実行環境のセットアップ
dbrunbind | パブリックACLのアンバインド
dbrunlink | オブジェクト間の関連づけの解除
dbrupcntr | コンテナのバージョンアップ
dbrupdoc | 文書のアップロード

コマンド形式

ここでは，実行コマンドの入力形式について説明します。

入力形式

コマンドの入力形式を次に示します。

コマンド名　オプション　コマンド引数

コマンド名

コマンド名には，実行するコマンドのファイル名を指定します。

オプション

オプションの記述形式を次に示します。説明で使用する「$」は，UNIXの場合はシェルプロンプト，Windowsの場合はコマンドプロンプトを表しています。また，「cmd」はコマンド名を表しています。

オプションの形式

オプションはマイナス（-）で始まる文字列で，コマンド行には一つまたは複数のオプションを指定できます。オプションの形式は，次に示すように引数を取らないかまたは1個の引数を取ります。

形式1：－オプションフラグ

形式2：－オプションフラグ＜空白またはタブ＞オプションの引数

オプションフラグ
1文字の英字です。大文字と小文字は区別されます。

オプションの引数
オプションフラグに対する引数です。

オプションの指定規則

オプションの引数がないオプションフラグは，一つのマイナス（-）でまとめて指定できます。次の二つは同じ指定です。
$ cmd -a -b
$ cmd -ab

オプションの引数が必要なオプションフラグのオプションの引数は省略できません。

オプションフラグとオプションの引数の間には空白およびタブを指定しても指定しなくてもどちらでもかまいません。次の二つは同じ指定です。
$ cmd -a file
$ cmd -afile

オプションの引数に空白およびタブを含めて指定する場合は，前後をダブルクォート（"）で囲んでください。次に示す例は，オプションの引数として「1 2」を指定しています。
$ cmd -a "1 2"

同じオプションフラグを２回以上指定することはできません。次に示すような指定はエラーとなります。
$ cmd -a file1 -a file2

二つのマイナス（--）はオプションの最後を示す区切り記号とみなします。したがって，次に示す例では「-b」をコマンド引数とみなします。
$ cmd -a -- -b

マイナス（-）だけのオプションは入力できません。例えば，「$ cmd -」と入力すると，マイナス（-）をコマンド引数とみなします。

オプションはコマンド引数より前に指定してください。次に示す例で，-aがオプションの引数を必要としない場合，「file」および「-b」をコマンド引数とみなします。
$ cmd - a file -b

コマンド引数

コマンド引数は，コマンド操作の直接の対象となるものを指定します。指定するコマンド引数は，各コマンドによって異なります。

詳細は各コマンドの説明を参照してください。

オプションおよびコマンド引数に指定する内容について

オプションおよびコマンド引数に，パス，識別子，ファイル，レンディションタイプなどを指定する場合の記述形式を次に示します。必要に応じてマニュアルまたは記述個所を参照して，指定してください。

オプションフラグの引数にOIIDファイルやダウンロードファイルURLなどのパスを指定する場合，パスは印刷可能なASCIIコードで記述してください。

OIIDを指定する場合の記述形式については，「付録A　OIID指定時のURLの文法」を参照してください。

OIIDファイル，バージョン識別子ファイル，リンク識別子ファイルなど，IDファイルの記述形式については，「3.4　IDファイル」を参照してください。

プロパティ情報ファイルを指定する場合の記述形式については，「3.5　プロパティ情報ファイル」を参照してください。

問い合わせファイルを指定する場合の記述形式については，「3.6　問い合わせファイル」を参照してください。

レンディションタイプを指定する場合の記述形式については，マニュアル「DocumentBroker Version 3　クラスライブラリ　C++　解説」を参照してください。

コマンド実行結果

ここでは，戻り値と実行結果について説明します。

戻り値

戻り値は，オブジェクト操作ツールのすべてのコマンドで共通です。コマンドの終了状態によって，次の表に示す値を返却します。

表5-2　戻り値一覧

戻り値 | 意味
0 | 正常終了
1 | 警告つき正常終了
2 | 引数不正による異常終了
上記以外 | そのほかの異常終了

実行結果

実行結果は１オブジェクトにつき1行で標準出力に出力されます。

各項目はコンマ（,）で区切って出力されます。

エラーメッセージは標準エラー出力に出力されます。

実行環境制御ファイルで，OutputセクションのFormatエントリに指定した値によって，出力情報が異なります。Formatエントリに「VR0112」を指定した場合は，Version 1のオブジェクト操作ツールでの出力情報と同じ形式で出力されます。Formatエントリの指定を省略した場合，または「VR0200」を指定した場合は，リンク識別子などの情報が新たに追加された形式で出力されます。
それぞれの場合の出力形式の詳細は，各コマンドの実行例を参照してください。

dbrbind（パブリックACLのバインド）

機能

オブジェクトにパブリックACLをバインドします。

操作クラス

バインドするオブジェクト

CdbrIndependentPersistenceクラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

バインドされるオブジェクト

CdbrPublicACLクラス

形式

dbrbind 〔 -v { バージョン識別子 | バージョン識別子ファイル} 〕

　　　　{ OIID | OIIDファイル }

　　　　{ パブリックACL OIID | パブリックACL OIIDファイル }

オプション

-v　{ バージョン識別子 | バージョン識別子ファイル}

バージョン付き文書またはバージョン付き構成管理コンテナの場合，バインドするバージョンのバージョン識別子を指定します。このオプションを省略した場合は，オブジェクト自身にバインドされます。

バージョン付き文書およびバージョン付き構成管理コンテナ以外の場合にこのオプションを指定するとエラーになります。

バージョン識別子

バインドするバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

バインドするバージョン識別子を記述したファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

コマンド引数

OIID

バインドするオブジェクトのOIIDを指定します。

OIIDファイル

バインドするオブジェクトのOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

パブリックACL OIID

バインドされるパブリックACLのOIIDを指定します。

パブリックACLファイル

バインドされるパブリックACLのOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

注意事項

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

すでにバインドされているパブリックACLをバインドしようとすると，実行メソッドでエラーになります。

dbrcrtacl（パブリックACLの作成）

機能

プロパティ情報ファイルに記述された内容に従ってパブリックACLを作成します。プロパティ情報ファイルに複数のセクションを記述することで，複数のパブリックACLを一括して作成できます。

パブリックACLが作成されると，作成したパブリックACLのOIIDが標準出力に出力されます。

操作クラス

CdbrPublicACLクラス

形式

dbrcrtacl　edmClass_PublicACL用プロパティ情報ファイル

オプション

なし

コマンド引数

edmClass_PublicACL用プロパティ情報ファイル

作成するパブリックACLのedmClass_PublicACLクラスのクラス名および設定するプロパティを記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

プロパティ情報ファイルの記述例

パブリックACLを作成する場合の，edmClass_PublicACL用プロパティ情報ファイルの記述例を示します。

edmClass_PublicACL
[edmClass_PublicACL]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='PublicACL'

実行例

実行例を次に示します。なお，この例はWindowsの場合です。UNIXの場合は，「type PropACL」を「cat PropACL」に読み替えてください。

$ type PropACL
;; edmClass_PublicACL
[edmClass_PublicACL]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='PublicACL'

$ dbrcrtacl  PropACL
dma:///07a17522…00000000039
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

なし

dbrcrtcntr（コンテナの作成）

機能

プロパティ情報ファイルに記述された内容に従ってコンテナを作成します。プロパティ情報ファイルに複数のセクションを記述することで，複数のコンテナを一括して作成できます。

コンテナが作成されると，作成されたコンテナのOIIDが標準出力に出力されます。また，コンテインメントを設定した場合には，リンク識別子も標準出力に出力されます。

操作クラス

作成するオブジェクト

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

作成したオブジェクトを包含するオブジェクト

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

形式

バージョンなしコンテナの場合

dbrcrtcntr　-c RC　〔 -T { OIID | OIIDファイル } 〕

　　　　　　　　dmaClass_Container用プロパティ情報ファイル

バージョンなし構成管理コンテナの場合

dbrcrtcntr　-c VTC　〔 -T { OIID | OIIDファイル } 〕

　　　　　　　　edmClass_ContainerVersion用プロパティ情報ファイル

バージョン付き構成管理コンテナの場合

dbrcrtcntr　-c CRC　〔 -T { OIID | OIIDファイル } 〕

　　　　　　　　dmaClass_ConfigurationHistory用プロパティ情報ファイル

　　　　　　　　edmClass_ContainerVersion用プロパティ情報ファイル

オプション

-c {RC | VTC | CRC}

作成するコンテナの種類を指定します。このオプションは省略できません。

RC

バージョンなしコンテナを作成します。

VTC

バージョンなし構成管理コンテナを作成します。

CRC

バージョン付き構成管理コンテナを作成します。

-T { OIID | OIIDファイル }

既存のコンテナと作成したコンテナ間の包含関係を設定します。作成したコンテナが既存のコンテナに包含されます。OIIDを記述したOIIDファイルを指定することもできます。このオプションを省略した場合は，どのコンテナとも包含関係を設定しません。

なお，このオプションを指定した場合は，プロパティ情報ファイルにlinkエントリを必ず指定してください。

OIID

作成したコンテナと包含関係を設定するコンテナのOIIDを指定します。

OIIDファイル

作成したコンテナと包含関係を設定するコンテナのOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

コマンド引数

dmaClass_Container用プロパティ情報ファイル

作成するコンテナのdmaClass_Containerクラスのクラス名および設定するプロパティを記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

edmClass_ContainerVersion用プロパティ情報ファイル

作成するコンテナのedmClass_ContainerVersionクラスのクラス名および設定するプロパティを記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

dmaClass_ConfigurationHistory用プロパティ情報ファイル

作成するコンテナのdmaClass_ConfigurationHistoryクラスのクラス名および設定するプロパティを記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

バージョンなしコンテナを作成する場合のプロパティ情報ファイルの記述例

バージョンなしコンテナを作成する場合のdmaClass_Container用プロパティ情報ファイルの記述例を示します。

-Tオプションを指定しないでバージョンなしコンテナを作成する場合

[usrClass_Container]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Container'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}

-Tオプションを指定してバージョンなしコンテナを作成する場合

[usrClass_Container]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Container'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
link=DCR※

注※　linkエントリは必ず指定します。

バージョンなし構成管理コンテナを作成する場合のプロパティ情報ファイルの記述例

バージョンなし構成管理コンテナを作成する場合のedmClass_ContainerVersion用プロパティ情報ファイルの記述例を示します。

-Tオプションを指定しないでバージョンなし構成管理コンテナを作成する場合

[usrClass_ContainerVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Container'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}

-Tオプションを指定してバージョンなし構成管理コンテナを作成する場合

[usrClass_ContainerVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Container'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
link=DCR※

注※　linkエントリは必ず指定します。

バージョン付き構成管理コンテナを作成する場合のプロパティ情報ファイルの記述例

バージョン付き構成管理コンテナを作成する場合の，dmaClass_ConfigurationHistory用プロパティ情報ファイルおよびedmClass_ContainerVersion用プロパティ情報ファイルの記述例を示します。

-Tオプションを指定しないでバージョン付き構成管理コンテナを作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Container'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}

edmClass_ContainerVersion用プロパティ情報ファイルの記述例

[usrClass_ContainerVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

-Tオプションを指定してバージョン付き構成管理コンテナを作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Container'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
link=VCR※¹
mode=FLOATING※²

注※1　linkエントリは必ず指定します。

注※2　linkエントリにVCRを指定した場合，modeエントリは必ず指定します。

edmClass_ContainerVersion用プロパティ情報ファイルの記述例

[usrClass_ContainerVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

実行例

実行例を次に示します。なお，実行環境制御ファイルのOutputセクションのFormatエントリの指定，および指定したオプションによって，出力形式が異なります。

また，この例はWindowsの場合です。UNIXの場合は，「type PropRC」を「cat PropRC」に読み替えてください。

$ type PropRC
;; usrClass_Container
[usrClass_Container]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Container'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
link=RCR

（Formatエントリが「VR0112」の場合）
$ dbrcrtcntr  -c  RC  PropRC
dma:///07a17522…00000002
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

$ dbrcrtcntr  -c  RC  -T  dma:///07a1…0001  PropRC
dma:///07a17522…00000003
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

（Formatエントリが「VR0200」の場合）
$ dbrcrtcntr  -c  RC  PropRC
dma:///07a17522…00000004
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

$ dbrcrtcntr  -c  RC  -T  dma:///07a1…0001  PropRC
acl://LR…0005,dma:///07a17522…00000005
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

-Tオプションを指定する場合は，次のプロパティ情報ファイルの各セクションに，linkエントリを必ず記述してください。

バージョンなしコンテナを作成するとき
dmaClass_Container用プロパティ情報ファイル

バージョンなし構成管理コンテナを作成するとき
edmClass_ContainerVersion用プロパティ情報ファイル

バージョン付き構成管理コンテナを作成するとき
dmaClass_ConfigurationHistory用プロパティ情報ファイルまたはedmClass_ContainerVersion用プロパティ情報ファイル

エントリの記述がない場合はエラーになります。また，バージョン付き構成管理コンテナを作成する場合，両方のプロパティ情報ファイルにlinkエントリを指定すると，dmaClass_ConfigurationHistory用プロパティ情報ファイルの値が有効になります。

構成管理モードのコンテインメントを設定できるのは，バージョン付き構成管理コンテナ作成時に，-Tオプションのオプションの引数に構成管理コンテナのOIIDまたはOIIDファイルを指定した場合だけです。

linkエントリにVCRを指定した場合は，コマンド引数に指定するedmClass_ContainerVersion用プロパティ情報ファイルまたはdmaClass_ConfigurationHistory用プロパティ情報ファイルの各セクションにmodeエントリを必ず記述してください。エントリの記述がない場合には，エラーになります。また，両方のプロパティ情報ファイルにmodeエントリを指定すると，dmaClass_ConfigurationHistory用プロパティ情報ファイルの値が有効になります。

-Tオプションのオプションの引数にバージョン付き構成管理コンテナのOIIDまたはOIIDファイルを指定した場合は，最新バージョンのバージョン付き構成管理コンテナに包含されます。

バージョン付き構成管理コンテナを作成する時に指定したdmaClass_ConfigurationHistory用プロパティ情報ファイルとedmClass_ContainerVersion用プロパティ情報ファイルに記述したセクション数が同じでない場合，エラーになります。

dbrcrtdata（独立データの作成）

機能

プロパティ情報ファイルに記述された内容に従って独立データを作成します。プロパティ情報ファイルに複数のセクションを記述することで，複数の独立データを一括して作成できます。

独立データが作成されると，作成した独立データのOIIDが標準出力に出力されます。

操作クラス

CdbrIndependentPersistenceクラス

形式

dbrcrtdata　edmClass_IndependentPersistence用プロパティ情報ファイル

オプション

なし

コマンド引数

edmClass_IndependentPersistence用プロパティ情報ファイル

作成する文書のedmClass_IndependentPersistenceクラスのクラス名および設定するプロパティを記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

プロパティ情報ファイルの記述例

独立データを作成する場合のedmClass_IndependentPersistence用プロパティ情報ファイルの記述例を示します。

;; usrClass_IndependentPersistence
[usrClass_IndependentPersistence]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Independent'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}

実行例

実行例を次に示します。なお，この例はWindowsの場合です。UNIXの場合は，「type PropIP」を「cat PropIP」に読み替えてください。

$ type PropIP
;; usrClass_IndependentPersistence
[usrClass_IndependentPersistence]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Independent'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}

$ dbrcrtdata  PropIP
dma:///07a17522…00000006
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

なし

dbrcrtdoc（文書の作成）

機能

プロパティ情報ファイルに記述された内容に従って文書を作成します。プロパティ情報ファイルに複数のセクションを記述することで，複数の文書を一括して作成できます。

文書が作成されると，作成された文書のOIIDが標準出力に出力されます。コンテインメントを設定した場合には，リンク識別子も標準出力に出力されます。

操作クラス

作成するオブジェクト

CdbrDocumentクラス

CdbrVersionableDocumentクラス

作成したオブジェクトを包含するオブジェクト

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

形式

バージョンなし文書の場合

dbrcrtdoc　-c　D　〔-I〕

　　　　　　〔 -T { リンク先OIID | リンク先OIIDファイル } 〕

　　　　　　〔 -k { Content | MultiContent | FileLink | Reference } 〕

　　　　　　dmaClass_DocVersion用プロパティ情報ファイル

バージョン付き文書の場合

dbrcrtdoc　-c VD　〔-I〕

　　　　　　〔 -T { リンク先OIID | リンク先OIIDファイル } 〕

　　　　　　〔 -k { Content | MultiContent | FileLink | Reference } 〕

　　　　　　dmaClass_ConfigurationHistory用プロパティ情報ファイル

　　　　　　dmaClass_DocVersion用プロパティ情報ファイル

オプション

-c { D | VD }

作成する文書の種類を指定します。このオプションは省略できません。

D

バージョンなし文書を作成します。

VD

バージョン付き文書を作成します。

-I

全文検索インデクスを作成しない場合に指定します。シングルファイル文書を作成する場合，このオプションを省略していて，かつ作成する文書が次の条件を満たしているとき，プロパティ情報ファイルのurlエントリに指定したファイルから，全文検索インデクスが作成されます。

dmaClass_DocVersion用プロパティ情報ファイルのセクション名に，全文検索機能付き文書クラスを記述している。

指定したMIME名の先頭が「text/」である。

なお，マルチファイル文書，File Link文書，またはリファレンスファイル文書の場合は，このオプションを省略しても全文検索インデクスは作成されません。

-T { リンク先OIID | リンク先OIIDファイル }

作成した文書とコンテナ間の包含関係を設定します。リンク先OIIDを記述したリンク先OIIDファイルを指定することもできます。このオプションを省略した場合は，作成した文書はどのコンテナにも包含されません。

なお，このオプションを指定した場合は，プロパティ情報ファイルにlinkエントリを必ず指定してください。

リンク先OIID

作成した文書を包含するコンテナのリンク先OIIDを指定します。

リンク先OIIDファイル

作成した文書を包含するコンテナのリンク先OIIDを記述したリンク先OIIDファイルのファイルパスを指定します。

リンク先OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，リンク先OIIDファイルに記述できるOIIDの数は一つだけです。

-k { Content | MultiContent | FileLink | Reference }

作成する文書のコンテント種別を指定します。このオプションを指定した場合，プロパティ情報ファイルの指定が，このオプションの指定と一致していないとエラーになります。このオプションを省略した場合，プロパティ情報ファイルの指定に従ってコンテントを登録します。

Content

シングルファイル文書を作成します。プロパティ情報ファイルのurlエントリに指定されたファイルを，データベースに登録します。

MultiContent

マルチファイル文書を作成します。プロパティ情報ファイルのdirectoryエントリに指定したディレクトリ下の全ファイルか，filesエントリに指定されたファイルをデータベースに登録します。

FileLink

File Link文書を作成します。

Reference

リファレンスファイル文書を作成します。コンテントをファイルシステム上の領域に格納し，コンテントの格納先を示す情報をデータベースで管理します。

オプション省略時

プロパティ情報ファイルのurlエントリ，またはdirectoryエントリの指定に従ってコンテントを登録します。この場合，コンテントはデータベースに登録します。

urlエントリが指定されている場合
シングルファイル文書を作成します。

directoryエントリが指定されている場合
マルチファイル文書を作成します。

コマンド引数

dmaClass_ConfigurationHistory用プロパティ情報ファイル

作成する文書のdmaClass_ConfigurationHistoryクラスのクラス名および設定するプロパティを記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

dmaClass_DocVersion用プロパティ情報ファイル

作成する文書のdmaClass_DocVersionクラスのクラス名および設定するプロパティを記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

バージョンなし文書を作成する場合のプロパティ情報ファイルの記述例

バージョンなし文書を作成する場合は，コマンド引数としてdmaClass_DocVersion用プロパティ情報ファイルを指定します。次に，dmaClass_DocVersion用プロパティ情報ファイルの記述例を示します。なお，この例はWindowsの場合です。UNIXの場合は，urlエントリを「url='file:///tmp/create.doc'」のように指定してください。

-Tオプションを指定しないで，マルチファイル文書を作成する場合

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
directory='file:///c:¥temp'※
files[2]=
{
{edmProp_RetrievalName='foo',edmProp_ComponentType='body'},
{edmProp_RetrievalName='bar',edmProp_ComponentType='fig-1'}
}
mime='application/x-edm-undefined'※

注※　directoryエントリおよびmimeエントリは必ず指定します。

-Tオプションを指定しないで，シングルファイル文書を作成する場合

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
url='file:///c:¥temp¥create.doc'※
mime='text/plain'※

注※　urlエントリおよびmimeエントリは必ず指定します。

-Tオプションを指定して，マルチファイル文書を作成する場合

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
link=RCR※
directory='file:///c:¥temp'※
files[2]=
{
{edmProp_RetrievalName='foo',edmProp_ComponentType='body'},
{edmProp_RetrievalName='bar',edmProp_ComponentType='fig-1'}
}
mime='application/x-edm-undefined'※

注※　linkエントリ，directoryエントリおよびmimeエントリは必ず指定します。

-Tオプションを指定して，シングルファイル文書を作成する場合

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
link=RCR※
url='file:///c:¥temp¥create.doc'※
mime='text/plain'※

注※　linkエントリ，urlエントリおよびmimeエントリは必ず指定します。

バージョン付き文書を作成する場合のプロパティ情報ファイルの記述例

バージョン付き文書を作成する場合は，コマンド引数としてdmaClass_ConfigurationHistory用プロパティ情報ファイルおよびdmaClass_DocVersion用プロパティ情報ファイルを指定します。次に，各プロパティ情報ファイルの記述例を示します。なお，この例は，Windowsの場合です。UNIXの場合は，urlエントリを「url='file:///tmp/create.doc'」または「url='file:///tmp/create.txt'」，filelink_contentpathエントリを「filelink_contentpath='DATA/area1/'」または「filelink_contentpath='DATA/area1/file.jpg'」，reference_contentbasepathエントリを「reference_contentbasepath='/drv01/dir01/userdir'」のように指定してください。

-Tオプションを指定しないで，マルチファイル文書を作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
directory='file:///c:¥temp'※
files[2]=
{
{edmProp_RetrievalName='foo',edmProp_ComponentType='body'},
{edmProp_RetrievalName='bar',edmProp_ComponentType='fig-1'}
}
mime='application/x-edm-undefined'※

注※　directoryエントリおよびmimeエントリは必ず指定します。

dmaClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

-Tオプションを指定しないで，シングルファイル文書を作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
url='file:///c:¥temp¥create.doc'※
mime='text/plain'※

注※　urlエントリおよびmimeエントリは必ず指定します。

dmaClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

-Tオプションを指定して，マルチファイル文書を作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
link=RCR※
directory='file:///c:¥temp'※
files[2]=
{
{edmProp_RetrievalName='foo',edmProp_ComponentType='body'},
{edmProp_RetrievalName='bar',edmProp_ComponentType='fig-1'}
}
mime='application/x-edm-undefined'※

注※　linkエントリ，directoryエントリおよびmimeエントリは必ず指定します。

dmaClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

-Tオプションを指定して，シングルファイル文書を作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
link=RCR※
url='file:///c:¥temp¥create.doc'※
mime='text/plain'※

注※　linkエントリ，urlエントリおよびmimeエントリは必ず指定します。

dmaClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

-Tオプションを指定しないで，File Link文書をクライアントのコンテントを使用して作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
url='file:///c:¥temp¥create.txt'※1
mime='text/plain'※1
filelink_famname='fam01'※2
filelink_contentpath='DATA¥area1¥'※3

注※1　urlエントリおよびmimeエントリは必ず指定します。

注※2　実行環境制御ファイルのFileLinkセクションにDefaultFAMNameエントリの指定がない場合は必ず指定します。

注※3　実行環境制御ファイルのFileLinkセクションにDefaultContentPathエントリの指定がない場合は，必ず指定します。

dmaClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

-Tオプションを指定して，File Link文書をファイルサーバ上のコンテントを使用して作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
link=RCR※1
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki',usrProp_Age=27},
  {usrProp_Name='yamada',usrProp_Age=30},
  {usrProp_Name='sato',usrProp_Age=32}
}
url=DBRSVCONTENT※1
mime='text/plain'※1
filelink_famname='fam01'※2
filelink_contentpath='DATA¥area1¥file.jpg'※1

注※1　linkエントリ，urlエントリ，mimeエントリおよびfilelink_contentpathエントリは必ず指定します。urlエントリには，「DBRSVCONTENT」を指定します。filelink_contentpathエントリには，登録するファイルサーバ上のコンテントのパスを指定します。

注※2　実行環境制御ファイルのFileLinkセクションにDefaultFAMNameエントリの指定がない場合は，必ず指定します。

dmaClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

-Tオプションを指定しないでリファレンスファイル文書を作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
url='file:///c:¥temp¥create.doc'※¹
mime=' MIME::application/x-edm-undefined'※¹
reference_type=RELATIVE※²
reference_contentbasepath='c:¥dir01¥data'※³
reference_contentpath='user01'

注※1　urlエントリおよびmimeエントリは必ず指定します。

注※2　実行環境制御ファイルのReferenceセクションにDefaultReferenceTypeエントリの指定がない場合は，必ず指定します。

注※3　reference_typeの指定が「RELATIVE」で，実行環境制御ファイルのReferenceセクションにDefaultContentBasePathエントリの指定がない場合は，必ず指定します。

dmaClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

-Tオプションを指定してリファレンスファイル文書を作成する場合

dmaClass_ConfigurationHistory用プロパティ情報ファイルの記述例

;; usrClass_ConfigurationHistory
[usrClass_ConfigurationHistory]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
usrProp_Authors[3][2]=
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32}
}
link = RCR※¹
url='file:///c:¥temp¥create.doc'※¹
mime='MIME::application/x-edm-undefined'※¹
reference_type=RELATIVE※²
reference_contentbasepath='c:¥dir01¥data'※³
reference_contentpath='user01'

注※1　linkエントリ，urlエントリおよびmimeエントリは必ず指定します。

注※2　実行環境制御ファイルのReferenceセクションにDefaultReferenceTypeエントリの指定がない場合は，必ず指定します。

注※3　reference_typeの指定が「RELATIVE」で，実行環境制御ファイルのReferenceセクションにDefaultContentBasePathエントリの指定がない場合は，必ず指定します。

dmaClass_DocVersion用プロパティ情報ファイルの記述例

;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Version'

実行例

実行例を次に示します。なお，実行環境制御ファイルのOutputセクションのFormatエントリの指定，および指定したオプションによって，出力形式が異なります。

また，この例はWindowsの場合です。UNIXの場合は，「type PropDV」を「cat PropDV」に，「url='file:///c:¥temp¥create.txt'」を「url='file:///tmp/create.txt'」に読み替えてください。

$ type PropDV
;; usrClass_DocVersion
[usrClass_DocVersion]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Document'
link=RCR
url='file:///c:¥temp¥create.txt'
mime='text/plain'

（Formatエントリが「VR0112」の場合）
$ dbrcrtdoc  -c  D  PropDV
dma:///07a17522…00000008
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

$ dbrcrtdoc  -c  D  -T  dma:///07a1…0007  PropDV
dma:///07a17522…00000009
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

（Formatエントリが「VR0200」の場合）
$ dbrcrtdoc  -c  D  PropDV
dma:///07a17522…00000010

$ dbrcrtdoc  -c  D  -T  dma:///07a1…0007  PropDV
acl://LR…0010,dma:///07a17522…00000011
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

マルチファイル文書の場合，コマンド引数に指定する次のプロパティ情報ファイルの各セクションに，directoryエントリおよびmimeエントリを必ず記述してください。

バージョンなし文書を作成するとき
dmaClass_DocVersion用プロパティ情報ファイル

バージョン付き文書を作成するとき
dmaClass_ConfigurationHistory用プロパティ情報ファイルまたはdmaClass_DocVersionクラス用プロパティ情報ファイル

エントリの記述がない場合はエラーになります。また，バージョン付き文書の場合，両方のプロパティ情報ファイルにdirectoryエントリおよびmimeエントリを指定すると，dmaClass_ConfigurationHistory用プロパティ情報ファイルの値が有効となります。

シングルファイル文書の場合，コマンド引数に指定する次のプロパティ情報ファイルの各セクションに，urlエントリおよびmimeエントリを必ず記述してください。

バージョンなし文書を作成するとき
dmaClass_DocVersion用プロパティ情報ファイル

バージョン付き文書を作成するとき
dmaClass_ConfigurationHistory用プロパティ情報ファイルまたはdmaClass_DocVersionクラス用プロパティ情報ファイル

エントリの記述がない場合はエラーになります。また，バージョン付き文書の場合，両方のプロパティ情報ファイルにurlエントリおよびmimeエントリを指定すると，dmaClass_ConfigurationHistory用プロパティ情報ファイルの値が有効となります。

-Tオプションを指定する場合は，コマンド引数に指定する次のプロパティ情報ファイルの各セクションにlinkエントリを必ず記述してください。

バージョンなし文書を作成するとき
dmaClass_DocVersion用プロパティ情報ファイル

バージョン付き文書を作成するとき
dmaClass_ConfigurationHistory用プロパティ情報ファイルまたはdmaClass_DocVersionクラス用プロパティ情報ファイル

エントリの記述がない場合はエラーになります。また，バージョン付き文書の場合，両方のプロパティ情報ファイルにlinkエントリを指定すると，dmaClass_ConfigurationHistory用プロパティ情報ファイルの値が有効となります。

構成管理モードのコンテインメントを設定できるのは，次の場合だけです。

バージョン付き文書作成時に，-Tオプションのオプションの引数に構成管理コンテナのOIIDまたはOIIDファイルを指定して作成した場合

dmaClass_DocVersion用プロパティ情報ファイルのセクション名に，edmClass_VersionTracedDocVersionクラスもしくはそのサブクラス，またはedmClass_VersionTracedComponentDocVersionクラスもしくはそのサブクラスのクラス名を記述した場合

linkエントリにVCRを指定した場合は，必ずmodeエントリを指定してください。エントリの記述がない場合は，エラーになります。また，両方のプロパティ情報ファイルにmodeエントリを指定すると，dmaClass_ConfigurationHistory用プロパティ情報ファイルの値が有効になります。

-Tオプションのオプションの引数にバージョン付き構成管理コンテナのOIIDまたはOIIDファイルを指定した場合は，最新バージョンのバージョン付き構成管理コンテナに包含されます。

バージョン付き文書を作成する時に指定したdmaClass_ConfigurationHistory用プロパティ情報ファイルとdmaClass_DocVersion用プロパティ情報ファイルに記述したセクション数が同じでない場合，エラーになります。

コマンド引数に指定するどちらかのプロパティ情報ファイルの各セクションに，次のエントリを必ず指定してください。

urlエントリ
文書として管理するファイルのファイルパスを指定します。

mimeエントリ
文書として管理するファイルのMIME名を指定します。

エントリの記述がない場合はエラーになります。また，バージョン付き文書の場合，両方のプロパティ情報ファイルにurlエントリまたはmimeエントリを指定すると，dmaClass_ConfigurationHistory用プロパティ情報ファイルの値が有効となります。

マルチファイル文書の場合，dbrProp_RetrievalNameプロパティに値を設定するには，プロパティ情報ファイルに，プロパティとしてdbrProp_RetrievalNameを指定します。

コンテントの登録先を，ファイルサーバとする場合，-kオプションでFileLinkを指定します。この場合，-kオプションは省略できません。

File Link文書の，ファイルサーバ上のコンテントの削除モードは，クライアントのコンテントを指定して文書を作成した場合と，ファイルサーバ上に登録されているコンテントを指定して文書を作成した場合で異なります。それぞれの場合のコンテントの削除モードを次に示します。

クライアントのコンテントを指定して文書を作成した場合
クライアントのコンテントを指定して作成した文書を削除すると，ファイルサーバ上のコンテントも同期して削除されます。なお，コンテントとしてディレクトリを登録したときは，ディレクトリごと削除されます。

ファイルサーバ上に登録されているコンテントを指定して文書を作成した場合
ファイルサーバ上に登録されているコンテントを指定して作成した文書を削除しても，ファイルサーバ上のコンテントは削除されません。なお，コンテントにディレクトリを使用しているときでも，ディレクトリは削除されません。

コンテントの削除モードを変更する場合は，実行環境制御ファイルのFileLinkセクションの，ClientContentDeleteModeエントリ，またはServerContentDeleteModeエントリの設定を変更してください。

リファレンスファイル文書の場合，コンテントの格納先には，DocumentBrokerサーバから接続可能であり，かつDocumentBrokerサーバから参照可能なディレクトリを設定してください。

リファレンスファイル文書の場合，コンテント格納先ベースパスのディレクトリおよびコンテント格納先パスのディレクトリの下位に，DocumentBrokerがコンテントを管理するためのディレクトリが作成され，その下位にコンテントが格納されます。なお，リファレンスファイル文書のコンテントと，コンテントが格納されているディレクトリを同時に削除する場合は，dbrdeldocコマンド（文書の削除）で，削除ディレクトリのルートパスを指定してください。削除ディレクトリのルートパスの指定方法については，コマンド「dbrdeldoc（文書の削除）」を参照してください。

-Tオプションを指定する場合に，コンテナへの包含に失敗すると，ファイルシステム上のコンテントは削除されません。そのため，必要に応じて手動で削除してください。

dbrcrtidx（全文検索インデクスの作成）

機能

文書の全文検索インデクスを作成します。全文検索インデクスが作成できるのは，作成時に，dmaClass_DocVersionクラスまたはそのサブクラスとして，全文検索機能付き文書クラスを指定した文書です。

操作クラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

形式

dbrcrtidx　 〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　 { OIID | OIIDファイル } 〔 全文検索インデクスファイルURL 〕

オプション

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き文書の場合，全文検索インデクスを作成するバージョンのバージョン識別子を指定します。このオプションを省略した場合は最新バージョンに対して全文検索インデクスが作成されます。

バージョンなし文書の場合に，このオプションを指定するとエラーになります。

バージョン識別子

全文検索インデクスを作成するバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

全文検索インデクスを作成するバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

コマンド引数

OIID

全文検索インデクスを作成する文書のOIIDを指定します。

OIIDファイル

全文検索インデクスを作成する文書のOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

全文検索インデクスファイルURL

全文検索インデクスファイルのファイルパスをURL形式で指定します。例えば，UNIXの場合，「/tmp/index.txt」を使用して全文検索インデクスを作成したいときには，「file:///tmp/index.txt」と指定します。Windowsの場合，「c:¥temp¥index.txt」を使用して全文検索インデクスを作成したいときには，「file:///c:¥temp¥index.txt」と指定します。この引数を省略した場合は，すでに登録されているファイルから全文検索インデクスが作成されます。

全文検索インデクスファイルには，登録されている文書の内容に対応するプレーンテキスト形式のファイルを指定してください。例えば，Wordで作成したファイルを登録した文書に対しては，ユーザプログラムなどでそのWordファイルから抽出したテキストファイルを指定してください。

注意事項

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

すでに全文検索インデクスが作成されている文書に対してこのコマンドを実行した場合，全文検索インデクスを再作成します。

プレーンテキスト用全文検索インデクスが作成できるのは，dmaClass_DocVersionクラスまたはそのサブクラスとして，プレーンテキスト用全文検索機能付き文書クラスを指定して作成した文書です。
全文検索機能付き文書クラスについては，マニュアル「DocumentBroker Version 3　クラスライブラリ　C++　解説」を参照してください。

全文検索機能付き文書クラス以外のdmaClass_DocVersionクラスまたはそのサブクラスを指定して作成された文書に対して，このコマンドを実行して全文検索インデクスを作成しようとすると，実行メソッドでエラーになります。

dbrdelacl（パブリックACLの削除）

機能

パブリックACLを削除します。OIIDファイルに複数のOIIDを指定すると，複数のパブリックACLを一括して削除できます。

操作クラス

CdbrPublicACLクラス

形式

dbrdelacl　{ OIID | OIIDファイル }

オプション

なし

コマンド引数

OIID

削除するパブリックACLのOIIDを指定します。

OIIDファイル

削除するパブリックACLのOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

注意事項

なし

dbrdelcntr（コンテナの削除）

機能

コンテナを削除します。OIIDファイルに複数のOIIDを指定すると，複数のコンテナを一括して削除できます。

操作クラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

形式

dbrdelcntr　〔 -l { DCR 〔 -R 〕 | RCR | VCR | ALL } |

　　　　　　-v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　〔 -k Reference

　　　　　　{ { { 〔 -a { RELATIVE | NONE } 〕

　　　　　　　〔 -b コンテント格納先ベースパス 〕

　　　　　　　〔 -y 削除ディレクトリのルートパス 〕 } |

　　　　　　　〔 -i リファレンス情報ファイル 〕 }

　　　　　　〔 -z 〕 } 〕

　　　　　　{ OIID | OIIDファイル }

オプション

-l { DCR | RCR | VCR | ALL }

包含するオブジェクトとの間に設定されているコンテインメントの種別を指定します。このオプションを省略した場合は，コンテナに包含されているオブジェクトを削除しないで，操作対象に指定したコンテナだけを削除します。

DCR

直接型のコンテインメントでコンテナに包含されているオブジェクトを削除します。

RCR

参照型のコンテインメントでコンテナに包含されているオブジェクトを削除します。

VCR

構成管理型のコンテインメントでコンテナに包含されているオブジェクトを削除します。

ALL

コンテインメントの種別に関係なくコンテナに包含されているオブジェクトを削除します。

-R

操作対象となるコンテナに包含されているコンテナに対して，直接型のコンテインメントでコンテナに包含されているオブジェクトを再帰的に削除します。このオプションは-l DCRオプションを指定した場合だけ有効です。-l DCRオプションを指定していない場合にこのオプションを指定するとエラーになります。

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き構成管理コンテナの場合，削除するバージョンのバージョン識別子を指定します。このオプションを省略した場合は，すべてのバージョンおよびバージョン付き構成管理コンテナ自身が削除されます。

バージョンなしコンテナおよびバージョンなし構成管理コンテナを削除するときにこのオプションを指定するとエラーになります。

バージョン識別子

削除するバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

削除するバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-k Reference

コンテナに包含されているリファレンスファイル文書を削除します。このオプションは，-lオプションを指定した場合だけ有効です。

-lオプションを省略してこのオプションを指定すると，エラーになります。また，実行環境制御ファイルのReferenceセクションでContentDeleteModeエントリの指定がSpecifyであり，かつリファレンスファイル文書がコンテナに包含されている場合，このオプションを省略するとエラーになります。

コンテナ内で，リファレンスファイル文書を，シングルファイル文書，マルチファイル文書やFileLink文書と混在して使用する場合，このオプションの指定を省略してリファレンスファイル文書を削除するには，実行環境制御ファイルのReferenceセクションで，ContentDeleteModeエントリにAutoを指定してください。ContentDeleteModeエントリにAutoを指定することで，自動的にリファレンスファイル文書かどうかを判別して，リファレンスファイル文書を削除します。ただし，ContentDeleteModeエントリの指定がAutoの場合でも，実行環境制御ファイルに，リファレンス情報としてリファレンス種別，コンテント格納先ベースパスおよび削除ディレクトリのルートパスを指定してください。

削除するコンテナとコンテナに包含されるリファレンスファイル文書の，リファレンス情報が同じかどうかで，リファレンスファイル文書の削除方法が異なります。削除方法を次に示します。

削除するコンテナごとのリファレンス情報が同一の場合
-aオプション，-bオプションおよび-yオプションを指定してください。

削除するコンテナごとにリファレンス情報が異なる場合
コンテナごとのリファレンス情報をリファレンス情報ファイルに指定し，-iオプションを指定してください。

削除するコンテナ内でリファレンス情報が異なる場合
このコマンドで，コンテナ内のリファレンスファイル文書のすべては削除できません。

コンテナに包含されるリファレンスファイル文書の削除方法の詳細は，「表5-8　リファレンスファイル文書を扱う場合のオブジェクトの削除方法」を参照してください。

このオプションを指定した場合も，シングルファイル文書，マルチファイル文書，またはFileLink文書を削除できます。

-a { RELATIVE | NONE }

コンテナに包含されるリファレンスファイル文書を削除する場合に，リファレンスファイル文書のリファレンス種別を指定します。

-kオプションを省略してこのオプションを指定した場合，またはこのオプションと同時に-iオプションを指定した場合，エラーになります。このオプションを省略した場合，実行環境制御ファイルの，ReferenceセクションのDefaultReferenceTypeエントリの指定を使用します。

RELATIVE

コンテントの格納先をファイルシステム上の領域とし，コンテントロケーションを相対パスで管理するオブジェクトです。

NONE

コンテントがなく，コンテントロケーションを管理しないオブジェクトです。

RELATIVEを指定すると，リファレンス種別がNONEのリファレンスファイル文書も削除できます。

-b コンテント格納先ベースパス

コンテナに包含されるリファレンスファイル文書を削除する場合に，コンテント格納先ベースパスを指定します。このオプションは，実行環境制御ファイルまたは-aオプションで，リファレンス種別の指定がRELATIVEの場合に有効です。

オプション引数には，コンテントが格納されているディレクトリの基点となるパスを指定します。例えば，コンテナに包含されるリファレンスファイル文書の基点となるパスが「/drv01/dir01/userdir」ディレクトリの場合，このオプションに「/drv01/dir01/userdir」を指定します。このオプションの指定の末尾に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。

-kオプションの指定を省略してこのオプションを指定した場合，またはこのオプションと-iオプションを同時に指定した場合，エラーになります。このオプションを省略した場合，実行環境制御ファイルの，ReferenceセクションのDefaultContentBasePathエントリの指定を使用します。

コンテナとコンテナに包含されるリファレンスファイル文書を削除する場合，リファレンスファイル文書のコンテント格納先ベースパスが，すべて一致している必要があります。また，-Rオプションを指定した場合も，コンテナの下位のコンテナに包含されるリファレンスファイル文書のコンテント格納先ベースパスが，すべて一致している必要があります。コンテナ内でコンテント格納先ベースパスが異なる場合の，リファレンスファイル文書の削除方法については，「表5-8　リファレンスファイル文書を扱う場合のオブジェクトの削除方法」を参照してください。

このオプションに指定したコンテント格納先ベースパスは，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オプションの指定を省略してこのオプションを指定した場合，またはこのオプションと-iオプションを同時に指定した場合，エラーになります。このオプションを省略した場合，実行環境制御ファイルの，ReferenceセクションのDefaultDeleteRootPathエントリの指定を使用します。

コンテナに包含されるリファレンスファイル文書を削除する場合，削除するすべてのリファレンスファイル文書の，コンテントの絶対パスの基点となるパスを指定します。-Rオプションを指定する場合も，すべてのリファレンスファイル文書のコンテントの絶対パスの基点となるパスを指定します。コンテントの絶対パスには，コンテント格納先ベースパスとContentLocationプロパティに格納されたコンテント格納先を示す相対パスを結合したパスが使用されます。

DocumentBrokerがコンテントを管理するためのディレクトリは，このオプションおよび実行環境制御ファイルのReferenceセクションのDefaultDeleteRootPathエントリで，削除ディレクトリのルートパスの指定を省略した場合も，コンテントと同時に削除されます。

Windowsの場合，削除ディレクトリのルートパスにUNC形式のパスを使用することもできます。例えば，「server01」というマシンのネットワーク上で共有しているフォルダ「share」を削除ディレクトリのルートパスに指定する場合は，このオプションに「¥¥server01¥share」を指定します。

-i リファレンス情報ファイル

コンテナごとにコンテント格納先ベースパスが異なる運用で，複数のコンテナを一括して，コンテナに包含されているリファレンスファイル文書を削除する場合に，リファレンス情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

-kオプションの指定を省略してこのオプションを指定した場合，またはこのオプションを，-aオプション，-bオプションおよび-yオプションと同時に指定した場合，エラーになります。

リファレンス情報ファイルには，コンテナごとに，リファレンスファイル文書のリファレンス情報として，リファレンス種別，コンテント格納先ベースパス，および削除ディレクトリのルートパスを記述します。リファレンス情報ファイルに記述する指定順序は，OIIDファイルで指定するOIIDの順序と一致させてください。また，リファレンス情報ファイルに指定するセクション数は，OIIDファイルに指定するOIIDの数と一致させてください。リファレンス情報ファイルの記述形式については，「3.8　リファレンス情報ファイル」を参照してください。

-z

コンテナに包含されているリファレンスファイル文書を削除する場合に，トランザクションをコンテナに包含されているオブジェクト単位に分割して実行します。

このオプションを指定すると，コマンドの実行時にエラーが発生しても，リファレンスファイル文書のコンテントとオブジェクトの不整合が起きません。このオプションを指定しない場合，トランザクションは，コマンド引数で指定するコンテナ単位に分割して実行します。-kオプションの指定を省略してこのオプションを指定した場合，エラーになります。

コマンド引数

OIID

削除するコンテナのOIIDを指定します。

OIIDファイル

削除するコンテナのOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。ただし，-vオプションを指定している場合，記述できるOIIDの数は一つだけです。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

実行例

図5-1に示すオブジェクト構成を前提としてOBJ_11を削除した場合の，削除対象となる下位オブジェクトとオプション指定との関係を表5-3に示します。

図5-1　オブジェクト構成

表5-3　-lオプションの指定と削除対象になる下位オブジェクト

-lオプションの指定 | 削除されるオブジェクト | コンテインメントによる包含関係が解除されるオブジェクト
指定なし | OBJ_11 | OBJ_21，OBJ_22，OBJ_23
-l DCR | OBJ_11，OBJ_21 | OBJ_22，OBJ_23，OBJ_31，OBJ_32，OBJ_33
-l DCR -R | OBJ_11，OBJ_21，OBJ_31 | OBJ_22，OBJ_23，OBJ_32，OBJ_33
-l RCR | OBJ_11，OBJ_22 | OBJ_21，OBJ_23，OBJ_34，OBJ_35，OBJ_36
-l VCR | OBJ_11，OBJ_23 | OBJ_21，OBJ_22，OBJ_37，OBJ_38，OBJ_39
-l ALL | OBJ_11，OBJ_21，OBJ_22，OBJ_23 | OBJ_31，OBJ_32，OBJ_33，OBJ_34，OBJ_35，OBJ_36，OBJ_37，OBJ_38，OBJ_39

注意事項

バージョン付き構成管理コンテナまたはバージョンなし構成管理コンテナを包含しているバージョンなしコンテナに対して，-lオプションを指定すると，エラーになります。

-lオプションの指定によって削除されたコンテナと，そのコンテナに包含されるオブジェクトの間に設定されていた包含関係はすべて解除されます。

コンテインメントの種別に関係なく，-lオプションを指定した場合は，ほかのオブジェクトを包含している場合でも，包含されるオブジェクトは削除されます。

-lオプションの指定によって削除される下位オブジェクトが文書の場合に，文書に文書間リレーションが設定されているとき，リレーションは次のように扱われます。

削除される下位オブジェクトがリレーション元文書の場合，リレーションも削除されます。

削除される下位オブジェクトがリレーション先文書の場合，リレーションは削除されません。

-vオプション指定時には，複数のオブジェクトを一括して削除できません。指定したバージョンを削除できるコンテナは一つだけです。OIIDファイルに複数のOIIDを指定した場合はエラーになります。

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

バージョンなしコンテナの場合に，-lVCRオプションを指定すると，下位オブジェクトは削除されないで，バージョンなしコンテナだけが削除されます。

バージョン付き構成管理コンテナと同時に削除できるのは，最新バージョンに包含されているオブジェクトです。

リファレンスファイル文書の場合，コンテントの格納先には，DocumentBrokerサーバから接続可能であり，かつDocumentBrokerサーバから参照可能なディレクトリを設定してください。

リファレンスファイル文書を扱うコンテントの操作でエラーになると，オブジェクトとコンテントの状態が不整合となり，メッセージKMBR30201-E（要因コード3，86）が出力される場合があります。この場合は，再度，dbrdelcntrコマンド（コンテナの削除）を実行してオブジェクトを削除してください。また，メッセージの詳細については，マニュアル「DocumentBroker Version 3　メッセージ」を参照してください。

リファレンスファイル文書を削除する場合に，誤って異なるリファレンスファイル文書のコンテント格納先ベースパスを指定すると，オブジェクトは削除され，コマンドは正常終了します。ただし，コンテントは削除されないため，必要に応じて手動で削除してください。

リファレンスファイル文書を削除する場合に，リファレンスファイル文書かどうかを自動的に判別して削除するときは，実行環境制御ファイルのReferenceセクションでContentDeleteModeエントリにAutoを指定します。
また，ContentDeleteModeエントリの指定がSpecifyの場合は，-kオプションの指定に従ってリファレンスファイル文書を削除します。そのため，-kオプションの指定を省略するとエラーになります。
ContentDeleteModeエントリの指定とdbrdelcntrコマンド（コンテナの削除）の実行結果については，「表3-2　ContentDeleteModeエントリの指定とdbrdelcntrコマンド，dbrdeldocコマンドの実行結果」を参照してください。

-lオプションを指定して，コンテナに包含されるリファレンスファイル文書を削除する場合，コンテナごとにリファレンスファイル文書のコンテント格納先ベースパスが同一である必要があります。
コンテナ内に，異なるコンテント格納先ベースパスのリファレンスファイル文書が混在している場合は，コンテント格納先ベースパスが同一のリファレンスファイル文書に絞り込んで，同一のコンテント格納先ベースパスごとにdbrdeldocコマンド（文書の削除）でリファレンスファイル文書を削除します。そのあと，dbrdelcntrコマンド（コンテナの削除）でコンテナを削除してください。リファレンスファイル文書の削除の詳細については，「表5-8　リファレンスファイル文書を扱う場合のオブジェクトの削除方法」を参照してください。

-iオプションとOIIDファイルを指定して，複数のコンテナを一括して削除する場合，-iオプションで指定したリファレンス情報ファイルのセクション数とOIIDファイルのOIIDの数が異なると，エラーになります。

コンテナに包含されるリファレンスファイル文書を削除する場合，-k Referenceオプションおよび-zオプションを指定します。これらのオプションを指定することで，トランザクションがコンテナに包含されるオブジェクト単位に分割して実行され，エラー発生時のオブジェクトとコンテントの不整合を防ぐことができます。-zオプションを指定しない場合，トランザクションは，コマンド引数で指定するコンテナ単位に分割して実行されます。

dbrdeldata（独立データの削除）

機能

独立データを削除します。OIIDファイルに複数のOIIDを指定すると，複数の独立データを一括して削除できます。

操作クラス

CdbrIndependentPersistenceクラス

形式

dbrdeldata　{ OIID | OIIDファイル }

オプション

なし

コマンド引数

OIID

削除する独立データのOIIDを指定します。

OIIDファイル

削除する独立データのOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

注意事項

なし

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　リファレンスファイル文書を扱う場合のオブジェクトの削除方法」を参照してください。

dbrdelidx（全文検索インデクスの削除）

機能

文書の全文検索インデクスを削除します。

操作クラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

形式

dbrdelidx　〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　{ OIID | OIIDファイル }

オプション

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き文書の場合，全文検索インデクスを削除するバージョンのバージョン識別子を指定します。このオプションを省略した場合は最新バージョンの全文検索インデクスが削除されます。

バージョンなし文書の場合，このオプションを指定するとエラーになります。

バージョン識別子

全文検索インデクスを削除するバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

全文検索インデクスを削除するバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

コマンド引数

OIID

全文検索インデクスを削除する文書のOIIDを指定します。

OIIDファイル

全文検索インデクスを削除する文書のOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。

ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

注意事項

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

全文検索インデクスがない場合は，何もしないで正常終了します。

全文検索機能付き文書クラス以外のdmaClass_DocVersionクラスまたはそのサブクラスを指定して作成した文書に対して，このコマンドを実行して全文検索インデクスを削除しようとすると，実行メソッドでエラーになります。

dbrdowndoc（文書のダウンロード）

機能

文書に登録されているファイルをダウンロードします。

操作クラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

形式

dbrdowndoc　〔 -v 　{ バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　　〔 -M 　レンディションタイプ 〕

　　　　　　〔 -k { Content | MultiContent | FileLink | Reference

　　　　　　　〔 -a { RELATIVE } 〕

　　　　　　　〔 -b コンテント格納先ベースパス 〕 } 〕

　　　　　　{ OIID | OIIDファイル }

　　　　　　{ダウンロードファイルURL | ダウンロードディレクトリURL }

オプション

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き文書の場合，ダウンロードするバージョンのバージョン識別子を指定します。このオプションを省略した場合は，最新バージョンが仮定されます。

バージョンなし文書をダウンロードするときにこのオプションを指定するとエラーになります。

バージョン識別子

ダウンロードするバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

ダウンロードするバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-M　レンディションタイプ

ダウンロードするレンディションタイプを指定します。このオプションを省略した場合は，マスタレンディションが仮定されます。

-k { Content | MultiContent | FileLink | Reference }

ダウンロードする文書のコンテント種別を指定します。このオプションを指定した場合，ダウンロードファイルURL，またはダウンロードディレクトリURLの指定が，このオプションの指定と一致していないとエラーになります。このオプションを省略した場合，ダウンロードファイルURL，またはダウンロードディレクトリURLの指定に従ってコンテントをダウンロードします。

Content

シングルファイル文書のコンテントを，データベースからダウンロードします。ダウンロードURLに指定されたファイルに，コンテントをダウンロードします。

MultiContent

マルチファイル文書のコンテントを，データベースからダウンロードします。ダウンロードディレクトリURLに指定されたディレクトリに，コンテントをダウンロードします。

FileLink

File Link文書のコンテントを，ファイルサーバからダウンロードします。ダウンロードURLに指定されたファイル，またはダウンロードディレクトリURLに指定されたディレクトリに，コンテントをダウンロードします。

Reference

リファレンスファイル文書のコンテントを，ファイルシステム上の領域からダウンロードします。ダウンロードURLに指定されたファイルに，コンテントをダウンロードします。

オプション省略時

ダウンロードファイルURL，またはダウンロードディレクトリURLの指定に従ってコンテントをダウンロードします。

ダウンロードファイルURLが指定されている場合
シングルファイル文書のコンテントをダウンロードします。

ダウンロードディレクトリURLが指定されている場合
マルチファイル文書のコンテントをダウンロードします。

-a { RELATIVE }

ダウンロードするリファレンスファイル文書のリファレンス種別を指定します。

-kオプションにReferenceを指定していない場合に，このオプションを指定するとエラーになります。このオプションを省略した場合，実行環境制御ファイルの，ReferenceセクションのDefaultReferenceTypeエントリの指定を使用します。

RELATIVE

リファレンス種別がRELATIVEのリファレンスファイル文書のコンテントをダウンロードします。このオプションを指定した場合，-bオプションにコンテント格納先ベースパスを指定します。

-b コンテント格納先ベースパス

リファレンスファイル文書をダウンロードする場合に，コンテント格納先ベースパスを指定します。

オプション引数には，ダウンロードするコンテントが格納されているディレクトリの基点となるパスを指定します。例えば，リファレンスファイル文書のコンテントの基点となるパスが「/drv01/dir01/userdir」ディレクトリの場合，このオプションに「/drv01/dir01/userdir」を指定します。このオプションの指定の末尾に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。

-kオプションにReferenceを指定していない場合に，このオプションを指定するとエラーになります。このオプションを省略した場合，実行環境制御ファイルの，ReferenceセクションのDefaultContentBasePathエントリの指定を使用します。

このオプションに指定したコンテント格納先ベースパスは，ContentLocationプロパティに格納されたコンテント格納先を示す相対パスと結合して，絶対パスとして使用されます。

Windowsの場合，コンテント格納先ベースパスにUNC形式のパスを使用することもできます。例えば，「server01」というマシンのネットワーク上で共有しているフォルダ「share」をコンテント格納先ベースパスに指定する場合は，このオプションに「¥¥server01¥share」を指定します。

コマンド引数

OIID

ダウンロードする文書のOIIDを指定します。

OIIDファイル

ダウンロードする文書のOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

ダウンロードファイルURL

シングルファイル文書，File Link文書（コンテントとしてファイルを登録している）またはリファレンスファイル文書の場合，ダウンロードファイルのファイルパスをURL形式で指定します。例えば，UNIXの場合，「/tmp/download.doc」にダウンロードするときには，「file:///tmp/download.doc」と指定します。Windowsの場合，「c:¥temp¥download.doc」にダウンロードするときには，「file:///c:¥temp¥download.doc」と指定します。

ダウンロードディレクトリURL

マルチファイル文書，またはFile Link文書（コンテントとしてディレクトリまたはファイルを登録している）の場合，ダウンロードファイルまたはダウンロードディレクトリを格納するディレクトリパスを，URL形式で指定します。例えば，UNIXの場合，「/tmp」にダウンロードファイルを格納するときには，「file:///tmp」と指定します。Windowsの場合，「c:¥temp」にダウンロードファイルを格納するときには，「file:///c:¥temp」と指定します。

注意事項

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

-kオプションを省略した場合，シングルファイル文書（レンディション）またはマルチファイル文書（レンディション）をダウンロードの対象にします。コマンド引数に，ダウンロードファイルURLを指定すると，ダウンロードする文書はシングルファイル文書として扱われます。また，コマンド引数に，ダウンロードディレクトリURLを指定すると，ダウンロードする文書はマルチファイル文書として扱われます。コマンド引数の指定と，ダウンロードする文書の種類が一致しないとエラーになります。

File Link文書で，ファイルサーバにコンテントを登録した文書（レンディション）のコンテントをダウンロードする場合，-kオプションでFileLinkを指定します。この場合，-kオプションは省略できません。ダウンロードファイルURLまたはダウンロードディレクトリURLに指定したディレクトリが存在しないと，ディレクトリが作成され，コンテントがダウンロードされます。なお，ダウンロードファイルURLに指定したファイルが存在するとエラーになります。

リファレンスファイル文書の場合，コンテントの格納先には，DocumentBrokerサーバから接続可能であり，かつDocumentBrokerサーバから参照可能なディレクトリを設定してください。

リファレンスファイル文書のコンテントをダウンロードする場合に，誤って異なるリファレンスファイル文書のコンテント格納先ベースパスを指定すると，エラーになります。

dbrexquery（問い合わせの実行）

機能

問い合わせファイルに記述された問い合わせ式を実行します。実行結果は標準出力に出力されます。

実行結果の出力形式について，次に示します。

1オブジェクトにつき1行で標準出力に出力されます。

指定したプロパティがコンマ（,）で区切って出力されます。

操作クラス

検索可能なDMAのクラス

形式

dbrexquery　問い合わせファイル

オプション

なし

コマンド引数

問い合わせファイル

実行する問い合わせ式を記述したファイルのファイルパスを指定します。問い合わせファイルのファイル名は任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

実行例

実行例を次に示します。なお，実行環境制御ファイルでのOutputセクションのFormatエントリの指定によって，出力形式が異なります。

また，この例はWindowsの場合です。UNIXの場合は，「type QueryFile」を「cat QueryFile」に読み替えてください。

$ type QueryFile
SELECT  ALL
          usrClass_Container.usrProp_IsReadOnly,
          usrClass_Container.usrProp_State,
          usrClass_Container.usrProp_Title,
          usrClass_Container.usrProp_Authors
FROM  usrClass_Container
WHERE  usrClass_Container.usrProp_Title
             LIKE  'container _'  ESCAPE  '¥'
AND usrClass_Container.usrProp_Authors[ANY] .usrProp_Age <= 30
ORDER BY  usrClass_Container.usrProp_State

（Formatエントリが「VR0112」の場合）
$ dbrexquery  QueryFile
TRUE,1,container1,{{suzuki,27},{yamada,30} ,{sato,32}}
FALSE,2,container2,{tanaka,22}
KMBR32115-I 検索を実行しました。

（Formatエントリが「VR0200」の場合）
$ dbrexquery  QueryFile
TRUE,1,'container1',{{'suzuki',27},{'yamada',30} ,{'sato',32}}
FALSE,2,'container2',{'tanaka',22}
KMBR32115-I 検索を実行しました。

注意事項

出力可能なプロパティは基本単位がScalar型でデータ型がString型，Integer32型，Boolean型のプロパティ，および基本単位がVariableArray型でデータ型がObject型のプロパティです。

出力可能な構成要素プロパティのデータ型はString型，Integer32型，Boolean型です。

基本単位がVariableArray型でデータ型がObject型プロパティは，プロパティおよび構成要素プロパティが，波括弧（{　}）で囲まれて出力されます。各構成要素プロパティはコンマで区切られて出力されます。この時，出力できるすべての構成要素プロパティが出力されます。

1行に出力できるサイズは，UNIXの場合，NL（0x0a）を除いてデフォルトでは8,190バイト以内です。Windowsの場合，CR + NL（0x0d + 0x0a）を除いてデフォルトでは8,190バイト以内です。8,190バイトを超える場合は可能な範囲で出力されて，メッセージが標準エラー出力に出力されます。

1行に出力するサイズを変更するときは，UNIXの場合，実行環境ファイルでOutputセクションのLineSizeエントリにNL（0x0a）を除いた出力サイズを指定してください。Windowsの場合，実行環境ファイルでOutputセクションのLineSizeエントリにCR + NL（0x0d + 0x0a）を除いた出力サイズを指定してください。

選択リストに基本単位がVariableArray型でデータ型がObject型のプロパティを指定した場合DISTINCTを指定しても重複排除されません。

選択リストとして指定できるプロパティのデータ型は，String型，Integer32型，Boolean型，および基本単位がVariableArray型のObject型です。ただし，基本単位がVariableArray型のObject型のプロパティの添え字と，その構成要素となるクラスのプロパティは指定できません。

指定できる問い合わせ文字列のサイズはコメント行および空白行を除いて8,190バイトです。

値がNULL値の場合は，何も出力されません。

プロパティ出力時にエラーが発生した場合，「ERROR」という文字列と，付加情報が出力されます。

実行環境制御ファイルでOutputセクションのFormatエントリに「VR0200」を指定した場合，文字としてのシングルクォート（'）を含むString型プロパティが出力されるときは，文字列を囲むシングルクォート（'）とは別にシングルクォート（'）が二つ続けて出力されます。

dbrgetprop（プロパティの取得）

機能

プロパティ情報ファイルに記述した内容に従って，オブジェクトのプロパティを取得します。OIIDファイルに複数のOIIDを指定すると，複数のオブジェクトのプロパティを一括して取得できます。

操作クラス

CdbrIndependentPersistenceクラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

CdbrPublicACLクラス

形式

dbrgetprop　〔 { -v { バージョン識別子 | バージョン識別子ファイル } |

　　　　　　　　-L { リンク識別子 | リンク識別子ファイル } }〕

　　　　　　{ OIID | OIIDファイル }　プロパティ情報ファイル

オプション

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き文書またはバージョン付き構成管理コンテナの場合，プロパティを取得するバージョンのバージョン識別子を指定します。このオプションおよび-Lオプションを省略した場合は，すべてのバージョンで共有するプロパティを取得します。

バージョン付き文書およびバージョン付き構成管理コンテナ以外のプロパティを取得する場合にこのオプションを指定するとエラーになります。

バージョン識別子

プロパティを取得するバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

プロパティを取得するバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-L　{ リンク識別子 | リンク識別子ファイル }

コンテナに設定したコンテインメントのプロパティを取得する場合に，プロパティを取得するコンテインメントのリンク識別子を指定します。このオプションおよび-vオプションを省略した場合は，すべてのバージョンで共有するプロパティを取得します。

コンテナ以外のプロパティを取得するときにこのオプションを指定するとエラーになります。

リンク識別子

プロパティを取得するコンテインメントのリンク識別子を指定します。

リンク識別子ファイル

プロパティを取得するコンテインメントのリンク識別子を記述したリンク識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「acl://」で始まるパスは指定できません。なお，リンク識別子ファイルに記述できるリンク識別子の数は一つだけです。

コマンド引数

OIID

プロパティを取得するオブジェクトのOIIDを指定します。

OIIDファイル

プロパティを取得するオブジェクトのOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。ただし，-vオプションを指定している場合または-Lオプションを指定している場合，記述できるOIIDの数は一つだけです。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

プロパティ情報ファイル

取得するオブジェクトのクラス名および設定するプロパティを記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

プロパティ情報ファイルの記述例

独立データのプロパティを取得する場合のedmClass_IndependentPersistence用プロパティ情報ファイルの記述例を示します。このファイルには，取得するプロパティの名前だけ指定します。

;; usrClass_IndependentPersistence
[usrClass_IndependentPersistence]
usrProp_IsReadOnly
usrProp_State
usrProp_Title
usrProp_Authors

実行例

実行例を次に示します。なお，この例はWindowsの場合です。UNIXの場合は，「type PropFile」を「cat PropFile」に読み替えてください。

$ type PropFile
[usrClass_IndependentPersistence]
usrProp_IsReadOnly
usrProp_State
usrProp_Title
usrProp_Authors
$ dbrgetprop  dma:///07a17522-…-0000000001  PropFile
# Properties by dbrgetprop 1999/08/01 15:00:00
# dma:///07a17522-a626-11d0-b11f-0020af27a837/673d2be0-…-0000000001
[usrClass_IndependentPersistence]
usrProp_IsReadOnly=TRUE
usrProp_State=1
usrProp_Title='Independent'
usrProp_Authors[3][2]=
{
 {usrProp_Name='suzuki',
  usrProp_Age=27},
 {usrProp_Name='yamada',
  usrProp_Age=30},
 {usrProp_Name='sato',
  usrProp_Age=32}
}

注意事項

文字としてのシングルクォート（'）を含むString型プロパティを取得する場合，文字列を囲むシングルクォート（'）とは別にシングルクォート（'）が二つ続けて出力されます。

OIIDファイルに記述したOIID数とプロパティ情報ファイルに記述したセクション数が同じでない場合，エラーになります。オブジェクトのOIIDを指定した場合，プロパティ情報ファイルに記述するセクション数は一つでなければなりません。

取得するプロパティを記述したプロパティ情報ファイルには値を指定する必要はありません。また，指定していてもエラーにはなりません。

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

-vオプションまたは-Lオプション指定時には，複数のオブジェクトのプロパティを一括して取得することはできません。指定したバージョンまたはコンテインメントのプロパティを取得できるオブジェクトは一つだけです。OIIDファイルに複数のOIIDを指定した場合はエラーになります。

バージョン付き構成管理コンテナに対して，-vオプションと-Lオプションを同時には指定できません。

基本単位がVariableArray型のプロパティとしては，データ型がObject型以外のプロパティを出力することはできません。

クラスライブラリ固有のプロパティは，クラス定義情報ファイルに記述していなくても，セクション名に指定したクラスのプロパティとして取得できます。ただし，指定したオブジェクトの操作クラスに導入されていないクラスライブラリ固有のプロパティを指定した場合は，実行メソッドでエラーになります。

プロパティ情報ファイルに記述したクラス名は，クラス定義情報ファイルにアクセスするときだけ使用します。プロパティの取得には影響しません。

値がNULL値の場合は，「NULL」という文字列が出力されます。

値取得時にエラーが発生した場合，「ERROR」という文字列と付加情報が出力されます。

dbrlink（オブジェクト間の関連づけ）

機能

コンテインメントによる二つのオブジェクト間の関連づけを設定します。コンテインメントが設定されると，設定されたコンテインメントのリンク識別子が標準出力に出力されます。

操作クラス

包含するオブジェクト

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

包含されるオブジェクト

CdbrDocumentクラス

CdbrVersionableDocumentクラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

形式

dbrlink　-l { DCR | RCR | VCR　 -m { FLOATING | FIX

　　　　〔 -w { 包含されるオブジェクトのバージョン識別子 |

　　　　　　　　包含されるオブジェクトのバージョン識別子ファイル } 〕} }

　　　　〔 -v { 包含するオブジェクトのバージョン識別子 |

　　　　　　　　包含するオブジェクトのバージョン識別子ファイル } 〕

　　　　　{ 包含するオブジェクトのOIID |

　　　　　包含するオブジェクトのOIIDファイル }

　　　　　{ 包含されるオブジェクトのOIID |

　　　　　包含されるオブジェクトのOIIDファイル }

オプション

-l　{ DCR | RCR | VCR }

設定するコンテインメントの種別を指定します。このオプションは省略できません。

DCR

直接型のコンテインメントを設定します。

RCR

参照型のコンテインメントを設定します。

VCR

構成管理型のコンテインメントを設定します。VCRを設定したときは，必ず-mオプションを指定してください。

-m　{ FLOATING | FIX }

設定する構成管理モード種別を指定します。このオプションは，-l VCRオプションを指定した場合だけ指定できます。また，-l VCRオプションを指定した場合は，省略できません。

FLOATING

FLOATINGモードを設定します。

FIX

FIXモードを設定します。

このモードを指定したとき，-wオプションを指定できます。

-w　{ バージョン識別子 | バージョン識別子ファイル }

包含されるオブジェクトがバージョン付き文書またはバージョン付き構成管理コンテナの場合，コンテインメントを設定するバージョンのバージョン識別子を指定します。このオプションは，-m FIXオプションを指定した場合だけ指定できます。このオプションを省略した場合は，最新バージョンにコンテインメントが設定されます。

包含されるオブジェクトがバージョン付き文書およびバージョン付き構成管理コンテナ以外の場合，このオプションを指定するとエラーになります。

バージョン識別子

包含されるバージョン付き文書またはバージョン付き構成管理コンテナのバージョン識別子を指定します。

バージョン識別子ファイル

包含されるバージョン付き文書またはバージョン付き構成管理コンテナのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-v　{ バージョン識別子 | バージョン識別子ファイル }

包含するオブジェクトがバージョン付き構成管理コンテナの場合，コンテインメントを設定するバージョンのバージョン識別子を指定します。このオプションを省略した場合は，最新バージョンにコンテインメントが設定されます。

包含するオブジェクトがバージョンなしコンテナまたはバージョンなし構成管理コンテナの場合，このオプションを指定するとエラーになります。

バージョン識別子

包含するオブジェクトであるバージョン付き構成管理コンテナのバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

包含するオブジェクトであるバージョン付き構成管理コンテナのバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

コマンド引数

包含するオブジェクトのOIID

オブジェクトを包含するコンテナのOIIDを指定します。

包含するオブジェクトのOIIDを記述したOIIDファイル

オブジェクトを包含するコンテナのOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

包含されるオブジェクトのOIID

コンテナに包含されるオブジェクトのOIIDを指定します。

包含されるオブジェクトのOIIDを記述したOIIDファイル

コンテナに包含されるオブジェクトのOIIDを記述したIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

実行例

実行例を次に示します。なお，実行環境制御ファイルのOutputセクションのFormatエントリの指定，および指定したオプションによって，出力形式が異なります。

（Formatエントリが「VR0112」の場合）
$ dbrlink  -l  RCR  dma:///07a1…0018  dma:///07a1…0019
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

（Formatエントリが「VR0200」の場合）
$ dbrlink  -l  RCR  dma:///07a1…0018  dma:///07a1…0019
acl:///LR…00000019
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

すでに直接型のコンテインメントが設定されている二つのオブジェクト間に，さらに直接型のコンテインメントを設定しようとすると実行メソッドでエラーになります。ただし，すでに参照型のコンテインメントまたは構成管理型のコンテインメントが設定されている二つのオブジェクト間に，直接型のコンテインメント，参照型のコンテインメントまたは構成管理型のコンテインメントをさらに設定することはできます。

-l VCRオプション指定時に包含するオブジェクトとして指定できるのは，バージョン付き文書またはバージョン付き構成管理コンテナです。

-vオプションおよび-wオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

構成管理の対象になる文書は，次のクラスを指定して作成したバージョン付き文書だけです。

edmClass_VersionTracedDocVersionクラスまたはそのサブクラス

edmClass_VersionTracedComponentDocVersionクラスまたはそのサブクラス

-l VCRオプション指定時に-mオプションを指定しないとエラーになります。また，-l DCRオプションおよび-l RCRオプション指定時に-mオプションを指定した場合はエラーになります。

dbrlsacl（バインドしているパブリックACL一覧またはバインドされているオブジェクト一覧の取得）

機能

バインドしているパブリックACLまたはバインドされているオブジェクトの一覧を取得します。取得した情報は標準出力に出力されます。

指定したオブジェクトがパブリックACL以外の場合は，バインドしているパブリックACLの情報が出力されます。

指定したオブジェクトがパブリックACLの場合は，バインドされているオブジェクトの情報が出力されます。

OIIDファイルに複数のOIIDを指定すると，バインドしているパブリックACLの一覧を複数のオブジェクト分出力したり，またはバインドされているオブジェクト一覧を複数のパブリックACL分一括して出力したりできます。

一覧として出力できる情報は，オブジェクト種別およびOIIDです。

操作クラス

CdbrIndependentPersistenceクラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

CdbrPublicACLクラス

形式

dbrlsacl　〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　 { OIID | OIIDファイル }

オプション

-v　{ バージョン識別子 | バージョン識別子ファイル }

操作対象オブジェクトがバージョン付き文書またはバージョン付き構成管理コンテナの場合，バインドしているパブリックACLの一覧を取得するバージョンのバージョン識別子を指定します。このオプションを省略した場合は，オブジェクト自身にバインドしているパブリックACL一覧を取得します。

操作対象オブジェクトがバージョン付き文書およびバージョン付き構成管理コンテナ以外の場合にこのオプションを指定するとエラーになります。

バージョン識別子

バインドしているパブリックACL一覧を取得するバージョン識別子を指定します。

バージョン識別子ファイル

バインドしているパブリックACL一覧を取得するバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

コマンド引数

OIID

バインドしているパブリックACL一覧を取得するオブジェクトのOIID，またはバインドされているオブジェクト一覧を取得するパブリックACLのOIIDを指定します。

OIIDファイル

バインドしているパブリックACL一覧を取得するオブジェクトのOIID，またはバインドされているオブジェクト一覧を取得するパブリックACLのOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。ただし，-vオプションを指定している場合，記述できるOIIDの数は一つだけです。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

実行例

実行例を次に示します。なお，この例はWindowsの場合です。UNIXの場合は，「type OIIDs」を「cat OIIDs」に読み替えてください。

$ type OIIDs
;; CdbrIndependentPersistence
dma:///07a17522…00000040
;; CdbrPublicACL
dma:///07a17522…00000041

$ dbrlsacl  OIIDs
# dma:///07a17522…00000040
ACL,dma:///07a17522…00000041

# dma:///07a17522…00000041
IP,dma:///07a17522…00000040

注意事項

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

-vオプション指定時には，複数オブジェクトにバインドされているパブリックACLの一覧，および複数のパブリックACLにバインドしているオブジェクト一覧を一括して取得できません。バージョンを指定してバインドされているパブリックACL一覧を取得できるオブジェクトは一つだけです。OIIDファイルに複数のOIIDを指定した場合はエラーになります。

バインドしているオブジェクトの一覧を取得する場合，バージョン付きオブジェクトの１バージョンはバージョンなしオブジェクトとして表示されます。
例えば，図5-2のようにバージョン付き文書の1バージョンにパブリックACLがバインドしている場合，このコマンドを実行すると，バージョンなし文書バージョン2の情報が出力されます。

図5-2　バインドしているパブリックACLから一覧として取得できる文書

dbrlschild（コンテナに包含されるオブジェクト一覧の取得）

機能

コンテナに包含されるオブジェクトの情報を取得します。取得した情報は，標準出力に出力されます。OIIDファイルに複数のOIIDを指定すると，複数のコンテナに包含されるオブジェクトの一覧を一括して出力できます。

出力される情報はコンテインメントの種別，リンク識別子，オブジェクト種別およびOIIDです。構成管理型のコンテインメントが設定されている場合は，構成管理モードおよびバージョントレースしているオブジェクトのOIIDも出力できます。各情報はコンマ（,）で区切って出力されます。

出力される情報について，次に説明します。

コンテインメントの種別

次のどれかが出力されます。

DCR
直接型のコンテインメントが設定されている場合

RCR
参照型のコンテインメントが設定されている場合

VCR
構成管理型のコンテインメントが設定されている場合

リンク識別子

コンテインメントを識別するためのリンク識別子が出力されます。

オブジェクト種別

オブジェクトの種別を表す文字列が出力されます。「1.3.2　クラスライブラリとの関係」を参照してください。

OIID

オブジェクトのOIIDが出力されます。

構成管理モード

次のどちらかが出力されます。

FIX
FIXモードが設定されている場合

FLOATING
FLOATINGモードが設定されている場合

バージョントレースしているオブジェクトのOIID

構成管理型モードによって追跡しているオブジェクト（DocVersionオブジェクトまたはContainerVersionオブジェクト）のOIIDが出力されます。

操作クラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

形式

dbrlschild　〔 -l { DCR | RCR | VCR | ALL } 〕

　　　　　 〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　　{ OIID | OIIDファイル }

オプション

-l { DCR | RCR | VCR | ALL }

設定されているコンテインメントの種別を指定します。このオプションを省略した場合はALLが仮定されます。

DCR

直接型のコンテインメントで関連づけられているオブジェクトの情報を出力します。

RCR

参照型のコンテインメントで関連づけられているオブジェクトの情報を出力します。

VCR

構成管理型のコンテインメントで関連づけられているオブジェクトの情報を出力します。

ALL

コンテインメントの種別に関係なく，包含されているオブジェクトの情報を出力します。

コマンド引数

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き構成管理コンテナの場合，包含されるオブジェクトの一覧を取得するバージョンのバージョン識別子を指定します。このオプションを省略した場合は，最新バージョンのコンテナに包含されるオブジェクトの一覧を取得します。

バージョンなしコンテナおよびバージョンなし構成管理コンテナに包含されるオブジェクトの一覧を取得するときにこのオプションを指定するとエラーになります。

バージョン識別子

包含されるオブジェクトの一覧を取得するバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

包含されるオブジェクトの一覧を取得するバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

OIID

包含するオブジェクトの一覧を取得するコンテナのOIIDを指定します。

OIIDファイル

包含するオブジェクトの一覧を取得するコンテナのOIIDを記述したIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。ただし，-vオプションを指定している場合，記述できるOIIDの数は一つだけです。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

実行例

実行例を次に示します。なお，実行環境制御ファイルのOutputセクションのFormatエントリの指定，および指定したオプションによって，出力形式が異なります。また，例で改行されている場合も，実際には1オブジェクトに対応する情報は1行で出力されます。

（Formatエントリが「VR0112」の場合）

$ dbrlschild  dma:///07a17522…00000020
# dma:///07a17522…00000020
DCR,RC,dma:///07a17522…00000021
RCR,VD,dma:///07a17522…00000022
VCR,CRC,dma:///07a17522…00000023
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

（Formatエントリが「VR0200」の場合）

$ dbrlschild  dma:///07a17522…00000020
# dma:///07a17522…00000020
DCR,acl:///LD…0021,RC,dma:///07a17522…00000021
RCR,acl:///LR…0022,VD,dma:///07a17522…00000022
VCR,acl:///LV…0023,CRC,dma:///07a17522…00000023
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

-l VCRオプションを指定した場合には，構成管理モードおよびバージョントレースOIIDも出力されます。

$ dbrlschild  -l  VCR  dma:///07a17522…00000020
# dma:///07a17522…00000020
VCR,FLOATING,acl:///LV…0023,CRC,dma:///07a1…0023,dma:///07a1…0024
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

実行環境制御ファイルでOutputセクションのFormatエントリに「VR0112」を指定した場合，重複は排除されません。

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

-vオプション指定時には，複数のコンテナに包含されるオブジェクトの一覧は一括して取得できません。指定したバージョンの包含されるオブジェクトの一覧が取得できるコンテナは一つだけです。OIIDファイルに複数のOIIDを指定した場合はエラーになります。

バージョンなしコンテナに対して-l VCRオプションを指定した場合，何もしないで正常終了します。

dbrlscompo（マルチファイル文書のコンテント情報一覧の取得）

機能

マルチファイル文書のコンテント情報を取得します。取得した情報は，標準出力に出力されます。OIIDファイルに複数のOIIDを指定すると，マルチファイル文書のコンテント情報一覧を一括して取得できます。

出力される情報は，コンテント情報の有効モード，コンポーネント種別，ファイル名，およびコンテントサイズです。なお，1行目にコンテント情報の有効モード，2行目以降にコンポーネント種別，ファイル名およびコンテントサイズが出力されます。各情報はコンマ（,）で区切って出力されます。出力される情報を次に示します。

コンテント情報の有効モード

コンテント情報の有効モードが出力されます。出力される情報は，（[SYSTEM]）固定です。

コンポーネント種別

ファイルを識別する文字列が出力されます。

ファイル名

ファイル名が出力されます。

コンテントサイズ

ファイルのサイズが出力されます。

操作クラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

形式

dbrlscompo　〔 -v { バージョン識別子 | バージョン識別子ファイル }〕

　　　　　　〔 -M レンディションタイプ 〕

　　　　　　{ OIID | OIIDファイル }

オプション

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き文書の場合，コンテント情報を取得するバージョンのバージョン識別子を指定します。このオプションを省略した場合は，最新バージョンのコンテント情報を取得します。

なお，バージョンなし文書のコンテント情報を取得するときに，このオプションを指定するとエラーになります。

バージョン識別子

コンテント情報を取得するバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

コンテント情報を取得するバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-M　レンディションタイプ

マルチファイル文書のコンテント情報を取得する場合に，コンテント情報を取得するレンディションのタイプを指定します。このオプションを省略した場合は，マスタレンディションを仮定します。

コマンド引数

OIID

コンテント情報を取得するマルチファイル文書のOIIDを指定します。

OIIDファイル

コンテント情報を取得するマルチファイル文書のOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。ただし，-vオプションを指定している場合，記述できるOIIDの数は一つだけです。

OIIDファイルのファイル名は，オブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

実行例

実行例を次に示します。

$ dbrlscompo  dma:///07a17522…00000036
# dma:///07a17522…00000036
[SYSTEM]
body,foo,128
fig-1,bar,64
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

-vオプション指定時は，複数のマルチファイル文書のコンテント情報一覧を一括して取得できません。-vオプションに指定したバージョン識別子のマルチファイル文書のコンテント情報一覧を取得できる文書は一つだけです。OIIDファイルに複数のOIIDを指定した場合はエラーになります。

dbrlsparent（オブジェクトを包含するコンテナ一覧の取得）

機能

対象オブジェクトを包含しているコンテナの情報を取得します。取得した情報は，標準出力に出力されます。OIIDファイルに複数のOIIDを指定すると，複数のオブジェクトを包含しているコンテナの一覧を一括して取得できます。

出力される情報はコンテインメントの種別，リンク識別子，オブジェクト種別およびOIIDです。各情報はコンマ（,）で区切って出力されます。出力される情報について，次に説明します。

コンテインメントの種別

次のどれかが出力されます。

DCR
直接型のコンテインメントが設定されている場合

RCR
参照型のコンテインメントが設定されている場合

VCR
構成管理型のコンテインメントが設定されている場合

リンク識別子

コンテインメントを識別するためのリンク識別子が出力されます。

オブジェクト種別

オブジェクトの種別を表す文字列が出力されます。「1.3.2　クラスライブラリとの関係」を参照してください。

OIID

オブジェクトのOIIDが出力されます。

操作クラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

形式

dbrlsparent　〔 -l { DCR | RCR | VCR | ALL } 〕　{ OIID | OIIDファイル }

オプション

-l { DCR | RCR | VCR | ALL }

出力するコンテナとの間に設定されているコンテインメントの種別を指定します。このオプションを省略した場合はALLが仮定されます。

DCR

直接型のコンテインメントが設定されているコンテナを出力します。

RCR

参照型のコンテインメントが設定されているコンテナを出力します。

VCR

構成管理型のコンテインメントが設定されているコンテナを出力します。

ALL

バージョン付き文書またはバージョン付き構成管理コンテナの場合，直接型のコンテインメント，参照型のコンテインメントおよび構成管理型のコンテインメントが設定されているコンテナの情報を出力します。

バージョン付き文書およびバージョン付き構成管理コンテナ以外の場合，直接型のコンテインメントおよび参照型のコンテインメントが設定されている情報を出力します。

コマンド引数

OIID

包含するコンテナの一覧を取得するオブジェクトのOIIDを指定します。

OIIDファイル

包含するコンテナの一覧を取得するオブジェクトのOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

実行例

実行例を次に示します。なお，実行環境制御ファイルでのOutputセクションのFormatエントリの指定によって，出力形式が異なります。

（Formatエントリが「VR0112」の場合）
$ dbrlsparent  dma:///07a17522…00000030
# dma:///07a17522…00000030
DCR,RC,dma:///07a17522…00000031
RCR,VTC,dma:///07a17522…00000032
VCR,CRC,dma:///07a17522…00000033
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

（Formatエントリが「VR0200」の場合）
$ dbrlsparent  dma:///07a17522…00000030
# dma:///07a17522…00000030
RCR,acl:///LD…0031,RC,dma:///07a17522…00000031
DCR,acl:///LR…0032,VTC,dma:///07a17522…00000032
VCR,acl:///LV…0033,CRC,dma:///07a17522…00000033
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

実行環境制御ファイルのOutputセクションのFormatエントリに「VR0112」を指定している場合，重複は排除されません。

バージョン付き構成管理コンテナの1バージョンは，バージョンなし構成管理コンテナとしても出力されます。
例えば，図5-3のようにバージョン付き構成管理コンテナの1バージョンが直接型，参照型または構成管理型のコンテインメントで文書を包含している場合，このコマンドを実行するとバージョン付きコンテナとバージョンなしコンテナバージョン2の情報が出力されます。

図5-3　1バージョンが直接型，参照型または構成管理型のコンテインメントで文書を包含している場合に文書から取得できるコンテナ

また，図5-4のようにバージョン付き構成管理コンテナの複数のバージョンが参照型または構成管理型のコンテインメントで同じ文書を包含している場合，このコマンドを実行するとバージョン付きコンテナとバージョンなしコンテナバージョン1およびバージョン2の情報が出力されます。

図5-4　複数のバージョンが参照型または構成管理型のコンテインメントで同じ文書を包含している場合に文書から取得できるコンテナ

構成管理型のコンテインメントを設定できないオブジェクトの場合に-l VCRオプションを指定した場合，何もしないで正常終了します。

dbrlsversion（バージョン一覧の取得）

機能

オブジェクトに対してすでに確定しているバージョンの情報を取得します。取得した情報は，標準出力に出力されます。OIIDファイルに複数のOIIDを指定すると，複数のオブジェクトのバージョン一覧が一括して出力されます。

出力される情報はバージョン識別子です。

操作クラス

CdbrVersionableDocumentクラス

CdbrConfiguratedReferentialContainerクラス

形式

dbrlsversion　〔 -o { ASC |DESC | NONE } 〕　{ OIID | OIIDファイル }

オプション

-o { ASC | DESC | NONE }

出力する順序を指定します。このオプションを省略した場合はNONEが仮定されます。

ASC

古いバージョンから出力します。

DESC

新しいバージョンから出力します。

NONE

出力する順序を指定しません。

コマンド引数

OIID

バージョン一覧を取得するオブジェクトのOIIDを指定します。

OIIDファイル

バージョン一覧を取得するオブジェクトのOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

実行例

実行例を次に示します。

$ dbrlsversion  dma:///07a17522…00000034
# dma:///07a17522…00000034
acl:///VD…0035
acl:///VD…0036
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

なし

dbrlsversionable（バージョン管理情報一覧の取得）

機能

管理オブジェクトの情報を取得します。取得した情報は，標準出力に出力されます。OIIDファイルに複数のOIIDを指定すると，複数のオブジェクトのバージョン管理情報一覧を一括して取得できます。

出力される情報はオブジェクト種別，OIIDおよびバージョン識別子です。各情報はコンマ（,）で区切って出力されます。出力される情報について，次に説明します。

オブジェクト種別

オブジェクトの種別を表す文字列が出力されます。「1.3.2　クラスライブラリとの関係」を参照してください。

OIID

オブジェクトのOIIDが出力されます。

バージョン識別子

オブジェクトのバージョン識別子が出力されます。

操作クラス

CdbrDocumentクラス

CdbrVersionTraceableContainerクラス

形式

dbrlsversionable　{ OIID | OIIDファイル }

オプション

なし

コマンド引数

OIID

管理オブジェクトの一覧を取得するオブジェクトのOIIDを指定します。

OIIDファイル

管理オブジェクトの一覧を取得するオブジェクトのOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

実行例

実行例を次に示します。なお，実行環境制御ファイルでのOutputセクションのFormatエントリの指定によって，出力形式が異なります。

（Formatエントリが「VR0112」の場合）
$ dbrlsversionable  dma:///07a17522…0000037
# dma:///07a17522-a626-11d0-b11f-0020af27a837/…0000037
VD,dma:///07a17522…0000038
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

（Formatエントリが「VR0200」の場合）
$ dbrlsversionable  dma:///07a17522…0000037
# dma:///07a17522-a626-11d0-b11f-0020af27a837/…0000037
VD,dma:///07a17522…0000038,acl:///VD…00000037
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

なし

dbrrndrdoc（文書のレンディション操作）

機能

文書のレンディションを操作します。次の操作ができます。

レンディションの追加

マスタレンディションの変更

レンディションの削除

レンディション一覧の取得
なお，レンディション一覧の取得で出力される情報は，レンディションタイプです。

操作クラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

形式

レンディションを追加する場合

dbrrndrdoc　-x ADD　-M レンディションタイプ

　　　　　〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　〔 -t { USER | BATCH } 〕

　　　　　〔 -k { Content | FileLink

　　　　　　　〔 -j コンテント登録先FAM名 〕

　　　　　　　〔 -g コンテント登録先パス 〕 } 〕

　　　　　{ OIID | OIIDファイル }　〔 登録ファイルURL 〕

マスタレンディションを変更する場合

dbrrndrdoc　-x CHANGE　-M レンディションタイプ

　　　　　〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　{ OIID | OIIDファイル }

レンディションを削除する場合

dbrrndrdoc　-x DELETE　-M レンディションタイプ

　　　　　〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　{ OIID | OIIDファイル }

レンディション一覧を取得する場合

dbrrndrdoc　-x LIST

　　　　　〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　〔 -p プロパティ情報ファイル 〕

　　　　　{ OIID | OIIDファイル }

オプション

-x { ADD | CHANGE | DELETE | LIST }

操作の種類を指定します。このオプションを省略した場合は，LISTが仮定されます。

ADD

レンディションを追加します。

CHANGE

マスタレンディションを変更します。

DELETE

レンディションを削除します。

LIST

レンディション一覧を取得します。

-M レンディションタイプ

操作するレンディションのレンディションタイプを指定します。

-xオプションのオプションの引数にLIST以外を指定した場合，このオプションは省略できません。

-xオプションのオプションの引数にLISTを指定した場合，このオプションを指定するとエラーになります。

-v { バージョン識別子 | バージョン識別子ファイル }

バージョン付き文書の場合，操作するバージョンのバージョン識別子を指定します。このオプションを省略した場合は，最新バージョンが仮定されます。

バージョンなし文書の場合にこのオプションを指定するとエラーになります。

バージョン識別子

操作するバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

操作するバージョンのバージョン識別子を記述したファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-t { USER | BATCH }

ファイル指定の種類を指定します。

-xオプションのオプションの引数にADD以外を指定した場合，このオプションを指定するとエラーになります。また，-kオプションにFileLinkを指定した場合，このオプションにUSER以外を指定するとエラーになります。

-xオプションのオプションの引数にADDを指定した場合，このオプションを省略するとUSERが仮定されます。

USER

コマンド引数の登録ファイルURLに指定したファイルを，追加したレンディションに登録します。

BATCH

ファイルが未登録のレンディションを追加します。

追加したレンディションは，DocumentBroker Rendering Optionによってマスタレンディションに登録されたファイルを変換する場合に，変換後のファイルを登録するために使用します。

-k { Content | FileLink 〔 -j コンテント登録先FAM名 〕〔 -g コンテント登録先パス 〕 }

レンディションを追加して登録する文書のコンテント種別を指定します。

-x ADDオプション以外を指定した場合，このオプションを指定するとエラーになります。また，このオプションにFileLinkを指定した場合に，-tオプションにUSER以外を指定するとエラーになります。

なお，このオプションを省略した場合，Contentが仮定されます。

Content

シングルファイル文書のレンディションを追加します。コンテントは，データベースに登録します。

FileLink

File Link文書のレンディションを追加します。コンテントは，ファイルサーバに登録します。

-j コンテント登録先FAM名

File Link文書のレンディションを追加する場合に，コンテントの登録先となるファイルサーバのFAM名を指定します。-kオプションにFileLinkを指定していない場合に，このオプションを指定するとエラーになります。このオプションを省略した場合，実行環境制御ファイルのFileLinkセクションの，DefaultFAMNameエントリに指定されたFAM名のファイルサーバを使用します。

-g コンテント登録先パス

File Link文書としてレンディションを追加する場合に，ファイルサーバ上の登録先パスを指定します。

クライアントのコンテントを指定してレンディションを追加するとき，およびファイルサーバ上に登録されているコンテントを指定してレンディションを追加するときの，オプションの引数の指定方法を次に示します。

クライアントのコンテントを指定してレンディションを追加するとき
ファイルサーバ上の登録先ディレクトリのパスを指定します。ディレクトリのパスの末尾にはデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述します。ファイルサーバに登録するコンテントは，登録ファイルURLで指定します。
このオプションに指定した登録先ディレクトリが存在しない場合，ディレクトリが作成され，コンテントが登録されます。ただし，ディレクトリの末尾にデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述しない場合，コンテント名称の自動生成を行わない（実行環境制御ファイルで，FileLinkセクションの FileNamingModeエントリにSpecifyを指定している）環境で，このオプションに指定したディレクトリがファイルサーバ上に存在するとエラーになり，存在しないとこのオプションで指定した名称でコンテントが登録されます。
UNIXの場合に，コンテントの登録先ディレクトリが，「/dir01/data」の下位にある「area1」ディレクトリのとき，次のように指定します。

指定形式の種別
指定例

フルパス指定
/dir01/data/area1/

エイリアス指定
DATA/area1/
（「/dir01/data」のエイリアス名が「DATA」のとき）

また，Windowsの場合に，コンテントの登録先ディレクトリが，「c:¥dir01¥data」の下位にある「area1」ディレクトリのとき，次のように指定します。

指定形式の種別
指定例

フルパス指定
c:¥dir01¥data¥area1¥

エイリアス指定
DATA¥area1¥
（「c:¥dir01¥data」のエイリアス名が「DATA」のとき）

ファイルサーバ上に登録されているコンテントを指定してレンディションを追加するとき
ファイルサーバ上のコンテントのパスを指定します。登録ファイルURLには，DBRSVCONTENTを指定します。

なお，-kオプションにFileLinkを指定していない場合に，このオプションを指定するとエラーになります。このオプションを省略した場合，実行環境制御ファイルのFileLinkセクションの，DefaultContentPathエントリの指定を使用します。ファイルサーバ上に登録されているコンテントを指定してレンディションを追加する場合には，このオプションは省略できません。

UNIXの場合に，レンディションの追加に使用するコンテントが，「/dir01/data/area1」の下位にある「file.jpg」のとき，次のように指定します。

指定形式の種別
指定例

フルパス指定
/dir01/data/area1/file.jpg

エイリアス指定
DATA/area1/file.jpg
（「/dir01/data」のエイリアス名が「DATA」のとき）

Windowsの場合に，レンディションの追加に使用するコンテントが，「c:¥dir01¥data¥area1」の下位にある「file.jpg」のとき，次のように指定します。

指定形式の種別
指定例

フルパス指定
c:¥dir01¥data¥area1¥file.jpg

エイリアス指定
DATA¥area1¥file.jpg
（「/dir01/data」のエイリアス名が「DATA」のとき）

-p プロパティ情報ファイル

-xオプションにLISTを指定してレンディションの一覧を取得するときに，同時にプロパティ値を取得する場合，レンディションの一覧を取得するオブジェクトのクラス名，およびプロパティ値を取得するプロパティの名称を記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスの指定は，絶対パスまたは相対パスのどちらでも指定できます。

取得したプロパティ値は，レンディションタイプに続いてコンマ（,）で区切って出力されます。

指定できるプロパティを次に示します。次のプロパティ以外を指定した場合は，エラーとなります。

dbrProp_RetrievalName
レンディションのdbrProp_RetrievalNameプロパティの値を取得する場合に指定します。

dbrProp_RenditionStatus
レンディションのdbrProp_RenditionStatusプロパティの値を取得する場合に指定します。
dbrProp_RenditionStatusプロパティの値は，マスタレンディションとサブレンディションの状態を表します。10進数で表示されます。
dbrProp_RenditionStatusプロパティに設定される値とレンディションの状態の関係を次の表に示します。なお，dbrProp_RenditionStatusプロパティには，16進数の値が設定されます。また，指定したレンディションがマスタレンディションの場合は，DBR_RENDSTATUS_MASTERD（00000000：4バイトの16進数）が設定されます。

表5-4　dbrProp_RenditionStatusプロパティの値とレンディションの状態の関係（状態フラグ：下位2バイト）

dbrProp_RenditionStatusプロパティの値 | 対応する値（16進数） | レンディションの状態
DBR_RENDSTATUS_NO_SUBREND | 0001 | 指定したサブレンディションに対応するマスタレンディションのコンテントは登録済みですが，サブレンディションのコンテントが未登録です。
DBR_RENDSTATUS_SUBREND_EXIST | 0002 | 指定したサブレンディションに対応するマスタレンディションおよびサブレンディションのコンテントが登録されています。
DBR_RENDSTATUS_MASTERREND_UPDATE | 0004 | 指定したサブレンディションに対応するマスタレンディションが更新されていますが，サブレンディションが更新されていないため，マスタレンディションとサブレンディションの内容が不一致です。

表5-5　dbrProp_RenditionStatusプロパティの値とレンディションの状態の関係（変換フラグ：上位2バイト）

dbrProp_RenditionStatusプロパティの値 | 対応する値（16進数） | レンディションの状態
DBR_RENDSTATUS_CONVERT_NOTREQUIRED | 0000 | レンディション変換が不要な状態です。この状態の場合，DocumentBroker Rendering Optionによるレンディション変換の対象になりません。
DBR_RENDSTATUS_CONVERT_REQUIRED | 0001 | レンディション変換が必要な状態です。この状態の場合，DocumentBroker Rendering Optionによるレンディション変換の対象になります。
DBR_RENDSTATUS_CONVERT_ERROR | 0002 | DocumentBroker Rendering Optionによるレンディション変換時にエラーが発生した状態です。この状態になると，DocumentBroker Rendering Optionによるレンディション変換はできなくなります。

dbrProp_ContentType
レンディションのdbrProp_ContentTypeプロパティの値（コンテントの登録先）を取得する場合に指定します。
dbrProp_ContentTypeプロパティは，各レンディションに対応したコンテント種別を示します。コンテント種別から，レンディションのコンテントがマルチファイル文書か，シングルファイル文書か，File Link文書か，またはリファレンスファイル文書かどうか知ることができます。このプロパティは，Integer32型の4バイトの値として表示されます。
dbrProp_ContentTypeプロパティの値とコンテント種別の関係を次の表に示します。

表5-6　dbrProp_ContentTypeプロパティの値とコンテント種別の関係

dbrProp_ContentTypeプロパティの値 | 対応する値 | コンテント種別
DBR_CONTENTTYPE_CONTENT | 0 | ContentTransferオブジェクト（シングルファイル文書であるコンテント）です。
DBR_CONTENTTYPE_FILELINK | 1 | ContentFileLinkオブジェクト（File Link文書であるコンテント）です。
DBR_CONTENTTYPE_MULTIFILE | 2 | ContentTransfersオブジェクト（マルチファイル文書であるコンテント）です。
DBR_CONTENTTYPE_REFERENCE | 3 | ContentReferenceオブジェクト（リファレンスファイル文書であるコンテント）です。
DBR_CONTENTTYPE_OTHER | -1 | 上記以外のコンテントを持つオブジェクトです。

dbrProp_ReferenceType
リファレンスファイル文書のレンディションのReferenceTypeプロパティの値を取得する場合に指定します。
ReferenceTypeプロパティの値は，コンテントのリファレンス種別を表します。ReferenceTypeプロパティの値とリファレンス種別の関係を次の表に示します。

表5-7　dbrProp_ReferenceTypeプロパティの値とリファレンス種別の関係

dbrProp_ReferenceTypeプロパティの値 | 対応する値 | リファレンス種別
DBR_REFERENCETYPE_NONE | 0 | コンテントはありません。
DBR_REFERENCETYPE_USER_RELATIVE_CONTENT | 1001 | ユーザ管理領域に格納したコンテント（相対パス）です。

dbrProp_ContentLocation
リファレンスファイル文書のレンディションのContentLocation（コンテントロケーション）を取得する場合に指定します。

コマンド引数

OIID

操作する文書のOIIDを指定します。

OIIDファイル

操作する文書のOIIDを記述したOIIDファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

登録ファイルURL

シングルファイル文書の場合，追加するレンディションに登録するファイルのファイルパスをURL形式で指定します。

File Link文書の場合，クライアントのコンテントを指定してレンディションを追加するときは，ファイルサーバに登録するコンテントのパスをURL形式で指定します。また，ファイルサーバ上に登録されているコンテントを指定してレンディションを追加するときは，DBRSVCONTENTを指定して，-gオプションに利用するファイルサーバ上のコンテントのパスを指定します。なお，ファイルサーバ上に登録されているコンテントを使用するとき，-gオプションを省略するとエラーになります。

例えば，UNIXの場合，「/tmp/add.doc」を登録するときには，「file:///tmp/add.doc」と指定します。Windowsの場合，「c:¥temp¥add.doc」を登録するときには，「file:///c:¥temp¥add.doc」と指定します。

なお，-x ADDオプション以外を指定した場合，このコマンド引数を指定するとエラーになります。

実行例

実行例を次に示します。なお，この例はWindowsの場合です。UNIXの場合は，「file:///c:¥temp¥add.txt」を「file:///tmp/add.txt」に，「type PropFile」を「cat PropFile」に読み替えてください。

$ dbrrndrdoc -x LIST dma:///07a17522…00000051
# dma:///07a17522…00000051
MIME::application/ms-word
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

$ dbrrndrdoc -x ADD -M MIME::text/plain dma:///07a17522…00000051 file:///c:¥temp¥add.txt
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

$ dbrrndrdoc -x LIST dma:///07a17522…00000051
# dma:///07a17522…00000051
MIME::application/ms-word
MIME::text/plain
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

$ dbrrndrdoc -x CHANGE -M MIME::text/plain dma:///07a17522…00000051
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

$ dbrrndrdoc -x DELETE -M MIME::application/ms-word dma:///07a17522…00000051
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

$ dbrrndrdoc -x LIST dma:///07a17522…00000051
# dma:///07a17522…00000051
MIME::text/plain
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

$ type PropFile
[usrClass_Document]
dbrProp_ContentType
dbrProp_RetrievalName
dbrProp_RenditionStatus

$ dbrrndrdoc -x LIST -p PropFile dma:///07a17522…00000051
# dma:///07a17522…00000051
MIME::application/ms-word,0,資料1.doc,0
MIME::text/plain,0,資料1.txt,2
KMBR32002-I 1件のオブジェクトに対する操作を行いました。

注意事項

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

-xオプションのオプションの引数にADDを指定した場合，すでに存在するレンディションタイプを-Mオプションで指定すると，実行メソッドでエラーになります。

-xオプションのオプションの引数にADDを指定して，-tオプションを省略または-tオプションのオプションの引数にUSERを指定する場合は，必ず登録ファイルURLを指定してください。登録ファイルURLを省略すると，実行メソッドでエラーになります。

-xオプションのオプションの引数にADDを指定して，-tオプションのオプションの引数にBATCHを指定する場合は，登録ファイルURLを指定しないでください。登録ファイルURLを指定すると，実行メソッドでエラーになります。

-xオプションのオプションの引数にCHANGEを指定した場合，マスタレンディションのレンディションタイプまたは存在しないレンディションタイプを-Mオプションで指定すると，実行メソッドでエラーになります。

-xオプションのオプションの引数にDELETEを指定した場合，マスタレンディションのレンディションタイプまたは存在しないレンディションタイプを-Mオプションで指定すると，実行メソッドでエラーになります。

File Link文書で，コンテントの登録先を，ファイルサーバとする場合，-kオプションでFile Linkを指定します。この場合，-kオプションは省略できません。

File Link文書の，ファイルサーバ上のコンテントの削除モードは，クライアントのコンテントを指定してレンディションを追加した場合と，ファイルサーバ上に登録されているコンテントを指定してレンディションを追加した場合で異なります。それぞれの場合のコンテントの削除モードを次に示します。

クライアントのコンテントを指定してレンディションを追加した場合
クライアントのコンテントを指定して追加したレンディションを削除すると，ファイルサーバ上のコンテントも同期して削除されます。なお，コンテントとしてディレクトリを登録したときは，ディレクトリごと削除されます。

ファイルサーバ上に登録されているコンテントを指定してレンディションを追加した場合
ファイルサーバ上に登録されているコンテントを指定して追加したレンディションを削除しても，ファイルサーバ上のコンテントは削除されません。なお，コンテントにディレクトリを使用しているときでも，ディレクトリは削除されません。

コンテントの削除モードを変更する場合は，実行環境制御ファイルのFileLinkセクションの，ClientContentDeleteModeエントリ，またはServerContentDeleteModeエントリの設定を変更してください。

リファレンスファイル文書の場合，レンディションは追加できません。

dbrsetmode（構成管理モードの設定）

機能

構成管理モードを設定します。

構成管理モードは，バージョン付き構成管理コンテナによって包含されるオブジェクトのバージョンを構成管理するためのモードです。

バージョン付き構成管理コンテナによってバージョン付き文書を構成管理している例を，図5-5に示します。

図5-5　バージョン付き構成管理コンテナによってバージョン付き文書を構成管理している例

図5-5では，三つのバージョンを持つバージョン付き構成管理コンテナ（コンテナ）によって，二つのバージョンを持つバージョン付き文書（文書）を，次のように構成管理しています。

コンテナのバージョン1では，文書のバージョン1をFIXモードで管理しています。

コンテナのバージョン2では，文書のバージョン2をFIXモードで管理しています。

コンテナのバージョン3では，文書のバージョン2をFLOATINGモードで管理しています。

構成管理モードの設定とは，コンテナの構成管理モードを，FIXモードまたはFLOATINGモードに設定（変更）することです。例えば，コンテナのバージョン3が文書を管理する構成管理モードとしてFIXモードを設定すると，文書がバージョン3にバージョンアップした場合も，バージョンなし構成管理コンテナは文書のバージョン2を管理したままになります。これをFLOATINGモードに変更すると，コンテナのバージョン3が管理する文書は，バージョン3の文書になります。

図5-5のコンテナのバージョン3に，FIXモードを設定した場合とFLOATINGモードを設定した場合に管理する文書のバージョンを，図5-6に示します。

図5-6　FIXモードを設定した場合とFLOATINGモードを設定した場合に管理する文書のバージョン

注意

図5-5の場合，コンテナのバージョン3がFLOATINGモードで管理している文書のバージョン2の内容を更新すると，コンテナのバージョン2がFIXモードで管理している文書の内容も更新されます。

操作クラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

形式

構成管理コンテナでリンク識別子を指定しない場合

dbrsetmode -m { FLOATING | FIX }

　　　　　 〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　　{ 包含するオブジェクトのOIID

　　　　　　| 包含するオブジェクトのOIIDファイル }

　　　　　　{ 包含されるオブジェクトのOIID

　　　　　　| 包含されるオブジェクトのOIIDファイル }

構成管理コンテナでリンク識別子を指定する場合

dbrsetmode -m { FLOATING | FIX

　　　　　　〔 -w { DBRVTVERSION |

　　　　　　　固定バージョン識別子 | 固定バージョン識別子ファイル } 〕 }

　　　　　　　-L { リンク識別子 | リンク識別子ファイル }

　　　　　　　{ 包含するオブジェクトのOIID

　　　　　　　 | 包含するオブジェクトのOIIDファイル }

オプション

-m　{ FLOATING | FIX }

設定する構成管理モード種別を指定します。このオプションは省略できません。

FLOATING

FLOATINGモードを設定します。

FIX

FIXモードを設定します。

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き構成管理コンテナの場合，構成管理モードを設定するバージョンのバージョン識別子を指定します。このオプションを省略した場合は最新バージョンの構成管理モードが設定されます。

バージョンなし構成管理コンテナの場合にこのオプションを指定するとエラーになります。

バージョン識別子

構成管理モードを設定するバージョン付き構成管理コンテナのバージョン識別子を指定します。

バージョン識別子ファイル

構成管理モードを設定するバージョン付き構成管理コンテナのバージョン識別子を記述したファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-w　{ 固定バージョン識別子 | 固定バージョン識別子ファイル }

FIXモードを設定する場合に固定するバージョン識別子を指定します。このオプションは，-Lオプションおよび-m FIXオプションを指定した場合だけ指定できます。このオプションを省略した場合は最新バージョンが仮定されます。

DBRVTVERSION

現在構成管理されているバージョンで固定します。

固定バージョン識別子

FIXモードで固定するバージョン識別子を指定します。

固定バージョン識別子ファイル

FIXモードで固定するバージョンのバージョン識別子を記述したファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「acl://」で始まるパスは指定できません。なお，このバージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-L　{ リンク識別子 | リンク識別子ファイル }

構成管理モードを設定するリンク識別子を指定します。

リンク識別子

構成管理モードを設定するリンク識別子を指定します。

リンク識別子ファイル

構成管理モードを設定するリンク識別子を記述したファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「acl://」で始まるパスは指定できません。なお，リンク識別子ファイルに記述できるリンク識別子の数は一つだけです。

コマンド引数

包含するオブジェクトのOIID

構成管理モードを変更する包含するオブジェクトのOIIDを指定します。

包含するオブジェクトのOIIDファイル

構成管理モードを変更する包含するオブジェクトのOIIDを記述したファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ただし，「dma://」で始まるパスは指定できません。なお，包含するオブジェクトのOIIDファイルに記述できるOIIDの数は一つだけです。

包含されるオブジェクトのOIID

構成管理モードを変更する包含されるオブジェクトのOIIDを指定します。

包含されるオブジェクトのOIIDファイル

構成管理モードを変更する包含されるオブジェクトのOIIDを記述したファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスの指定は，絶対パスまたは相対パスのどちらでもかまいません。ただし，「dma://」で始まるパスは指定できません。なお，包含されるオブジェクトのOIIDファイルに記述できるOIIDの数は一つだけです。

注意事項

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

バージョン付き構成管理コンテナで-vオプションと-Lオプションを同時に指定することはできません。

指定したリンク識別子のコンテインメントが存在しない場合は，実行メソッドでエラーになります。

構成管理コンテナでリンク識別子を指定しないでFIXモードを設定する場合，二つのオブジェクト間に設定されているすべての構成管理型のコンテインメントに対して，FIXモードを設定して，現在構成管理しているバージョンで固定します。

すでに設定されている構成管理モードを指定した場合，構成管理モードを再設定します。

指定した二つのオブジェクト間に構成管理型のコンテインメントが設定されていない場合は，何もしないで正常終了します。

dbrsetprop（プロパティの設定）

機能

プロパティ情報ファイルに記述した内容に従ってオブジェクトのプロパティを設定します。OIIDファイルに複数のOIIDを指定することで，複数のオブジェクトのプロパティを一括して設定できます。

操作クラス

CdbrIndependentPersistenceクラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

CdbrPublicACLクラス

形式

dbrsetprop　〔 { -v { バージョン識別子 | バージョン識別子ファイル } |

　　　　　　　-L { リンク識別子 | リンク識別子ファイル } }〕

　　　　　　{ OIID | OIIDファイル }　プロパティ情報ファイル

オプション

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き文書またはバージョン付き構成管理コンテナの場合，プロパティを設定するバージョンのバージョン識別子を指定します。このオプションおよび-Lオプションを省略した場合は，すべてのバージョンで共有するプロパティが設定されます。

バージョン付き文書およびバージョン付き構成管理コンテナ以外の場合に，このオプションを指定するとエラーになります。

バージョン識別子

プロパティを設定するバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

プロパティを設定するバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-L　{ リンク識別子 | リンク識別子ファイル }

コンテナの場合，プロパティを設定するコンテインメントのリンク識別子を指定します。このオプションおよび-vオプションを省略した場合は，すべてのバージョンで共有するプロパティが設定されます。

コンテナ以外のプロパティを設定するときにこのオプションを指定するとエラーになります。

リンク識別子

プロパティを設定するコンテインメントのリンク識別子を指定します。

リンク識別子ファイル

プロパティを設定するコンテインメントのリンク識別子を記述したリンク識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「acl://」で始まるパスは指定できません。なお，リンク識別子ファイルに記述できるリンク識別子の数は一つだけです。

コマンド引数

OIID

プロパティを設定するオブジェクトのOIIDを指定します。

OIIDファイル

プロパティを設定するオブジェクトのOIIDを記述したOIIDファイルのファイルパスを指定します。OIIDファイルには，複数のOIIDが指定できます。ただし，-vオプションまたは-Lオプションを指定している場合，記述できるOIIDの数は一つだけです。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。

プロパティ情報ファイル

設定するオブジェクトのクラス名および設定するプロパティを記述したプロパティ情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

プロパティ情報ファイルの記述例

独立データのプロパティを変更する場合のedmClass_IndependentPersistence用プロパティ情報ファイルの記述例を示します。変更するプロパティだけ指定します。

;; usrClass_IndependentPersistence
[usrClass_IndependentPersistence]
usrProp_IsReadOnly=FALSE
usrProp_State=999
usrProp_Title='Independent2'
usrProp_Authors[4][2]= '
{
  {usrProp_Name='suzuki', usrProp_Age=27},
  {usrProp_Name='yamada', usrProp_Age=30},
  {usrProp_Name='sato',   usrProp_Age=32},
  {usrProp_Name='kimura', usrProp_Age=25}
}

注意事項

OIIDファイルに記述したOIID数とプロパティ情報ファイルに記述したセクション数が同じでない場合，エラーになります。オブジェクトのOIIDを指定した場合，プロパティ情報ファイルに記述するセクション数は一つでなければなりません。

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

-vオプションまたは-Lオプション指定時には，複数のオブジェクトに対してプロパティを一括して設定することはできません。指定したバージョンおよびコンテインメントのプロパティを設定できるオブジェクトは一つだけです。OIIDファイルに複数のOIIDを指定した場合はエラーになります。

バージョン付き構成管理コンテナに対して，-vオプションと-Lオプションを同時に指定することはできません。

プロパティエントリが一つもないセクションを記述したプロパティ情報ファイルを指定すると，実行メソッドでエラーになります。

基本単位がVariableArray型のObject型のプロパティを設定する場合，一部の構成要素プロパティだけを設定することはできません。すべての配列および構成要素プロパティを設定してください。

クラスライブラリ固有のプロパティは，クラス定義情報ファイルに記述していなくても，セクション名に指定したクラスのプロパティとして設定できます。ただし，指定したオブジェクトの操作クラスに導入されていないクラスライブラリ固有のプロパティを指定した場合は，実行メソッドでエラーになります。

プロパティ情報ファイルに記述したクラス名はクラス定義情報ファイルにアクセスする時だけ参照します。プロパティの設定には影響しません。

dbrtoolsetup（実行環境のセットアップ）

機能

オブジェクト操作ツールの実行環境をセットアップします。

形式

dbrtoolsetup　〔-x { CREATE | UPDATE } 〕　実行環境ディレクトリ

オプション

-x { CREATE | UPDATE }

セットアップの処理種別を指定します。このオプションを省略した場合は，UPDATEが仮定されます。

CREATE

UNIXの場合は「実行環境ディレクトリ/etc」，Windowsの場合は「実行環境ディレクトリ¥etc」に，デフォルトの実行環境制御ファイルおよびクラス情報定義ファイルをコピーしてオブジェクト操作ツール実行環境を作成します。このオプションは最初にオブジェクト操作ツールを使用する場合に指定します。

UPDATE

オブジェクト操作ツールの実行環境を更新する場合に指定します。実行環境は，UNIXの場合は「実行環境ディレクトリ/etc」，Windowsの場合は「実行環境ディレクトリ¥etc」です。次の場合は必ずこのオプションを指定してコマンドを実行してください。

実行環境制御ファイルまたはクラス定義情報ファイルを変更した場合

DocumentBroker Development KitまたはDocumentBroker Runtimeをバージョンアップした場合

コマンド引数

実行環境ディレクトリ

オブジェクト操作ツールの実行環境ディレクトリのディレクトリパスを指定します。ディレクトリパスは絶対パスで指定してください。

注意事項

実行環境ディレクトリに指定したディレクトリが存在しない場合，エラーとなります。コマンド実行前にディレクトリが存在することを確認してください。

-x CREATEオプションを指定してコマンドを実行すると，図5-7に示すディレクトリおよびファイルが作成されます。なお，図5-7はWindowsの場合のディレクトリ構成です。UNIXの場合のディレクトリ構成については，図中の注を参照してください。

図5-7　実行環境作成時のディレクトリ構成（Windowsの場合）

すでに-x CREATEオプションを指定したコマンドの実行によって実行環境が作成されている状態で，再度-x CREATEオプションを指定して実行すると，コマンドは処理をスキップして正常終了します。

UNIXの場合，-x UPDATEオプションを指定してコマンドを実行できるのは，-x CREATEオプションを指定して実行環境を作成したユーザだけです。Windowsの場合，-x UPDATEオプションを指定してコマンドを実行できるユーザは，実行環境に設定されているアクセス権に依存します。

実行環境制御ファイルまたはクラス定義情報ファイルを変更後，-x UPDATEオプションを指定してコマンドを実行しなかった場合，オブジェクト操作ツールの実行が遅くなったり，エラーとなったりすることがあります。

このコマンドの実行に対するコマンド実行ログは出力されません。

実行環境を使用しなくなった場合は，実行環境ディレクトリ下のディレクトリおよびファイルを削除してください。

dbrunbind（パブリックACLのアンバインド）

機能

オブジェクトにバインドされているパブリックACLをアンバインドします。

操作クラス

アンバインドするオブジェクト

CdbrIndependentPersistenceクラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

アンバインドされるオブジェクト

CdbrPublicACLクラス

形式

dbrunbind　〔 -v { バージョン識別子 | バージョン識別子ファイル} 〕

　　　　　　{ OIID | OIIDファイル }

　　　　　　{ パブリックACL OIID | パブリックACL OIIDファイル }

オプション

-v　{ バージョン識別子 | バージョン識別子ファイル}

バージョン付き文書またはバージョン付き構成管理コンテナの場合，アンバインドするバージョンのバージョン識別子を指定します。このオプションを省略した場合は，オブジェクト自身からアンバインドされます。

バージョン付き文書およびバージョン付き構成管理コンテナ以外の場合に，このオプションを指定するとエラーになります。

バージョン識別子

アンバインドするバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

アンバインドするバージョンのバージョン識別子を記述したファイルのファイルパスを指定します。ファイルパスの指定は，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列，および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

コマンド引数

OIID

アンバインドするオブジェクトのOIIDを指定します。

OIIDファイル

アンバインドするオブジェクトのOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスの指定は，絶対パスまたは相対パスのどちらでもかまいません。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

パブリックACL OIID

アンバインドされるパブリックACLのOIIDを指定します。

パブリックACL OIIDファイル

アンバインドされるパブリックACLのOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

注意事項

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

バインドされていないパブリックACLをアンバインドしようとすると，実行メソッドでエラーになります。

dbrunlink（オブジェクト間の関連づけの解除）

機能

コンテインメントによる二つのオブジェクト間の関連づけを解除します。

操作クラス

包含するオブジェクト

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

包含されるオブジェクト

CdbrDocumentクラス

CdbrVersionableDocumentクラス

CdbrReferentialContainerクラス

CdbrVersionTraceableContainerクラス

CdbrConfiguratedReferentialContainerクラス

形式

リンク識別子を指定しない場合

dbrunlink　〔 -l { DCR | RCR | VCR | ALL } 〕

　　　　　〔 -v { 包含するオブジェクトのバージョン識別子

　　　　　　| 包含するオブジェクトのバージョン識別子ファイル } 〕

　　　　　　{ 包含するオブジェクトのOIID

　　　　　　| 包含するオブジェクトのOIIDファイル }

　　　　　　{ 包含されるオブジェクトのOIID

　　　　　　| 包含されるオブジェクトのOIIDファイル }

リンク識別子を指定する場合

dbrunlink　 -L { リンク識別子 | リンク識別子ファイル }

　　　　　　{ 包含するオブジェクトのOIID

　　　　　　| 包含するオブジェクトのOIIDファイル }

オプション

-l { DCR | RCR | VCR | ALL }

解除するコンテインメントの種別を指定します。このオプションを省略した場合はALLが仮定されます。

DCR

直接型のコンテインメントを解除します。

RCR

参照型のコンテインメントを解除します。

VCR

構成管理型のコンテインメントを解除します。

ALL

コンテインメントの種別に関係なく，すべての関連づけを解除します。

-v　{ 包含するオブジェクトのバージョン識別子 | 包含するオブジェクトのバージョン識別子ファイル }

包含するオブジェクトがバージョン付き構成管理コンテナの場合，コンテインメントを解除するバージョンのバージョン識別子を指定します。このオプションを省略した場合は，最新バージョンに設定されたコンテインメントが解除されます。

包含するオブジェクトがバージョンなしコンテナおよびバージョンなし構成管理コンテナの場合にこのオプションを指定するとエラーになります。

バージョン識別子

コンテインメントを解除するバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

コンテインメントを解除するバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-L　{ リンク識別子 | リンク識別子ファイル }

関連づけを解除するコンテインメントのリンク識別子を指定します。

リンク識別子

解除するコンテインメントのリンク識別子を指定します。

リンク識別子ファイル

解除するコンテインメントのリンク識別子を記述したリンク識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「acl://」で始まるパスは指定できません。なお，リンク識別子ファイルに記述できるリンク識別子の数は一つだけです。

コマンド引数

包含するオブジェクトのOIID

オブジェクトを包含しているコンテナのOIIDを指定します。

包含するオブジェクトのOIIDファイル

オブジェクトを包含しているコンテナのOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

包含されるオブジェクトのOIID

コンテナに包含されているオブジェクト（関連づけを解除するオブジェクト）のOIIDを指定します。

包含されるオブジェクトのOIIDファイル

コンテナに包含されているオブジェクト（関連づけを解除するオブジェクト）のOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

注意事項

二つのオブジェクト間に複数の参照型コンテインメントが設定されている場合，-lオプションのオプションの引数にRCRまたはALLを指定して実行すると，参照型コンテインメントによる関連づけがすべて解除されます。

二つのオブジェクト間に複数の構成管理型のコンテインメントが設定されている場合，-l オプションのオプションの引数にVCRまたはALLを指定して実行すると，構成管理型コンテインメントによる関連づけがすべて解除されます。

バージョンなしコンテナに対して-l オプションのオプションの引数にVCRを指定した場合，何もしないで終了します。

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

バージョン付き構成管理コンテナに対して-vオプションと-Lオプションは同時に指定できません。

二つのオブジェクト間にコンテインメントによる関連づけがない場合（包含関係がない場合），何もしないで正常終了します。

指定したリンク識別子のコンテインメントが存在しない場合は，エラーになります。

dbrupcntr（コンテナのバージョンアップ）

機能

バージョン付き構成管理コンテナをバージョンアップします。

操作クラス

CdbrConfiguratedReferentialContainerクラス

形式

dbrupcntr { OIID | OIIDファイル }

オプション

なし

コマンド引数

OIID

バージョンアップするバージョン付き構成管理コンテナのOIIDを指定します。

OIIDファイル

バージョンアップするバージョン付き構成管理コンテナのOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

注意事項

バージョンアップ前のバージョンに設定されていた直接型のコンテインメントは，バージョンアップ後のバージョンにはコピーされません。

バージョンアップ前のバージョンに設定されていた参照型のコンテインメントおよび構成管理型のコンテインメントは，バージョンアップ後のバージョンにコピーされます。

dbrupdoc（文書のアップロード）

機能

指定したファイルを文書にアップロードします。

操作クラス

CdbrDocumentクラス

CdbrVersionableDocumentクラス

形式

dbrupdoc　〔-I〕〔 -v { バージョン識別子 | バージョン識別子ファイル } 〕

　　　　　　　　〔 -M　レンディションタイプ 〕

　　　　　　　　〔 -N　変更レンディションタイプ 〕

　　　　　　　　〔 -k { Content | MultiContent | FileLink

　　　　　　　　　　〔 -j コンテント登録先FAM名 〕

　　　　　　　　　　〔 -g コンテント登録先パス 〕

　　　　　　　　 | Reference〔 -a RELATIVE 〕

　　　　　　　　　　　　　〔 -b コンテント格納先ベースパス 〕

　　　　　　　　　　　　　〔 -h コンテント格納先パス 〕 } 〕

　　　　　 { OIID | OIIDファイル }

　　　　　 { アップロードファイルURL |アップロード情報ファイル}

オプション

-I

全文検索インデクスを作成しない場合に指定します。シングルファイル文書をアップロードする場合，このオプションを省略していて，かつアップロードする文書が次の条件を満たしているとき，アップロードファイルURLに指定したファイルから，全文検索インデクスが作成されます。

作成時に指定されたdmaClass_DocVersionクラスまたはそのサブクラスが，全文検索機能付き文書クラスである。

設定されているレンディションタイプの先頭が「MIME::text/」である。

なお，マルチファイル文書またはFile Link文書の場合は，このオプションを省略しても全文検索インデクスは作成されません。

-v　{ バージョン識別子 | バージョン識別子ファイル }

バージョン付き文書の場合，アップロードするバージョンのバージョン識別子を指定します。このオプションを省略した場合は，最新バージョンがチェックアウトされて，ファイルがアップロードされたあと，チェックインされます。

バージョンなし文書をアップロードするときにこのオプションを指定するとエラーになります。

バージョン識別子

アップロードするバージョンのバージョン識別子を指定します。

バージョン識別子ファイル

アップロードするバージョンのバージョン識別子を記述したバージョン識別子ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「DBRVTVERSION」という文字列および「acl://」で始まるパスは指定できません。なお，バージョン識別子ファイルに記述できるバージョン識別子の数は一つだけです。

-M　レンディションタイプ

アップロードするレンディションタイプを指定します。このオプションを省略した場合は，マスタレンディションが仮定されます。

バージョン付き文書に対してこのオプションを指定する場合は，必ず-vオプションも指定してください。

-N　変更レンディションタイプ

アップロード時にレンディションタイプを変更する場合に，変更後のレンディションタイプを指定します。このオプションを省略した場合は，レンディションタイプは変更されません。なお，マルチファイル文書の場合，このオプションは指定できません。

-k { Content | MultiContent | FileLink 〔 -j コンテント登録先FAM名 〕〔 -g コンテント登録先パス 〕 | Reference 〔 -a RELATIVE〕〔 -b コンテント格納先ベースパス〕〔 -h コンテント格納先パス〕 }

アップロードする文書のコンテントの種別を指定します。

このオプションを指定した場合，アップロードファイルURL，またはアップロード情報ファイルに指定されたコンテントの登録先が，このオプションの指定と一致していないとエラーになります。また，アップロードしようとするレンディションのコンテントの登録先と一致しないとエラーになります。コンテントの登録先は，dbrrndrdocコマンドでレンディションの一覧を取得する（-xオプションにLISTを指定する）場合に，dbrProp_ContentTypeプロパティの値を取得する（-pオプションで指定するプロパティ情報ファイルに「dbrProp_ContentType」を指定する）ことで確認できます。なお，このオプションを省略した場合は，アップロードファイルURL，またはアップロード情報ファイルの指定に従って文書をアップロードします。

Content

シングルファイル文書のコンテントとして，データベースにアップロードします。アップロードURLに指定されたファイルに，コンテントをアップロードします。

MultiContent

マルチファイル文書のコンテントとして，データベースにアップロードします。アップロード情報ファイルの指定に従って，コンテントをアップロードします。

FileLink

File Link文書のコンテントとして，ファイルサーバにアップロードします。

Reference

リファレンスファイル文書のコンテントとして，ファイルシステム上の領域にアップロードします。

オプション省略時

アップロードファイルURL，またはアップロード情報ファイルの指定に従って文書のコンテントをデータベースにアップロードします。

アップロードファイルURLが指定されている場合
シングルファイル文書のコンテントをデータベースにアップロードします。

アップロード情報ファイルが指定されている場合
マルチファイル文書のコンテントをデータベースにアップロードします。

-j コンテント登録先FAM名

File Link文書の場合に，コンテントの登録先となるファイルサーバのFAM名を指定します。-kオプションにFileLinkを指定していない場合に，このオプションを指定するとエラーになります。このオプションを省略した場合，実行環境制御ファイルのFileLinkセクションの，DefaultFAMNameエントリに指定されたFAM名のファイルサーバを使用します。

-g コンテント登録先パス

File Link文書のコンテントをアップロードする場合に，ファイルサーバ上の登録先パスを指定します。

クライアントのコンテントを指定して文書をアップロードするとき，およびファイルサーバ上に登録されているコンテントを指定して文書をアップロードするときの，オプションの引数の指定方法を次に示します。

クライアントのコンテントを指定して文書をアップロードするとき
ファイルサーバ上の登録先ディレクトリのパスを指定します。ディレクトリの末尾にはデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述します。ファイルサーバに登録するコンテントは，アップロードファイルURLで指定します。
このオプションに指定した登録先ディレクトリが存在しない場合，ディレクトリが作成され，コンテントが登録されます。ただし，ディレクトリの末尾にデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述しない場合，コンテント名称の自動生成を行わない（実行環境制御ファイルで，FileLinkセクションの FileNamingModeエントリにSpecifyを指定している）環境で，このオプションに指定したディレクトリがファイルサーバ上に存在するとエラーになり，存在しないとディレクトリは作成しないで，このオプションで指定した名称でコンテントが登録されます。
UNIXの場合に，コンテントの登録先ディレクトリが，「/dir01/data」の下位にある「area1」ディレクトリのとき，次のように指定します。

指定形式の種別
指定例

フルパス指定
/dir01/data/area1/

エイリアス指定
DATA/area1/
（「/dir01/data」のエイリアス名が「DATA」のとき）

また，Windowsの場合に，コンテントの登録先ディレクトリが，「c:¥dir01¥data」の下位にある「area1」ディレクトリのとき，次のように指定します。

指定形式の種別
指定例

フルパス指定
c:¥dir01¥data¥area1¥

エイリアス指定
DATA¥area1¥
（「c:¥dir01¥data」のエイリアス名が「DATA」のとき）

ファイルサーバ上に登録されているコンテントを指定して文書をアップロードするとき
ファイルサーバ上のコンテントのパスを指定します。アップロードファイルURLには，DBRSVCONTENTを指定します。

なお，-kオプションにFileLinkを指定していない場合に，このオプションを指定するとエラーになります。このオプションを省略した場合，実行環境制御ファイルのFileLinkセクションの，DefaultContentPathエントリの指定を使用します。ファイルサーバに登録されているコンテントを指定する場合には，このオプションは省略できません。

UNIXの場合に，文書のアップロードに使用するコンテントが，「/dir01/data/area1」の下位にある「file.jpg」のとき，次のように指定します。

指定形式の種別
指定例

フルパス指定
/dir01/data/area1/file.jpg

エイリアス指定
DATA/area1/file.jpg
（「/dir01/data」のエイリアス名が「DATA」のとき）

Windowsの場合に，文書のアップロードに使用するコンテントが，「c:¥dir01¥data¥area1」の下位にある「file.jpg」のとき，次のように指定します。

指定形式の種別
指定例

フルパス指定
c:¥dir01¥data¥area1¥file.jpg

エイリアス指定
DATA¥area1¥file.jpg
（「/dir01/data」のエイリアス名が「DATA」のとき）

-a RELATIVE

アップロードするリファレンスファイル文書のリファレンス種別を指定します。

-kオプションにReferenceを指定していない場合に，このオプションを指定するとエラーになります。

このオプションを省略した場合，実行環境制御ファイルの，ReferenceセクションのDefaultReferenceTypeエントリの指定を使用します。

リファレンス種別がNONEの，コンテントが登録されていないリファレンスファイル文書をアップロードする場合も，このオプションまたは実行環境制御ファイルで，リファレンス種別を指定します。

RELATIVE

コンテントの格納先をファイルシステム上の領域とし，コンテントロケーションを相対パスで管理します。

-b コンテント格納先ベースパス

リファレンスファイル文書をアップロードする場合に，コンテント格納先ベースパスを指定します。

アップロードするリファレンスファイル文書の，リファレンス種別がRELATIVEのとき，およびリファレンス種別がNONEのときの，オプション引数の指定内容を次に示します。

リファレンス種別がRELATIVEのとき
オプション引数には，更新元のリファレンスファイル文書のコンテント格納先ベースパスを指定します。例えば，更新元となるリファレンスファイル文書のコンテント格納先ベースパスが「/drv01/dir01/userdir」の場合，このオプションに同じ値「/drv01/dir01/userdir」を指定します。

リファレンス種別がNONEのとき
オプション引数には，更新するリファレンスファイル文書のコンテントを格納するディレクトリの基点となるパスを指定します。例えば，アップロードファイルURLで指定したコンテントを，「/drv01/dir01/userdir」ディレクトリの下位にある「user01」ディレクトリに格納する場合，「user01」ディレクトリの基点となるパスとして，このオプションに「/drv01/dir01/userdir」を指定します。また，コンテントを格納するディレクトリとして，-hオプションで「user01」を指定します。このオプションの指定の末尾に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。
このオプションで指定したコンテント格納先ベースパスは，-hオプションで指定したコンテント格納先パスと結合して，絶対パスとして使用されます。ContentLocationプロパティには次に示すパスが格納されます。
aaaa/bbbb/cccc
aaaa：コンテント格納先パス
bbbb：DocumentBrokerがコンテントを管理するためのディレクトリ
cccc：ファイル名※
注※
次に示すどちらかのファイル名が設定されます。
・登録ファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにOriginを指定した場合）
・DocumentBrokerが指定するファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにDivideを指定した場合）

-kオプションにReferenceを指定していない場合に，このオプションを指定するとエラーになります。このオプションを省略した場合，実行環境制御ファイルの，ReferenceセクションのDefaultContentBasePathエントリの指定を使用します。

Windowsの場合，コンテント格納先ベースパスにUNC形式のパスを使用することもできます。例えば，「server01」というマシンのネットワーク上で共有しているフォルダ「share」をコンテント格納先ベースパスに指定する場合は，このオプションに「¥¥server01¥share」を指定します。

-h コンテント格納先パス

リファレンスファイル文書をアップロードする場合に，コンテント格納先パスを指定します。このオプションは，リファレンス種別がNONEの，コンテントが登録されていないリファレンスファイル文書をアップロードする場合だけ有効です。

-kオプションにReferenceを指定していない場合に，このオプションを指定するとエラーになります。

オプション引数には，-bオプションで指定したコンテント格納先ベースパスからの相対パスで，コンテントの格納先とするディレクトリを指定します。例えば，アップロードファイルURLで指定したコンテントを，-bオプションで指定した「/drv01/dir01/userdir」ディレクトリの下位にある「user01」ディレクトリに格納する場合，このオプションに「user01」を指定します。このオプションの指定の先頭に，パスのデリミタ「/」（UNIXの場合）または「¥」（Windowsの場合）を記述する必要はありません。

このオプションの指定を省略すると，-bオプションで指定したコンテント格納先ベースパスのディレクトリの下位に，DocumentBrokerがコンテントを管理するためのディレクトリが作成され，その下位にコンテントが格納されます。

このオプションで指定したコンテント格納先パスは，-bオプションで指定したコンテント格納先ベースパスと結合して，絶対パスとして使用されます。ContentLocationプロパティには次に示すパスが格納されます。

aaaa/bbbb/cccc

aaaa：コンテント格納先パス

bbbb：DocumentBrokerがコンテントを管理するためのディレクトリ

cccc：ファイル名※

注※

次に示すどちらかのファイル名が設定されます。

アップロードファイルURLで指定したコンテントのファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにOriginを指定した場合）

DocumentBrokerが指定するファイル名（DocumentSpace構成定義ファイルのReferenceStorageModeエントリにDivideを指定した場合）

コマンド引数

OIID

アップロードする文書のOIIDを指定します。

OIIDファイル

アップロードする文書のOIIDを記述したOIIDファイルのファイルパスを指定します。

OIIDファイルのファイル名はオブジェクトのOIID形式以外であれば任意です。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。ただし，「dma://」で始まるパスは指定できません。なお，OIIDファイルに記述できるOIIDの数は一つだけです。

アップロードファイルURL

シングルファイル文書の場合，アップロードするファイルのパスをURL形式で指定します。

File Link文書の場合，クライアントのコンテントを指定して文書をアップロードするとき，ファイルサーバに登録するコンテントのパスをURL形式で指定します。また，ファイルサーバ上に登録されているコンテントを指定して文書をアップロードするときは，DBRSVCONTENTを指定して，-gオプションにファイルサーバ上のコンテントのパスを指定します。なお，ファイルサーバ上に登録されているコンテントを使用するとき，-gオプションを省略するとエラーになります。

例えば，UNIXの場合，「/tmp/upload.doc」のファイルをアップロードするときは，「file:///tmp/upload.doc」と指定します。Windowsの場合，「c:¥temp¥upload.doc」のファイルをアップロードするときは，「file:///c:¥temp¥upload.doc」と指定します。

アップロード情報ファイル

マルチファイルを管理する文書の場合，アップロードするマルチファイル文書の情報を記述した，アップロード情報ファイルのファイルパスを指定します。ファイルパスは，絶対パスまたは相対パスのどちらでも指定できます。

ただし，「DBRSVCONTENT」という文字列のファイル，および「file://」で始まるパスは指定できません。

注意事項

-vオプションを指定した場合，チェックアウトおよびチェックインは実行されません。指定したバージョンのアップロードだけが実行されます。

-vオプションのオプションの引数に「DBRVTVERSION」を指定するとエラーになります。

-Iオプションおよび-vオプションを指定しないでシングルファイル文書であるバージョン付き文書をアップロードした場合，チェックイン後のバージョンに対応する全文検索インデクスが作成されます。なお，マルチファイル文書の場合，File Link文書，またはリファレンスファイル文書のレンディションの場合は，-Iオプションの指定を省略しても全文検索インデクスは作成されません。

複数のレンディションを持つ，マルチファイルを管理しないバージョン付き文書に対してチェックアウトおよびチェックインをした場合，最新のバージョンの文書はマスタレンディションだけの文書になります。チェックアウト前の文書のサブレンディションは，最新バージョンには引き継がれません。

シングルファイル文書であるバージョン付き文書に対して-Mオプションを指定する場合，-vオプションを指定しないとエラーになります。

アップロードファイルが格納されている場所として，ファイルパス（アップロードファイルURL）を指定した場合，アップロードファイルは，マルチファイルを管理する文書として扱われます。また，アップロードファイルが格納されている場所として，ディレクトリパス（アップロードディレクトリURL）を指定した場合，アップロードファイルは，マルチファイルを管理する文書として扱われます。アップロードファイルが格納されている場所の指定と，アップロードファイルの種類が一致しない場合はエラーとなります。

マルチファイル文書の場合，dbrProp_RetrievalNameプロパティの値を更新するには，プロパティ情報ファイルのdbrProp_RetrievalNameプロパティの値を更新して，dbrsetpropコマンドを実行します。

マルチファイル文書の場合，アップロード情報ファイルのdirectoryエントリに指定したディレクトリ下にファイルがないとエラーになります。

シングルファイル文書のレンディションの場合，-vオプションおよび-Iオプションを指定しないでバージョン付き文書をアップロードすると，チェックイン後のバージョンに対する全文検索インデクスが作成されます。

-kオプションを省略した場合，アップロードファイルURLを指定すると，シングルファイル文書として扱われ，アップロード情報ファイルを指定すると，マルチファイル文書として扱われます。

File Link文書で，コンテントの登録先を，ファイルサーバとする場合，-kオプションでFileLinkを指定します。この場合，-kオプションは省略できません。

File Link文書の，ファイルサーバ上のコンテントの削除モードは，クライアントのコンテントを指定してアップロードした場合と，ファイルサーバ上のコンテントを指定してアップロードした場合で異なります。それぞれの場合のコンテントの削除モードを次に示します。

クライアントのコンテントを指定してアップロードした場合
クライアントのコンテントを指定してアップロードした文書を削除すると，ファイルサーバ上のコンテントも同期して削除されます。なお，クライアントのコンテントをディレクトリ単位で登録したときは，ディレクトリごと削除されます。

ファイルサーバ上のコンテントを指定してアップロードした場合
ファイルサーバ上のコンテントを指定してアップロードした文書を削除しても，ファイルサーバ上のコンテントは削除されません。なお，ファイルサーバ上のコンテントをディレクトリ単位で指定したときも，ディレクトリは削除されません。

コンテントの削除モードを変更する場合は，実行環境制御ファイルのFileLinkセクションの，ClientContentDeleteModeエントリ，またはServerContentDeleteModeエントリの設定を変更してください。

リファレンスファイル文書の場合，コンテントの格納先には，DocumentBrokerサーバから接続可能であり，かつDocumentBrokerサーバから参照可能なディレクトリを設定してください。

リファレンスファイル文書をアップロードする場合に，誤って異なるリファレンスファイル文書のコンテント格納先ベースパスを指定すると，エラーになります。

リファレンスファイル文書を扱うコンテントの操作でエラーになると，オブジェクトとコンテントの状態が不整合となり，メッセージKMBR30201-E（要因コード3，86）が出力される場合があります。この場合は，エラーになったオブジェクトを削除したあと，再度，dbrupdocコマンド（文書のアップロード）を実行して，リファレンスファイル文書をアップロードしてください。また，メッセージの詳細については，マニュアル「DocumentBroker Version 3　メッセージ」を参照してください。

リファレンスファイル文書の場合，コンテント格納先ベースパスのディレクトリおよびコンテント格納先パスのディレクトリの下位に，DocumentBrokerがコンテントを管理するためのディレクトリが作成され，その下位にコンテントが格納されます。なお，リファレンスファイル文書のコンテントと，コンテントが格納されているディレクトリを同時に削除する場合は，dbrdeldocコマンド（文書の削除）で，削除ディレクトリのルートパスを指定してください。削除ディレクトリのルートパスの指定方法については，コマンド「dbrdeldoc（文書の削除）」を参照してください。

リファレンスファイル管理機能を使用する場合のオブジェクトの削除

ここでは，リファレンスファイル管理機能を使用する場合のオブジェクトの削除方法について説明します。

リファレンスファイル管理機能を使用する場合，ユーザがコンテント格納先ベースパスを管理してください。特に，複数のコンテント格納先ベースパスを管理する場合，dbrdelcntrコマンド（コンテナの削除）およびdbrdeldocコマンド（文書の削除）では文書ごとにコンテント格納先ベースパスを指定できないため，オブジェクトの削除には注意が必要です。ただし，dbrdelcntrコマンド（コンテナの削除）は，コンテナごとにコンテント格納先ベースパスを指定できます。

コンテント格納先ベースパスの管理に応じたオブジェクトの削除方法を次の表に示します。

表5-8　リファレンスファイル文書を扱う場合のオブジェクトの削除方法

管理するコンテント格納先ベースパスの数
削除対象のオブジェクト
削除方法

一つ
文書
dbrdeldocコマンドを実行します。

コンテナと包含される文書
再帰的に削除しない
dbrdelcntrコマンドを実行します。

再帰的に削除する
-Rオプションを指定して，dbrdelcntrコマンドを実行します。

複数
コンテナ内で同一※1
文書
-Rオプションを指定してdbrdelcntrコマンドを実行するか，または次の手順で削除してください。

削除対象を，同一のコンテント格納先ベースパスの文書に絞り込みます。

同一のコンテント格納先ベースパスの文書に対して，dbrdeldocコマンドを実行します。

コンテナと包含される文書
再帰的に削除しない
-iオプションを指定して，dbrdelcntrコマンドを実行します。

再帰的に削除する

コンテナの下位のコンテナに包含される文書のコンテント格納先ベースパスがすべて同一の場合

-Rオプションおよび-iオプションを指定して，dbrdelcntrコマンドを実行します。

コンテナの下位のコンテナに包含される文書のコンテント格納先ベースパスが，コンテナごとに異なる場合

dbrlschildコマンドを実行して，コンテナに包含される削除対象のコンテナ一覧を取得します。

取得した一覧のコンテナごとに，コンテナに包含される文書のコンテント格納先ベースパスをリファレンス情報ファイルに指定し，-iオプションを指定してdbrdelcntrコマンドを実行します。このとき，-Rオプションは指定しないでください。

コンテナ内に混在※2
文書
次の手順で削除してください。

削除対象を，同一のコンテント格納先ベースパスの文書に絞り込みます。

同一のコンテント格納先ベースパスの文書に対して，dbrdeldocコマンドを実行します。

コンテナと包含される文書
再帰的に削除しない
次の手順で削除してください。

削除対象を，同一のコンテント格納先ベースパスの文書に絞り込みます。

同一のコンテント格納先ベースパスの文書に対して，dbrdeldocコマンドを実行します。

dbrdelcntrコマンドを実行して，コンテナを削除します。

再帰的に削除する
次の手順で削除してください。

削除対象を，同一のコンテント格納先ベースパスの文書に絞り込みます。

同一のコンテント格納先ベースパスの文書に対して，dbrdeldocコマンドを実行します。

dbrdelcntrコマンドを実行して，コンテナを削除します。

注※1

コンテナ内で，コンテナに包含されるリファレンスファイル文書のコンテント格納先ベースパスがすべて同一の場合です。

注※2

コンテナ内で，コンテナに包含されるリファレンスファイル文書のコンテント格納先ベースパスが異なる場合です。

付録

＜この付録の構成＞

付録A　OIID指定時のURLの文法

付録B　文書空間で使用する文字コード種別がUTF-8の場合のサポート範囲

付録C　用語解説

付録A　OIID指定時のURLの文法

ここでは，データベースに格納されたDMAオブジェクトが保持しているOIIDを指定する場合の指定方法について説明します。

データベースに格納されたDMAオブジェクト（永続オブジェクト）は，プロパティの値としてNULLでないOIID（Object Instance Identifier）を保持しています。OIIDは，論理的に永続オブジェクトへのURL（Uniform Resource Locator）であると考えられます。したがって，URLのシンタクスを使用して定義されます。OIIDを定義するURLを，特に「DMA URL」といいます。

OIIDの使用方法

OIIDは，文書空間でのオブジェクトの存在や格納位置などを明確にするために使用する識別子です。文書空間中でOIIDは，最大2の48乗-1個作成できます。

なお，OIIDにはユーザアプリケーションから見た連続性，規則性はありません。このため，例えば，ユーザが文書やコンテナなどを指定するときに識別子として直接OIIDを入力するような使用方法は，OIIDの使用方法として適しません。

＜この節の構成＞

(1)　OIIDの形式

(2)　OIID（DMA URL）のBNF記法

(1)　OIIDの形式

OIIDはURLのシンタクスを使用して定義します。

(a)　形式

OIIDは次の形式で指定します。

dma:///<system id>/<docspace id>/<object id>

各項目について説明します。

<system id> ::= <テキスト化されたDMA SystemのDmaId>

OIIDを生成したDMA Systemを登録するために使われたGUIDです。

「(2)　OIID（DMA URL）のBNF記法」で示す「dmasystem」に相当します。

<docspace id> ::= <テキスト化された文書空間のDmaId>

OIIDを生成した文書空間を登録するために使われたGUIDです。

「(2)　OIID（DMA URL）のBNF記法」で示す「dmadocspace」に相当します。

<object id> ::= <印刷可能なASCIIコード>

ASCIIサブセットにコード化されたデータシーケンスです。

「(2)　OIID（DMA URL）のBNF記法」で示す「dmaobjectid」に相当します。

(b)　指定例

OIIDの指定例を次に示します。

＜指定例＞

dma:///07a17522-a626-11d0-b11f-0020af27a837/a95414a4-fef7

-11d3-999f-080009bafc2d/f5d8e3a2-284c-11d2-9177

-0000e21303670000000000006852

(2)　OIID（DMA URL）のBNF記法

OIID（DMA URL）のBNF記法を次に示します。

dmaurl= "dma://" "/" dmasystem "/"dmadocspace "/" dmaobjectid

dmasystem = dmaguid

dmadocspace = dmaguid

dmaobjectid = oidchars

dmaguid = 1*dmaguidchar

dmaguidchar = hex | "-"

oidchars = *oidchar

oidchar = alpha | digit | safe | ":" | "@" | "&" | "="

alpha = lowalpha | hialpha

lowalpha = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" |

　　　　　"m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" |

　　　　　"y" | "z"

hialpha = "A" | "B" | "C" | "D" | "E" | "F" | "G" | "H" | "I" | "J" | "K" |

　　　　 "L" | "M" | "N" | "O" | "P" | "Q" | "R" | "S" | "T" | "U" | "V" |

　　　　 "W" | "X" | "Y" | "Z"

digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9"

safe = "$" | "-" | "_" | "." | "+"

hex = digit | "A" | "B" | "C" | "D" | "E" | "F" |"a" | "b" | "c" | "d" | "e" | "f"

付録B　文書空間で使用する文字コード種別がUTF-8の場合のサポート範囲

ここでは，文書空間で使用する文字コード種別がUTF-8の場合にサポートする範囲について説明します。なお，文書空間で使用する文字コード種別がShift-JISの場合は，すべての機能をサポートしています。

文書空間で使用する文字コード種別がUTF-8の場合に使用できるオブジェクト操作ツールのコマンドを次の表に示します。

表B-1　文書空間で使用する文字コード種別がUTF-8の場合に使用できるオブジェクト操作ツールのコマンド

コマンド名 | 機能 | 使用可否
dbrbind | パブリックACLのバインド | ○
dbrcrtacl | パブリックACLの作成 | ○
dbrcrtcntr | コンテナの作成 | ○
dbrcrtdata | 独立データの作成 | ○
dbrcrtdoc | 文書の作成 | ○※
dbrcrtidx | 全文検索インデクスの作成 | ○
dbrdelacl | パブリックACLの削除 | ○
dbrdelcntr | コンテナの削除 | ○
dbrdeldata | 独立データの削除 | ○
dbrdeldoc | 文書の削除 | ○※
dbrdelidx | 全文検索インデクスの削除 | ○
dbrdowndoc | 文書のダウンロード | ○※
dbrexquery | 問い合わせの実行 | ○
dbrgetprop | プロパティの取得 | ○
dbrlink | オブジェクト間の関連づけ | ○
dbrlsacl | バインドしているパブリックACL一覧またはバインドされているオブジェクト一覧の取得 | ○
dbrlschild | コンテナに包含されるオブジェクト一覧の取得 | ○
dbrlscompo | マルチファイル文書のコンテント情報一覧の取得 | －
dbrlsparent | オブジェクトを包含するコンテナ一覧の取得 | ○
dbrlsversion | バージョン一覧の取得 | ○
dbrlsversionable | バージョン管理情報一覧の取得 | ○
dbrrndrdoc | 文書のレンディション操作 | ○
dbrsetmode | 構成管理モードの設定 | ○
dbrsetprop | プロパティの設定 | ○
dbrtoolsetup | 実行環境のセットアップ | ○
dbrunbind | パブリックACLのアンバインド | ○
dbrunlink | オブジェクト間の関連づけの解除 | ○
dbrupcntr | コンテナのバージョンアップ | ○
dbrupdoc | 文書のアップロード | ○※

（凡例）

○：使用できます。

－：使用できません。

注※

File Link文書の場合は，作成，削除，ダウンロード，またはアップロードできません。

付録C　用語解説

DocumentBrokerで使用する用語について説明します。

（英字）

ACE

Access Control Elementの略です。アクセス制御エレメントのことです。

ACFlag

Access Control Flagの略です。アクセス制御フラグのことです。

ACL

Access Control Listの略です。アクセス制御リストのことです。

AND-NOT検索

検索オペレータに「AND-NOT」を使用する検索方法です。二つの検索条件をAND-NOTでつないで，左側のオペランドに指定した検索条件は成立するが，右側のオペランドに指定した検索条件は成立しない文書を検索します。例えば，「著者が『日立太郎』であるが，所属は『日立製作所』ではない文書を検索する」というような場合に使用できます。

AND検索

検索オペレータに「AND」を使用して，検索条件同士の論理積を求める検索方法です。例えば，「著者が『日立太郎』で，文書中に『コンピュータ』という文字列を含む文書を検索する」というような場合に使用できます。

API（Application Programming Interface）

アプリケーションプログラムとのインターフェースを指します。

CdbrCompoundオブジェクト

複合データを表すオブジェクトです。複合データとは，複数の異なる型によって表されるデータです。主に，VariableArray型のプロパティとして設定されているObject型の要素の値を参照，設定するときに使用します。

CdbrConfiguratedReferentialContainerオブジェクト

バージョン付き構成管理コンテナに相当するオブジェクトです。CdbrConfiguratedReferentialContainerクラスを基に作成します。

CdbrDocumentオブジェクト

（バージョンなし）文書に相当するオブジェクトです。CdbrDocumentクラスを基に作成します。CdbrVersionableDocumentオブジェクトの個々のバージョンとしても操作できます。

CdbrEqlStatementオブジェクト

SQLに基づいた文法で検索条件が記述できるedmSQL検索を実行するためのオブジェクトです。CdbrEqlStatementクラスを基に作成します。

CdbrIndependentPersistenceオブジェクト

クラスライブラリで提供するクラスの階層構造に属さない，独立データを表すオブジェクトです。CdbrIndependentPersistenceクラスを基に作成します。

CdbrPublicACLオブジェクト

パブリックACLを表すオブジェクトです。CdbrPublicACLクラスを基に作成します。

CdbrReferentialContainerオブジェクト

フォルダや分類（インデクス）を使用した文書管理を実現する，（バージョンなし）コンテナに相当するオブジェクトです。CdbrReferentialContainerクラスを基に作成します。

CdbrSessionオブジェクト

文書空間とクライアント環境のセッションを確立するオブジェクトです。CdbrSessionクラスを基に作成します。

CdbrVariableArrayオブジェクト

可変長配列を表すオブジェクトです。主に，VariableArray型のプロパティの値を参照，設定するときに使用します。

CdbrVersionableDocumentオブジェクト

DocumentBrokerで扱うバージョン付き文書に相当するオブジェクトです。このオブジェクトによって表される文書は，バージョン管理ができます。CdbrVersionableDocumentクラスを基に作成します。

CdbrVersionTraceableContainerオブジェクト

バージョンなし構成管理コンテナに相当するオブジェクトです。CdbrVersionTraceableContainerクラスを基に作成します。CdbrConfiguratedReferentialContainerオブジェクトの個々のバージョンとしても操作できます。

Child

直接型のコンテインメント（DirectContainment）の場合，オブジェクト（Parent）に包含されるオブジェクトを指します。

ConfigurationHistoryオブジェクト

バージョン管理に使用する最上位のDMAオブジェクトです。文書のバージョンを管理するVersionSeriesオブジェクトを管理します。

Containableオブジェクト

コンテナの包含要素になるオブジェクトです。CdbrContainableクラスのサブクラスを基に作成されたオブジェクトを指します。

Containee

参照型のコンテインメント（ReferentialContainment）の場合，オブジェクト（Container）に包含されるオブジェクトを指します。

Container

参照型のコンテインメントの場合，オブジェクト（Containee）を包含するオブジェクトを指します。

ContainerVersionオブジェクト

包含しているオブジェクト全体を一つの概念的なオブジェクトとして管理するDMAオブジェクトです。また，構成管理型のコンテインメントではオブジェクトを包含するオブジェクトとして利用できます。ContainerVersionオブジェクトは，バージョンを保持できるオブジェクトです。したがって，ContainerVersionオブジェクトのバージョンを上げることで，ある時点でのオブジェクトのまとまりを管理できます。

Containerオブジェクト

コンテインメントを利用してオブジェクトを管理する場合に，オブジェクトを包含するDMAオブジェクトの一つです。dmaClass_Containerクラスおよびユーザが定義したdmaClass_Containerクラスのサブクラスを基に作成します。

ContentElement（dmaClass_ContentElementクラス）

文書のコンテントにアクセスするために使われるDMAオブジェクトの抽象クラスです。ContentElementの四つのサブクラス（edmClass_ContentFileLinkクラス，dmaClass_ContentTransferクラス，edmClass_ContentTransfersクラス，およびdmaClass_ContentReferenceクラス）は，コンテントの格納とアクセス機能を提供します。

ContentFileLinkオブジェクト

文書のコンテントを管理するために使用するDMAオブジェクトです。File Link連携機能を使用する場合に使用します。dmaClass_ContentElementクラスのサブクラスであるedmClass_ContentFileLinkクラスを基に作成します。

ContentReferenceオブジェクト

文書のコンテントを管理するために使用するDMAオブジェクトです。コンテントをデータベースに格納しないで，位置情報を永続化して管理する場合に使用します。dmaClass_ContentElementクラスのサブクラスであるdmaClass_ContentReferenceクラスを基に作成します。

ContentTransfersオブジェクト

文書のコンテントを管理するために使用するDMAオブジェクトです。一つの文書のコンテントとして複数のファイルをデータベースに格納（永続化）して管理する場合に使用します。dmaClass_ContentElementクラスのサブクラスであるedmClass_ ContentTransfersクラスを基に作成します。

ContentTransferオブジェクト

文書のコンテントを管理するために使用するDMAオブジェクトです。コンテントをデータベースに格納（永続化）して管理する場合に使用します。dmaClass_ContentElementクラスのサブクラスであるdmaClass_ContentTransferクラスを基に作成します。

CORBA（Common Object Request Broker Architecture）

OMG（Object Management Group）が提唱するオブジェクト間の通信メカニズムを提供するORB（Object Request Broker）の標準アーキテクチャです。

DMA（Document Management Alliance）

文書管理インターフェースの標準化を図る団体AIIM（Association for Information and Image Management International）によって定義される共通インターフェースです。

DMA URL

DMAオブジェクトのOIID（Object Instance Identifier）を定義するURLです。

DMAオブジェクト

DMAが規定するオブジェクトモデルに基づいたオブジェクトです。DMAで規定されたクラス（クラス名がdmaClass_で始まるクラス），DocumentBrokerで拡張したクラス（クラス名がedmClass_で始まるクラス），およびこれらのクラスからユーザが定義したサブクラスを基に作成されます。

DocumentSpace構成定義ファイル（docspace.ini）

文書空間の構成を定義するために使用するファイルです。

DocVersionオブジェクト

DocumentBrokerで扱う文書に相当するDMAオブジェクトです。dmaClass_DocVersionクラスおよびユーザが定義したdmaClass_DocVersionクラスのサブクラスを基に作成します。

edmClass_Relationshipクラス

文書間リレーションを表すDMAクラスです。単独では作成できない，文書に従属するRelationshipオブジェクトの基となるクラスです。

edmSQL

DocumentBrokerのオブジェクトを検索するための検索条件式を表現するための文法です。SQLの文法に基づいています。

edmSQL検索

検索条件に，SQLライクの文法で記述できるedmSQL文を指定して実行する検索のことです。

FAM（File Access Module）

HiRDB File Linkで使用するファイルサーバ上で，コンテントを管理するためのプログラムです。

File Link文書

HiRDB File Linkで管理しているファイルサーバに格納されている一つのファイル，または一つのディレクトリおよびそのサブディレクトリ下のすべてのファイルをコンテントとして持つ文書のことです。データベースでは，コンテントへのリンク情報を管理しています。CdbrDocumentクラスまたはCdbrVersionableDocumentクラスを使用して操作します。

File Link連携機能

HiRDB File Linkと連携してコンテントを管理する機能です。

GUID

Globally Unique Identifierの略です。DMAのクラス，プロパティ，検索オペレータなどに与えるユニークな識別子です。GUIDは，「X」を0～9およびa～f（小文字）で表される16進数とした「XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX（8けた-4けた-4けた-4けた-12けた）」の形式で表されます。

IDファイル

オブジェクト操作ツールを使用して複数のオブジェクトを一括して操作する場合，操作対象となるオブジェクトのOIIDなどを記述するファイルです。

LDAP

Lightweight Directory Access Protocolの略です。TCP/IP上で動作する解放型DAPを提供し，X.500のデータモデルを保持しています。

NOT条件

指定したキーワードとの不一致を求める検索条件です。例えば，「作成者が『日立太郎』ではない文書を検索する」というような場合に使用できます。

OIID

Object Instance Identifierの略です。文書空間での永続オブジェクトの存在や格納位置などを明確にするために使用する識別子です。OIIDはDMA URLとして定義されます。

OR検索

検索オペレータに「OR」を使用して，検索条件同士の論理和を求める検索方法です。例えば，「作成者が『日立太郎』であるオブジェクトか，作成者の所属が『日立製作所』であるオブジェクトを検索する」というような場合に使用できます。

Parent

直接型のコンテインメントの場合，オブジェクト（Child）を包含するオブジェクトを指します。

Renditionオブジェクト

文書の表現形式（HTML，PDFなど）を管理するDMAオブジェクトです。

Reservationオブジェクト

新しいバージョンを作成する権利をVersionSeriesオブジェクトに予約するDMAオブジェクトです。

Scalar型

プロパティの基本単位の一つです。基本単位がScalar型であるプロパティは，データ型に従った値を一つだけ持ちます。

SystemManagerオブジェクト

Systemオブジェクトを管理するDMAオブジェクトです。

Systemオブジェクト

サーバ内の文書空間を管理するDMAオブジェクトです。

UOC（User Own Coding）

ユーザによって作成されたプログラムのことです。DocumentBrokerでは，ユーザ認証や，アクセス制御機能のためのユーザ情報取得にUOCを使用できます。

VariableArray型

プロパティの基本単位の一つです。基本単位がVariableArray型であるプロパティは，データ型に従った複数の値を可変長な一次元配列として持ちます。また配列の要素は，構造体で管理できます。

Versionableオブジェクト

バージョン管理の対象になるオブジェクトです。CdbrVersionableクラスのサブクラスを基に作成されたオブジェクトを指します。

VersionDescriptionオブジェクト

文書のバージョン（更新履歴）を管理するために使用するDMAオブジェクトです。VersionSeriesオブジェクトとVersionableオブジェクトを接続するために使用します。

VersionSeriesオブジェクト

文書のバージョン（更新履歴）を管理するために使用するDMAオブジェクトです。連続的な履歴を持つバージョンの構成を保持するオブジェクトです。

VersionTracedDocVersionオブジェクト

直接型，参照型および構成管理型のコンテインメントで，コンテナに包含される対象となるためのプロパティを持つDMAオブジェクトです。dmaClass_DocVersionクラスのサブクラスのedmClass_VersionTracedDocVersionクラスを基に作成します。

VTContainee

構成管理型のコンテインメントの場合，オブジェクト（VTContainer）に包含されるオブジェクトを指します。

VTContainer

構成管理型のコンテインメントの場合，オブジェクト（VTContainee）を包含するオブジェクトを指します。

W3C（World Wide Web Consortium）

HTMLやXMLなど，WWWに関する技術の標準化を推進する非営利団体です。

（ア行）

アクセス権

オブジェクトを作成したり，すでに作成されているオブジェクトにアクセスしたりする権利です。

アクセス制御エレメント（ACE：Access Control Element）

アクセス制御リスト（ACL）の要素です。一つのサブジェクトと一つのパーミッションの組で構成され，指定されたサブジェクトに対して指定されたパーミッションの範囲のアクセス権を与えることを示す情報です。

アクセス制御機能

DocumentBrokerの文書空間でのオブジェクトの作成や，管理されている文書やコンテナなどのオブジェクトに対する操作を，ユーザやグループごとに許可または制限する機能です。

アクセス制御機能付き検索

アクセス制御機能を利用した文書空間で検索を実行した場合に，ユーザにアクセス権がないオブジェクトは検索結果として取得しない検索です。

アクセス制御情報

アクセス制御されている文書空間で，ユーザがメソッドを発行する際に，アクセス権の判定に使用される情報です。

アクセス制御情報変更権

オブジェクトに設定されているアクセス制御情報（ACFlagおよびACL）を変更する権利です。また，パブリックACLをアクセス制御対象オブジェクトにバインドすることを許可する権利も含みます。なお，パブリックACLのアクセス情報変更権には，パブリックACLのユーザ定義プロパティを変更する権利を含みます。

アクセス制御フラグ（ACFlag：Access Control Flag）

オブジェクトの所有者，プライマリグループおよび全ユーザという区分でパーミッションを設定できるアクセス制御情報の一つです。

アクセス制御モデル

アクセス制御機能を利用して運用されている文書管理モデルです。

アクセス制御リスト（ACL：Access Control List）

任意のユーザまたはグループにパーミッションを設定できるアクセス制御情報の一つです。アクセス制御エレメント（ACE）のリストで構成されます。

アドレス呼び出し

文書空間内に構成されている独立した永続オブジェクトに付けられたID（OIID）を利用して，そのオブジェクトを探索することです。

インデクス情報ファイル

ユーザが追加するプロパティにインデクスを定義する場合に，定義するインデクスの情報を記述するファイルです。

永続オブジェクト

データベースに格納されたオブジェクトを指します。

永続プロパティ

データベースに存在するプロパティを指します。

オブジェクト作成権

オブジェクト作成権限で，文書空間にオブジェクトを作成する権利を与えるパーミッションです。ユーザ権限定義ファイルで使用します。

オブジェクト作成権限

文書空間にオブジェクトを作成する権限で，ユーザ権限の一つです。ユーザ権限定義ファイルで定義します。オブジェクト作成権限を与えられたユーザおよびグループに属するユーザは，オブジェクトを作成するメソッド（CreateObject）を実行できます。

オブジェクト操作権限

文書空間内のすべてのオブジェクトを，与えられた権限の範囲で操作する権利で，ユーザ権限の一つです。ユーザ権限定義ファイルで定義します。例えば，オブジェクト操作権限としてプロパティ参照権を与えられたユーザおよびグループに属するユーザは，文書空間内のすべてのオブジェクトのプロパティを参照できます。

オブジェクト操作ツール

DocumentBrokerが提供するクラスライブラリを使用したクライアントアプリケーションです。クラスライブラリを使用してユーザがクライアントアプリケーションを開発する場合に，必要であると思われる機能をコマンド群として提供します。

オブジェクトリファレンス

DMAオブジェクトへのリファレンスを示すObject型プロパティの値です。例えば，dmaProp_ParentContainerプロパティの値がこれに当たります。

（カ行）

仮のバージョン識別子

チェックアウト中の仮のバージョンを識別するための識別子です。

チェックアウト中のオブジェクトを参照・更新する時に使用します。この識別子はチェックアウト時にDocumentBrokerによって設定される識別子であり，仮のバージョンに該当するオブジェクトのOIIDとは異なります。

関連オブジェクト

コンテインメントの型（直接型，間接型および構成管理型）を定義するためのDMAオブジェクトです。

直接型のコンテインメントの場合，オブジェクトを包含するオブジェクト（Parent）とオブジェクトに包含されるオブジェクト（Child）をDirectContainmentRelationshipオブジェクトを使用して関連づけます。参照型のコンテインメントの場合，オブジェクトを包含するオブジェクト（Container）とオブジェクトに包含されるオブジェクト（Containee）をReferentialContainmentRelationshipオブジェクトを使用して関連づけます。

構成管理型のコンテインメントの場合，オブジェクトを包含するオブジェクト（VTContainer）とオブジェクトに包含されるオブジェクト（VTContainee）をVersionTraceableContainmentRelationshipオブジェクトを使用して関連づけます。

基本コンテント更新権

基本パーミッションの一つで，オブジェクトのコンテントを更新する権利を与えるパーミッションです。基本プロパティ参照権を含みます。文書に対して設定する場合は，全文検索インデクスを作成，削除する権利を含みます。

基本コンテント参照権

基本パーミッションの一つで，オブジェクトのコンテントを参照する権利を与えるパーミッションです。基本プロパティ参照権を含みます。文書に対して設定する場合は，全文検索を実行する権利を含みます。

基本削除権

基本パーミッションの一つで，オブジェクトを削除する権利を与えるパーミッションです。基本プロパティ参照権を含みます。

基本単位

DMAで規定されているプロパティは，データ型に従った値を1個持つか複数個持つかが決められています。これを基本単位といいます。

基本バージョン管理権

基本パーミッションの一つで，バージョン管理されているオブジェクトのバージョンを追加，削除する権利を与えるパーミッションです。基本プロパティ参照権を含みます。

基本パーミッション

ユーザおよびグループがオブジェクトに対して実行できる操作の範囲を定めるパーミッションの基本単位です。オブジェクト操作権限，アクセス制御フラグおよびアクセス制御エレメントで，ユーザおよびグループに許可する操作の範囲を定めるときに使用します。例えば，あるユーザに対して，文書の更新と削除を許可する場合は，更新と削除を許可するために，基本コンテント更新権と基本削除権という二つのパーミッションを設定します（一つのパーミッションで一つの権利を与える）。基本パーミッションには，基本プロパティ参照権，基本プロパティ更新権，基本コンテント参照権，基本コンテント更新権，基本リンク権，基本バージョン管理権および基本削除権があります。

基本プロパティ更新権

基本パーミッションの一つで，オブジェクトのプロパティを更新する権利を与えるパーミッションです。基本プロパティ参照権を含みます。

基本プロパティ参照権

基本パーミッションの一つで，オブジェクトのプロパティを参照する権利を与えるパーミッションです。そのほかのすべての基本パーミッションに含まれます。コンテナに対して設定する場合は，関連オブジェクトのユーザ定義プロパティの参照と管理されている要素を参照する権利を含みます。

基本リンク権

基本パーミッションの一つで，コンテインメントの設定，変更および関連オブジェクトのユーザ定義プロパティを変更する権利を与えるパーミッションです。基本プロパティ参照権を含みます。

近傍条件検索

検索オペレータに「Prox」を使用する拡張検索（全文検索）です。指定する検索タームが同時に存在する場合に，その検索ターム間の距離を条件として検索します。例えば，「『文書管理』という検索タームと『ドキュメント』という検索タームを含み，これらの検索タームがこのとおりの順序で出現し，かつ検索ターム間に入る文字が5文字以内である文書を検索する」というような場合に使用できます。

組み合わせパーミッション

基本パーミッションを複数組み合わせた権利を与えるパーミッションの単位です。アクセス制御フラグおよびアクセス制御エレメントでユーザおよびグループに許可する操作の範囲を定めるときに使用します。組み合わせパーミッションには，プロパティ参照権，参照権，プロパティ更新権，参照更新権，削除権，リンク権，バージョン管理権およびフルコントロールがあります。例えば，あるユーザに対して，ある文書の参照更新権という組み合わせパーミッションを設定すると，そのユーザは基本プロパティ参照権，基本プロパティ更新権，基本コンテント参照権および基本コンテント更新権が設定されたのと同じ範囲の操作を，その文書に対して実行できます。

クラス定義情報ファイル

DocumentBrokerサーバで定義されているDMAオブジェクトのクラスまたはそのサブクラスのクラス名またはプロパティ名からGUID，データ型，プロパティの基本単位などの情報を取得するために使用するファイルです。EDMCrtSimMetaコマンドで作成できます。オブジェクト操作ツールを使用する場合に必要です。

継承（Inheritance）

既存のクラスを利用して新しいクラスを定義するオブジェクト指向の技術です。

構成管理型のコンテインメント（VersionTraceableContainment）

コンテナを利用した文書管理の方法です。構成管理型のコンテインメントで使われるコンテナは，バージョンを作成できるオブジェクトの構成を管理します。

構成管理コンテナ

構成管理型のコンテインメントで使われるコンテナです。

包含されるオブジェクトのバージョンを固定して管理したり，常に最新のバージョンを追跡して管理したりすることで，包含されるオブジェクト全体の構成を管理するために使用するコンテナです。CdbrVersionTraceableContainerに相当します。DMAオブジェクトでは，ContainerVersionオブジェクトに相当します。

構造指定検索

XML文書を管理している場合に，文書の論理構造（エレメント）やエレメントの属性をキーとして検索する方法です。例えば，「タイトルに『コンピュータ』という単語が含まれ，章に『XML』という単語が含まれる文書を検索する」というような場合に使用します。また，「『document』というエレメントに設定されている属性『status』の属性値が『public』である文書を検索する」というような場合にも使用できます。

コンテインメント（包含）

コンテナを使用したオブジェクトの包含関係を示します。コンテインメントには直接型（DirectContainment），参照型（ReferentialContainment）および構成管理型（VersionTraceableContainment）の3種類があります。

コンテナ

コンテインメントで，オブジェクトを包含できるオブジェクトの総称です。CdbrReferentialContainerオブジェクト，CdbrConfiguratedReferentialContainerオブジェクトおよびCdbrVersionTraceableContainerオブジェクトがこれに当たります。また，DMAオブジェクトとしては，Containerオブジェクト，VersionTraceableContainerオブジェクトおよびContainerVersionオブジェクトがあります。

コンテント

一般的には，属性に対する文書のデータ部分を指します。DMAでは，ある文書に関連づけられていて，DMAで規定されているContentモデルに従ってアクセスされるオブジェクトの集合を指します。また，アクセスされるオブジェクトの実体（例えば，report.doc，document.htmなど）をコンテントデータといいます。

コンテント格納先パス

リファレンスファイル管理機能を使用する場合に，コンテント格納先ベースパスを基点とする相対パスのことです。

コンテント格納先ベースパス

リファレンスファイル管理機能を使用する場合に，コンテント格納先の基点となるディレクトリパスのことです。

コンテント種別

レンディションのコンテントが，シングルファイル文書のコンテントか，マルチファイル文書のコンテントか，リファレンスファイル文書のコンテントか，またはFile Link文書のコンテントかを示します。

コンテントロケーション

リファレンスファイル管理機能を使用する場合に，コンテントの格納先を示す情報のことです。

（サ行）

削除権

組み合わせパーミッションの一つです。基本削除権と同じ操作を許可するパーミッションです。

サブクラス

あるクラスから派生するクラスのことです。または，それ自身がサブクラスとして参照されているクラスのことです。

サブジェクト（Subject）

アクセス権を与えるユーザまたはグループです。

サブジェクト種別（SubjectType）

アクセス権を与えるサブジェクトが，ユーザなのか，グループなのかまたはシステムなのかを識別するための情報です。

サブレンディション

マルチレンディション文書に，追加登録されたレンディションのことです。マスタレンディション以外のレンディションを指します。なお，サブレンディションは，登録後にマスタレンディションに変更できます。

参照型のコンテインメント（ReferentialContainment）

コンテナを利用した文書管理の方法です。参照型のコンテインメントで使われるコンテナは，文書にはり付けるインデクスの働きをします。

参照権

組み合わせパーミッションの一つです。基本コンテント参照権と同じ操作を許可するパーミッションです。

参照更新権

組み合わせパーミッションの一つです。基本プロパティ参照権，基本プロパティ更新権，基本コンテント参照権および基本コンテント更新権を組み合わせたパーミッションです。すなわち，参照更新権を設定することで，プロパティを参照，更新する権利とコンテントを参照，更新する権利を設定できます。

システム管理者

DocumentBrokerの運用管理者です。

実行環境制御ファイル

オブジェクト操作ツールの実行環境を定義するファイルです。

状態フラグ

マルチレンディション文書の，マスタレンディションに対するサブレンディションのコンテントの状態を表すフラグです。マスタレンディションとサブレンディションのコンテントの状態が一致している，マスタレンディションのコンテントが更新されたのに対してサブレンディションのコンテントが更新されていない，またはサブレンディションのコンテントが存在しない，という3種類の状態が表されます。dbrProp_RenditionStatusプロパティの下位2バイトに設定されます。

所有者（Owner）

オブジェクトの所有者として設定されているユーザです。アクセス制御フラグでパーミッションを与えられます。所有者に設定されているユーザは，そのオブジェクトのアクセス制御フラグで所有者に与えられたパーミッションの範囲の操作をそのオブジェクトに対して実行できます。また，そのオブジェクトの所有者およびセキュリティACLの値を変更できます。

シングルファイル文書

データベースに登録されている一つのファイルをコンテントとして持つ文書のことです。CdbrDocumentクラスまたはCdbrVersionableDocumentクラスを使用して操作します。

スーパークラス

あるクラスのクラス定義に使われたクラスを，派生したクラスのスーパークラスといいます。

セキュリティACL

オブジェクトに設定されたアクセス制御情報へのアクセスを制御するためのアクセス制御リストです。任意のユーザまたはグループにアクセス制御情報変更権を設定できます。

セキュリティ運用者

DocumentBrokerのアクセス制御の運用情報の管理者です。セキュリティ定義ファイルを保守します。

セキュリティ管理者

アクセス制御機能を利用した文書空間で，アクセス判定を受けることなく，すべてのオブジェクトに自由にアクセスする特権を持ち，文書空間のすべてのオブジェクトを保守するユーザです。セキュリティ定義ファイルに定義します。

セキュリティ定義ファイル

アクセス制御の運用情報を定義するファイルです。セキュリティ管理者，ユーザ権限定義ファイル名およびオブジェクト作成時に，アクセス制御フラグにデフォルトで設定されるパーミッションを定義します。

全文検索

文書中に含まれるキーワードを条件（全文検索条件）として，キーワードを含む文書を検索する方法です。

全文検索インデクス

全文検索の対象になるテキストデータに対応するプロパティです。edmProp_TextIndexプロパティ，edmProp_StIndexプロパティ，edmProp_ConceptTextIndexプロパティ，edmProp_ConceptStIndexプロパティおよびedmProp_Contentプロパティに相当します。

全文検索機能付き文書クラス

全文検索の対象となる文書を作成するためのdmaClass_DocVersionクラスのサブクラスです。メタ情報ファイルを新規に作成したり，既存のメタ情報ファイルを編集したりして，全文検索のためのプロパティを追加したユーザ定義のクラスです。

（タ行）

チェックアウト（check-out）

文書またはコンテナにバージョンを追加するために，次バージョンの追加を予約して，最新バージョンのコピーを要求することです。

DMAオブジェクトでは，VersionSeriesオブジェクトに新規DocVersionオブジェクト（文書）を作成するための権利を予約して，新規DocVersionオブジェクトの追加対象となるVersionSeriesオブジェクトで管理している最新のDocVersionオブジェクトのコピーを要求することです。

チェックイン（check-in）

文書またはコンテナのバージョンの追加を確定することです。

DMAオブジェクトでは，VersionSeriesオブジェクトに，新規DocVersionオブジェクト（文書）を追加することです。クライアントは特定のVersionSeriesオブジェクトに対して，Reservationオブジェクトを保持しておく必要があります。

直接型のコンテインメント（DirectContainment）

コンテナを利用した文書管理の方法です。直接型のコンテインメントで使われるコンテナは，文書を格納するフォルダの働きをします。

定義情報ファイル

サブクラスおよびプロパティを追加するときに，追加するオブジェクトの定義情報を記述するファイルです。

ディレクトリサービス

ネットワーク上にあるユーザや組織の情報などの資源とその属性を記憶し，検索できるようにしたシステムです。

DocumentBrokerでは，Active DirectoryやSun Java System Directory Serverなどの製品を使用したLDAP対応のディレクトリサービスと連携できます。

LDAP対応のディレクトリサービスとして使用できる製品の詳細については，マニュアル「DocumentBroker Version 3　システム導入・運用ガイド」を参照してください。

動作環境メタ情報ファイル

DocumentBrokerを起動するときに参照するメタ情報です。実行環境ディレクトリ/etc/meta_filesに格納されます。

独立データ

CdbrIndependentPersistenceオブジェクトに相当します。ほかのオブジェクトに依存しない，独立したオブジェクトです。

特権

アクセス制御機能を利用した文書空間で，アクセス判定を受けることなく，すべてのオブジェクトに自由にアクセスする権利です。セキュリティ定義ファイルにセキュリティ管理者として定義されたユーザに与えられます。特権の有無は，ログイン時にセキュリティ定義ファイルが参照され，ログインユーザごとに作成されるユーザ情報に保持されます。

トップオブジェクト

クラスライブラリのオブジェクトを構成する複数のDMAオブジェクトのうち，最上位に位置するオブジェクトです。例えば，CdbrDocumentオブジェクトの場合は，DMAオブジェクトのDocVersionオブジェクトがトップオブジェクトです。

（ナ行）

ナビゲーション

ある独立した永続オブジェクトから，別の関連する独立した永続オブジェクトに対する横断的な参照関係を指します。

（ハ行）

バージョン管理権

組み合わせパーミッションの一つです。基本プロパティ参照権，基本プロパティ更新権，基本コンテント参照権，基本コンテント更新権および基本バージョン管理権を組み合わせたパーミッションです。

バージョン付き構成管理コンテナ

バージョンを保持できる構成管理コンテナです。CdbrConfiguratedReferentialContainerオブジェクトに相当します。DMAオブジェクトでは，ConfigurationHistoryオブジェクトに相当します。

バージョンなし構成管理コンテナ

バージョンを保持しない構成管理コンテナです。CdbrVersionTraceableContainerオブジェクトに相当します。DMAオブジェクトでは，ContainerVersionオブジェクトに相当します。

パーミッション

オブジェクトの作成，オブジェクトのプロパティ参照，オブジェクトのコンテント更新などの実行可能な操作の範囲を表す値です。オブジェクト作成権限を与えるパーミッション，オブジェクトの操作の範囲を定めるパーミッションがあります。オブジェクトの操作の範囲を定めるパーミッションには，基本パーミッションと組み合わせパーミッションがあります。

パブリックACL

文書空間にオブジェクトとして存在するアクセス制御リスト（ACL）です。複数のオブジェクトが共有できます。

ファイルサーバ

HiRDB File Linkで構築したファイルサーバを指します。

フィルタリング定義ファイル（TFD）

Preprocessing Library for Text Searchの正規化機能によって構造指定検索用データ（ESIS-Bデータ）から不要なタグを除去したり，不要なタグ間のテキストをタグごと除去したりする場合に必要な定義ファイルです。

プライマリグループ

アクセス制御フラグ（ACFlag）でパーミッションを与えるグループです。

フルコントロール

組み合わせパーミッションの一つです。すべての基本パーミッションを組み合わせたパーミッションです。オブジェクトに対するすべての操作を許可します。

プロパティ更新権

組み合わせパーミッションの一つです。基本プロパティ更新権と同じ操作を許可するパーミッションです。

プロパティ参照権

組み合わせパーミッションの一つです。基本プロパティ参照権と同じ操作を許可するパーミッションです。

文書

CdbrVersionableDocumentオブジェクトおよびCdbrDocumentオブジェクトに相当します。CdbrVersionableDocumentオブジェクトを，「バージョン付き文書」と呼びます。CdbrDocumentオブジェクトを，「バージョンなし文書」と呼びます。

DMAオブジェクトでは，dmaClass_DocVersionクラスおよびそのサブクラスを基に作成するオブジェクトのことです。

文書空間

DMAオブジェクトモデルを実装するリポジトリです。

変換フラグ

マルチレンディション文書の，サブレンディションのコンテントを，レンディション変換の対象にするかどうかを表すフラグです。DocumentBroker Rendering Optionを使用してレンディション変換を実行する場合に使用します。また，DocumentBroker Rendering Optionによるレンディション変換でエラーが発生した場合には，エラーを示すフラグとしても使われます。dbrProp_RenditionStatusプロパティの上位2バイトに設定されます。

（マ行）

マスタレンディション

マルチレンディション文書に，最初に登録されたレンディションのことです。マルチレンディション文書を参照・更新するときには，レンディション形式を指定しますが，レンディション形式を指定しない場合は，マスタレンディションが対象になります。なお，マスタレンディションとして扱うレンディションは，登録後に変更できます。

マルチファイル管理機能

一つの文書に，複数のファイルを登録して管理する機能です。

マルチファイル文書

データベースに登録されている複数のファイルをコンテントとして持つ文書のことです。CdbrDocumentクラスまたはCdbrVersionableDocumentクラスを使用して操作します。

マルチレンディション機能

一つの文書に，同一内容の複数の異なる形式のコンテントを登録する機能です。

マルチレンディション文書

複数のレンディションを登録している文書のことです。一つの同じ内容を表す複数の形式のコンテントを保持する文書です。CdbrDocumentクラスまたはCdbrVersionableDocumentクラスを使用して操作します。

メタ情報ファイル

DocumentBrokerが利用するDMAのクラス，プロパティ，検索オペレータなどの詳細情報を定義したファイルです。クラスおよびプロパティを追加，変更する場合に使用できます。

メタデータ（metadata）

クラス，プロパティおよびオペレータに関する詳細情報を定義するデータです。

メタデータ空間

単一の継承関係を形成するクラスの集合のことです。

（ヤ行）

ユーザ権限

文書空間にオブジェクトを作成する権利（オブジェクト作成権限）と，文書空間内のすべてのオブジェクトに対する操作の範囲（オブジェクト操作権限）をユーザまたはグループ単位で定めるアクセス制御情報の一つです。ユーザ権限定義ファイルに定義します。ユーザ権限の内容は，ログイン時にユーザ権限定義ファイルが参照され，ログインユーザごとに作成されるユーザ情報に保持されます。

ユーザ権限定義ファイル

ユーザ権限（オブジェクト作成権限およびオブジェクト操作権限）を定義するためのファイルです。

ユーザ情報

ログインユーザのユーザ識別子，所属グループ，特権およびユーザ権限を表す情報です。ログイン時にユーザごとに生成され，アクセス権の判定に使用されます。

（ラ行）

ランキング検索

全文検索条件に対する適応度をスコアとして算出して，スコアを基に検索結果集合の要素（文書）をソートして出力する検索です。

リファレンスファイル管理機能

DocumentBrokerサーバから接続可能なファイルシステムの任意のディレクトリで文書のコンテントを管理し，文書のプロパティおよびコンテントの格納先の情報をデータベースで管理する機能です。

リファレンスファイル文書

DocumentBrokerサーバから接続可能なファイルシステムの任意のディレクトリに格納されているファイルをコンテントとして持つ文書のことです。データベースでは，文書のプロパティとコンテントの格納先の情報を管理しています。CdbrDocumentクラスまたはCdbrVersionableDocumentクラスを使用して操作します。

リレーション

DMAオブジェクトのRelationshipオブジェクトに相当します。文書と文書の間の参照関係を表すオブジェクトです。

リレーション先文書

文書間リレーションを設定される，参照先になる文書です。

リレーション識別子

文書間に設定されたリレーションを識別するための識別子です。

リレーションを削除したり，リレーションのプロパティを更新したりする時に使用します。この識別子は，リレーションを設定した時にDocumentBrokerによって設定される識別子です。同じ文書から同じ文書に対して二つのリレーションを設定した場合は，それぞれ異なるリレーション識別子が設定されます。

リレーション元文書

文書間リレーションを設定する元になる文書です。

リンク

DMAオブジェクトのDirectContainmentRelationshipオブジェクト，ReferentialContainmentRelationshipオブジェクトまたはVersionTraceableContainmentRelationshipオブジェクトによって表される，文書とコンテナの関連づけです。

リンク権

組み合わせパーミッションの一つです。基本リンク権と同じ操作を許可するパーミッションです。

リンク識別子

コンテナオブジェクトへのリンク（関連づけ）を識別するための識別子です。

リンクを解除したり，リンクのプロパティの参照または更新したり，構成管理モードを変更したりする時に使用します。

この識別子は関連づけをした時にDocumentBrokerによって設定される識別子です。同じコンテナオブジェクトに，同じ要素を2度関連づけした場合は，それぞれ異なるリンク識別子が設定されます。

レンディション

文書のコンテントの形式およびそのコンテントをあわせてレンディションと呼びます。DMAオブジェクトのRenditionオブジェクトおよびContentTransferオブジェクトに相当します。

レンディションタイプ

Wordなどのアプリケーションで編集したファイル，HTML形式のファイル，GIFなどの画像データのファイルのように，登録した文書のコンテントのファイルの形式を表す文字列です。レンディションごとに設定できます。DocumentBrokerでは，レンディションタイプとして，MIME名を指定することを推奨しています。

レンディション変換

マルチレンディション文書の，マスタレンディションのコンテントの文書形式を変換して，サブレンディションのコンテントを作成，登録することです。

ローカルACL

オブジェクトごとに設定できるアクセス制御リスト（ACL）です。VariableArray型のプロパティとして設定されます。

ロケール（Locale）

言語や使用する文字コードの種別，特定の国や地域で特別な意味を持つ属性などの定義のことです。ロケールは地域化した形でアプリケーションの拡張性を提供するために使われます。

索引

[Ａ][Ｃ][Ｄ][Ｅ][Ｆ][Ｇ][Ｉ][Ｌ][Ｍ][Ｎ][Ｏ][Ｐ][Ｒ][Ｓ][Ｔ][Ｕ][Ｖ][Ｗ][Ｘ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(英字)

(Ａ)

ACE

ACFlag

ACL

AND-NOT検索

AND検索

API

(Ｃ)

CdbrCompoundオブジェクト

CdbrConfiguratedReferentialContainerオブジェクト

CdbrDocumentオブジェクト

CdbrEqlStatementオブジェクト

CdbrIndependentPersistenceオブジェクト

CdbrPublicACLオブジェクト

CdbrReferentialContainerオブジェクト

CdbrSessionオブジェクト

CdbrVariableArrayオブジェクト

CdbrVersionableDocumentオブジェクト

CdbrVersionTraceableContainerオブジェクト

Child

ConfigurationHistoryオブジェクト

Containableオブジェクト

Containee

Container

ContainerVersionオブジェクト

Containerオブジェクト

ContentElement

ContentFileLinkオブジェクト

ContentReferenceオブジェクト

ContentTransfersオブジェクト

ContentTransferオブジェクト

CORBA

(Ｄ)

DBR_DETAIL_ERRORLOG

DBR_DETAIL_ERRORLOG

dbrbind

dbrcrtacl

dbrcrtcntr

dbrcrtdata

dbrcrtdoc

dbrcrtidx

dbrdelacl

dbrdelcntr

dbrdeldata

dbrdeldoc

dbrdelidx

dbrdowndoc

dbrexquery

dbrgetprop

dbrlink

dbrlsacl

dbrlschild

dbrlscompo

dbrlsparent

dbrlsversion

dbrlsversionable

dbrrndrdoc

dbrsetmode

dbrsetprop

DBRTOOLSDIR

DBRTOOLSDIR

dbrtoolsetup

dbrunbind

dbrunlink

dbrupcntr

dbrupdoc

directoryエントリ

DMA

DMA URL

DMAオブジェクト

DocumentBroker Development Kitをバージョンアップした場合

DocumentBroker Runtimeをバージョンアップした場合

DocumentSpace構成定義ファイル

DocVersionオブジェクト

(Ｅ)

edmClass_Relationshipクラス

edmSQL

edmSQL検索

(Ｆ)

FAM

filelink_contentpathエントリ

filelink_famnameエントリ

FileLinkセクション

File Link文書

File Link連携機能

filesエントリ

(Ｇ)

GUID

(Ｉ)

IDファイル

IDファイル

IDファイル

(Ｌ)

LANG

LDAP

LIBPATH

linkエントリ

Logセクション

(Ｍ)

mimeエントリ

modeエントリ

(Ｎ)

NODISCLAIM

NOT条件

(Ｏ)

OIID

OIID（DMA URL）のBNF記法

OIID指定時のURLの文法

OIIDの形式

OIIDファイル

OR検索

Outputセクション

(Ｐ)

Parent

PATH

PATH

PSALLOC

(Ｒ)

reference_contentbasepathエントリ

reference_contentpathエントリ

reference_typeエントリ

Referenceセクション

Renditionオブジェクト

Reservationオブジェクト

(Ｓ)

Scalar型

Sessionセクション

SystemManagerオブジェクト

Systemオブジェクト

(Ｔ)

TZ

(Ｕ)

UOC

urlエントリ

(Ｖ)

VariableArray型

Versionableオブジェクト

VersionDescriptionオブジェクト

VersionSeriesオブジェクト

VersionTracedDocVersionオブジェクト

VTContainee

VTContainer

(Ｗ)

W3C

(Ｘ)

XDK_HOME

(ア行)

(あ)

アクセス権

アクセス制御エレメント

アクセス制御機能

アクセス制御機能付き検索

アクセス制御情報

アクセス制御情報変更権

アクセス制御フラグ

アクセス制御モデル

アクセス制御リスト

アップロード情報ファイル

アドレス呼び出し

(い)

インデクス情報ファイル

(え)

永続オブジェクト

永続プロパティ

(お)

オブジェクト作成権

オブジェクト作成権限

オブジェクト操作権限

オブジェクト操作ツール

オブジェクト操作ツールで使用できる文字コード種別

オブジェクトリファレンス

(カ行)

(か)

仮のバージョン識別子

関連オブジェクト

(き)

基本コンテント更新権

基本コンテント参照権

基本削除権

基本単位

基本バージョン管理権

基本パーミッション

基本プロパティ更新権

基本プロパティ参照権

基本リンク権

近傍条件検索

(く)

組み合わせパーミッション

クラス定義情報ファイル

クラス定義情報ファイル

クラス定義情報ファイル

クラス定義情報ファイル

(け)

継承

(こ)

構成管理型のコンテインメント

構成管理コンテナ

構造指定検索

コマンド一覧

コマンド実行ログ

コンテインメント

コンテナ

コンテント

コンテント格納先パス

コンテント格納先ベースパス

コンテント種別

コンテントロケーション

(サ行)

(さ)

削除権

サブクラス

サブジェクト

サブジェクト種別

サブレンディション

参照型のコンテインメント

参照権

参照更新権

(し)

システム管理者

実行環境制御ファイル

実行環境制御ファイル

実行環境制御ファイル

実行環境制御ファイル

実行環境制御ファイルの記述例

出力ログ情報

障害対策

状態フラグ

所有者

シングルファイル文書

(す)

スーパークラス

(せ)

セキュリティACL

セキュリティ運用者

セキュリティ管理者

セキュリティ定義ファイル

全文検索

全文検索インデクス

全文検索機能付き文書クラス

(タ行)

(ち)

チェックアウト

チェックイン

直接型のコンテインメント

(て)

定義情報ファイル

ディレクトリサービス

(と)

問い合わせファイル

問い合わせファイル

動作環境メタ情報ファイル

独立データ

特権

トップオブジェクト

(ナ行)

(な)

ナビゲーション

(ハ行)

(は)

バージョン管理権

バージョン識別子ファイル

バージョン付き構成管理コンテナ

バージョンなし構成管理コンテナ

パーミッション

パブリックACL

(ふ)

ファイルサーバ

フィルタリング定義ファイル（TFD）

プライマリグループ

フルコントロール

プロパティエントリ

プロパティ更新権

プロパティ参照権

プロパティ情報ファイル

プロパティ情報ファイル

プロパティ情報ファイルの記述例

文書

文書空間

(へ)

変換フラグ

(マ行)

(ま)

マスタレンディション

マルチファイル管理機能

マルチファイル文書

マルチレンディション機能

マルチレンディション文書

(め)

メタ情報ファイル

メタデータ

メタデータ空間

(ヤ行)

(ゆ)

ユーザ権限

ユーザ権限定義ファイル

ユーザ情報

(ラ行)

(ら)

ランキング検索

(り)

リファレンス情報ファイル

リファレンスファイル管理機能

リファレンスファイル管理機能を使用する場合のオブジェクトの削除

リファレンスファイル文書

リレーション

リレーション先文書

リレーション識別子

リレーション元文書

リンク

リンク権

リンク識別子

リンク識別子ファイル

(れ)

レンディション

レンディションタイプ

レンディション変換

(ろ)

ローカルACL

ロケール

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
AIXは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Microsoft Office Wordは，米国Microsoft Corporationの商品名称です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。Microsoft Wordは，米国Microsoft Corporationの商品名称です。
OLEは，米国Microsoft Corporationが開発したソフトウェア名称です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
TIFFは，米国Aldus Corp.が開発したフォーマットの名称です。
UNIXは，The Open Groupの米国ならびに他の国における登録商標です。
VisualAgeは，米国およびその他の国におけるInternational Business Machines Corporationの商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
活文，PDFstaffは，株式会社日立ソリューションズの登録商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。