특정 엔터티 유형의 레코드 중에서 검색할 수 있습니다. 이 API는 매개 변수로 전달되는 검색 문자열로 미리 채워진 검색 필드가 있는 통합 인터페이스 엔터티 페이지를 엽니다.
Syntax
Microsoft.CIFramework.renderSearchPage(entityLogicalName, searchString, searchType).then(successCallback, errorCallback);
매개 변수
| 이름 | 유형 | 필수 | Description |
|---|---|---|---|
| 엔티티논리 이름 | String | Yes | 쿼리하려는 레코드의 엔터티 논리 이름(예: "account")입니다. |
| 검색문자열 | String | Yes | 엔터티 레코드의 속성 중에서 검색할 문자열입니다. |
| 검색유형 | 불리언 (Boolean) | 아니오 | 열 검색 페이지 유형(관련성 검색의 경우 0, 분류된 검색의 경우 1). 매개변수가 제공되지 않으면 레코드가 카테고리별로 검색됩니다. 관련성 검색에 대한 자세한 내용은 Dataverse 검색 구성을 참조하세요. |
| success콜백 | 기능 | 아니오 | 일부 레코드가 검색될 때 호출하는 함수입니다. |
| error콜백 | 기능 | 아니오 | 작업이 실패할 때 호출하는 함수입니다. |
반환 값
성공하면 successCallback 매개 변수의 설명에서 이전에 지정한 속성을 포함하는 promise 개체를 반환합니다.
예시
다음 예제에서는 관련성 검색 유형을 지정하여 거래처 엔터티의 레코드 중에서 "Contoso"라는 용어를 쿼리하는 방법을 보여 줍니다.
var entityname = "account"
var searchterm = "Contoso"
var searchtype = 0 // relevance search
Microsoft.CIFramework.renderSearchPage(entityname, searchterm, searchtype).then(
function (success) {
console.log(success);
},
function (error) {
console.log(error);
}
);
다음 예제에서는 검색 유형을 지정하지 않고 계정 엔터티의 레코드 중에서 "Contoso"라는 용어를 쿼리하는 방법을 보여 줍니다.
var entityname = "account"
var searchterm = "Contoso"
Microsoft.CIFramework.renderSearchPage(entityname, searchterm).then( // if search type is not passed, it defaults to categorized search
function (success) {
console.log(success);
},
function (error) {
console.log(error);
}
);