Converting a local map into a submap
Use the Graphical Data Mapping editor to convert a local map into a submap by using the Refactor to submap function.
About this task
You can convert a local map into a submap so that the transformation logic can be reused by other graphical data maps.
- The input and output elements to the local map must be global elements.
- There must be at least one transform configured in the local map.
If you want to convert a local map to an existing submap, you cannot use the Refactor to submap function. You must change the transform from a Local map transform to a Submap transform.
To convert a local map into a submap, complete the following steps:
- Right-click the Local Map transform
in the graphical data map, and then
select Refactor to submap.
The following figure shows the menu that opens when you right-click the Local map transform:The New Message Map wizard opens.
- On the Specify a new message map file pane, the type of map that you want to create is selected as Submap called by another map. This is a message map that can be referenced from another message map. This is known as a submap and can contain components of a message body such as global elements and global types. A submap does not contain Properties, message headers, or the LocalEnvironment. Click Next.
- On the Select map inputs and outputs pane, the input and output objects of the submap have been pre-selected.
- Click Finish. The new submap is displayed in the Graphical Data Mapping editor, and you can edit it in the same way that you would edit any graphical data map. For information about how to edit maps, see Editing message maps.
A submap is created, containing all the mappings from the local map.
What to do next
Edit the submap. For more information, see Editing message maps.