可讓您在特定實體類型的記錄中搜尋。 此 API 會開啟 [整合介面] 實體頁面,其中的搜尋欄位已預先填入作為參數傳遞的搜尋字串。
語法
Microsoft.CIFramework.renderSearchPage(entityLogicalName, searchString, searchType).then(successCallback, errorCallback);
參數
| 名稱 | 類型 | 為必填項目 | Description |
|---|---|---|---|
| 實體邏輯名稱 | 繩子 | Yes | 您要查詢之記錄的實體邏輯名稱,例如 “account”。 |
| 搜尋字串 | 繩子 | Yes | 在實體記錄的屬性中搜尋的字串。 |
| 搜尋類型 | 布林值 | 否 | 要開啟的搜尋頁面類型 — 0 表示相關性搜尋,1 表示分類搜尋。 如果未提供參數,則會依種類搜尋記錄。 如需相關性搜尋的相關資訊,請參閱 設定 Dataverse 搜尋。 |
| successCallback 回調 | 功能 | 否 | 擷取某些記錄時要呼叫的函式。 |
| errorCallback 回調 | 功能 | 否 | 作業失敗時要呼叫的函式。 |
返回值
成功時,傳回一個 promise 物件,其中包含先前在 successCallback 參數描述中指定的屬性。
範例
下列範例示範如何指定相關性搜尋類型,在帳戶實體的記錄中查詢一詞 “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);
}
);