サンプル: 共通の条件に合致するレコードを一括して削除する

このサンプルは、一般的な条件に一致するレコードを一括削除する方法を示しています。 サンプルは ここ からダウンロードできます。

Note

このサンプルは、Dynamics 365 Customer Engagement (on-premises) と Dataverse の両方に適用されます。

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

すべてのサンプルのローカル コピーを取得してビルドするには、次の手順を実行します。

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

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

このサンプルの概要

BulkDeleteRequest メッセージは、一括削除要求を作成する必要があるデータが含まれているシナリオで使用するためのものです。

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

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

セットアップ

  1. 組織の現在のバージョンをチェックします。
  2. サンプルの取引先企業レコードを作成します。
  3. 一括削除の操作が完了した後に、システム ユーザーの電子メールの送信先のクエリ。
  4. BulkDeleteRequest では一括削除プロセスを作成し、要求プロパティを設定します。
  5. InspectBulkDeleteOperationメソッドでは、作成された BulkDeleteOperation に関する情報を確認および表示します。
  6. RetrieveBulkDeleteOperation メソッドは、BulkDeleteOperation を取得します。

使用方法

  1. 標準の電子メール テンプレートが存在するかどうか確認します。
  2. PerformBulkDelete メソッドでは、メインの一括削除操作が実行されます。

クリーン アップ

セットアップ で作成されたサンプル データを削除するためのオプションを表示します。 サンプルで作成されるエンティティおよびデータを検証する場合、削除は任意です。 手動でレコードを削除することで同じ結果を得られます。