Indexed variables

Some variables access a list of values rather than a single value. These variables are called indexed variables. All indexed variables support the indexing arguments described in this section.

In general, if an Index argument is provided for an indexed variable, the variable evaluates to a single value from the list. Otherwise, the variable evaluates to a sequence that contains all values in the list. The following table describes the indexing arguments and their effect in more detail.

Indexing arguments provided(don't combine!)

Description of result

None

Concatenation of all values in the list separated by a semicolon, all on the same line

If there are no values, the result is the empty string

Index="integer"

The list value indicated by the specified one-based index

If the Index argument is provided, all other arguments are ignored

Separator="separator-string"

Concatenation of all values in the list separated by the specified string, all on the same line

If there are no values, the result is the empty string

If the Separator argument is provided, the Prefix and Suffix arguments are ignored

Prefix="prefix-string"

Suffix="suffix-string"

Concatenation of all values in the list, each on a separate line of the form: <prefix-string><value><suffix-string>

If there are no values, the result is the empty string

Examples

Text in a property value

Evaluates to

[Job.EmailAddress:Index="1"]

tvr1@enfocus.com

[Job.EmailAddress]

tvr1@enfocus.com;tvr2@enfocus.com

[Job.EmailAddress:Separator=", "]

tvr1@enfocus.com, tvr2@enfocus.com

The email addresses for this job are:

[Job.EmailAddress:Prefix=" - "]

The email addresses for this job are: - tvr1@enfocus.com - tvr2@enfocus.com

See also: