Copy Base - Auto Map

Automatically maps source elements to target elements for copy or move operations in a Data Action.

Remarks

The AutoMap command is designed to streamline the configuration of copy or move actions between complex data structures, such as Data Models, Data Sections, or Data Tables. When executed, it analyzes the child elements of the selected source and target, and automatically generates a set of copy actions for elements with matching names and compatible types.

When to Use

• Use this command when you need to quickly set up mappings between two similar data containers, such as copying all fields from one section to another, or mapping columns between tables.
• It is especially useful when the source and target have many child elements with the same names, reducing manual configuration.
• After running AutoMap, you can review and adjust the generated actions to handle exceptions, custom logic, or special cases.

How It Works

• The command compares the child elements of the source and target Data Elements.
• For each target child, it searches for a source child with the same name and a compatible type.
• If a match is found and the element is not read-only, a copy action is created and added to the 'Actions' list.
• Existing actions are not overwritten; AutoMap only adds new mappings for unmapped elements.

Usage Guidance

• The command is enabled when both the source and target are set, are not Data Fields, and no actions have been defined yet.
• Use AutoMap as a starting point for mapping; always review the generated actions to ensure they meet your business requirements.
• You can further customize the mapping by editing, removing, or adding actions as needed.

> Tip: AutoMap is ideal for rapidly configuring data normalization, migration, or transformation rules between similar data structures. It helps ensure consistency and reduces the risk of manual mapping errors.

See Also

AppendCopy