このサンプルは、単一の Web サービス メソッド呼び出しを使用し、ExecuteMultipleRequest をパラメーターとして渡すことで複数の組織メッセージ要求を実行する方法を説明します。 ネットワークに送信するメッセージ要求の数を減らすことにより、メッセージ処理のパフォーマンスが向上します。
このサンプルを実行する方法
- ローカル コピーを作成できるように、 Microsoft/PowerApps-Samples リポジトリをダウンロードまたは複製します。
- (省略可能)
dataverse/App.configファイルを編集して、接続先のMicrosoft Dataverse インスタンスを指定するconnection stringを定義します。 - Visual Studioでサンプル ソリューションを開き、F5 を押してサンプルを実行します。
dataverse/App.configでconnection stringを指定すると、実行するすべてのサンプルでその接続情報が使用されます。
dataverse/App.config ファイルでconnection stringを指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスと使用する資格情報に関する情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。
実行するために Dataverse インスタンスへの接続を必要とするこのリポジトリのサンプルには、 dataverse/App.config ファイルへのリンクされた参照が含まれています。
このサンプルの概要
ExecuteMultipleRequest メッセージは、1 つ以上のメッセージ要求を単一のバッチ処理として実行するために必要なデータが含まれているシナリオで使用されることを意図しており、オプションで結果の収集を返します。
このサンプルがどのように動作するか
このサンプルの概要で説明されているシナリオをシミュレートするために、サンプルは次のことを行います:
セットアップ
組織の現在のバージョンをチェックします。
実演
-
ExecuteMultipleRequestメソッドがExecuteMultipleRequestオブジェクトを作成します。 -
ExecutingMultipleSettingsメソッドでは、実行時の動作を定義する設定を割り当てます: エラー時に続行し、応答を返します。 -
OrganizationRequestCollectionメソッドは、空の組織要求コレクションを作成します。 -
CreateRequestメソッドはテーブルごとにリクエストコレクションに追加されます。 -
GetCollectionOdEntitiesToUpdateクラスは、以前に作成されたテーブルを更新します。
クリーンアップ
セットアップで作成されたレコードを削除するオプションを表示します。 サンプルによって作成されたテーブルとデータを調べる場合、削除はオプションです。 手動でレコードを削除することで同じ結果を得られます。