Loop Items

For each item in a string of items stored in a variable (an "array"):

  • Place the individual item into a new or existing variable; and

  • Perform a specified action or series of actions

After completing the action(s) for the last item in the array, the wizard exits the loop and moves on.

In order for this command to work properly, all the items in the variable must be delimited (i.e., separated) in a consistent way.

Step 1 - Identify the array

The first step in using the loop items command is to identify the array and define a few settings.

  1. Enter the name of the variable in which the array is stored.

  2. Enter the delimiter that separates each item in the array.

  3. Enter the name of the variable into which you'd like to place each individual item.

    Why? Since the action(s) in the loop will be performed on each item in the array (one at a time), it makes sense to first place the item into a variable, then perform the defined actions on the value of that variable.

Step 2 - Define the actions

Upon adding the loop items command to your wizard, you will notice that it becomes an empty "container" within the Editor Pane, waiting for you to fill it with instructions:

  1. Enter the action(s) the wizard should take for each item in the array

    • You can do this by dragging the required Advanced Command(s) directly into the container

Break that loop!

Under certain conditions, you may want to break and/or restart the loop created by the loop items container. Make this happen by using the Loop: Break and/or the Loop: Restart command (usually within an If Else command).