Field Maps

Field Maps are used to define how fields in the source system map to fields in the target system during migration. This section provides an overview of the field maps used in the Azure DevOps Migration Tools, including their configuration and usage. See Field Mapping Tool for more information.

Field Calculation Map

The Field Calculation Map performs mathematical calculations on numeric fields using NCalc expressions during work item migration. It allows you to compute values dynamically by applying mathematical or logical operations on source fields and storing the result in a target field.

Field Clear Map

The Field Clear Map removes data from a specified field by setting its value to null during work item migration. It includes intelligent validation to ensure the field can be safely cleared without causing migration errors.

Field Literal Map

The Field Literal Map sets a static, constant value to a target field on all migrated work items. This is useful for applying consistent values across work items during migration, such as setting default states, assigning standard tags, or populating fields with organizational defaults.

Field Merge Map

The Field Merge Map merges values from multiple source fields into a single target field using a configurable format template. This enables combining related information from separate fields into consolidated data.

Field Skip Map

The Field Skip Map ensures that specific target fields remain unchanged during migration by restoring their original values. This is useful for preserving existing data in target fields that should not be modified during the migration process.

Field To Field Map

The Field To Field Map performs direct field-to-field copying from source to target work items, with optional default value substitution for empty or null values. This is the most commonly used field map for straightforward field mappings.

Field To Field Multi Map

The Field To Field Multi Map enables efficient batch mapping of multiple field pairs in a single configuration, allowing you to map several source fields to their corresponding target fields simultaneously.

Field To Tag Field Map

The Field To Tag Field Map converts field values into work item tags, enabling you to transform structured field data into a more flexible tagging system during migration.

Field Value Map

The Field Value Map transforms field values based on a lookup table, allowing specific source values to be translated to different target values. This is essential for mapping between different value systems, process templates, and organizational standards.

Multi Value Conditional Map

The Multi Value Conditional Map applies conditional logic to map field values based on multiple criteria, enabling complex value transformations that depend on combinations of field values and conditions.

Regex Field Map

The Regex Field Map applies regular expression transformations to map values from a source field to a target field using pattern matching and replacement. This enables sophisticated text transformations, data extraction, and format standardization during migration.

Tree To Tag Field Map

The Tree To Tag Field Map converts hierarchical area path or iteration path structures into flat tags, enabling tree-based organizational information to be preserved as searchable tags during migration.

These fieldmaps are usied by the Field Mapping Tool to map fields from the source to the target system. The field maps are defined in the fieldMaps section of the configuration file.`