List Field

Collects

Users select from a predefined list of values.

Typical use

The List step allows the user to select a pre-defined value from a list. This could be anything from selecting which shipping agent to use during a picking routine to specifying a reason for moving or discarding an item.

Parameters 

DefaultValue

The initial value.

DefaultTo

When 'defaultValue' is not used in a list configuration, this configuration value determines whether to pre-select the first value in the list or start 'blank' instead. Defaults to 'FirstValue'

ClearOnClear

If true, the field will be cleared when the clear/reset button on the header is tapped

Label

The text shown above the field

ListValues

The list data, semicolon separated 

This cannot be combined with the use of 'dataTable'

ListSeparator

Only set if ListValues is not semicolon separated

DataTable

Used when the list data is generated as part of Reference Data

• Alternative to "ListValues"
• Make sure to also configure 'dataKeyColumn' and 'dataDisplayColumn'

DataDisplayColumn

Reference to the column which holds the displayable values (Usually "Name")

DataKeyColumn

Reference to a column in the data table holding the values (Usually "Code")

LinkedElement

References another element which should be notified on changes to this element. Also used when list filtering is enabled

FilterColumn

Used to specify the column in the data table which should be used for filtering the contents of the list. E.g. A reference in the slave tabel to the master key

Locked

Prevents the user from editing the value if set to true

Optional

Is the field mandatory

EanAi

If specified, the field accepts GS1 barcodes with the specified application identifiers

A comma-separated list of GS1 Application Identifiers (e.g. "30,37") that the field will accept