lookupObjects

Opens a lookup dialog allowing the user to select one or more items.

Available for

Model-driven apps

Syntax

context.utils.lookupObjects(lookupOptions)

Parameters

Parameter Name Type Required Description
lookupOptions UtilityApi.LookupOptions Yes Defines the options for opening the lookup dialog. See Remarks

Return Value

Type: Promise<LookupValue[]>

Remarks

The lookupOptions available for components is different from those for the Client API Xrm.Utility.lookupObjects lookupOptions properties available for model-driven app client side scripts.

lookupOptions properties

For components, lookupOptions parameter 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.
entityTypes Array Yes The table types to display.
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.

The disableMru and filters properties available for model-driven app client scripts are not available for components.

Utility
Power Apps component framework API reference
Power Apps component framework overview