Element

Icon

Description

The developer determines the contents of a Select Field. The user can later choose one of the options in the list.

TypeString
Prepopulation
Editing

Configuration Options

Use the Attributes panel to edit the form element.

AttributeDescriptionAllowed Values
Name
DescriptionAny string.
LabelAny string.
Mandatorytrue
false
Read-onlytrue
false
Options

Click to open the Field Configuration editor where you can define the contents of the select field.

Any string.
Vertical Alignment
Top
Center
Bottom
CSS Class

Custom Attributes
Symbol Type

_

Field Configuration Editor

Setting the Default Value of a Select Field

Sometimes you might want to set the default value of a select field, so that the field is not empty when displayed on the form.

There are two options to set the default value of a select field:

If you set both values in the mapping diagram, defaultKey takes priority over the field value. In that case, the value of defaultKey is displayed as the default value for the select field in the executed form.

Via the Property defaultKey

The defaultKey defines the number of the select field entry that should be displayed as the default value in the executed form. You can use this option for fixed and dynamic lists if you always want the value of a specific position in the list to be displayed as the default value. With dynamic lists, however, it usually only makes sense to always select the first position of the list as the default value. 

Assign a list position number to the property defaultKey, for example via a literal as in the example on the left. The value of this list position is then displayed as the default value in the select field of the executed form.

The select field entry list always starts with the number 0.

Via the Field Value

The field value defines the value of the select field entry that should be displayed as the default value in the executed form. Select this option for a dynamic list if the content of a specific element of the list should always be displayed as the default value.

In the example on the left, the default value to be displayed in the executed form is assigned via the field value Customer ID:

Field Value (Customer ID)Label (displayed default value)
0001Rose Bloom
0002Adam Sun
0003Liv Falls
0004John Snow