다음을 통해 공유


retrieveRecord

테이블 레코드를 검색합니다.

사용할 수 있는 대상

모델 기반 앱 및 포털.

Syntax

context.webAPI.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

매개 변수

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

OData 시스템 쿼리 옵션( $select$expand)을 사용하여 데이터를 검색합니다.

  • $select 시스템 쿼리 옵션을 사용하면 쉼표로 구분된 속성 이름 목록을 포함하여 반환되는 속성을 제한할 수 있습니다. 검색하는 열을 제한하는 것이 중요한 성능 모범 사례입니다. $select 사용하여 속성을 지정하지 않으면 모든 속성이 반환됩니다.
  • $expand 시스템 쿼리 옵션을 사용하여 반환되는 관련 테이블의 데이터를 제어합니다. 탐색 속성의 이름만 포함하는 경우 관련 레코드에 대한 모든 속성을 받게 됩니다. 탐색 속성 이름 뒤의 괄호 안에 있는 $select system query 옵션을 사용하여 관련 레코드에 대해 반환되는 속성을 제한할 수 있습니다. 단일 값 탐색 속성과 컬렉션 값 탐색 속성 모두에 이 옵션을 사용합니다.

?시작하는 쿼리 옵션을 지정합니다. 를 & 사용하여 쿼리 옵션을 구분하여 여러 쿼리 옵션을 지정할 수도 있습니다. 다음은 그 예입니다.

?$select=name&$expand=primarycontactid($select=contactid,fullname)
success콜백 기능 아니오

레코드를 검색할 때 호출하는 함수입니다. 검색된 속성과 값이 있는 JSON 개체가 함수에 전달됩니다.

error콜백 기능 아니오 작업이 실패할 때 호출하는 함수입니다.

반환 값

형식: Promise<엔터티>

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