開啟查閱控制項以選取一或多個項目。
語法
Xrm.Utility.lookupObjects(lookupOptions).then(successCallback, errorCallback)
參數
| 名稱 | 類型 | 為必填項目 | Description |
|---|---|---|---|
lookupOptions |
物體 | Yes | 定義開啟查閱對話方塊的選項。 請參閱 lookupOptions 屬性 |
successCallback |
功能 | 否 | 叫用查閱控制項時要呼叫的函式。 會傳遞具有下列屬性的物件陣列： - entityType：繩子。 在查閱控制項中選取的記錄的表格類型。- id：繩子。 在查閱控制項中選取的記錄識別碼。- name：繩子。 在查閱控制項中選取的記錄名稱。 |
errorCallback |
功能 | 否 | 作業失敗時要呼叫的函式。 如果使用者取消作業，則不會被視為失敗。 |
lookupOptions 屬性
lookupOptions 具有下列屬性：
| 屬性名稱 | 類型 | 為必填項目 | Description |
|---|---|---|---|
allowMultiSelect |
布林值 | 否 | 指出查閱是否允許選取多個項目。 |
defaultEntityType |
繩子 | 否 | 要使用的預設表格類型。 |
defaultViewId |
繩子 | 否 | 要使用的預設檢視。 |
disableMru |
布林值 | 否 | 決定是否顯示最近使用的 （MRU） 項目。 僅適用於統一介面。 |
entityTypes |
Array | Yes | 要顯示的表格類型。 |
filters |
物件陣列 | 否 | 用於篩選結果。 陣列中的每個物件都包含下列值： - filterXml：繩子。 要套用的 FetchXML 篩選元素。- entityLogicalName：繩子。 要套用此篩選器的資料表類型。 |
searchText |
繩子 | 否 | 指出查閱控制項的預設搜尋字詞。 這僅在 統一介面上受支援。 |
viewIds |
Array | 否 | 視圖選擇器中可用的視圖。 僅支援系統檢視。 |
Example
//define data for lookupOptions
var lookupOptions =
{
defaultEntityType: "account",
entityTypes: ["account"],
allowMultiSelect: false,
defaultViewId:"0D5D377B-5E7C-47B5-BAB1-A5CB8B4AC10",
viewIds:["0D5D377B-5E7C-47B5-BAB1-A5CB8B4AC10","00000000-0000-0000-00AA-000010001003"],
searchText:"Allison",
filters: [{filterXml: "<filter type='or'><condition attribute='name' operator='like' value='A%' /></filter>",entityLogicalName: "account"}]
};
// Get account records based on the lookup Options
Xrm.Utility.lookupObjects(lookupOptions).then(
function(success){
console.log(success);},
function(error){console.log(error);});