このサンプルでは、IOrganizationService.ValidateSavedQueryRequest メッセージを使用して FetchXML クエリを検証し、続いて IOrganizationService.ExecuteByIdSavedQueryRequest メッセージ使用してクエリを実行する方法を示します。
このサンプルを実行する方法
- ローカル コピーを作成できるように、 Microsoft/PowerApps-Samples リポジトリをダウンロードまたは複製します。
- (省略可能)
dataverse/App.configファイルを編集して、接続先のMicrosoft Dataverse インスタンスを指定する接続文字列を定義します。 - Visual Studioでサンプル ソリューションを開き、F5 を押してサンプルを実行します。
dataverse/App.configで接続文字列を指定すると、実行するすべてのサンプルでその接続情報が使用されます。
dataverse/App.config ファイルで接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスと使用する資格情報に関する情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。
実行するために Dataverse インスタンスへの接続を必要とするこのリポジトリのサンプルには、 dataverse/App.config ファイルへのリンクされた参照が含まれています。
このサンプルの概要
ValidateSavedQueryRequest クラスは、保存済みクエリ (ビュー) を検証する必要があるデータが含まれているシナリオで使用するためのものです。
ExecuteByIdSavedQueryRequest クラスは、指定された ID を持つ、保存済みクエリ (ビュー) を実行する必要があるデータが含まれているシナリオで使用するためのものです。
このサンプルがどのように動作するか
このサンプルの概要 で説明されているシナリオをシミュレートするために、サンプルは次のことを行います。
段取り
- 組織の現在のバージョンをチェックします。
-
Accountメソッドは 3 つの取引先企業のレコードを作成します。 -
SavedQueryメソッドは、保存済みクエリを作成します。 -
UserQueryメソッドは、ユーザー クエリを作成します。
実際にやってみます
-
ValidateSavedQueryRequestメソッドは検証要求を作成します。 -
ExecuteByIdSavedQueryRequestメソッドは、保存済みクエリを実行します。
クリーンアップ
サンプルで作成されたすべてのデータを削除するためのオプションを表示します。 サンプルで作成されるデータを検証する場合、削除は任意です。 手動でデータを削除することで同じ結果を得られます。