サンプル: 複数の要求を実行する

このサンプルは、単一の Web サービス メソッド呼び出しを使用し、ExecuteMultipleRequest をパラメーターとして渡すことで複数の組織メッセージ要求を実行する方法を説明します。 ネットワークに送信するメッセージ要求の数を減らすことにより、メッセージ処理のパフォーマンスが向上します。

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

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

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

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

このサンプルの概要

ExecuteMultipleRequest メッセージは、1 つ以上のメッセージ要求を単一のバッチ処理として実行するために必要なデータが含まれているシナリオで使用されることを意図しており、オプションで結果の収集を返します。

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

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

セットアップ

組織の現在のバージョンをチェックします。

使用方法

1. ExecuteMultipleRequest メソッドが ExecuteMultipleRequest オブジェクトを作成します。
2. ExecutingMultipleSettings メソッドでは、実行時の動作を定義する設定を割り当てます: エラー時に続行し、応答を返します。
3. OrganizationRequestCollection メソッドは、空の組織要求コレクションを作成します。
4. CreateRequest メソッドがテーブルごとにメソッドがリクエストコレクションに追加されます。
5. GetCollectionOdEntitiesToUpdate クラスは、以前に作成されたテーブルを更新します。

クリーンアップ

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