Function: a!pickerFieldRecords()
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.
Name | Keyword | Types | Description |
---|---|---|---|
Label |
|
Text |
Text to display as the field label. |
Label Position |
|
Text |
Determines where the label appears. Valid values:
|
Instructions |
|
Text |
Supplemental text about this field. |
Help Tooltip |
|
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 |
|
Text |
Text to display in the field when it is empty. Does not show if the field is read only. |
Max Selections |
|
Number (Integer) |
Maximum number of allowed selections. Once this number is reached, further selections are blocked until a selection is removed. |
Record Type |
|
RecordType |
Required, singular. Filters picker to select records of this type. |
Filters |
|
List of QueryFilter |
List of filters to apply when searching for records. |
Display Value |
|
Any Type |
Array of currently selected records. This will be either a List of Text or a List of Number (Integer), depending on the recordType selected. |
Save Input To |
|
List of Save |
One or more variables that are updated with the array of selected records when the user selects or removes a record. Use a!save() to save a modified or alternative value to a variable. |
Required |
|
Boolean |
Determines if a value is required to submit the form. Default: false. |
Required Message |
|
Text |
Custom message to display when the field's value is required and not provided. |
Read-only |
|
Boolean |
Determines if the field should display as not editable. Default: false. |
Disabled |
|
Boolean |
Determines if the field should display as potentially editable but grayed out. Default: false. |
Validations |
|
List of Text String |
Validation errors to display below the field when the value is not null. |
Validation Group |
|
Text |
When present, this field is only validated when a button in the same validation group is pressed. See the documentation for more information about how to use validation groups. |
Accessibility Text |
|
Text |
Additional text to be announced by screen readers. Used only for accessibility; produces no visible change. |
Visibility |
|
Boolean |
Determines whether the component is displayed on the interface. When set to false, the component is hidden and is not evaluated. Default: true. |
Notes
[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 into the INTERFACE DEFINITION in EXPRESSION MODE.
Select a Record from a Record Type
1
2
3
4
5
6
7
8
9
=a!localVariables(
local!storedRecord,
a!pickerFieldRecords(
label: "Choose an Employee Record",
recordType: cons!EMPLOYEE_RECORD,
value: local!storedRecord,
saveInto: local!storedRecord
)
)
Displays the following:
Select a Record from a Record Type with a Filter
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
=a!localVariables(
local!storedRecord,
a!pickerFieldRecords(
label: "Choose an Employee Record",
recordType: cons!EMPLOYEE_RECORD,
filters:{
a!queryFilter(
field: "department",
operator: "=",
value: "Engineering"
)
},
value: local!storedRecord,
saveInto: local!storedRecord
)
)
Displays the following:
On This Page