Field Maps

[MrHinsh]

This discussion is for questions, feedback, and community support related to the Field Maps.

Quick Reference

• Documentation: Field Maps

How to Use This Discussion

• Ask Questions: If you need help configuring or using this component
• Share Examples: Post your configuration examples or use cases
• Report Issues: Describe any problems you encounter (though bugs should be reported as GitHub Issues)
• Request Features: Suggest improvements or new features

Related Documentation

Please refer to the official documentation for detailed configuration options and examples.

[ptc-96]

Hello,
I'm trying to use some field mappings in the new released version 16.2 and it seems like they don't work any more event if they worked in the previous version 16.1... Here is my configuration file:

"CommonTools": {
  "WorkItemTypeMappingTool": {
    "Enabled": true,
    "Mappings": {
      "User Story": "PBI"
    }
  },
  "FieldMappingTool": {
    "Enabled": true,
    "FieldMaps": [
      {
        "FieldMapType": "FieldToFieldMap",
        "sourceField": "TfsMigrationTool.ReflectedWorkItemId",
        "targetField": "Microsoft.VSTS.Build.IntegrationBuild",
        "defaultValue": "",
        "ApplyTo": ["*"]
      },
      {
        "FieldMapType": "FieldToFieldMap",
        "ApplyTo": [
          "PBI"
        ],
        "defaultValue": "",
        "sourceField": "Microsoft.VSTS.Scheduling.StoryPoints",
        "targetField": "Microsoft.VSTS.Scheduling.OriginalEstimate"
      },
      {
        "FieldMapType": "FieldValueMap",
        "sourceField": "System.State",
        "targetField": "System.State",
        "defaultValue": "Proposed",
        "ApplyTo": [
          "PBI",
          "User Story"
        ],
        "valueMapping": {
          "New": "Proposed",
          "Resolved": "Resolved",
          "Active": "Active",
          "Closed": "Closed",
          "Removed": "Closed"
        }
      },
      {
        "FieldMapType": "FieldToFieldMap",
        "sourceField": "Microsoft.VSTS.Common.AcceptanceCriteria",
        "targetField": "CustomProject.SystemAcceptanceCriteria",
        "defaultValue": "",
        "ApplyTo": [
          "PBI"
        ]
      }
    ]
  }

Could you please tell me if Am I doing something wrong?

FYI: I've tried also this one and it does not work neither:

"CommonTools": {
  "WorkItemTypeMappingTool": {
    "Enabled": true,
    "Mappings": {
      "User Story": "PBI"
    }
  },
  "FieldMappingTool": {
    "Enabled": true,
    "FieldMaps": [
      {
        "$type": "FieldToFieldMapOptions",
        "sourceField": "TfsMigrationTool.ReflectedWorkItemId",
        "targetField": "Microsoft.VSTS.Build.IntegrationBuild",
        "defaultValue": "",
        "ApplyTo": ["*"]
      },
      {
        "$type": "FieldToFieldMapOptions",
        "ApplyTo": ["*"],
        "defaultValue": "",
        "sourceField": "Microsoft.VSTS.Scheduling.StoryPoints",
        "targetField": "Microsoft.VSTS.Scheduling.OriginalEstimate"
      },
      {
        "$type": "FieldValueMapOptions",
        "sourceField": "System.State",
        "targetField": "System.State",
        "defaultValue": "Proposed",
        "ApplyTo": ["*"],
        "valueMapping": {
          "New": "Proposed",
          "Resolved": "Resolved",
          "Active": "Active",
          "Closed": "Closed",
          "Removed": "Closed"
        }
      },
      {
        "$type": "FieldToFieldMapOptions",
        "sourceField": "Microsoft.VSTS.Common.AcceptanceCriteria",
        "targetField": "CustomProject.SystemAcceptanceCriteria",
        "defaultValue": "",
        "ApplyTo": ["*"]
      }
    ]
  }

[MrHinsh]

What are you seeing?

• Can you provide the full config and log?
• Do you see the fieldmapps loaded at tha start of the log?

[ptc-96]

Hello,
I have been working a little bit deeply on it. It seems like migration fails if those fields specified for the mapping are not fulfilled in source project.
Can I just add a configuration in order to map a field if it has information in the source project and just ignore it if it hasn't?

[MrHinsh]

The field either exists on a work item or it does not. Regardless if its filled out.

You can specify using "ApplyTo": ["*"] to only apply the field map to work items that have that field with "ApplyTo": ["Bug"]

[o7ka4aln1ka]

Hello everyone,

First of all, thank you so much to the team for creating and maintaining this amazing migration tool! I’ve been using it successfully for the past three months to migrate Work Items between ADO instances, and it worked almost flawlessly. Your efforts are truly appreciated.

Recently, I tried performing another migration using the latest version of DevOpsMigrationTool, and I’ve run into some difficulties. My goal is straightforward: I want to migrate only work items (nothing else) from one ADO instance to another.

I’ve carefully followed the updated documentation here: Field Mapping Tool Docs to set up the mappings correctly. In the error log, there are multiple errors, but I decided to focus on just one Work Item type (BUG) and configure it properly first. My hope is that once this one is fixed and no longer appears as a warning, I can move on to update the other mappings.

Despite many attempts and trial-and-error adjustments to enable field mappings after each execution, I keep getting the same output. This leads me to think either my mappings are not being picked up even though it says Adding mapping or I’m missing something in the configuration.

Additionally, I have tried the different SeriLog levels but I could not find anything there that points to concrete error.

I would be very grateful if anyone could point me in the right direction—helping me identify where I might be going wrong and how to set up the configs properly. I have checked the discussion here and tried to update the config based on the answers found there as well.

I understand there have been changes to both the Target and Source ADO, which now require additional adjustments and field mappings. My main issue and question revolve around this point.

Below, I’ll attach my config and the output I get when running the tool.

Initial config that worked three months ago:
{
"Serilog": {
"MinimumLevel": "Information",
"MinimumLevelNot": "Debug"
},
"MigrationTools": {
"Version": "16.0",
"Endpoints": {
"Source": {
"EndpointType": "TfsTeamProjectEndpoint",
"Collection": "https://dev.azure.com/XXX-SOURCE/",
"Project": "Scrum-target",
"Authentication": {
"AuthenticationMode": "AccessToken",
"AccessToken": "${AccessTokenSource}"
},
"ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
"LanguageMaps": {
"AreaPath": "Area",
"IterationPath": "Iteration"
}
},
"Target": {
"EndpointType": "TfsTeamProjectEndpoint",
"Collection": "https://dev.azure.com/XXX-TARGET/",
"Project": "Scrum-source",
"ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
"Authentication": {
"AuthenticationMode": "AccessToken",
"AccessToken": "${AccessTokenTarget}"
},
"LanguageMaps": {
"AreaPath": "Area",
"IterationPath": "Iteration"
}
}
},
"Processors": [
{
"ProcessorType": "TfsWorkItemMigrationProcessor",
"Enabled": true,
"UpdateCreatedDate": false,
"UpdateCreatedBy": false,
"WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.ChangedDate] >= '2025-04-04' AND [System.TeamProject] = @teamproject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
"FixHtmlAttachmentLinks": true,
"WorkItemCreateRetryLimit": 5,
"FilterWorkItemsThatAlreadyExistInTarget": true,
"PauseAfterEachWorkItem": false,
"AttachRevisionHistory": false,
"GenerateMigrationComment": true,
"WorkItemIDs": null,
"MaxGracefulFailures": 99999,
"SkipRevisionWithInvalidIterationPath": false,
"SkipRevisionWithInvalidAreaPath": false,
"Enrichers": null,
"SourceName": "Source",
"TargetName": "Target",
"RefName": null
},
{
"ProcessorType": "TfsWorkItemOverwriteProcessor",
"Enabled": false,
"UpdateCreatedDate": true,
"UpdateCreatedBy": true,
"WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.ChangedDate] > '2025-04-04' AND [System.TeamProject] = @teamproject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
"FixHtmlAttachmentLinks": true,
"WorkItemCreateRetryLimit": 5,
"FilterWorkItemsThatAlreadyExistInTarget": false,
"PauseAfterEachWorkItem": false,
"AttachRevisionHistory": false,
"GenerateMigrationComment": true,
"WorkItemIDs": null,
"MaxGracefulFailures": 0,
"SkipRevisionWithInvalidIterationPath": false,
"SkipRevisionWithInvalidAreaPath": false,
"Enrichers": null,
"SourceName": "Source",
"TargetName": "Target",
"RefName": null
}
],
"FieldMaps": [],
"CommonTools": {
"TfsTeamSettingsTool": {
"Enabled": true,
"MigrateTeamSettings": true,
"UpdateTeamSettings": true,
"MigrateTeamCapacities": true
},
"FieldMappingTool": {
"Enabled": true,
"FieldMaps": []
}
}
}
}

All WI which were newer then the fixed date were migrated without any issue.

My latest config:
{
"Serilog": {
"MinimumLevel": "Information",
"MinimumLevelNot": "Debug"
},
"MigrationTools": {
"Version": "16.0",
"Endpoints": {
"Source": {
"EndpointType": "TfsTeamProjectEndpoint",
"Collection": "https://dev.azure.com/XXX-SOURCE/",
"Project": "Scrum-target",
"Authentication": {
"AuthenticationMode": "AccessToken",
"AccessToken": "${AccessTokenSource}"
},
"ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
"LanguageMaps": {
"AreaPath": "Area",
"IterationPath": "Iteration"
}
},
"Target": {
"EndpointType": "TfsTeamProjectEndpoint",
"Collection": "https://dev.azure.com/XXX-TARGET/",
"Project": "Scrum-source",
"ReflectedWorkItemIdField": "Custom.ReflectedWorkItemId",
"Authentication": {
"AuthenticationMode": "AccessToken",
"AccessToken": "${AccessTokenTarget}"
},
"LanguageMaps": {
"AreaPath": "Area",
"IterationPath": "Iteration"
}
}
},
"Processors": [
{
"ProcessorType": "TfsWorkItemMigrationProcessor",
"Enabled": true,
"UpdateCreatedDate": true,
"UpdateCreatedBy": false,
"WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.ChangedDate] >= '2025-08-01' AND [System.TeamProject] = @teamproject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
"FixHtmlAttachmentLinks": true,
"WorkItemCreateRetryLimit": 5,
"FilterWorkItemsThatAlreadyExistInTarget": true,
"PauseAfterEachWorkItem": false,
"AttachRevisionHistory": true,
"GenerateMigrationComment": true,
"WorkItemIDs": null,
"MaxGracefulFailures": 99999,
"SkipRevisionWithInvalidIterationPath": false,
"SkipRevisionWithInvalidAreaPath": false,
"Enrichers": null,
"SourceName": "Source",
"TargetName": "Target",
"RefName": null
},
{
"ProcessorType": "TfsWorkItemOverwriteProcessor",
"Enabled": false,
"UpdateCreatedDate": true,
"UpdateCreatedBy": true,
"WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.ChangedDate] >= '2025-08-01' AND [System.TeamProject] = @teamproject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request') ORDER BY [System.ChangedDate] desc",
"FixHtmlAttachmentLinks": true,
"WorkItemCreateRetryLimit": 5,
"FilterWorkItemsThatAlreadyExistInTarget": false,
"PauseAfterEachWorkItem": false,
"AttachRevisionHistory": false,
"GenerateMigrationComment": true,
"WorkItemIDs": null,
"MaxGracefulFailures": 0,
"SkipRevisionWithInvalidIterationPath": false,
"SkipRevisionWithInvalidAreaPath": false,
"Enrichers": null,
"SourceName": "Source",
"TargetName": "Target",
"RefName": null
}
],
"CommonTools": {
"FieldMappingTool": {
"Enabled": true,
"FieldMaps": [
{
"FieldMapType": "FieldValueMap",
"ApplyTo": [
"Bug"
],
"sourceField": "Microsoft.VSTS.Build.IntegrationBuild",
"targetField": "Microsoft.VSTS.Build.IntegrationBuild",
"valueMapping": {
"": ""
}
},
{
"ApplyTo": [
"Bug"
],
"defaultValue": "New",
"FieldMapType": "FieldValueMap",
"sourceField": "System.State",
"targetField": "System.State",
"valueMapping": {
"Active": "Develop",
"Closed": "Accepted",
"New": "New",
"Resolved": "Acceptance Test"
}
}
]
}
}
}
}

Output:
[14:10:45 INF] [16.2.11] Azure DevOps Migration Tools [Object Model]
[14:10:45 INF] [16.2.11] 16.2.11
[14:10:45 INF] [16.2.11] naked Agility with Martin Hinshelwood
[14:10:45 INF] [16.2.11] ===============================================================================
[14:10:45 INF] [16.2.11] --------------------------------------
[14:10:45 INF] [16.2.11] Telemetry Note:
[14:10:45 INF] [16.2.11] We use Application Insights to collect usage and error information in order to improve the quality of the tools.
[14:10:45 INF] [16.2.11] Currently we collect the following anonymous data:
[14:10:45 INF] [16.2.11] -Event data: application version, client city/country, hosting type, item count, error count, warning count, elapsed time.
[14:10:45 INF] [16.2.11] -Exceptions: application errors and warnings.
[14:10:45 INF] [16.2.11] -Dependencies: REST/ObjectModel calls to Azure DevOps to help us understand performance issues.
[14:10:45 INF] [16.2.11] This data is tied to a session ID that is generated on each run of the application and shown in the logs. This can help with debugging. If you want to disable telemetry you can run the tool with '--disableTelemetry' on the command prompt.
[14:10:45 INF] [16.2.11] Note: Exception data cannot be 100% guaranteed to not leak production data
[14:10:45 INF] [16.2.11] --------------------------------------
[14:10:45 INF] [16.2.11] Start Time: 08/18/2025 14:10:45
[14:10:45 INF] [16.2.11] Running with settings: {"ConfigFile": ".\one_by_one_configuration_e_komplet_sandbox.json.tmp", "DisableTelemetry": false, "DebugTrace": false, "skipVersionCheck": false, "$type": "ExecuteMigrationCommandSettings"}
[14:10:45 INF] [16.2.11] OSVersion: Microsoft Windows NT 6.2.9200.0
[14:10:45 INF] [16.2.11] Version (Assembly): 16.2.11
[14:10:45 INF] [16.2.11] Logpath: C:\Users\var\AppData\Local\Microsoft\WinGet\Packages\nkdAgility.AzureDevOpsMigrationTools_Microsoft.Winget.Source_8wekyb3d8bbwe\logs\20250818141043
[14:10:49 INF] [16.2.11] Verion Info:
[14:10:49 INF] [16.2.11] Running: 16.2.11.0
[14:10:49 INF] [16.2.11] Installed: 16.2.11
[14:10:49 INF] [16.2.11] Available: 16.2.11
_
___ __ __ ___ ___ _ _ | |_ ___
/ _ \ \ / / / _ \ / | | | | | | | / _
| / > < | / | ( | || | | | | /
_| /_/_\ _| _| _,| __| _|

[14:10:49 INF] [16.2.11] No validator found for processor type TfsWorkItemOverwriteProcessorOptions
[14:10:49 INF] [16.2.11] Creating Migration Engine c53309db-b5bf-4f31-b0a3-fd8677f8105e
[14:10:49 INF] [16.2.11] ProcessorContainer: Of 2 configured Processors only 2 are enabled
[14:10:49 INF] [16.2.11] ProcessorContainer: Adding Processor TfsWorkItemMigrationProcessor
[14:10:49 INF] [16.2.11] FieldMappingTool: Adding FieldMap FieldValueMap for Bug
[14:10:49 INF] [16.2.11] FieldMappingTool: Adding FieldMap FieldValueMap for Bug
[14:10:49 INF] [16.2.11] ProcessorContainer: Adding Processor TfsWorkItemOverwriteProcessor
[14:10:49 INF] [16.2.11] Logging has been configured and is set to: unknown.
[14:10:49 INF] [16.2.11] Max Logfile: Verbose.
[14:10:49 INF] [16.2.11] Max Console: Debug.
[14:10:49 INF] [16.2.11] Max Application Insights: Error.
[14:10:49 INF] [16.2.11] The Max log levels above show where to go look for extra info. e.g. Even if you set the log level to Verbose you will only see that info in the Log File, however everything up to Debug will be in the Console.
[14:10:49 INF] [16.2.11] Beginning run of 2 processors
[14:10:49 INF] [16.2.11] Processor: TfsWorkItemMigrationProcessor
[14:10:49 INF] [16.2.11] Migration Context Start: TfsWorkItemMigrationProcessor
Initializing expensive ProjectData from WorkItemStore...
Initializing expensive WorkItemStore...
[14:10:50 INF] [16.2.11] Connecting with AccessToken
[14:10:51 INF] [16.2.11] Access granted to XXX
[14:10:51 INF] [16.2.11] Work Item Store connected to XXX with BypassRules set to True
Initializing expensive ProjectData from WorkItemStore...
Initializing expensive WorkItemStore...
[14:10:51 INF] [16.2.11] Connecting with AccessToken
[14:10:52 INF] [16.2.11] Access granted to XXX
[14:10:52 INF] [16.2.11] Work Item Store connected to XXX with BypassRules set to True
[14:10:52 INF] [16.2.11] Validating work item types.
[14:10:52 INF] [16.2.11] Source work item types are: Bug, Code Review Request, Code Review Response, Epic, Feature, Feedback Request, Feedback Response, Shared Steps, Task, Test Case, Test Plan, Test Suite, User Story, Issue, Shared Parameter, Release Story, CMS Support Ticket, IT Support Ticket, Discovery, Enabler, Release, Spike, 3rd Level Support Request, Initiative, Enabler Story.
[14:10:52 INF] [16.2.11] Target work item types are: Bug, Code Review Request, Code Review Response, Epic, Feature, Feedback Request, Feedback Response, Shared Steps, Task, Test Case, Test Plan, Test Suite, User Story, Issue, Shared Parameter, Release Story, Spike, Discovery, Initiative, Release, CMS Support Ticket, 3rd Level Support Request, Enabler, Enabler Story, IT Support Ticket.
[14:10:52 INF] [16.2.11] Validating work item type 'Bug'
[14:10:52 WRN] [16.2.11] Source field 'Microsoft.VSTS.Build.IntegrationBuild' and target field 'Microsoft.VSTS.Build.IntegrationBuild' have different allowed values.
[14:10:52 INF] [16.2.11] Source allowed values: ''
[14:10:52 INF] [16.2.11] Target allowed values:
[14:10:52 WRN] [16.2.11] Source field 'System.State' and target field 'System.State' have different allowed values.
[14:10:52 INF] [16.2.11] Source allowed values: 'Active', 'Closed', 'New', 'Resolved'
[14:10:52 INF] [16.2.11] Target allowed values: 'Acceptance Test', 'Accepted', 'Approved', 'Develop', 'New', 'Removed', 'Triage'
[14:10:52 INF] [16.2.11] Validating work item type 'Code Review Request'
[14:10:52 WRN] [16.2.11] 'Code Review Request' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:52 INF] [16.2.11] All fields are either present or mapped.
[14:10:52 INF] [16.2.11] Validating work item type 'Code Review Response'
[14:10:52 WRN] [16.2.11] 'Code Review Response' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:52 INF] [16.2.11] All fields are either present or mapped.
[14:10:52 INF] [16.2.11] Validating work item type 'Epic'
[14:10:52 WRN] [16.2.11] Source field 'Microsoft.VSTS.Common.ResolvedReason' and target field 'Microsoft.VSTS.Common.ResolvedReason' have different allowed values.
[14:10:52 INF] [16.2.11] Source allowed values:
[14:10:52 INF] [16.2.11] Target allowed values: 'As Designed', 'Cannot Reproduce', 'Copied to Backlog', 'Deferred', 'Duplicate', 'Fixed', 'Fixed and verified', 'Obsolete', 'Will not Fix'
[14:10:52 WRN] [16.2.11] Source field 'System.State' and target field 'System.State' have different allowed values.
[14:10:52 INF] [16.2.11] Source allowed values: 'Active', 'Closed', 'New', 'Removed', 'Resolved'
[14:10:52 INF] [16.2.11] Target allowed values: 'Approved', 'Closed', 'MVP', 'New', 'Preserved', 'Removed', 'Research', 'Retro', 'Review', 'Solutioneering'
[14:10:53 INF] [16.2.11] Validating work item type 'Feature'
[14:10:53 WRN] [16.2.11] Source field 'Microsoft.VSTS.Common.ResolvedReason' and target field 'Microsoft.VSTS.Common.ResolvedReason' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values:
[14:10:53 INF] [16.2.11] Target allowed values: 'As Designed', 'Cannot Reproduce', 'Copied to Backlog', 'Deferred', 'Duplicate', 'Fixed', 'Fixed and verified', 'Obsolete', 'Will not Fix'
[14:10:53 WRN] [16.2.11] Source field 'Microsoft.VSTS.Build.IntegrationBuild' and target field 'Microsoft.VSTS.Build.IntegrationBuild' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values: ''
[14:10:53 INF] [16.2.11] Target allowed values:
[14:10:53 WRN] [16.2.11] Source field 'System.State' and target field 'System.State' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values: 'Active', 'Closed', 'New', 'Removed', 'Resolved'
[14:10:53 INF] [16.2.11] Target allowed values: 'Acceptance Test', 'Approved', 'Closed', 'Concept', 'Concept Review', 'Deploying', 'Implementing', 'New', 'Releasing', 'Removed', 'Review'
[14:10:53 INF] [16.2.11] Validating work item type 'Feedback Request'
[14:10:53 WRN] [16.2.11] 'Feedback Request' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'Feedback Response'
[14:10:53 WRN] [16.2.11] 'Feedback Response' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'Shared Steps'
[14:10:53 WRN] [16.2.11] 'Shared Steps' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'Task'
[14:10:53 WRN] [16.2.11] Missing field 'Custom.Definitionofdone' in 'Task'.
[14:10:53 INF] [16.2.11] Source field reference name: Custom.Definitionofdone
[14:10:53 INF] [16.2.11] Source field name: Definition of done
[14:10:53 INF] [16.2.11] Field type: Html
[14:10:53 INF] [16.2.11] Allowed values:
[14:10:53 INF] [16.2.11] Allowed values type: String
[14:10:53 WRN] [16.2.11] Source field 'System.State' and target field 'System.State' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values: 'Active', 'Closed', 'New', 'Removed'
[14:10:53 INF] [16.2.11] Target allowed values: 'Active', 'Closed', 'New', 'Removed', 'Review'
[14:10:53 INF] [16.2.11] Validating work item type 'Test Case'
[14:10:53 WRN] [16.2.11] 'Test Case' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'Test Plan'
[14:10:53 WRN] [16.2.11] 'Test Plan' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'Test Suite'
[14:10:53 WRN] [16.2.11] 'Test Suite' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'User Story'
[14:10:53 WRN] [16.2.11] Missing field 'Custom.TicketID' in 'User Story'.
[14:10:53 INF] [16.2.11] Source field reference name: Custom.TicketID
[14:10:53 INF] [16.2.11] Source field name: TicketID
[14:10:53 INF] [16.2.11] Field type: String
[14:10:53 INF] [16.2.11] Allowed values:
[14:10:53 INF] [16.2.11] Allowed values type: String
[14:10:53 WRN] [16.2.11] Source field 'Microsoft.VSTS.Build.IntegrationBuild' and target field 'Microsoft.VSTS.Build.IntegrationBuild' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values: ''
[14:10:53 INF] [16.2.11] Target allowed values:
[14:10:53 WRN] [16.2.11] Source field 'System.State' and target field 'System.State' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values: 'Active', 'Closed', 'New', 'Removed', 'Resolved'
[14:10:53 INF] [16.2.11] Target allowed values: 'Acceptance Test', 'Accepted', 'Approved', 'Concept', 'Develop', 'New', 'Removed'
[14:10:53 INF] [16.2.11] Validating work item type 'Issue'
[14:10:53 WRN] [16.2.11] 'Issue' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 WRN] [16.2.11] Source field 'Microsoft.VSTS.Common.Activity' and target field 'Microsoft.VSTS.Common.Activity' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values:
[14:10:53 INF] [16.2.11] Target allowed values: 'Deployment', 'Design', 'Development', 'Documentation', 'Requirements', 'Testing'
[14:10:53 WRN] [16.2.11] Source field 'System.State' and target field 'System.State' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values: 'Active', 'Closed'
[14:10:53 INF] [16.2.11] Target allowed values: 'Active', 'Closed', 'Removed'
[14:10:53 INF] [16.2.11] Validating work item type 'Shared Parameter'
[14:10:53 WRN] [16.2.11] 'Shared Parameter' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'Release Story'
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'CMS Support Ticket'
[14:10:53 WRN] [16.2.11] 'CMS Support Ticket' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'IT Support Ticket'
[14:10:53 WRN] [16.2.11] 'IT Support Ticket' does not contain reflected work item ID field 'Custom.ReflectedWorkItemId'.
[14:10:53 WRN] [16.2.11] Source field 'System.State' and target field 'System.State' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values: 'Active', 'Closed', 'New', 'Removed'
[14:10:53 INF] [16.2.11] Target allowed values: 'Active', 'Closed', 'New'
[14:10:53 INF] [16.2.11] Validating work item type 'Discovery'
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'Enabler'
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'Release'
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type 'Spike'
[14:10:53 INF] [16.2.11] All fields are either present or mapped.
[14:10:53 INF] [16.2.11] Validating work item type '3rd Level Support Request'
[14:10:53 WRN] [16.2.11] Source field 'System.State' and target field 'System.State' have different allowed values.
[14:10:53 INF] [16.2.11] Source allowed values: 'Active', 'Closed', 'New', 'Removed', 'Review'
[14:10:53 INF] [16.2.11] Target allowed values: 'Active', 'Closed', 'New', 'Review'
[14:10:53 INF] [16.2.11] Validating work item type 'Initiative'
[14:10:54 INF] [16.2.11] All fields are either present or mapped.
[14:10:54 INF] [16.2.11] Validating work item type 'Enabler Story'
[14:10:54 INF] [16.2.11] All fields are either present or mapped.
[14:10:54 ERR] [16.2.11] Some work item types or their fields are not present in the target system (see previous logs). Either add these fields into target work items, or map source fields to other target fields in options (SourceFieldMappings).
[14:10:54 INF] [16.2.11] If you have some field mappings defined for validation, do not forget also to configure proper field mapping in FieldMappingTool so data will preserved during migration.
[14:10:54 INF] [16.2.11] If you have different allowed values in some field, either update target field to match allowed values from source, or configure FieldValueMap in FieldMappingTool.

Having setup the field mapping for BUG I was expecting not to see this warning:
[14:10:52 INF] [16.2.11] Validating work item type 'Bug'
[14:10:52 WRN] [16.2.11] Source field 'Microsoft.VSTS.Build.IntegrationBuild' and target field 'Microsoft.VSTS.Build.IntegrationBuild' have different allowed values.
[14:10:52 INF] [16.2.11] Source allowed values: ''
[14:10:52 INF] [16.2.11] Target allowed values:
[14:10:52 WRN] [16.2.11] Source field 'System.State' and target field 'System.State' have different allowed values.
[14:10:52 INF] [16.2.11] Source allowed values: 'Active', 'Closed', 'New', 'Resolved'
[14:10:52 INF] [16.2.11] Target allowed values: 'Acceptance Test', 'Accepted', 'Approved', 'Develop', 'New', 'Removed', 'Triage'

After reading the documentation, I initially assumed that this was just a warning related to the IS state, and that using the mapping config would resolve it properly. However, the migration doesn’t start at all and I get the following error:
[14:10:54 ERR] [16.2.11] Some work item types or their fields are not present in the target system (see previous logs). Either add these fields into target work items, or map source fields to other target fields in options (SourceFieldMappings)
I thought I needed to map them properly first, but so far, I haven’t had any luck.

I would be extremely grateful if someone could guide me on what I might be missing or how to configure this correctly. Thank you so much in advance for your time and help—I truly appreciate it!

[MrHinsh]

We added a new validator in the latest version that validates before we load the work items. This allows fewer mistakes.

Check out the https://devopsmigration.io/docs/reference/tools/work-item-type-validator-tool/