Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

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:

Image RemovedImage Added

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

Image RemovedImage Added

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.

Image RemovedImage Added

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

Image RemovedImage Added

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

Image RemovedImage Added

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).

Panel
borderColor#65379B
titleColor#FFFFFF
titleBGColor#65379B
titleOn This Page
Table of Content Zone

Table of Contents
maxLevel3
minLevel2

Panel
borderColor#FF7C4C
titleColor#FFFFFF
titleBGColor#FF7C4C
titleRelated Articles
Panel
borderColor#00B886
titleColor#FFFFFF
titleBGColor#00B886
titleRelated Topics

HideElements
metastrue

Last updated: 

Lastmodifieddate