二重書き込み統合鍵の管理

Note

コミュニティの関心グループが Yammer から Microsoft Viva Engage に移行されました。 Viva Engage コミュニティに参加し、最新のディスカッションに参加するには、「 Finance and Operations Viva Engage Community へのアクセスを要求する 」フォームに入力し、参加するコミュニティを選択します。

デュアルライト統合キーは、Dataverse テーブル内の行を一意に識別するエンティティの自然キーです。 財務アプリと運用アプリでデュアル書き込み操作が開始されると、キーは Dataverse テーブルでその操作を実行する正しいレコードを見つけるのに役立ちます。 たとえば、財務および運用エンティティを Dataverse の Global Product テーブルに関連付けるデュアルライト マップの場合、マップが正しく処理されるようにグローバル製品テーブルの統合キーを定義する必要があります。 財務と運用アプリで製品レコードを更新または削除すると、グローバル製品テーブルで操作を実行する一意の関連レコードを見つけることができます。

Note

Dataverse テーブルに対してのみ統合キーを定義します。 財務エンティティと運用エンティティでは、統合キーは必要ありません。

統合鍵は Dataverse テーブルの代替鍵に基づいています。 テーブルの代替鍵を使用すると、外部システムとのプログラミングおよび統合を簡素化できます。 これらのキーは、Dataverse の行を一意に識別するグローバル一意識別子 (GUID) が外部システムに格納されていない場合に必須です。 Dataverse の代替キーの詳細については、行を参照する代替鍵の定義 を参照してください。

Important

統合キーに使用される Dataverse テーブルの代替キーには、アプリケーション ユーザーが変更できない列のみを含める必要があります。 統合鍵は財務と運用アプリと Dataverse のレコード間の関係を定義します。 レコードの代替キーの一部である列の値を変更する場合は、基本的にレコードの ID を変更し、財務および運用アプリのレコードと Dataverse の間の関係を解除します。 財務アプリと運用アプリと Dataverse の間でキーが一致することが重要です。

二重書き込み統合鍵の生成

自動鍵生成

デュアルライト統合キーは、Dataverse テーブルに対して定義した代替キーに基づいて自動的に生成されます。 欠落している、または間違いがある場合は、統合キーを更新できます。 たとえば、統合キーに関連する エラー コード が表示されるため、キーが見つからないか、正しくないことが分かることがあります。

統合キーを更新するには、次の手順に従います。

  1. Dataverse テーブルの代替キーが存在することを確認します。

    1. Power Apps メーカー ポータルを開き、Dataverse 環境を選択します。
    2. 二重書き込みテーブルマップで選択されている Dataverse テーブルを開きます。
    3. Dataverse テーブルに少なくとも 1 つの代替鍵が定義されていることを確認してください。
  2. 財務と運用アプリで、二重書き込み管理ワークスペースを開きます。

  3. 関連するテーブルマップを選択します。

  4. アクション ウィンドウで、テーブルの更新 を選択します。

テーブルを更新すると、統合キーが自動的に生成されます。

鍵の手動更新

統合鍵は手動で変更できます。 統合鍵 ページには 、自動的に生成された統合鍵が一覧表示されます。 リストには、環境の二重書き込みマップに含まれる各 Dataverse テーブルの鍵があります。 たとえば、必要なキー以外の代替キーから統合キーが自動的に生成された場合は、統合キーの変更が必要になる場合があります。

統合キーを変更するには、次の手順に従います。

  1. 財務と運用アプリで、二重書き込み管理ワークスペースを開きます。
  2. アクション ペインで、環境の詳細 を選択します。
  3. 統合鍵 タブ で、選択した Dataverse テーブルの統合鍵の鍵プロパティを追加、削除、または更新します。
  4. アクション ウィンドウで、保存を選択します。

統合鍵フィールドによる二重書き込みマップの構成

デュアル書き込みで一意のレコードを正しくリンクするには、統合キーを使用するテーブルのデュアル書き込みマップが次の要件を満たしている必要があります。

  • テーブルの統合キーのすべてのフィールドを、そのテーブルのデュアル書き込みテーブル マップに含めます。 マップを初期化する前に、すべての統合キー フィールドを財務および運用エンティティのフィールドにマップしていることを確認します。 この手順により、デュアル書き込み同期で正しいレコードを見つけることができます。
  • 参照先エンティティの展開されたキー フィールドであるルックアップ フィールドをマップします。 ルックアップ フィールドを Dataverse の代替キーの一部として使用する場合は、拡張フィールドをデュアルライト マップの財務および運用アプリのフィールドにマップする必要もあります。
  • 双方向にデュアル書き込みテーブル マップをマップする場合 (つまり、いずれかのフィールド マッピングが財務アプリと運用アプリと Dataverse の間で双方向である場合)、すべての統合キー フィールドも双方向にマップする必要があります。

これらの要件により、二重書き込みライブ同期が財務と運用アプリケーションまたは Dataverse 環境のいずれかで特定のレコードを見つけることができるようになります。