FetchXMLBuilder

FetchXMLBuilderクラスは、FetchXMLクエリをプログラム的に構築・操作するための流暢なAPIを提供します。生のXML文字列を構築する代わりに、強型メソッドを使ってエンティティ、列、フィルター、条件、ソート順序、リンクエンティティを定義できます。

Reactノート
FetchXMLBuilder はサーバー側のBlazorユーティリティであり、Reactにはこの クラスに相当するものはありません。代わりにReactが持っているのは FetchXMLクエリビルダーで、これはクエリを視覚的に編集し、FetchXMLを渡すコンポーネントです。クエリをすでに知っている呼び出し者はそれを文字列リテラルとして構成し、 ppp.retrieveRecordsAsync(fetchXml)に渡します。FetchXMLが到着した後も、サーバーは依然として重労働を行います(フィルターのマージ、ページング、セキュリティのトリミング)。

クエリの作成

空クエリで新しい FetchXMLBuilder を作成するか、既存のFetchXML文字列を解析してください。

列の選択

AddColumnで個別の列を追加するか、すべての列を取得するためにAllColumns = trueを設定してください。設定AllColumns個別に追加された列は削除されます。

フィルターの追加

AddFilterでエンティティやリンクエンティティにフィルターを追加し、そのフィルターに条件を追加します。各条件は列、演算子、値を指定します。

ソート結果

AddSortOrderを使ってソート順を定義します。列名や降順に並べ替えるかどうかを指定することができます。

ページング

Fetch要素のCount、Page、PagingCookieプロパティでページングを制御します。ReturnRecordCount = true結果に記録総数を含めるように設定してください。

既存のfetchXMLの解析

既存のFetchXML文字列をコンストラクタに渡し、解析・操作します。これはビューやその他のソースからのクエリを修正するのに役立ちます。

fetchXML文字列の生成

ToString()を呼び出してFetchXML文字列を生成します。出力は決定論的に順序付けられています:属性、次にソート順序、フィルター、リンクエンティティ。各グループ内では、要素はアルファベット順に並べられています。