This activity can be used in both Microflows and Nanoflows.
Note that there are minor differences between the way this function works in microflows, and the way it works in nanoflows.
With this activity you can change a list.
See Common Properties for properties that all microflow activities share (for example, caption). This page only describes the properties specific to the action.
2 Input Properties
Specifies the list that is changed.
3 Action Properties
Defines the type of change that is applied to the list.
|Add (default)||The object(s) referred to by value are added to the list. The same object can be added multiple times.|
|Remove||The object(s) referred to by value are removed from the list. If there are duplicate objects in the list, then only one will be removed. If you ask to remove an object which isn’t in the list, there is no error|
|Clear||The list is emptied.|
|Replace||The list is emptied and the object(s) referred to by value are added to the list.|
If you do not want duplicates in your (microflow) list, you can either remove the object(s) first, or use the Contains list operation to examine the list before adding the object(s).
Currently, this works differently in nanoflows. In a nanoflow objects will not be added if they are already in the list whereas, in a microflow, the same object can be added multiple times.
Value defines the objects that are used to change the list. The value is entered using an expression. The expression should result in an object or list of objects of the same type of entity as the input list.