Show TOC

Procedure documentationMapping the Format Between Source and Target Trees Locate this document in the navigation structure

 

You can map between the source format tree and the target format tree by creating connections and mapping rules for each node required in your format solution.

You can create a connection by dragging a line from a node in the source format tree (source node) and dropping it on the node in the target format tree (target node). You can map more than one source node to a target node and move connections to other source nodes or target nodes.

Mapping rules you specify on the Mapping Setting tab determine the value output in the runtime execution. For each mapping setting, you can specify one or multiple conditions and one “else” condition. For multiple conditions, the first condition is checked. If the first condition is not met, the second condition is checked. The checking continues until one condition is met. The “else” condition determines the value output if any condition is not met.

Prerequisites

You have opened a format project.

Procedure

Mapping a Source Node to a Target Node
  1. Click the node in the source format tree.

  2. Drag and drop on the node to which you want to map in the target format tree. A connection line is created and the Mapping Setting tab is enabled for the connection.

    To create mapping settings for a target node that is not required to be mapped to any source node, right-click the target node and choose Mapping Setting.

  3. To add a condition, choose .

    To remove a condition, choose .

  4. To change the condition name, choose the Rename field and specify the new name.

  5. To specify details of a condition, specify one or multiple expressions and value output if the condition is met.

    1. Specify expressions for the condition:

      You can create multiple expressions by connecting them with logical operators and braces in a tree structure, for example, expression 1 and (expression 2 or expression 3).

      • To add an expression, select the condition in the expression tree, choose , and choose Row.

        To change the expression name, choose Rename.

        Specify the following fields for the expression:

        • Type1: Select the type of the first argument.

        • Arg1: Specify the first argument.

        • Op: Select the operator.

        • Type2: Select the type of the second argument.

        • Arg2: Specify the second argument.

        For arguments as function type, you can specify functions. In functions, you can use reference no. to refer to the source node. For more information, see Using Reference No. in Functions.

      • To add a brace (“()“), select the condition in the expression tree and choose .

        The brace determines the priorities of processing expressions for a condition. The expressions in the brace have a higher priority. Under a brace, you can add expressions, braces, and logical operators by selecting the brace and choosing .

      • To add a logical operator, choose the condition in the expression tree and choose .

        You can add Add or Or to connect expressions.

      To remove an expression, brace, or logical operator, select it and choose .

    2. Specify the value output, if the condition is met.

      • Copy Value From Source Node: Uses the value from the source node.

      • Constant Value: Specify a constant value.

      • Function: Specify a function that generates a value.

        You can specify complex functions with arguments as the results of other expressions. You can use reference no. to refer to a source node in Function. For more information, see Using Reference No. in Functions.

      • No Value: No value is outputted.

  6. To specify the value output if one condition is not met, select the Else Condition checkbox and specify the value.

  7. To move the connection line to another node, click the connection line and do one of the following:

    • From an original source node to a new source node: click the source end of the connection line on the source format tree and drag the line to the new source node.

    • From an original target node to a new target node: click the target end of the connection line on the target format tree and drag the line to the new target node.

  8. To map another source node to a target node that is already mapped, do the following:

    1. Click another source node and drag and drop it on the target node.

    2. In the message window that appears, choose the Duplicate Node button. Another connection line is created from the source node to the target node.

      To replace the original connection, choose the Replace Connection button. The new connection line from the new source node to the target node replaces the original connection line.

Displaying Mapping Settings

To display the mapping setting for a target node, right-click a target node and choose Mapping Setting.

Clearing Mapping Settings

Right-click the target node from which you want to clear the mapping settings and choose Clear Mapping Setting.

Copying and Pasting Mapping Settings
  1. Click the connection line of the mapping settings you want to copy and choose Copy Mapping Settings.

  2. Click the connection line of the mapping settings you want to paste and choose Paste Mapping Settings.

Cutting and Pasting Mapping Settings
  1. Click the connection line of the mapping settings you want to cut and choose Cut Mapping Settings.

  2. Click the connection line of the mapping settings you want to paste and choose Paste Mapping Settings.

Deleting Mapping Settings

Select the connection line you want to delete and do one of the following:

  • Press the Delete key.

  • Right-click and choose Delete.

Both the connection line and the mapping settings are deleted.

More Information

Functions