Variables and external parameters

This section describes how to:

The Data Map Editor enables you to add variables or parameters to a map.

  • Variables enable you to store temporary values before the result will mapped to a target field.
  • Parameters enable you to receive external values to customize the map during run-time.

You can also use variables to store intermediate results and use them as input for other functions. In the following example, Variable1 takes the concat of iban and ownerName. This value can be used as input for a replace function. Also, you can use variables to map the same value to multiple output nodes.

Visual Mapper screen of variables and parameters with results

Add a variable

To add a variable:

  1. Right-click Variables on the left or right pane of the editor.
  2. Select Insert variable. The new variable is opened in the Properties view.
  3. Edit any of the following fields:
    • Name: Enter a unique name for the variable.
    • Type: Enter the type of the variable (string or integer).
    • Expression: Enter an expression for the variable. The expression can have a value either from the input schema or a typed in text.

Variables are shown in both the left pane (source elements) and right pane (target elements) of the editor. A link to a variable from a source element means that the value of the element will be stored in this variable. A link from a variable to a target element means that the value of the variable will be mapped to the target element.

Add a parameter

To add a parameter:

  1. Right-click Parameters on the left pane of the editor.
  2. Select Insert parameter. The new parameter is opened in the Properties view.
  3. Edit any of the following fields:
    • Name: Enter a unique name for the parameter.
    • Type: Enter the type of the parameter (string or integer).
    • Expression: Enter an expression for the parameter. The expression is defined in the Execute Data Map filter and can have the value of a whiteboard variable, for example ${http.request.uri} or a typed in text.
    • Required: Select the check box if the parameter is required. If the parameter is required, you cannot specify an expression. The value of the parameter is received at run-time.



Related Links