IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Defining and transforming data > Transforming data > Transforming data using XML maps > Automatically mapping elements > Automatically mapping elements by name

Grouping transforms into nested maps

Use the Group transforms into nested maps property to nest the transforms in a new local map transform. The local map provides a way of displaying parts of a larger graphical map, enabling you to view the map elements in a hierarchical way.

When the Group transforms into nested maps property is selected, the Auto map wizard attempts to place new transforms inside new Local Map transforms. The Auto map wizard recursively analyzes the input and output elements of the new transforms, searching for a common input ancestor and a common output ancestor. If a common input ancestor is found for the input elements, and a common output ancestor is found for the output elements, a new Local Map transform is created between them. Inside the new local map, when no more common ancestors can be found, the new transforms are created at this level. If there are still some common ancestors at a given level, the process is repeated.

For example, a map might contain the following input:

SomeInput
--Resources
---field1
---field2
---field3
---field4

and the following output:

SomeOutput
---Items
----field1
----field2
----field3
----field4

If the Group transforms into nested maps property is not selected, the Auto map wizard creates transforms between the input and output elements field1, field2, field3, and field4 at the current level of the map.

However, if the Group transforms into nested maps property is selected, the Auto map wizard creates a Local Map transform between SomeInput/Resources and SomeOutput/Items at the current level of the map, and then creates transforms between the input and output elements field1, field2, field3, and field4 inside the local map.

Automatically mapping elements by name

Related tasks:
Create and using a synonym file
Mapping by Same Name
Automatically mapping elements by name

Related reference:
Format of the synonym file
Algorithm used to match synonyms
Sample similarity values