サンプル: FetchXML とQueryExpression間のクエリを変換する

このサンプルは、 FetchXML と QueryExpression間でクエリを変換する方法を示しています。

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

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

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

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

このサンプルの概要

QueryExpression および fetchExpression メッセージは、それぞれ式と FetchXML の階層にクエリが含まれるシナリオで使用することを目的としています。

このサンプルの動作方法

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

設定

1. 自社組織の現在のバージョンを確認してください。
2. CreateRequireRecords メソッドは、サンプルで使用する取引先企業と 2 つの取引先担当者レコードを作成します。
3. QueryExpression は QueryExpression を構築し、 FetchXML に変換します。
4. DoFetchXmlToQueryExpressionConversion クラスは、QueryExpression に変換する Fetch クエリを作成します。
5. conversionRequest メソッドは、生成された QueryExpression を FetchXML に変換し、その逆も行います。
6. 変換されたクエリを使用して、RetrieveMultiple 要求を取得します。

クリーンアップ

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