LookupMetadata type
Important
The finance and operations (Dynamics 365) mobile app and platform are no longer supported. The platform components supporting the mobile app will be removed in a future update. The mobile app has also been removed from app stores. Previously installed instances of the app will continue to work. For more information, see Removed or deprecated platform features.
Lookup metadata type.
Hierarchy
InputControlMetadata
└─ LookupMetadata
Index
Properties
- BoundEntity
- BoundField
- Description
- DisplayField
- DisplayKey
- Editable
- ExtType
- FilterContext
- HelpText
- Hidden
- Id
- Label
- LookupEntity
- LookupPage
- LookupPageId
- Mandatory
- MultiSelect
- Name
- NumSequence
- Order
- ReferenceAppId
- ShowLookupPage
- Type
- ValueField
- ValueKey
Events
Properties
BoundEntity
BoundEntity: string (optional)
The entity to which the control is bound.
Inherited from ControlMetadata.BoundEntity
BoundField
BoundField: string (optional)
Inherited from ControlMetadata.BoundField
Description
Description: string (optional)
Description of the control.
Inherited from ControlMetadata.Description
DisplayField
DisplayField: string (optional)
The name of a control on the page, whose value should be displayed to the user. Usually, this value is user-friendly/user-readable text.
DisplayKey
DisplayKey: string (optional)
Editable
Editable: boolean (optional)
Boolean indicating if the control is editable. False when either the control or its parent is not editable. True when both the control and its parent are editable. True when either the control or its parent is editable and the other is undefined. Undefined if both the control's edit-ability and its parent's edit-ability is undefined.
Inherited from ControlMetadata.Editable
ExtType
ExtType: ControlType (optional)
The extended control type. For example, a control of type Input might have an extended type of Barcode.
Inherited from ControlMetadata.ExtType
FilterContext
FilterContext: DataFilter (optional)
HelpText
HelpText: string (optional)
The keyboard shortcut for a command. For example, "(Shift+F5)"
Inherited from ControlMetadata.HelpText
Hidden
Hidden: boolean (optional)
Boolean indicating if the control is hidden or not.
Inherited from ControlMetadata.Hidden
Id
Id: string (optional)
Identification string for a control.
Inherited from ControlMetadata.Id
Label
Label: string (optional)
Label for a control. For example, a control representing a person's first name might have a label "First Name".
Inherited from ControlMetadata.Label
LookupEntity
LookupEntity: any (optional)
The entity that is being looked up in the lookup.
LookupPage
LookupPage: string (optional)
LookupPageId
LookupPageId: string (optional)
Mandatory
Mandatory: boolean (optional)
If set to true then input for the control is required for the task to be completed. Mandatory controls will have a red outline.
Inherited from InputControlMetadata.Mandatory
MultiSelect
MultiSelect: boolean (optional)
If true, lookup will be configured as a multi-select.
Name
Name: string (optional)
Name of a control.
Inherited from ControlMetadata.Name
NumSequence
NumSequence: NumberSequenceConfig (optional)
Used for auto detecting and changing visibility of the number sequence controls in the task or page, based on AX number sequence configuration, through extended business logic. Example:
// hide number sequence reference page from users
metadataService.hideNavigation('numSeqReferencePage');
// parameters to be passed to 'numSequence' flag in configureControl
var configParam = {
referencePageName: 'numSeqReferencePage',
dataType: 'HcmPersonnelNumberId'
};
// setup 'PersonnelNumber' control as number sequence in the task 'add-worker'
metadataService.configureControl('add-worker', 'PersonnelNumber', { numSequence: configParam });
Inherited from InputControlMetadata.NumSequence
Order
Order: number (optional)
Number indicating the order in which a control will appear on a page.
Inherited from ControlMetadata.Order
ReferenceAppId
ReferenceAppId: string (optional)
ShowLookupPage
ShowLookupPage: boolean (optional)
Type
Type: ControlType (optional)
String indicating the control type.
Inherited from ControlMetadata.Type
ValueField
ValueField: string (optional)
The name of a control on the page, whose value should be used when committing the data. Usually, this value is a unique key.
ValueKey
ValueKey: string (optional)
Events
OnOptionSelected
OnOptionSelected: function(lookup: any, lookupEntityData: any): void (optional)
An event that is triggered by an option being selected.
OnValueChanged
OnValueChanged: function(value: any): void (optional)
An event that is triggered by a value being changed.