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:
- It creates a new mapping routine in the appropriate mapping file;
- It stores a reference to the new mapping routine in the artifact (here,
in the Assign node); and
- 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.