다음을 통해 공유

retrieveMultipleRecords

테이블 레코드의 컬렉션을 검색합니다.

사용할 수 있는 대상

모델 기반 앱 및 포털.

Syntax

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

매개 변수

이름 유형 필수 Description
엔티티논리 이름 String Yes 검색할 레코드의 테이블 논리적 이름입니다. 예: "계정".
options String 아니오

데이터를 검색하는 OData 시스템 쿼리 옵션 또는 FetchXML 쿼리입니다.

  • 지원되는 시스템 쿼리 옵션은 $select, $top, $filter, $expand 및 $orderby.
  • FetchXML 쿼리를 지정하려면 열을 사용하여 fetchXml 쿼리를 지정합니다.

참고: 항상 $select 시스템 쿼리 옵션을 사용하여 쉼표로 구분된 속성 이름 목록을 포함하여 테이블 레코드에 대해 반환되는 속성을 제한해야 합니다. 검색하는 열을 제한하는 것이 중요한 성능 모범 사례입니다. $select 사용하여 속성을 지정하지 않으면 모든 속성이 반환됩니다.

로 ?시작하는 쿼리 옵션을 지정합니다. 쿼리 옵션을 구분하는 데 사용하여 & 여러 시스템 쿼리 옵션을 지정할 수도 있습니다.

maxPageSize Number 아니오

페이지당 반환할 테이블 레코드 수를 나타내는 양수를 지정합니다. 이 매개 변수를 지정하지 않으면 기본값이 5,000으로 전달됩니다.

검색되는 레코드 수가 지정된 값 nextLink 보다 많은 경우 반환된 maxPageSize promise 개체의 열에는 다음 테이블 집합을 검색하는 링크가 포함됩니다.

success콜백 기능 아니오

테이블 레코드를 검색할 때 호출할 함수입니다. 다음 열이 있는 개체가 함수에 전달됩니다.

  • 엔터티: 각 개체가 열과 해당 값을 쌍으로 key: value 포함하는 검색된 테이블 레코드를 나타내는 JSON 개체의 배열입니다. 테이블 레코드의 ID는 기본적으로 검색됩니다.
  • nextLink: String. 검색되는 레코드 수가 요청의 매개 변수에 maxPageSize 지정된 값보다 많은 경우 이 열은 다음 레코드 집합을 반환하는 URL을 반환합니다.
error콜백 기능 아니오 작업이 실패할 때 호출하는 함수입니다.

반환 값

형식: Promise<RetrieveMultipleResponse>

설명: RetrieveMultipleResponse 요청에서 페이징(maxPageSize)이 지정되고 반환된 레코드 수가 페이징 값을 초과하는 경우 검색된 테이블 레코드와 다음 레코드 집합을 가리키는 URL이 있는 nextLink 매개 변수가 포함된 JSON 개체 배열이 포함된 프라미스를 반환합니다. 다음과 같은 매개 변수가 있습니다.

매개변수 반환 값 Description
entities Entity[] 각 개체가 열과 해당 값을 포함하는 검색된 테이블 레코드를 나타내는 JSON 개체의 배열입니다.
넥스트링크 string 검색되는 레코드 수가 요청의 'maxPageSize' 매개 변수에 지정된 값보다 많은 경우 이 매개 변수는 다음 레코드 집합을 반환하기 위해 URL을 반환합니다.

Web API
Power Apps 구성 요소 프레임워크 API 참조
Power Apps 구성 요소 프레임워크 개요

  • Last updated on