List Iterator Action
The List Iterator Action allows you to perform a set of actions for each item in a list.
For general information on iterators, see the Iterators overview topic.
Details
List of Items
This is the list of items to iterate through.
By default, each new line represents a value to iterate. In the above example, the iterator will set the variable User first to Fred (and run it's child actions), then to George (and run it's child actions) and then to Judy (and run it's child actions).
FinalBuilder Variables (ie %ListContents%) can be used as part (or all) of the list.
Options
Variable
The name of the FinalBuilder Project/User Variable to set for each value.
Skip Blank Entries
If this option is checked, empty lines will be skipped.
List Separator
List separator
Newline
Tab
Custom separator
Scripting Info
You can set the list of items in script from the "OnFirstRun" event. Example script text:
Action.ListOfItems.clear
Action.ListOfItems.Add("Item 1")
Action.ListOfItems.Add("Item 2")
List Separator
By default, each item in the list appears on a new line.
Optionally, you can change this so that items in the list are delimited by tabs, or by a custom separator character or string (ie comma-delimited.)
If you use a list separator other than newline, scripting of the ListOfItems property will not work as expected.