打开查找控件以选择一个或多个项。
Syntax
Xrm.Utility.lookupObjects(lookupOptions).then(successCallback, errorCallback)
参数
| Name | 类型 | 必选 | Description |
|---|---|---|---|
lookupOptions |
物体 | 是的 | 定义用于打开查找对话框的选项。 请参阅 lookupOptions 属性 |
successCallback |
功能 | 否 | 调用查找控件时要调用的函数。 传递具有以下属性的对象数组: - entityType:字符串。 查找控件中选择的记录的表类型。- id:字符串。 查找控件中选择的记录的 ID。- name:字符串。 查找控件中选择的记录的名称。 |
errorCallback |
功能 | 否 | 作失败时要调用的函数。 如果用户取消作,则不会被视为失败。 |
lookupOptions 属性
lookupOptions 具有以下属性:
| 属性名称 | 类型 | 必选 | Description |
|---|---|---|---|
allowMultiSelect |
布尔 | 否 | 指示查找是否允许选择多个项。 |
defaultEntityType |
String | 否 | 要使用的默认表类型。 |
defaultViewId |
String | 否 | 要使用的默认视图。 |
disableMru |
布尔 | 否 | 确定是否显示最近使用的(MRU)项。 仅适用于统一接口。 |
entityTypes |
Array | 是的 | 要显示的表类型。 |
filters |
对象数组 | 否 | 用于筛选结果。 数组中的每个对象包含以下值: - filterXml:字符串。 要应用的 FetchXML 筛选器元素。- entityLogicalName:字符串。 要向其应用此筛选器的表类型。 |
searchText |
String | 否 | 指示查找控件的默认搜索词。 这仅在 统一接口上受支持。 |
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);});