Modify list
See also: List item
Event action – Abstract
Purpose: Modifies an existing list by adding or removing an entry or clearing the list.
The Modify list event action optionally carries out one of the supported modifications (‘Add’, ‘Remove’, ‘Empty’) to an existing list:
|
Operation |
Effect |
|
►NOTE◄ In many applications, adding entries to a list can be implemented more efficiently by assigning a value (e.g. via Set value) to a suitably parameterised List item resolver. |
An entry (value configuration on the right) is added to the list (value configuration on the left).
|
|
An existing entry (value configuration on the right) is removed from the list (value configuration on the left).
|
|
|
All entries are removed from the list (only value configurations).
|
Configuration
|
After adding a new instance of the Modify list event action to a workflow, the Add operation is selected by default. Clicking on the symbol (here: [+]) opens a context menu offering all operations for selection. Depending on the operation selected, either only one value configuration appears for the definition of the list to be modified or a second value configuration (on the right) for the definition of the entry to be added or deleted. |
|
►NOTE◄ A reference object present in the context of the event action can be used in all contained value configurations (for the list or, if applicable, the entry) as an input value for suitable value resolvers.
►IMPORTANT◄ Modifications to a list only take effect if the value configuration for the list can be 'updated'. Otherwise, the modifications will run through without an error message, but will only affect the data status provided as a “snapshot” by the value resolver and not the object to which it goes back.
Specific configuration options for each operation are demonstrated on the following pages: