次の方法で共有

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

  • [アーティクル]

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

注記

統合キーは、Dataverse テーブルに対してのみ必要です。 財務と運用部門には必要ありません。

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

重要

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

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

自動鍵生成

二重書き込み統合鍵は、Dataverse テーブルに定義された代替鍵に基づいて自動的に生成されます。 欠落している、または間違いがある場合は、統合キーを更新できます。 (たとえば、統合鍵に関連するエラーコードが表示され、鍵がない、あるいは間違っていることがわかる場合があります)。

統合鍵を更新するには、以下の手順に従います。

  1. Dataverse テーブルに代替鍵が作成されていることを確認してください。

    1. ご利用の Dataverse 環境で、Power Apps Maker Portal を開きます。
    2. 二重書き込みテーブルマップで選択されている Dataverse テーブルを開きます。
    3. Dataverse テーブルに少なくとも 1 つの代替鍵が定義されていることを確認してください。

  2. 財務と運用アプリで、二重書き込み管理ワークスペースを開きます。

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

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

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

鍵の手動更新

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

統合鍵を変更するには、以下の手順に従います。

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

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

二重書き込みで一意なレコードを正しくリンクするには、統合鍵を使用するテーブルの二重書き込みマップが以下の要件を満たしている必要があります:

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

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