Regex Field Map
Applies regular expression transformations to map values from a source field to a target field using pattern matching and replacement.
Applies regular expression transformations to map values from a source field to a target field using pattern matching and replacement.
Options
topSamples
topSample
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"
}
]
}
}
}
}
Defaults
Defaults
{
"MigrationTools": {
"Version": "16.0",
"CommonTools": {
"FieldMappingTool": {
"FieldMaps": [
{
"FieldMapType": "RegexFieldMap",
"ApplyTo": [
"*"
]
}
]
}
}
}
}
Classic
Classic
{
"$type": "RegexFieldMapOptions",
"sourceField": "COMPANY.PRODUCT.Release",
"targetField": "COMPANY.DEVISION.MinorReleaseVersion",
"pattern": "PRODUCT \\d{4}.(\\d{1})",
"replacement": "$1",
"ApplyTo": [
"*",
"SomeWorkItemType"
]
}
Metadata
topSchema
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"
}
}
}
In this article
Project Information
Azure DevOps Marketplace
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