fetch 要素 の ブール値 returntotalrecordcount 属性を使用して、フィルター条件を満たすすべてのレコード (最大 5000件) のカウントを結果に含めるように指定します。 ページ化された結果を取得するときにこれを使用して、表示する合計ページ数を推定します。
returntotalrecordcount と一緒に フェッチ要素top の属性を適用することはできません。
期待できる動作は、SDK for .NET または Web API のどちらを使用しているかによって異なります。
returntotalrecordcount 属性の値が true の場合、RetrieveMultiple メソッドから返される EntityCollection には以下のプロパティの値が含まれます:
| Property | プロパティ |
|---|---|
| TotalRecordCount | レコードの合計数は最大 5000、それ以外の場合、値は -1です。 |
| TotalRecordCountLimitExceeded | クエリの結果が総レコード数を超えていれば true、そうでなければ false です。 |
(TotalRecordCountLimitExceeded または @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) 値は、(TotalRecordCount または @Microsoft.Dynamics.CRM.totalrecordcount) が操作しているテーブルの種類の最大ページ サイズと等しい場合に、すべての結果を取得するために送信する必要があるページング済み要求の数を計算する際に便利です。
ページ サイズが最大サイズより小さく、(TotalRecordCount または @Microsoft.Dynamics.CRM.totalrecordcount) が最大サイズ以下の場合は、すべてのレコードを取得するために送信する必要があるページング済み要求の数を計算できます。
(TotalRecordCountLimitExceeded または @Microsoft.Dynamics.CRM.totalrecordcountlimitexceeded) が true であり、(TotalRecordCount または @Microsoft.Dynamics.CRM.totalrecordcount) が最大値に等しい場合、この計算は実行できません。
チップ
フィルターを使わずにレコードの総数を取得するには、Web API RetrieveTotalRecordCount function または SDK for .NET RetrieveTotalRecordCountRequest class を用いて RetrieveTotalRecordCount メッセージを使用します。 取得されるデータは、過去 24 時間以内のスナップ ショットからのものになります。
次の手順
フォームのパフォーマンスを最適化する方法について解説します。