Regex Field Map

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

Last updated: July 28, 2025 | Edit this page | Discuss this page

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

top

Options

Parameter
Type
Description
Default Value
Parameter:
ApplyTo
Type:
List
Description:
A list of Work Item Types that this Field Map will apply to. If the list is empty it will apply to all Work Item Types. You can use “*” to apply to all Work Item Types.
Default Value:
missing XML code comments
Parameter:
Enabled
Type:
Boolean
Description:
If set to true then the Fieldmap will run. Set to false and the processor will not run.
Default Value:
missing XML code comments
Parameter:
pattern
Type:
String
Description:
Gets or sets the regular expression pattern to match against the source field value.
Default Value:
missing XML code comments
Parameter:
replacement
Type:
String
Description:
Gets or sets the replacement pattern that defines how matched groups should be used to construct the target value.
Default Value:
missing XML code comments
Parameter:
sourceField
Type:
String
Description:
Gets or sets the name of the source field to read data from and apply regex pattern matching.
Default Value:
missing XML code comments
Parameter:
targetField
Type:
String
Description:
Gets or sets the name of the target field to write the regex-transformed data to.
Default Value:
missing XML code comments
top

Samples

top

Sample

Sample

{
  "MigrationTools": {
    "Version": "16.0",
    "CommonTools": {
      "FieldMappingTool": {
        "FieldMaps": [
          {
            "FieldMapType": "RegexFieldMap",
            "ApplyTo": [
              "SomeWorkItemType"
            ],
            "pattern": "PRODUCT \\d{4}.(\\d{1})",
            "replacement": "$1",
            "sourceField": "COMPANY.PRODUCT.Release",
            "targetField": "COMPANY.DEVISION.MinorReleaseVersion"
          }
        ]
      }
    }
  }
}
top

Defaults

Defaults

{
  "MigrationTools": {
    "Version": "16.0",
    "CommonTools": {
      "FieldMappingTool": {
        "FieldMaps": [
          {
            "FieldMapType": "RegexFieldMap",
            "ApplyTo": [
              "*"
            ]
          }
        ]
      }
    }
  }
}
top

Classic

Classic

{
  "$type": "RegexFieldMapOptions",
  "sourceField": "COMPANY.PRODUCT.Release",
  "targetField": "COMPANY.DEVISION.MinorReleaseVersion",
  "pattern": "PRODUCT \\d{4}.(\\d{1})",
  "replacement": "$1",
  "ApplyTo": [
    "*",
    "SomeWorkItemType"
  ]
}
top

Metadata

top

Schema

This is the JSON schema that defines the structure and validation rules for this configuration.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://devopsmigration.io/schema/schema.fieldmaps.regexfieldmap.json",
  "title": "RegexFieldMap",
  "description": "Applies regular expression transformations to map values from a source field to a target field using pattern matching and replacement.",
  "type": "object",
  "properties": {
    "applyTo": {
      "description": "A list of Work Item Types that this Field Map will apply to. If the list is empty it will apply to all Work Item Types. You can use \"*\" to apply to all Work Item Types.",
      "type": "array"
    },
    "enabled": {
      "description": "If set to `true` then the Fieldmap will run. Set to `false` and the processor will not run.",
      "type": "boolean"
    },
    "pattern": {
      "description": "Gets or sets the regular expression pattern to match against the source field value.",
      "type": "string"
    },
    "replacement": {
      "description": "Gets or sets the replacement pattern that defines how matched groups should be used to construct the target value.",
      "type": "string"
    },
    "sourceField": {
      "description": "Gets or sets the name of the source field to read data from and apply regex pattern matching.",
      "type": "string"
    },
    "targetField": {
      "description": "Gets or sets the name of the target field to write the regex-transformed data to.",
      "type": "string"
    }
  }
}
Project Information
Azure DevOps Marketplace
YouTube Channel
Maintainer

Created and maintained by Martin Hinshelwood of nkdagility.com

Getting Support
Community Support
Questions & Discussions

The first place to look for usage, configuration, and general help.

Commercial Support

We provide training, ad-hoc support, and full service migrations through our professional services.

Azure DevOps Migration Services
Documentation