サンプル: レコードの作成および更新時の重複データ検出の使用

  • [アーティクル]

こののサンプルでは、テーブル レコードの作成および更新時に重複検出を行う方法を示しています。

.NET 用 SDK: レコードの作成および更新時の重複データ検出の使用のサンプル コード

このサンプルを実行する方法

  1. サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
  2. (オプション) Dataverse/App.config ファイルを編集して、接続先の Microsoft Dataverse インスタンスを指定する接続文字列を定義します。
  3. サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 Dataverse/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。

Dataverse/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスについての情報と、使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。

このリポジトリにあるサンプルのうち、Dataverse インスタンスに接続する必要があるものには、Dataverse/App.config ファイルを参照するリンクが含まれます。

このサンプルの概要

DuplicateRule メソッドは重複データ検出ルールを作成する必要があるデータが含まれているシナリオで使用するためのものです。

このサンプルがどのように動作するか

このサンプルは何をするか で説明されているシナリオをシミュレートするために、サンプルは次のことを行います:

セットアップ

  1. 組織の現在のバージョンをチェックします。
  2. Account メソッドは取引先企業のレコードを作成します。
  3. DuplicateRule メソッドは重複データ検出ルールを作成します。
  4. DuplicateRuleCondition メソッドは重複データ検出ルールの条件を作成します。
  5. PublishDuplicateRuleRequest メソッドは既に作成された重複データ検出ルールを発行します。 発行操作が完了するまで待機する必要があるため、ルールの状態を Published になるまでポーリングし続けます。

実際にやってみます

  1. Account メソッドは取引先企業のレコードを作成します。
  2. CreateRequest メソッドは重複データ検出の回避により操作を作成します。
  3. UpdateRequest メソッドは新しい取引先企業番号で取得した取引先企業レコードを更新します。

クリーンアップ

サンプルで作成されたすべてのデータを削除するためのオプションを表示します。 サンプルで作成されるデータを検証する場合、削除は任意です。 手動でデータを削除することで同じ結果を得られます。

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。