Manipulate Multivalued Variable Assertion

The Manipulate Multivalued Variable assertion is used to both create new Multivalued Variables and to append new values to existing Multivalued Variables.
gateway90
The Manipulate Multivalued Variable assertion is used to both create new Multivalued Variables and to append new values to existing Multivalued Variables.
Multivalued variables can hold values of different types. This assertion does not support all available types which may exist at runtime. From the Set Context Variable assertion, only the String, Integer and Date/Time are supported.
The following Java types are supported if you are writing custom Java code via custom assertions:
java.lang.String
java.lang.Integer
java.lang.Double
java.lang.Float
java.lang.Boolean
java.util.Date
(and any subclass; for example, Timestamp.)
Assertions may also set variables that do not belong to any of the types listed above. If the value being appended is not one of the supported Java types, then the assertion will fail.
Using the Assertion
  1. 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.
  2. Right-click "
    Manipulate Multivalued Variable...
    " in the policy window and then select
    Manipulate Multivalued Variable Properties
    or double-click the assertion in the policy window. The assertion properties are displayed. 
  3. Configure the properties as follows:
    Setting
    Description
    Target Multivalued Variable
    Specify the name of the multivalued context variable. If the variable does not already exist, it will be created.
    (1) The target variable may be an existing multivalued variable. However, not all existing multivalued variables can be modified after they are created. If an attempt is made to update such a variable the assertion will fail. Any variables created by this assertion can be modified by this assertion. (2) Be sure to observe the naming rules described under Context Variable Naming Rules.
    Variable to append
    Specify the name of the variable to append to the multivalued variable. Only a single variable can be referenced. The reference can include a variable syntax such as "${myvar}" or "myvar", or an array syntax such as ${myVar[0]} or "myVar[0]". The variable itself can be a multivalued variable.
  4. Click [
    OK]
    when done.