サンプル: 重複データ検出を有効にし、重複を取得する

このサンプルでは、重複データ検出機能を有効にして重複レコードを取得する方法を示します。

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

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

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

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

このサンプルの概要

IsDuplicateDetectionEnabled プロパティは、組織およびテーブルの重複データ検出ルールを有効にするシナリオで使用することを目的としています。

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

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

セットアップ

1. 組織の現在のバージョンをチェックします。
2. Account メソッドでは、重複レコードを取得するためにアカウント レコードを作成します。
3. RetrieveDuplicateRequest メソッドは、重複レコードを取得します。
4. EnableDuplicateDetectionForOrg クラスでは、組織の重複データ検出を有効にします。
5. 重複データ検出を有効にするには、IsDuplicateDetectionEnabled = true と設定します。
6. RetrieveEntityRequest メソッドは、エンティティ メタデータを取得します。
7. IsDuplicateDetectionEnabled = true と設定して、重複データ検出フラグを更新します。
8. UpdateEntityRequest にて、重複データ検出を使用してエンティティを更新し、true と設定します。

クリーン アップ

セットアップ で作成されたレコードを削除するオプションを表示します。 サンプルによって作成されたテーブルとデータを調べる場合、削除はオプションです。 手動でレコードを削除することで同じ結果を得られます。