FetchXMLBuilder

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

Reactノート
FetchXMLBuilder はサーバーサイドのBlazorユーティリティであり、Reactに相当するものはありません。React呼び出し者はFetchXMLを文字列リテラル(テンプレート文字列)として構成し、それらを直接 ppp.retrieveRecordsAsync(fetchXml) に渡します。FetchXMLが届いた後もサーバーが重労働(フィルターの統合、ページング、セキュリティ調整)を担当します。

クエリの作成

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

列の選択

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

フィルターの追加

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

ソート結果

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

ページング

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

既存のfetchXMLの解析

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

fetchXML文字列の生成

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