Rule that access multi-valued list fields have a number of specific points that you should understand. The examples in this section all assume you have a multi-valued list field with a name of FRUITS
, and that valid values within the list are apple, pear, orange, banana and raspberry.
For each assignment you make of a value within a multi-valued field, you are selecting that value. For example, if you want to set both apple and orange you would use:
FRUITS = ['apple','orange'];
The quotes around the values are optional, unless you have a space character within the value. For example, this is a valid statement:
FRUITS = [apple, 'orange', 'honeydew melon'];
If you want to set a single value of pear within the list you use a simple assignment statement.
FRUITS = 'pear';
FRUITS = ['orange', 'raspberry'];
FRUITS = '';
This syntax will find whether the single value of orange is currently set within the multi-valued list:
if (FRUITS.{contains 'orange'}) { ... };
This syntax will find whether the values of pear, orange and banana are currently set within the multi-valued list:
if (FRUITS.{contains 'pear', 'orange', 'banana'}) { ... };
This syntax will find whether the values of pear, and orange are currently set within the multi-valued list, but the value of banana is not within the multi-valued list:
if (FRUITS.{contains 'pear', 'orange'} && FRUITS.{excludes 'banana'}) { ... };
You can assign the selected values in a multi-valued list field to a text, text area, print text, or an HTML Area field. When you make the assignment, the text, text area, print text, or HTML Area field will contain the entire list of selected values, delimited with semi-colons.