Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

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.)

...