Loop List Action—Setting Properties

The Loop List action loops through a text list and populates a variable with the list items so that some action can be performed on each item. The list can be comma delimited or can use any other delimiter. The variable must be created in an earlier step using the Create Variable action.

One way to enter the list is to first create steps that populate a variable with the contents of a text file list. Then, when creating the Loop List step, use the variable (between percent signs (%)) as the list specification.

When the Loop List step is created, an End Loop step is created automatically. Place the steps to be performed on the list items between the Loop List step and the End Loop step. The steps within the block should be indented for visual clarity.

To set Loop List properties

  1. From the Task Builder Available Actions pane, open the Loop folder and double-click the Loop List action or drag it into the Steps pane.

  2. In the List box, type or paste the list, type a variable name between percent signs (%), or click the Insert Expression/Variable button and use the Expression Builder to select a variable or create an expression. (The variable must be created in an earlier step using the Create Variable action.)

  3. In the Populate variable with list item box, select the variable to be populated with the list items.

  4. In the Delimiter box, select the delimiter used in the text list. If the delimiter is not on the drop-down list, select custom and then enter the delimiter in Use the following character(s) as delimiter(s) box.

  5. If you want to sort the list items alphabetically, click the Advanced tab and then select a sort order in the Output list box.

  6. To set the Description tab properties, refer to Description Tab Options.

  7. To set the Error Causes and On Error tab properties, refer to Step Error Handling.

  8. When finished, click OK to save settings and close the properties dialog window.

To auto-indent after all steps are added

  1. In the Task Builder Steps pane, hold down SHIFT and click the first and last steps in the block so that the complete block of steps is selected.

  2. Click the Format button .

See Also

About Actions

Adding Task Steps

Loop List Action