retrieveMultipleRecords

  • [アーティクル]

テーブル レコードのコレクションを取得します。

以下に使用できます

モデル駆動型アプリ & ポータル

構文

context.webAPI.retrieveMultipleRecords(entityLogicalName, options, maxPageSize).then(successCallback, errorCallback);

パラメーター

名前 タイプ 必須 説明
entityLogicalName String はい 取得するレコードのテーブルの論理名。 たとえば、"account"。
options String いいえ

ODataシステム クエリ オプションまたは FetchXML クエリを使用してデータを取得します。

  • システム クエリ オプション $select、$top、$filter、$expand、および $orderby はサポートされます。
  • FetchXML クエリを指定するには、 fetchXml 列を使用してクエリを指定します。

メモ: $select システム クエリ オプションを使用し、プロパティ名のコンマ区切りリストを含めて、テーブル レコードに対して返されるプロパティを制限する必要があります。 取得する列を制限することは、パフォーマンスに関する重要なベスト プラクティスです。 プロパティが $select を使用して指定されていない場合は、すべてのプロパティが返されます。

? で始まるクエリ オプションを指定します。 クエリ オプションを & で区切って、複数のシステム クエリ オプションを指定することもできます。

maxPageSize 数 いいえ

ページごとに返されるテーブル レコードの数を表す正の数を指定します。 このパラメーターを指定しない場合、既定の 5000 が渡されます。

取得されるレコード数が、指定された maxPageSize 値より多い場合は、返された Promise オブジェクト内の nextLink 属性に、テーブルの次のセットを取得するためのリンクが含まれます。

successCallback Function いいえ

テーブル レコードを取得した場合に呼び出す関数。 次の列のオブジェクトは関数に渡されます。

  • entities: JSON オブジェクトの配列。各オブジェクトは、列と値のペア key: value を含む、取得したテーブル レコードを表します。 既定では、テーブル レコードの ID が取得されます。
  • nextLink: 文字列。 取得されるレコードの件数が、要求内の maxPageSize パラメーターで指定された値より多い場合、この列はレコードの次のセットを返す URL を返します。
errorCallback 関数 いいえ 処理が失敗したときに呼び出す関数。

戻り値

種類: Promise<RetrieveMultipleResponse>

説明: RetrieveMultipleResponse は、要求内でページング (maxPageSize) が指定され、返されるレコード数がページング値を超える場合にレコードの次のセットを指す URL とともに、取得したテーブル レコードおよび nextLink パラメーターを含む JSON オブジェクトの配列を含む promise を返します。 これには次のパラメータが使用されています :

パラメーター 戻り値 内容
entities Entity[] 各オブジェクトが列とその値を含む取得されたテーブル レコードを表す、JSON オブジェクトの配列。
nextLink string 取得されるレコードの件数が、要求内の 'maxPageSize' パラメーターで指定された値より多い場合、このパラメーターはレコードの次のセットを返す URL を返します。

Web API
Power Apps Component Framework API 参照
Power Apps Component Framework の概要

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。