In the Steps pane, hold down SHIFT and click the first and last steps in the block so that the complete block of steps is selected.
Click Format 
.
Loops through items in a list (comma, carriage return, or other delimited text). With each successive loop a block of steps is executed and the current index variable is updated with the next item in the list. The loop ends when at the end of the list or when a Break is encountered. To loop a block of steps through the records (rows) in a list (which is a variable containing multiple rows of data). With each loop the current record (row) in the list is incremented, until the last row is reached at which point the loop is ended.
Declaration
<AMLOOP TYPE="LIST" LIST="text(delimited list)" RESULTVARIABLE="text" DELIMITER="text(options)" SORT="text(options)">
See Also: Loop, End Loop, Loop Array, Loop Windows, Loop Expression, Loop Dataset, Loop List Control, Loop Tree Control
To set Loop List properties
In the Available Actions pane, open the Loop folder and double-click the Loop List action or drag it into the Steps pane.
In the List box, type or paste the list, type a variable name between percent signs (%), or click the percent sign (%) 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.)
In the Populate variable with list item box, select the variable to be populated with the list items.
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.
If you want to sort the list items alphabetically, click the Advanced tab and then select a sort order in the Output list box.
To set the Description tab properties, refer to Description Tab Options.
To set the Error Causes and On Error tab properties, refer to Step Error Handling.
When finished, click OK to save settings and close the properties dialog box.
To auto-indent after all steps are added
In the Steps pane, hold down SHIFT and click the first and last steps in the block so that the complete block of steps is selected.
Click Format .
|
Property |
Type |
Required |
Default |
Markup |
Description |
|
List |
Text |
Yes |
(Empty) |
LIST="Item1,Item2,Item3" |
The list of data to Loop through. The List can be delimited by a variety of characters. |
|
Populate variable with list item |
Text |
Yes |
(Empty) |
RESULTVARIABLE="varname" |
The name of the variable to populate with the current list item. With each successive loop, this variable will be populated with the next item in the list. |
|
Delimiter |
Text (options) |
No |
Comma |
DELIMITER="semi_colon" |
Specifies the character that delimits the items in the list. The available options are:
|
|
Property |
Type |
Required |
Default |
Markup |
Description |
|
Output List |
Text (options) |
No |
Do not sort the list |
SORT="ascending" |
Specifies whether a sort order should be applied towards the list before the loop begins. The available options are:
|