Skip to main content

List

Shows a list of items retrieved from a Data Source. Use it when you want to show information in a list style.

Example

Loading...

Properties

General

AttributeTypeDescriptionCategory
Model Id RequiredString

This is a unique id for the component.

Every field on a form model needs a unique ID, which is automatically generated but can be changed if needed (e.g. to reference in expressions or for debugging purposes).

If the field type supports rendering a label, and most types do, it can be configured here. This label is a displayed on the form to the end user and typically indicates what value is expected in the field.

The documentation property holds free-form text that can be used to give more details about this , like its purpose, usage in other models, etc.

Label Expression usage possibleTranslatable to different languagesText

The label attribute adds a label to the component.

Label position Selection:
  • Left
  • Top

The position of the label, you can choose between left or top.

Label tooltip Expression usage possibleTranslatable to different languagesText

When it is defined, a question mark icon will appear in the component label. When the user hovers over it it will show this text in a tooltip.

Documentation Multiline Text

A free-form text to explain the use cases for this form field.

Height String

The height of the iFrame in pixels; can be an expression.

These properties define how the list will be displayed to the user and behave in the form.

Title Expression usage possibleTranslatable to different languagesText

A human-readable title.

Title navigation URL Expression usage possibleText

Specifies a global navigation URL being rendered within the title of the list. Use this attribute for instance if you want to navigate to an extended list or the like. Of course you can use expressions to build the URL as well, but only global ones, the 'item' is not available here.

Collapsible Boolean

If true, the subform can be collapsed/expanded by clicking on an arrow ▲/▼.

Datasource

AttributeTypeDescriptionCategory
Data source Selection:
  • Static
  • REST
  • Master
  • Data Object

Options to select different types of Data source.

The datasource of the configures where the data options available to the user originate from. The source can be statically defined or dynamically populated from a third party service.

Items Expression usage possibleList

When using a 'static' datasource, the items need to be defined. If no values are shown, make sure you have configured the 'columns' property, as the items are defined by giving values for the different columns.

Master Data Key RequiredExpression usage possibleText

Key representing the Master Data Type. e.g., 'md-country'.

Include Translations Boolean

Flag indicating whether master data instance translations should be included in the fetched data.

Query URL RequiredExpression usage possibleText

URL to request the items with optional variables.

$searchText: Text the user typed if the component allows search.

$start: First item index (for pagination).

$pageSize: Number of items per page.

eg. /rest/users?start={{$start}}&size={{$pageSize}}

Lookup URL RequiredExpression usage possibleText

The REST endpoint URL used to retrieve the full item by ID. For example, rest/get?id={{$id}}&type={{someValue}} The URL can contain expressions evaluated against the current work object. The selected item ID is available as $id If the lookupURL does not contain {{$id}}, this will be automatically added at the end. The URL should not be encoded as it will be encoded automatically.

Path Text

When using a REST data source, this is the location in the response data to get the row collection.

Data object model Requireddataobjectselectsearch

Defines which type of data object data is returned when using the select and which operation is used.

Query Parameters List

The query parameters that should be added to the Query URL.

$searchText: Text the user typed if the component allows search.

$start: First item index (for pagination).

$pageSize: Number of items per page.

eg. /rest/users?start={{$start}}&size={{$pageSize}}

Query parameters will be added to the REST requests that are executed when data is fetched to display in the .

Format Expression usage possibleText

An expression used to generate the label for each item. For example, Mr. {{$item.name}} {{$item.surname}} The expression is evaluated against the current work object. The selected item is available as $item.

Advanced configuration options of the datasource. Please check the tooltips on each property for more information.

Storage RequiredSelection:
  • ID
  • Full value

Specifies how the data retrieved by the REST endpoint should be stored in the variable. Choose 'ID' if only the ID of the selected entry should be saved in the variable, choose 'Full value' if the whole object should be saved and thus making it possible to display other values of the selected element within the form as well. Pay attention as storing the full value could lead int bloating the variables with unnecessary information depending on the amount of data retrieved by the REST endpoint.

Map to RequiredText

The attribute of an item to map to. For a Static data source 'value' is commonly used as the map to attribute and for a REST data source 'id' is commonly used as the map to attribute.

Map to RequiredSelection:
  • id
  • key

The attribute of an item to map to. For a Static data source 'value' is commonly used as the map to attribute and for a REST data source 'id' is commonly used as the map to attribute.

Track by Text

The attribute to uniquely reference an item for tracking may improve form frontend performance. For 'REST' datasource is usually 'id', for Static data is usually 'value'.

Navigation URL Expression usage possibleText

The URL to navigate to for the selected item. The URL might contain expressions, most likely at least '{{$item.id}}' in order to include the ID of the selected element in the navigation URL.

Target Expression usage possibleText

Specifies the target for the navigation URL, use '_blank' to open the selected item in a new window or '_self' to use the same window for navigation.

Validation

AttributeTypeDescriptionCategory
Validation Panel Display Selection:
  • Show
  • Only message
  • Hide

Display at validation panel and validation tooltip.

Providing proper data in form fields is important, especially when in process, case, decision or any other models the values provided in the form fields are used in subsequent steps.

To make sure that the data is correct, validation is crucial. For this reason, a form can only be submitted when all fields are valid and thus all validation properties configured on the left apply.

Check the tooltips on the properties for more information.

Custom validations List

List of additional validations to apply.

The can have custom validation rules beyond the standard set of validations. Such a rule is written as a frontend expression in the form of {{myExpression}}. If this expression evaluates to false, the submission of the form won't be possible.

Rendering

AttributeTypeDescriptionCategory
Description Expression usage possibleTranslatable to different languagesText

The description attribute adds a description to the component.

Some field types have an extra line of text displayed to give the user more details about the field.

Ignored Expression usage possibleBoolean

If true the component will be hidden and the value will not be part of any payload.

Fields can also be shown or hidden based on the visible condition. This can be a frontend expression in the form of {{myExpression}} which can reference other form field values by their IDs.

Fields can also be enabled or disabled, and similarly this can be made dynamic based on a frontend expression.

Some field types can be ignored (the property is shown here if that's the case), which means that its value won't be taken into account.

Visible Expression usage possibleBoolean

Boolean value or expression specifies whether the component is visible or hidden. This expression might include another value in the same form, for instance use a checkbox bound to {{showAdditionalFields}} and use the very same expression as the visible attribute to show or hide the component according the checked state of the checkbox. If you want to only show the component, if the form is not used as the init-form, you can use the expression '{{root.id}}' which evaluates to true only, if there is a current case id which is not the case in an initialization form.

Enabled Expression usage possibleBoolean

Boolean value or expression specifies whether component is enabled or disabled.

Style class Text

Stylesheet class name. Add any style classes to be applied to the component for the desired styling and rendering.

The can get customized CSS classes to customize the default styling. Note that the CSS files needed for the customizations must be available on the runtime system.

Advanced

AttributeTypeDescriptionCategory
Events List

The emits low-level events on which can be reacted with a frontend expression to implement various use cases that are not possible with regular modeling.

If the expression produces a value, it can be stored in a new variable using the Result variable property.

List Attribute Details

Items

AttributeTypeDescription
Text Translatable to different languagesText

Label for the item

Value Expression usage possibleText

Value for the item

Query Parameters

AttributeTypeDescription
Name RequiredExpression usage possibleText

The name of the query parameter

Value RequiredExpression usage possibleText

The value of the query parameter. The value will be automatically URL-encoded.

Default Value Expression usage possibleText

The default value for the query parameter (in case the value didn't return anything). The value will be automatically URL-encoded.

Custom validations

AttributeTypeDescription
Expression RequiredExpression usage possibleText

Validation passes when this expression is true.

Error message RequiredTranslatable to different languagesText

Message to display when the validation fails.

Events

AttributeTypeDescription
Event label RequiredText

This is a unique id for the component.

Event type Selection:
  • On value change

The type of event emitted by the form field.

Expression Expression usage possibleText

Validation passes when this expression is true.

Result variable Text

Capture the result of the expression in a result variable.

Events

EventWhenAdditionalCancellable
List.dataLoadedList content is loadedDefinition + StateNo

See section Events for more information.