Join Variable Assertion
The Join Variable assertion combines the values in a multivalued context variable into a single-value context variable by concatenating each value with a user-defined string.
gateway83
The Join Variable assertion combines the values in a multivalued context variable into a single-value context variable by concatenating each value with a user-defined string.
Example
:The input variable "${varIn}" is a multivalued context variable that contains the values "one", "two", "three". After joining this variable into "${varOut}" with a delimiter of '+', you now have a single-value context variable with the value "one+two+three".
The join effect can also be achieved by using the syntax "${variable|;}", where the value after the '|' character is the delimiter string. For example, "${varIn|+}" will also result in "one+two+three" using the example above. For more information, see Concatenation Options during Interpolation under Working with Multivalued Context Variables.
Using the Assertion
- Do one of the following:
- To add the assertion to the Policy Development window, see Add an Assertion.
- To change the configuration of an existing assertion, proceed to step 2 below.
- When adding the assertion, the Join Variable Properties automatically appear; when modifying the assertion, right-clickJoin variable <... in the policy window and selectsource> into <target>Join Variable Propertiesor double-click the assertion in the policy window. The assertion properties are displayed.
- Configure the properties as follows:SettingDescriptionSource VariableEnter the context variable containing the source values to be joined. This must be a multivalued context variable.Target VariableEnter the context variable that will hold the results of the join. If this variable does not already exist, it will be created.Join ValueEnter any string to be used as a delimiter for the joined values. The default is a comma (',').
- Click [OK] when done.