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
const 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(
  (success) => console.log(success),
  (error) => console.log(error)
);

Xrm.Utility