For Each

For Each Overview


The For Each control block is basically a loop – a structure that is executed repeatedly. In the For Each block, each occurrence of a series of actions is called an iteration.

The For Each block does not do any specific actions by itself. You should put other action/control blocks inside of it in order to create a certain pattern. The For Each loop makes it easier to perform the same action for each element of a list. You could set conditions and perform different actions based on your preference.
The For Each block has a field that must contain an array. Arrays are initialized with "[{}*{}]" where ***** is the content that you want to list. The elements that you want to list in the array are separated with a comma. Blocks that you use to build your For Each's structure and actions are placed above the "End For" line, which is the ending line of the For Each block.
The iterations of a For Each block start with the first element from the list, with an index 0, and continues until the last element of the list, with an index (n-1) where n is the actual number of elements in the list.

You can drag a For Each control block and drop it inside a workflow working area when a green field appears. Doing so makes it a part of that workflow.

Procedure:

  1. Enter information in the list field. Click on thebutton to access a menu where you can build your array more easily. Choose the type of the items that your array will contain. Click on the Save button and you will have your array filled in the provided field.

    2. Design your loop according to your preferences and the actions that you want to be executed. To do so, choose from the wide variety of blocks in the menu and drag them between the For Each and End For lines when a green field appears.

    3. This structure will execute sequential iterations for each item that you have listed in the array. The number of iterations will be the number of items that you have provided.

    4. To refer to the current element of the iteration, type "$A2.item" where A2 is the name of the For Each block.

To disable the For Each Block without deleting it, click on the Disable checkbox.