Field Maps

Field Calculation Map

The Field Calculation Map is a specialised field map used in the Azure DevOps Migration Tools. It allows you to compute values dynamically during migration by applying mathematical or logical operations on numeric fields. Calculations are defined using NCalc expressions and can reference one or more source fields using named parameters.

This is especially useful for scenarios where derived values need to be migrated, such as calculating cost based on effort and rate, or generating summary fields that are not explicitly stored in the source system.

Field Clear Map

Removes data from a specified field by setting its value to null during work item migration.

Field Literal Map

Maps a literal (static) value to a target field, useful for setting constant values across all migrated work items.

Field Merge Map

Merges values from multiple source fields into a single target field using a specified format template.

Field Skip Map

Skips field mapping for a specific target field, effectively leaving the field unchanged during migration.

Field To Field Map

Maps the value from a source field to a target field directly, with optional default value substitution for empty or null values.

Field To Field Multi Map

Maps field values based on a lookup table, allowing specific source values to be translated to different target values.

Field To Tag Field Map

Maps field values based on a lookup table, allowing specific source values to be translated to different target values.

Field Value Map

Maps field values based on a lookup table, allowing specific source values to be translated to different target values.

Multi Value Conditional Map

Applies regular expression transformations to map values from a source field to a target field using pattern matching and replacement.

Regex Field Map

Applies regular expression transformations to map values from a source field to a target field using pattern matching and replacement.

Tree To Tag Field Map

Maps work item area path or iteration path hierarchies to tags, allowing tree structures to be represented as flat tag collections.