Skip to end of metadata
Go to start of metadata


Automapping is used to automatically map source and target fields whose names are an exact match within identical data structures. Automapping using the entire data structure can be performed in either mapping mode or script mode; automapping within selected source and target nodes is limited to mapping mode.

For more information about mapping source objects and manual mapping, see Mapping Source Objects.

Important Notes

When using automapping, be aware of these notes:

  • Source and target fields and nodes must be an exact match of the name and structure path, regardless of case. For example, "Address" and "address" are considered an exact match for mapping purposes.
  • Source and target fields must have either the same or compatible data types. For example, a source field with an integer data type is considered a match for an otherwise matching target field with a string data type.
  • Automapping is applied a single time only; that is, using automapping will not result in a mapping continuously updating based on any changes to the structure or after manual updates.
  • Existing mappings will be left in place. If a target field already has a different mapping in place, the new automapping will be appended to the existing mapping. This may result in an invalid mapping that should be resolved manually, such as by removing one of the mapped objects or adding scripting logic.
  • Automapping cannot be reversed. If you have reviewed the automapped fields and found any you want to change, you must unmap these fields manually.

Automapping All Fields

To automatically map all fields that can be automapped, click the words Automap Exact Matches along the top right of the target structure in either mapping mode or script mode:

Source and target field names that are an exact match within an identical source and target structure will automatically be mapped:

Automapping Fields within Nodes

To automap fields within certain source and target nodes, in mapping mode, drag a source node to a target node. The node names do not need to match; however, the structure of any fields (or child nodes) contained within them must be identical for those fields to be automapped.

Upon dropping the source node onto the target node, select the option to Automap:

Exact matches within the source and target nodes with identical structures will automatically be mapped:

Removing an Automapping

Once mappings are created using automapping, they are treated the same as manual mappings. To remove the mapping, or unmap target fields, you must do so manually (see Removing a Mapping under Mapping Source Objects).

On This Page

Last updated:  Apr 17, 2020

  • No labels