lookupObjects (客户端 API 参考)

打开查找控件以选择一个或多个项。

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);});

Xrm.Utility