ドキュメント移行モードを使用して、Vault が通常適用している一部の制約を緩和することで、多数のドキュメントを簡単に移行できます。例えば、ドキュメント、任意のライフサイクル状態のドキュメントレンディションを作成し、CSV 入力ファイルで名前、ドキュメント番号、バージョン番号を手動で設定できます。
Vault REST API、Vault ローダ、または Vault ローダコマンドラインツールを使用して、作成する新しいドキュメントや更新する既存のドキュメントにドキュメント移行モードを適用できます。その他のすべてのドキュメントは引き続き、通常どおりに操作できます。これらのオプションを使用して移行モードを適用するには、Vault 所有者アクション: ドキュメント移行権限が必要です。
注: ドキュメント移行モードは構成モードとは別のもので、機能は異なります。
ドキュメント移行モードの使用方法
ドキュメント移行モードでは、アップロードされた CSV 入力ファイルを介して以下のフィールドを変更できます。
- major_version_number__v
- minor_version_number__v
- document_number__v (ドキュメントとドキュメントバージョン)
- status__v (ドキュメントとドキュメントバージョン)
- rendition_type__v (ドキュメントレンディション)
ドキュメント API
Vault REST API の複数のドキュメントの作成、複数のドキュメントバージョンの作成、複数のドキュメントの更新、および複数のドキュメントレンディションの追加エンドポイントは X-VaultAPI-MigrationMode
ヘッダーを許容します。このヘッダーは、そのリクエストで作成または更新されるドキュメントにドキュメント移行モードを適用します。
Vault ローダ API
Vault REST API のデータオブジェクトのロードエンドポイントを使用して、documentmigrationmode
パラメータを true
に設定します。
Vault ローダ UI
Vault ローダでドキュメントを一括で作成または更新する場合は、ドキュメント移行モードチェックボックスを選択して、移行モードを適用します。オブジェクトタイプがドキュメント、ドキュメントレンディション、ドキュメントバージョン、またはドキュメント、バージョン、ロールの場合のみ、チェックボックスを選択できます。
Vault ローダ CLI
Vault ローダコマンドラインツールで、-documentmigrationmode
パラメータを使用します。
ドキュメント移行モードの制約
ドキュメント移行モードを適用している API コールまたは Vault ローダを介してドキュメントを作成または更新する場合、一部の Vault 機能が制限され、アップロードの完了後に追加の手順が必要となることがあります。次の制限は、ドキュメント移行モードを適用して作成または更新されたドキュメントのみに適用されます。
制限 | ドキュメントの作成または更新後 |
ドキュメントへのリーガルホールドの自動適用が無効化されます | 対象のドキュメントにリーガルホールドを再適用します |
ビデオファイルのレンダリングが無効化されます | サポートに問い合わせて、影響を受けるビデオファイルの再レンダリングをリクエストします |
ドキュメントに対する連続 EDL マッチングが無効化されます | 影響を受けるドキュメントに EDL マッチングを再適用します |
Sandbox Vault のみ: `X-VaultAPI-MigrationMode` API ヘッダーを使用して移行されたドキュメントのフルテキスト検索のインデックスを無効にします。 | ドキュメントのフルテキスト検索を通常に戻します |
Sandbox Vault のみ: `X-VaultAPI-MigrationMode` API ヘッダーを使用して作成されたドキュメントの OCR インデックスは無効になっています。 | ドキュメントの OCR インデックスを通常に戻します |
Vault は、API または Vault ローダ経由でアップロードされたドキュメントには イベントアクションを実行しません。 | イベントアクションの実行を通常に戻します。 |
Vault Training で、E-ラーニング基準フィールド値が設定されていません。 | E-ラーニング基準フィールド値が設定されます。 |