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 |
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: