ファイルの更新

// シングルファイル文書の場合
// （マスタレンディションのファイルの更新）
DmaBoolean UpdateContent(
  const pDmaString_T      pFilePath,
  DmaInteger32            lCreateIndexFlg = DBR_CREATE_INDEX)
　
// シングルファイル文書の場合
// （RenditionTypeを指定したファイルの更新）
DmaBoolean UpdateContent(
  const pDmaString_T      pFilePath,
  pDmaString_T            pRenditionType,
  DmaInteger32            lCreateIndexFlg)
　
// マルチファイル文書の場合
DmaBoolean UpdateContent(
  SDBR_PATHLIST&     PathList,
  pDmaString_T       pRenditionType)
　
// File Link文書の場合
DmaBoolean UpdateContent(
  SDBR_FILELINK_PATHINFO&   FileLinkPath,
  pDmaString_T              pRenditionType)
　
// ファイルパス情報構造体
struct SDBR_PATHINFO {
  pDmaString_T    pFilePath;       // ファイルのURL
  pDmaString_T    pComponentType;  // ファイルを識別する文字列
};
　
// ファイルパス情報リスト構造体
struct SDBR_PATHLIST {
  DmaInteger32    lCount;          // 登録ファイル数
  SDBR_PATHINFO*  pItem;           // ファイルパス情報構造体のポインタ
};
　
// File Linkパス情報構造体
struct SDBR_FILELINK_PATHINFO {
  pDmaString_T  pFilePath;          // 登録ファイルまたはディレクトリのURL
  pDmaString_T  pFamName;           // FAM名
  pDmaString_T  pFamFilePath;       // コンテント保管先パス
  DmaInteger32  lContentDeleteMode; // コンテント削除モード
  DmaInteger32  lFileNamingMode;    // コンテント名自動生成モード
};

登録されているCdbrDocumentオブジェクトの内容を更新するメソッドです。CdbrDocumentクラスに格納したコンテントを，指定したパスのファイルで更新します。

このメソッドは，リファレンスファイルを管理する文書に対しては実行できません。

Windowsの場合，次のことに注意してください。

• GetContentAndLockによるコンテントの取得時，大文字と小文字を区別しないと同一になるファイル名がある場合，先に取得したファイルが上書きされます。例えば，先に取得された「AAA.txt」は，あとから取得された「aaa.txt」によって上書きされます。
• GetContentAndLockによるコンテントの取得時，ロングファイル名とショートファイル名の関係で同一のファイル名とみなされるファイルがある場合，先に取得したファイルが上書きされます。例えば，先に取得された「AAAAAAAAA.txt」は，あとから取得された「AAAAAA~1.txt」によって上書きされます。

シングルファイル文書の場合（マスタレンディションのファイルの更新）

シングルファイル文書（マルチレンディション文書の場合はマスタレンディションであるシングルファイル文書）を更新する場合は，更新に使用するファイルのパスと全文検索インデクスを作成するかどうかを指定します。

内容を更新するCdbrDocumentオブジェクト（マルチレンディション文書の場合はマスタレンディション）が次の条件に当てはまる場合に，lCreateIndexFlgにDBR_CREATE_INDEXを指定すると，全文検索インデクスを作成できます。

• 全文検索機能付き文書クラスを基に作成されたDocVersionオブジェクトを構成要素とするCdbrDocumentオブジェクトである。
• RenditionTypeがテキスト型（MIME::text/で始まるMIME::text/plain，MIME::text/sgmlまたはMIME::text/html）である。

更新が正常に完了すると，パス名を除いたファイル名がRetrievalNameプロパティに設定されます。例えば，UNIXの場合に，ファイル"/tmp/sample.doc"で更新すると，"sample.doc"が設定されます。Windowsの場合に，ファイル"c:\temp\sample.doc"で更新すると，"sample.doc"が設定されます。

UNIXの場合に，文書に登録されたコンテントの内容をファイル"/tmp/sample.doc"で更新する例を次に示します。Windowsの場合は，ファイル"c:\temp\sample.doc"で更新する例として，例中の"file:///tmp/sample.doc"を"file:///c:\temp\sample.doc"と読み替えてください。

文書の内容（コンテント）を更新する例

pDbrDoc->UpdateContent("file:///tmp/sample.doc");
　

シングルファイル文書の場合（RenditionTypeを指定したファイルの更新）

マルチレンディション文書のサブレンディションであるシングルファイル文書を更新する場合は，更新に使用するファイルのパスのほかに，更新対象のサブレンディションをpRenditionTypeで指定します。なお，サブレンディションの内容を更新する場合，全文検索インデクスは作成できません。

マルチファイル文書の場合

マルチファイル文書を更新する場合は，更新に使用するコンテントの情報として，SDBR_PATHLIST構造体を指定します。

マルチファイル文書の場合，次のことに注意してください。

• CdbrDocumentクラスに格納した複数のファイルを，SDBR_PATHINFO構造体に設定したファイルパスのファイルで，一括して更新します。SDBR_PATHINFO構造体は，引数PathListで指定するSDBR_PATHINFO構造体に設定します。なお，特定のコンテントだけを更新することはできません。また，更新後は，更新前のファイルは使用できません。
• 更新前のファイルを格納したBLOBのデータが書き換えられるため，BLOBのデータの長さは，更新後のファイルサイズの合計になります。
• この形式のUpdateContentを，マルチファイル文書ではないバージョンなし文書に対して実行すると，ERR_NOT_MULTI_CONTENTSのエラーになります。
• マルチファイル文書では，テキストファイルの部分が特定できないため，全文検索用インデクスは作成されません。全文検索インデクスを作成する場合，テキスト部分を抽出したファイルを，CreateIndexメソッドの引数に指定して実行してください。なお，マルチファイル文書の場合，CreateIndexメソッドの引数にNULLを指定するとERR_CONTENTTYPE_MISMATCHのエラーになります。

File Link文書の場合

File Link文書を更新する場合は，更新に使用するコンテントの情報として，SDBR_FILELINK_PATHINFO構造体を指定します。この構造体には，更新に使用するコンテントとして，ファイルまたはディレクトリを指定できます。ディレクトリを指定した場合，指定したディレクトリおよびそのサブディレクトリ下のすべてのファイルでコンテントを更新できます。また，すでにHiRDB File Linkで管理されているデータでコンテントを更新することもできます。

File Link文書の場合，次のことに注意してください。

• このメソッドは，レンディションのコンテント種別がContentFileLinkオブジェクトの場合（dbrProp_ContentTypeプロパティの値がDBR_CONTENTTYPE_FILELINKの場合）にだけ有効です。そのほかのコンテント種別を持つレンディションに対して実行すると，ERR_CONTENTTYPE_MISMATCHのエラーになります。
• このメソッドで，ERR_FILELINK_FAILEDのエラーが発生した場合は，詳細メッセージにHiRDB File Linkが出力するエラー情報が出力されます。HiRDB File Linkが出力するエラーを参照して，対処してください。
• File Link文書では，全文検索用インデクスは作成されません。全文検索インデクスを作成する場合，テキスト部分を抽出したファイルを，CreateIndexメソッドの引数に指定して実行してください。なお，File Link文書の場合，CreateIndexメソッドの引数にNULLを指定すると，ERR_CONTENTTYPE_MISMATCHのエラーになります。

pFilePath（入力）

更新に使用するファイルのパス名を指定します。ファイルのパス名はURL形式で設定します。例えば，UNIXの場合，ファイル"/tmp/sample.doc"を登録するには，"file:///tmp/sample.doc"と指定します。Windowsの場合，ファイル"c:\temp\sample.doc"を登録するには，"file:///c:\temp\sample.doc"と指定します。有効なプロトコルは"file:"だけです。これ以外のプロトコルを指定した場合はエラーになります。

なお，ここで指定するパスは，GetContentメソッドで取得したファイルである必要はありません。ただし，RenditionTypeが異なるファイルは指定できません。

pRenditionType（入力）

RenditionTypeを指定してレンディションの内容を更新する場合，内容を更新するレンディションのRenditionTypeを表す文字列を指定します。

この引数で指定したRenditionTypeが，対象文書のサブレンディションとして存在しない場合はエラーになります。

マスタレンディションの内容を更新する場合はNULLを指定するか，「マスタレンディションのファイルを更新する場合」の形式を使用することもできます。なお，空文字列（""）は指定できません。

マルチファイル文書の場合，NULLまたは「シングルファイル文書の場合（マスタレンディションのファイルの更新）」の形式を指定してください。

lCreateIndexFlg（入力）

全文検索インデクスを作成するかどうかを指定します。

次のどちらかを指定してください。この値を省略した場合は，DBR_CREATE_INDEXが指定されたものとして処理されます。

• DBR_CREATE_INDEX
  pFilePathに指定したパス名のファイルから全文検索インデクスが作成されます。
  
• DBR_NOT_CREATE_INDEX
  全文検索インデクスが作成されません。
  

なお，CdbrDocumentオブジェクトの構成要素が全文検索機能付きクラス以外から作成されたDocVersionオブジェクトである場合，およびファイルのRenditionTypeがテキスト型でない場合は，lCreateIndexFlgの値は無視されます。

また，マルチレンディション文書の場合，lCreateIndexFlgはマスタレンディションの内容を更新する場合だけ有効です。

PathList（入力）

更新に使用するファイルのファイルパス情報が設定されたSDBR_PATHLIST構造体を指定します。SDBR_PATHLIST構造体については，「付録C.1(11)　SDBR_PATHLIST構造体（ファイルパス情報リスト構造体）」を参照してください。

FileLinkPath（入力）

File Link文書を更新するために必要な情報を格納した，SDBR_FILELINK_PATHINFO構造体を指定します。

なお，SDBR_FILELINK_PATHINFO構造体のメンバpFilePathとメンバpFamFilePathの両方にNULLを設定した場合にはDMARC_BAD_PARAMETERのエラーになります。

SDBR_FILELINK_PATHINFO構造体に設定する内容については，「付録C.1(5)　SDBR_FILELINK_PATHINFO構造体（File Linkパス情報構造体）」を参照してください。

DMA_TRUE 　正常終了

DMA_FALSE　異常終了

major_code	minor_code	説明	対処
ERR_CORBA	CORBAの戻り値が設定されます。	CORBAでエラーが発生しました。	ユーザプログラムでは対処できません。エラー情報として文字列の値を取得して，ユーザプログラムを終了してください。
ERR_DB	ERR_DB_DEADLOCK_OCCURRED	データベースでデッドロックが発生しました。	時間を置いて，再度実行してください。
ERR_DB	ERR_DB_FAILED	データベースで障害が発生しました。 または，マルチファイル文書で指定したファイルのサイズの合計が，BLOBの定義長を超えました。	syslogを参照して，障害の原因を取り除いてください。
ERR_DB	ERR_DB_LOCKED	オブジェクトがロックされています。	時間を置いて，再度実行してください。
ERR_DBR	ERR_ACCESS_NOT_PERMITTED	アクセス権がありません。	この操作は実行できません。
ERR_DBR	ERR_ACLIB_OBJECT_INVALID	クラスライブラリのオブジェクトは無効です。	有効なクラスライブラリのオブジェクトを指定してください。
ERR_DBR	ERR_BAD_CONTENTSCOUNT	登録しようとするファイルの数が多過ぎます。	登録するファイルの数を見直してください。
ERR_DBR	ERR_CONTENTTYPE_MISMATCH	指定したレンディションタイプのコンテントに対して実行できません。	正しい文書オブジェクトを指定してメソッドを実行してください。
ERR_DBR	ERR_FAL_NOT_LOADED	HiRDB File Linkのライブラリがロードできません。	詳細メッセージを基に対処してください。
ERR_DBR	ERR_FILELINK_FAILED	HiRDB File Linkでエラーが発生しました。	詳細メッセージを基に対処してください。
ERR_DBR	ERR_INVALID_STATUS	セッションの状態が不正です。一つのセッションに同時に複数のメソッド処理要求が出されています。	一つのセッションに対しては，一度に一つの処理要求しか出さないように見直してください。
ERR_DBR	ERR_NONEXISTS_RENDITION	指定されたRenditionTypeは存在しません。	RenditionTypeを見直してください。
ERR_DBR	ERR_NOT_MULTI_CONTENTS	マルチファイル文書の文書ではありません。	マルチファイル管理機能を使用しない場合の形式で実行してください。
ERR_DBR	ERR_OBJECT_NOT_CONNECT	オブジェクトは接続されていません。	オブジェクトを接続してください。
ERR_DBR	ERR_RETRIEVALNAME_DUPLICATED	RetrievalNameが重複して指定されています。	RetrievalNameが重複しないように指定してください。
ERR_DBR	ERR_SESSION_NOT_CONNECT	セッションが接続されていません。	セッションを接続してください。
ERR_DMA	DMARC_ACCESS_DENIED	要求された操作に対してアクセス権がありません。	正しいアクセス権を設定してください。
ERR_DMA	DMARC_BAD_CLASSID	指定された識別子は，利用できるオブジェクトのクラスではありません。	正しいクラス識別子を指定してください。
ERR_DMA	DMARC_BAD_OIID	SetOIIDメソッドで設定されたOIIDが不正です。	正しいOIIDを指定してください。
ERR_DMA	DMARC_BAD_PARAMETER	不正な引数が入力されました。	正しい引数を指定してください。
ERR_DMA	DMARC_BAD_URL	リソースのURLが不正です。	URLの内容を見直してください。
ERR_DMA	DMARC_NO_MEMORY	メモリ不足で実行できません。	メモリを増設してください。またはメモリを大量に消費しているアプリケーションを停止させて，処理を再実行してください。
ERR_DMA	DMARC_NOT_FOUND	要求された要素が見つかりません。	正しいオブジェクトを設定してください。
ERR_DMA	DMARC_NOT_SUPPORTED	このセッションまたはオブジェクトではサポートされていないメソッドです。	この操作は実行できません。
ERR_DMA	DMARC_RESOURCE_NOT_FOUND	指示されたリソースが見つかりません。	正しいリソースを指定してください。
ERR_DMA	DMARC_UNEXPECTED	予期しないエラーが発生しました。	処理を終了してください。
ERR_DMA	DMARC_URL_PROTOCOL_NOT_SUPPORTED	サポートしていないURLプロトコルです。	file:///で始まっているか確認してください。
ERR_DMA	EDMRC_FTPSERVICE_LOST_CONNECTION	ファイル転送サービスへのセッションが切断されました。	ネットワーク環境を確認してください。または，時間を置いて，再度実行してください。
ERR_DMA	EDMRC_FTPSERVICE_MAX_SESSION	ファイル転送サービスに同時に接続できるセッション数の上限に達しています。	時間を置いて，Connectユーザ数が減ったあと，再度実行してください。または，ファイル転送サービス環境定義ファイルのFtpSessionMaxエントリを見直してください。
ERR_DMA	EDMRC_FTPSERVICE_NOT_AVAILABLE	ファイル転送サービスが利用できません。	サーバのバージョンに対応したクライアントを利用してください。
ERR_DMA	EDMRC_NO_FTPSERVICE	使用できるファイル転送サービスがありません。	ネットワーク環境を確認してください。 _HIEDMS_FTPMODE=STATICを指定してファイル転送サービスを起動しているかどうかを，確認してください。 時間を置いて，再度実行してください。 ファイル転送サービスのセットアップコマンドを実行しているかどうかを，確認してください。