Moving transforms into a local map or a submap

In the Graphical Data Mapping editor, you can group transforms into a local map or submap to enhance readability and maintenance of the message map. You can re-factor a local map to a submap to enable reuse of mappings of global complex types in multiple maps.

About this task

You can use a Quick Fix to move one or more transforms inside a local map or submap.

Your map has one or more transforms that are defined between child elements of an input and an output complex element. Then, you decide to change the design of your map, and move these transforms into a local map or into a submap.

Procedure

You must complete the following steps to move one or more transforms into a local map or submap:

  1. Create a map with a complex input element and a complex output element.
  2. Define transforms between the input and output child elements.

    Figure that shows the initial map with transforms at parent level.

  3. Change map design to group part of the transforms in a local map or submap.
  4. Wire a Move transform from the source folder to the target folder.
  5. Change the Move transform to a Local map transform or Submap transform.

    Figure that shows the local map transform.

    The Graphical Data Mapping editor displays an error marker on each child field mapping. This error indicates that the element is also mapped at the parent level.

    The Graphical Data Mapping editor offers a Quik Fix on each transform to move the transform inside the local map or submap.

    Figure that shows the map with transforms at parent level, including error markers.

  6. Click the Quick Fix associated to each of the transforms that you want to move inside the local map or submap. Then, click Nest transform within the parent map.

    Figure that shows the quick fix options.

    The local transform moves inside the local map. The Graphical Data Mapping editor automatically re-factors the map.

Results

The transforms, that initially were defined at the main level, are now located inside the local map or submap.

Figure that shows the nested map.

What to do next

Deploy the message map and verify that the output message is valid. For more information, see Troubleshooting a message map.