サンプル: 保存済みクエリの検証および実行

このサンプルでは、IOrganizationService.ValidateSavedQueryRequest メッセージを使用して FetchXML クエリを検証し、続いて IOrganizationService.ExecuteByIdSavedQueryRequest メッセージ使用してクエリを実行する方法を示します。 サンプルは ここ からダウンロードできます。

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

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

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

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

このサンプルの概要

ValidateSavedQueryRequest クラスは、保存済みクエリ (ビュー) を検証する必要があるデータが含まれているシナリオで使用するためのものです。

ExecuteByIdSavedQueryRequest クラスは、指定された ID を持つ、保存済みクエリ (ビュー) を実行する必要があるデータが含まれているシナリオで使用するためのものです。

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

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

セットアップ

1. 組織の現在のバージョンをチェックします。
2. Account メソッドは 3 つの取引先企業のレコードを作成します。
3. SavedQuery メソッドは、保存済みクエリを作成します。
4. UserQuery メソッドは、ユーザー クエリを作成します。

使用方法

1. ValidateSavedQueryRequest メソッドは有効な要求を作成されます。
2. ExecuteByIdSavedQueryRequest メソッドは、保存済みクエリを実行します。

クリーン アップ

サンプルで作成されたすべてのデータを削除するためのオプションを表示します。 サンプルで作成されるデータを検証する場合、削除は任意です。 手動でデータを削除することで同じ結果を得られます。

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。