Edit

lookupObjects (Client API reference)

  • Article

Opens a lookup control to select one or more items.

Syntax

Xrm.Utility.lookupObjects(lookupOptions).then(successCallback, errorCallback)

Parameters

Name Type Required Description
lookupOptions Object Yes Defines the options for opening the lookup dialog. See lookupOptions properties
successCallback Function No A function to call when the lookup control is invoked. An array of objects with the following properties is passed:
- entityType: String. table type of the record selected in the lookup control.
- id: String. ID of the record selected in the lookup control.
- name: String. Name of the record selected in the lookup control.
errorCallback Function No A function to call when the operation fails. It is not considered a failure if the user cancels the operation.

lookupOptions properties

lookupOptions has the following properties:

Property Name Type Required Description
allowMultiSelect Boolean No Indicates whether the lookup allows more than one item to be selected.
defaultEntityType String No The default table type to use.
defaultViewId String No The default view to use.
disableMru Boolean No Decides whether to display the most recently used(MRU) item.
Available only for Unified Interface.
entityTypes Array Yes The table types to display.
filters Array of objects No Used to filter the results. Each object in the array contains the following values:
-filterXml: String. The FetchXML filter element to apply.
- entityLogicalName: String. The table type to which to apply this filter.
searchText String No Indicates the default search term for the lookup control. This is supported only on Unified Interface.
viewIds Array No The views to be available in the view picker. Only system views are supported.

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