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.
Related articles
Utility
Power Apps component framework API reference
Power Apps component framework overview