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.

To convert a local map into a submap, the following conditions must be true:
  • 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.

Note: If you have global elements defined as input and output objects to the local map, and you have not defined any transformations between the input and output objects, you cannot convert a local map into a submap. To create the submap, you can change the Local map transform for the Submap transform. The following figure shows the menu option that you can use to create a submap instead of a local map:

This figure shows the menu option to change a local map transform to a submap transform.

Procedure

To convert a local map into a submap, complete the following steps:

  1. 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:This figure shows the menu that opens when you right-click the Local map transform.

    The New Message Map wizard opens.
  2. 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.
  3. On the Select map inputs and outputs pane, the input and output objects of the submap have been pre-selected.
  4. 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.

Results

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.