Displays an autocompleting input for the selection of one or more records, filtered by a single record type. Suggestions and picker tokens use the title of the record.
|Label||label||Text||Optional text to display as the field label.|
|Label Position||labelPosition||Text|| Optional text to determine where the label appears. Valid values include
|Instructions||instructions||Text||Optional text displayed below the picker.|
|Help Tooltip||helpTooltip||Text|| Displays a help icon with the specified text as a tooltip. The tooltip displays a maximum of 500 characters. The help icon does not show when the label position is
|Placeholder||placeholder||Text||Optional text to display in the field when it is empty. Does not show if the field is read-only.|
|Max Selections||maxSelections||Integer||Once this number of selections has been reached, further selections are blocked until a selection is removed.|
|Record Type||recordType||Record Type||Only records of this record type appear in the suggestions.|
|Filters||filters||Query Filter Array|| Filters to apply when searching for records, configured using
|Selected Records||value||Text or Integer Array||Array of identifiers of the currently selected records. The record title of each selected record will be displayed in the picker.|
|Save Selection To||saveInto||Save Array|| One or more variables that are updated with the array of selected records when the user selects or removes a record. Use
|Required||required||Boolean|| Determines if a value is required to submit the form. Default is
|Required Message||requiredMessage||Text||Custom message to be displayed when the field's value is required and not provided.|
|Disabled||disabled||Boolean|| Determines if the user is prevented from changing the value. Default is
|Validations||validations||Text Array||Validation errors to be displayed below the field when the value is not null.|
|Validation Group||validationGroup||Text||When present, this field is only validated when a button in the same validation group is clicked.|
|Visibility||showWhen||Boolean||Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true.|
[Not Available]token is displayed for any invalid identifiers in the Selected Records array.
The examples below reference the record created from the Entity-Backed Record Tutorial through a constant that references the employee record type. Copy and paste an example in the expression view of the interface designer.
Select a Record from a Record Type
Displays the following:
Select a Record from a Record Type with a Filter
Displays the following: