サンプル: レコードの作成および更新時の重複データ検出の使用
こののサンプルでは、テーブル レコードの作成および更新時に重複検出を行う方法を示しています。
このサンプルを実行する方法
- サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
- (オプション) Dataverse/App.config ファイルを編集して、接続先の Microsoft Dataverse インスタンスを指定する接続文字列を定義します。
- サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 Dataverse/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。
Dataverse/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスについての情報と、使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。
このリポジトリにあるサンプルのうち、Dataverse インスタンスに接続する必要があるものには、Dataverse/App.config ファイルを参照するリンクが含まれます。
このサンプルの概要
DuplicateRule
メソッドは重複データ検出ルールを作成する必要があるデータが含まれているシナリオで使用するためのものです。
このサンプルがどのように動作するか
このサンプルは何をするか で説明されているシナリオをシミュレートするために、サンプルは次のことを行います:
セットアップ
- 組織の現在のバージョンをチェックします。
Account
メソッドは取引先企業のレコードを作成します。DuplicateRule
メソッドは重複データ検出ルールを作成します。DuplicateRuleCondition
メソッドは重複データ検出ルールの条件を作成します。PublishDuplicateRuleRequest
メソッドは既に作成された重複データ検出ルールを発行します。 発行操作が完了するまで待機する必要があるため、ルールの状態をPublished
になるまでポーリングし続けます。
実際にやってみます
Account
メソッドは取引先企業のレコードを作成します。CreateRequest
メソッドは重複データ検出の回避により操作を作成します。UpdateRequest
メソッドは新しい取引先企業番号で取得した取引先企業レコードを更新します。
クリーンアップ
サンプルで作成されたすべてのデータを削除するためのオプションを表示します。 サンプルで作成されるデータを検証する場合、削除は任意です。 手動でデータを削除することで同じ結果を得られます。
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。