Rational Developer for System z, Version 7.6

Initialize Mapping -- a convenient way to map data between two nodes

Use the Initialize Mapping menu item to insert a new Assign node between two nodes directly connected to each other and to initialize the new Assign node for mapping data between the two original nodes.
This topic contains the following subtopics:

Overview

Where there are two Invoke nodes connected to each other, or there is an Invoke node connected to a Receive node, a Reply node, or a Throw node, then selecting the Initialize Mapping menu item to cause the flow editor to do the following:
  1. The flow editor deletes the connection between the two existing nodes.

  2. The flow editor automatically inserts and connects a new Assign node between the two existing nodes.

  3. To the mapping routine of the new Assign node, the flow editor adds source messages and target messages from the mapping routines associated with the two terminals that previously anchored the connection between the two original nodes. You can also select additional source messages and target messages to add to the mapping routine of the new Assign node.

  4. The flow editor opens the mapping routine of the new Assign node in the mapping editor.

You can now create mappings between the source messages and the target messages in the mapping routine of the new Assign node.

Where the Initialize Mapping menu item is enabled

The Initialize Mapping menu item is enabled in the following situations in the flow editor:

  • Two connected Invoke nodes:

    The Initialize Mapping menu item is enabled where an Invoke node is connected by its output terminal directly to the input terminal of another Invoke node.

    An example of such a situation is when two Invoke nonterminal nodes, each of which invokes a different nonterminal application, are connected together. You might want to copy some of the data returned by the first nonterminal application into the input message that is passed to the second Invoke nonterminal node.

  • An Invoke node connected to Receive node, a Reply node, or a Throw node:

    The Initialize Mapping menu item is enabled in the three following situations:

    1. Where the Receive node of the flow is connected by its output terminal directly to the input terminal of an Invoke node.

    2. Where an Invoke node is connected by its output terminal directly to the Reply node of the flow.

    3. Where an Invoke node is connected by its output terminal directly to a Throw node.

    An example of such a situation is where an Invoke nonterminal node is directly connected to the Reply node of the flow. In this situation you might want to copy some of the data returned by the Invoke nonterminal application into the output message of the flow

How to use the Initialize Mapping menu item

To use the Initialize Mapping menu item:

  1. On the flow editor canvas, right-click the connection (the actual line or "wire") between the terminals of the two connected nodes.

  2. Select Initialize Mapping. The Selection of Mapping Messages window opens.
    Note:
    • This window contains a list of all the messages in the current service flow project and also lists the IBM® system messages.

    • If any of the listed messages already serves as a source message or a target message of either of the mapping routines associated with the two terminals that previously anchored the connection between the two original nodes, then the Source or Target check box beside the message is selected.

  3. In the Selection of Mapping Messages window:

    1. In the Source column select the check box beside any message that you want to add to the Source pane of the new Assign node.

    2. In the Target column select the check box beside any message that you want to add to the Target pane of the new Assign node.

    3. Click OK to perform the operation or Cancel to cancel it.

  4. The flow editor creates the new Assign node, connects it as an intermediate node between the two originally connected nodes, creates the mapping routine for the new Assign node, and adds to this new mapping routine the following messages:

    1. Any messages that are currently referenced by the mapping routines associated with the terminals that previously anchored the connection between the two original nodes.

    2. Any message in the Selection of Mapping Messages window for which the Source check box or the Target checkbox is selected

  5. The flow editor then launches the mapping editor and opens the mapping routine of the new Assign node.

  6. You can now create mappings between the source elements and the target elements in the mapping routine of the new Assign node (see Working with mapping routines and mappings).

Note:
  • The Initialize Mapping operation does not modify either of the mapping routines associated with the terminals that previously anchored the connection between the two original nodes.

  • After the Initialize Mapping operation is complete the connections between the Assign node and the terminals to which it is connected do not have the Initialize Mapping menu entry enabled, because an Assign node does not have mapping routines associated with its terminals.


Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)