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

FetchXML は、Dataverse からデータを取得するために使用される、独自の XML ベースのクエリ言語です。データの取得に使われる要素については、FetchXml の参照を参照してください。

注意

FetchXML を使用して、モデル駆動型アプリと一部のレポート機能のビューを定義することもできます。この記事には、これらのユースケースの要素と属性は含まれていません。コードによるモデル駆動型アプリのビューのカスタマイズの詳細情報。

FetchXML クエリを作成する

すべてのクエリは単一のテーブルに基づいています。ルート要素は fetch です。エンティティ要素を使用して、クエリがデータを取得するテーブルを選択します。次の例は、単純な FetchXML クエリを表しています。

<fetch top='5'>
  <entity name='account'>
      <attribute name='name' />
  </entity>
</fetch>

このクエリは、Account テーブルの最初の 5 行の名前の列を返し、テーブルのLogicalNameを使用してエンティティ属性を設定します。

返される行数を制限するには、取り込み要素top の属性を使用します。 top属性がない場合、Dataverse は最大 5,000 個の標準テーブル行と 500 行のエラスティックテーブル行を返します。

または、ページングを使用して、返すレコードの数を指定します。データのページをリクエストするときには、top 属性を使わないでください。ページングされた結果をリクエストする方法を解説します

top 属性を使用して行数をリクエストする場合は、returntotalrecordcount を使用できません。行を数える方法を学ぶ

取り込み要素distinct 属性を使用して、クエリで結果内の重複値を除外するように要求します。

distinct 属性を使用する場合、ページングの一貫性を保つために、順序要素を少なくとも 1 つ追加する必要があります。

distinct 属性を使用すると、各レコードの主キー値はすべての個別の値の集計を表すため、返される結果には含まれません。

クエリを開始するテーブルを選択した後、クエリを調整して必要なデータを取得します。次の記事では、クエリを完了する方法について説明します。

FetchXML 要求を作成してテストするための無料のツールがあります。

注意

Microsoft では、コミュニティによって作成されたツールはサポートされていません。コミュニティツールに関する質問や問題がある場合は、ツールの発行元にお問い合わせください。

次のメッセージなどの Dataverse 操作のパラメーターとして FetchXML を使用することもできます。

メッセージ名	SDK for .NET リクエストクラス	Web API 操作
`BackgroundSendEmail`	BackgroundSendEmailRequest	BackgroundSendEmail アクション
`BulkDetectDuplicates`	BulkDetectDuplicatesRequest	BulkDetectDuplicates アクション
`FullTextSearchKnowledgeArticle`	FullTextSearchKnowledgeArticleRequest	FullTextSearchKnowledgeArticle アクション
`FetchXmlToQueryExpression`	FetchXmlToQueryExpressionRequest	FetchXmlToQueryExpression 関数
`SendBulkMail`	SendBulkMailRequest	SendBulkMail アクション
`Rollup`	RollupRequest	ロールアップ機能

列を選択する方法について説明します。

FetchXML を使用してデータを取得する方法について説明します。

このページはお役に立ちましたか?