You can create a submap for use in your message
flows in the Application
Development view with messages as input
and output objects. Data from database tables can also be used as
input to the message map.
About this task
A submap enables you to use the
same piece of mapping function in multiple message
maps.
Procedure
Complete the following steps to create a submap in the Application
Development view:
- Choose one of the following options to start the New Message
Map wizard:
- In the IBM® App Connect
Enterprise Toolkit,
click .
- In the Application
Development view,
right-click the application, library, integration service,
or Integration project where
you want to create the message map.
Then, click .
The New Message
Map wizard opens.
- On the Specify a new message map file pane,
select Submap called by another map.
A submap is created that can be referenced from another message map. A submap can contain components
of a message body such as global elements and global types. A submap
does not contain Properties, message headers, or the local environment.
- Specify the Container, Map
name, and broker schema for
the submap. Click Next.
- On the Select map inputs and outputs pane,
expand the list of available input objects, and select the input objects
that you want to use as input to the submap.
If necessary,
use the Filter map input names field to filter
what is shown in the list of available objects. Each object in the
list is displayed in the form: objectname {namespace}.
- Expand the list of available output objects, and select
the output object that you want to use as output for the submap.
If necessary, use the Filter map output names field
to filter what is shown in the list of available objects. Each object
in the list is displayed in the form: objectname {namespace}.
- Click Finish to create the submap.
Results
The submap is created, and the Graphical
Data Mapping editor opens with the selected
sources and targets.
The submap is created as a .map file.
You
can see the submap in the Application
Development view displayed
under a Maps category, and organized by namespace.
What to do next
Edit the submap, and define transformations
between the input message assembly and the output message assembly.
For more information, see Editing message maps.