Select item (repeatable element/grid)
Actions – Abstract
Selects a desired item in a Data grid or in the grid view of the Repeatable element containers.
A data grid, a 'Repeatable element' container or the repeating row element itself can be used as a linked element.
To select the desired item an index (0 <= index < number of lines), line data or an applicable field value can be specified (see below).
Selects a desired item in a Data grid or in the grid view of the Repeatable element containers. A data grid, a 'Repeatable element' container or the repeating row element itself can be used as a linked element.
To select the desired item an index (0 <= index < number of lines), line data or an applicable field value can be specified (see below).
(1) An optional data field that can be specified to identify an item (e.g. 'id'). This field is ignored and disabled if the linked element is the repeatable row element itself. The data field can be specified as any path, relative to the row data structure (e.g. 'Path.to.data.field').
►IMPORTANT◄ The value behind the data field must be able to uniquely identify the line entry (e.g. 'id' for business objects), because: If the compare property field is specified, the system searches for the item that corresponds to the value passed to the actions in the specified data field.
If no Compare property (1) is defined, three further selections are possible:
Selection of a row at a specific position
If the behaviour transfers a number to the action, it is interpreted as a position index (0 <= index < number of lines) of the entry to be selected.
Selection by line content
The data transferred to the action (if no index) is searched directly in the list and selected if it matches.
►CAUTION◄ Often data is copied into other containers for visualization and further processing (e.g. Populate element data as copy, Selected item of grid....). Such copies cannot be selected in this way because they are clones and no longer exactly the same objects. In such cases, the information in Compare property (1) should be used.
Direct selection of a row element (only 'Repeatable element' container)
The repeating line element has been linked to the action and is thus directly selected. However, this can only happen if the action within the line element was triggered (e.g. by a delayed behaviour).