FetchXML を使用してデータのクエリを実行する

10 分

FetchXML は Microsoft が開発したクエリ言語で、Microsoft Dataverse のデータに対して複雑なクエリ操作を実行できます。 OData コネクタよりもはるかに多くのフィルター処理オプションが用意されており、オプションセットラベルやルックアップフィールドなどの参照データのラベルを表示できます。

FetchXML クエリは、次の方法を使用して実行できます。

Dataverse Web API
組織サービス

また、カスタム FetchXML フィルターをモデル駆動型アプリ内のルックアップフィールドに適用することもできます。このアプローチでは、標準の方法では簡単に実行できない、より複雑な検索シナリオを実現できます。このプロセスを実行する方法の詳細については、「addCustomFilter クライアント API リファレンス」を参照してください。

サンプル FetchXML クエリ

次のサンプルクエリでは、アカウントテーブルから accountid フィールドと name フィールドを取得します。

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
   </entity>
</fetch>

このデータを (州などで) フィルター処理する必要がある場合は、次のサンプルクエリのような操作を実行できます。

<fetch mapping='logical'>
   <entity name='account'>
      <attribute name='accountid'/>
      <attribute name='name'/>
      <filter type='and'>
        <condition attribute='address1_stateorprovince' operator='eq' value='WA' />
      </filter>
   </entity>
</fetch>

クエリ作成支援ツール

データをクエリしているとき、クエリの対象となるテーブルを含むモデル駆動型アプリがある場合は、FetchXML のダウンロード機能を備えた高度な検索機能を使用すると、最も簡単に FetchXML クエリを作成できます。この方法では、UI で取得できるフィルターと関連データに制限がありますが、XML を自分で新たに作成する必要がないため、多くの場合は最初に使用すると便利です。

コミュニティによって作成されたもう 1 つの注目のツールは、FetchXML Builder です。このツールを使用すると、高度な検索機能では実行できない方法で FetchXML を作成できます (集計、外部結合、"持たない" のクエリ、リンクされている複数レベルのエンティティからの属性)。その他にも豊富な機能が用意されています。詳細については、Web サイト: FetchXML Builder を参照してください。

その他のリソース

FetchXML クエリ言語の詳細については、ページングの処理や階層データのクエリなど、複数の高度なトピックについて説明している「FetchXML を使用してデータのクエリを実行する」セクションを参照してください。

続行

サンプル FetchXML クエリ

クエリ作成支援ツール

その他のリソース

フィードバック