For Each

This workflow action is used to loop through each value in a collection variable.

Other actions can be dragged on to the designer as child actions of the For each action, and these actions will be executed for each value in the collection. The current value of the collection is accessible to each of the child actions via a workflow variable.

To use the workflow action:

Locate the action in Workflow Actions Toolbox (located on the left hand-side);

Click on the Category listings to reveal the actions; OR
Search for the action using a keyword.

Select the action, drag it onto the design canvas and drop it onto a design pearl.

Alternatively

Left-clicking the pearl, mouse-over Insert Action and then the Categories to reveal the actions, click the required action from the list.

To change the settings used by the action:

On the action’s title click the down arrow to activate a drop-down
Select Configure; OR
Double-click the action's icon.

For more information on the other options in the drop-down, please refer to the Getting started with the Nintex Workflow designer.

Options within the action

Target Collection

The collection variable to loop through.

Store result in

As the action loops through each value in the Target Collection, the value will be assigned to this variable. Actions that are children of the For Each action can use this variable to access the current value of the collection.

Any variable type can be selected, the workflow designer must ensure that it is compatible with the values stored in the collection.

Index

A number variable can be selected to store the position of each item in the collection as it is accessed. The first item will be at position 0.

Stop processing

A Yes/No variable type can be selected to break the loop. When the variable is true the loop will not process any more collection items and the workflow will continue to the next action after the For each loop.