Spark メッセージングで Vault から Vault のインテグレーションを作成する際に、ターゲット Vault のデータモデルに適合するように、ソース Vault のデータモデルのデータを変換する必要がある可能性があります。例えば、ソース Vault の country__v 値の「米国」がターゲット Vault の「米国」に相当することを示す必要があるとします。
参照関係は、ソース Vault の値から直接対象オブジェクトまたはドキュメントのフィールド値を設定するために参照関係を設定することができるインテグレーションルールの一つです。
参照関係の作成手順は次の 3 つです:
- 統合ルールを設定します。詳細をご確認ください。
- 参照関係オブジェクトレコードを設定する。この記事ではこの手順について詳しく説明します。
- 参照ルックアップを使用するために Spark メッセージプロセッサを作成します。開発者ポータルの Spark メッセージプロセッサの詳細をご覧ください。
参照関係管理へのアクセス
管理者 > 接続からインテグレーションの表示と管理が行えます。ここで、Vault から Vault への接続タイプにレコードを選択します。接続詳細ページで、参照関係セクションを見つけます。
接続タブの接続に接続するには、アプリケーション: 接続の管理権限が付与されたセキュリティプロファイルが必要です。
参照関係レコードの作成方法
参照関係レコードを作成するには:
- 接続詳細ページで、参照関係セクションを展開します。
- 追加をクリックします。
- 参照関係の作成ダイアログで、この参照のタイプを選択します。例: オブジェクト。ソース Vault のタイプとターゲット Vault のタイプが異なり、不一致のデータタイプがある場合は、 全般を選択します。
- 次に対象オブジェクトを選択します。例: Country (country__v)。タイプとして全般 を選択した場合、
__cで完了する名前 を入力します。小文字、英数字、およびアンダースコア (_) のみが許可されます。 - 続行をクリックします。
- タイプオブジェクトのルックアップを作成する場合は、対象キーフィールドを選択します。これは、Vault 間の値をマッピングするために使用するオブジェクトのフィールドです。オブジェクトレコード名が変わる可能性があるため、キーフィールドとして name__v を選択することは推奨されません。代わりに、ID のような静的フィールドの使用を推奨します。
- 次に、ルックアップに最初の値を追加する必要があります。追加をクリックします。
- ソースキーを入力します。このキーは、ソース Vault のオブジェクトレコードを特定するもので、固有である必要があります。レコード ID の使用が推奨されます。例: ソース Vault の「米国」国レコードに対する ID。
- 対象キーを選択します。このキーは、ターゲット Vault のオブジェクトレコードを特定します。例えば、ターゲット Vault で使用可能なオブジェクトレコードのリストから米国を選択します。ルックアップタイプが全般の場合、この値を手動で入力する必要があります。
- ステータスを設定します。Spark メッセージプロセッサにコード化する準備が整うまで、ルックアップを無効に設定することが推奨されます。
- 保存をクリックします。さらに参照関係レコードを追加するには、保存 + 作成をクリックします。
- 任意の作業: オブジェクトに関連付けられるものすべてに値を追加する場合は、CSV テンプレートの使用が推奨されます。
一般
ソース Vault のデータタイプがターゲット Vault のデータタイプと一致しない場合、またはここに記載されていないデータタイプと一致させる必要がある場合、管理者は一般 オプションを使用してデータタイプを手動でマップすることができます。
一般は、すべての単一値フィールドに対して any-to-any マッピングをサポートしています。複数値フィールドはサポートされていません。例えば、はい/いいえフィールドはサポートされていて、複数値の選択リストはサポートされていません。最善の方法として、必要なデータタイプが利用できない場合にのみ、一般を使用します。
参照関係テンプレートのエクスポートおよび読み込み
一度に多くの参照関係値を簡単に更新するには、入力可能テンプレートをエクスポートしてすべてのレコードを一括更新することができます。それには、参照関係詳細ページでテンプレートのエクスポートをクリックします。
Vault は、以下の列を含む CSV ファイルとしてテンプレートをダウンロードします:
- ターゲット名 (表示/参照利用のみ): この事前入力された列には、この対象オブジェクトに関連付けられたターゲット Vault のすべてのレコード (最大 2,000 レコード) の名前が一覧表示されます。
- ターゲットキー: この入力可能列は、ターゲット Vault でこのレコードを特定するために使用される対象キーフィールド値を一覧表示します。例えば、対象キーフィールドが ID の場合、ターゲット Vault でこれらのレコードに関連付けられた ID を入力します。
- ソース名 (表示/参照利用のみ): この入力可能列は、この対象オブジェクトに関連付けられたソース Vault のすべてのレコード名を一覧表示するために使用できます。
- ソースキー: この入力可能列は、ソース Vault でオブジェクトレコードを特定するためのキーを一覧表示し、固有である必要があります。レコード ID の使用が推奨されます。例: ソース Vault の「米国」国レコードに対する ID。
エクスポートしたテンプレートに入力したら、Vault に値を素早く読み込むことができます。そうするには、参照関係の読込みをクリックし、完了した CSV を選択します。読み込み処理が完了したら、システムメッセージが送信されます。読み込み中にエラーが発生した場合は、システムメッセージにエラーログをダウンロードするためにリンクが含まれます。