Rational Developer for System z

How mapping routines are accessed

A reference to a mapping routine includes (a) the name of the mapping routine, and (b) the name of the mapping file in which the mapping routine is located.

References to mapping routines

Mapping routines can be referenced from Assign nodes and from the input terminal or an output terminal of most types of Invoke nodes (see Artifacts from which mapping routines can be referenced).

A reference to a mapping routine contains two items: The mapping file can be any mapping file in the service flow project to which the Assign node or the Invoke node belongs.

A reference to a mapping routine can be empty, signifying that no mapping routine is currently associated with the artifact.

When you use the mapping editor to open a mapping routine for an artifact, and the mapping routine does not already exist, then the mapping editor creates the mapping routine and stores a reference to it in the artifact. For example, if you have just created a new Assign node and you right-click the Assign node and select Open Mapping Routine, then the mapping editor does the following:
  1. It creates a new mapping routine in the appropriate mapping file;
  2. It stores a reference to the new mapping routine in the artifact (here, in the Assign node); and
  3. It opens the new mapping routine for editing.

You can subsequently re-open the same mapping routine with the same procedure (in this example, right-click the Assign node and select Open Mapping Routine).

You can also set a mapping reference to refer to any mapping file and mapping routine in the same service flow project (see Selecting a mapping routine for an Invoke or Assign node). If you do this, then the original mapping routine, if any, for the artifact is no longer referenced by the artifact but still exists in the mapping file.

A single mapping routine can be referred to by multiple artifacts (Assign nodes and the input terminals and output terminals of most types of Invoke nodes) -- see Multiple references to the same mapping routine.

Tip: The flow editor highlights any artifact (including Assign nodes and the input terminals and output terminals of most types of Invoke nodes) that contains a non-empty reference to a mapping routine.


Terms of use | Feedback

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