Field To Tag Field Map

[MrHinsh]

This discussion is for questions, feedback, and community support related to the Field To Tag Field Map.

Quick Reference

• Class Name: FieldToTagFieldMap
• Friendly Name: Field To Tag
• Documentation: Field To Tag Field Map

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.

[khalito]

Dear community,

I am having trouble to get this field to tag mapping right. I hope you can help me. Here is my config file

{
    "$schema": "https://devopsmigration.io/schema/configuration.schema.json",
    "Serilog": {
        "MinimumLevel": "Debug"
    },
    "MigrationTools": {
        "Version": "16.3",
        "Endpoints": {
            "Source": {
                "EndpointType": "TfsTeamProjectEndpoint",
                "Collection": "/",
                "Project": "Project1",
                "Authentication": {
                    "AuthenticationMode": "AccessToken",
                    "NetworkCredentials": {
                        "Domain": "",
                        "UserName": "",
                        "Password": ""
                    },
                    "AccessToken": ""
                },
                "ReflectedWorkItemIdField": "TfsMigrationTool.ReflectedWorkItemId",
                "LanguageMaps": {
                    "AreaPath": "Area",
                    "IterationPath": "Iteration"
                },
                "ProductVersion": "OnPremises"
            },
            "Target": {
                "EndpointType": "TfsTeamProjectEndpoint",
                "Collection": "/",
                "Project": "Project2",
                "Authentication": {
                    "AuthenticationMode": "AccessToken",
                    "NetworkCredentials": {
                        "Domain": "",
                        "UserName": "",
                        "Password": ""
                    },
                    "AccessToken": ""
                },
                "ReflectedWorkItemIdField": "TfsMigrationTool.ReflectedWorkItemId",
                "LanguageMaps": {
                    "AreaPath": "Area",
                    "IterationPath": "Iteration"
                },
                "ProductVersion": "OnPremises"
            }
        },
        "Processors": [
            {
                "ProcessorType": "TfsWorkItemMigrationProcessor",
                "Enabled": true,
                "WIQLQuery": "SELECT [System.Id] FROM WorkItems WHERE [System.TeamProject] = @TeamProject AND [System.WorkItemType] NOT IN ('Test Suite', 'Test Plan','Shared Steps','Shared Parameter','Feedback Request', 'Impediment', 'Objective', 'Milestone', 'Risk', 'Assistance') AND [System.Id] = '646554' ORDER BY [System.ChangedDate] desc",
                "FixHtmlAttachmentLinks": true,
                "WorkItemCreateRetryLimit": 5,
                "FilterWorkItemsThatAlreadyExistInTarget": false,
                "GenerateMigrationComment": true,
                "SourceName": "Source",
                "TargetName": "Target"
            }
        ],
        "CommonTools": {`
            "FieldMappingTool": {
                "Enabled": true,
                "FieldMaps": [
                    {
                        "FieldMapType": "FieldToTagFieldMap",
                        "ApplyTo": [
                            "Product Backlog Item",
                            "Bug"
                        ],
                        "sourceFields": [
                            "myorg.PAM.ReleaseVersion"
                        ],
                        "formatExpression": "Release version: {0}"
                    },
                    {
                        "FieldMapType": "FieldToTagFieldMap",
                        "ApplyTo": [
                            "Product Backlog Item",
                            "Bug"
                        ],
                        "sourceFields": [
                            "myorg.PAM.DataTransformationRequired"
                        ],
                        "formatExpression": "Data transformation required: {0}"
                    },
                    {
                        "FieldMapType": "FieldToTagFieldMap",
                        "ApplyTo": [
                            "Product Backlog Item",
                            "Bug"
                        ],
                        "sourceFields": [
                            "myorg.PAM.DataModelImpact"
                        ],
                        "formatExpression": "Data model impact: {0}"
                    },
                    {
                        "FieldMapType": "FieldToTagFieldMap",
                        "ApplyTo": [
                            "Bug"
                        ],
                        "sourceFields": [
                            "myorg.PAM.QAReported"
                        ],
                        "formatExpression": "QA reported: {0}"
                    }
           ]
       }
   }
}

When I run the migration, everything works except the field to tag mapping. in other words, the migration completes but with the following errors:

[21:07:54 DBG] [16.3.3] Running Field Map: FieldValueMap System.Reason System.Reason
[21:07:54 DBG] [16.3.3] Running Field Map: FieldToTagFieldMap null
[21:07:54 ERR] [16.3.3] Field map fault
System.ArgumentNullException: Value cannot be null.
Parameter name: name
   at Microsoft.TeamFoundation.WorkItemTracking.Client.FieldDefinitionCollection.Contains(String name)
   at Microsoft.TeamFoundation.WorkItemTracking.Client.FieldCollection.Contains(String fieldName)
   at MigrationTools.FieldMaps.AzureDevops.ObjectModel.FieldToTagFieldMap.InternalExecute(WorkItem source, WorkItem target) in D:\a\azure-devops-migration-tools\azure-devops-migration-tools\src\MigrationTools.Clients.TfsObjectModel\Tools\FieldMappingTool\FieldMaps\FieldToTagFieldMap.cs:line 27
   at MigrationTools.FieldMaps.AzureDevops.ObjectModel.FieldMapBase.Execute(WorkItemData source, WorkItemData target) in D:\a\azure-devops-migration-tools\azure-devops-migration-tools\src\MigrationTools.Clients.TfsObjectModel\Tools\FieldMappingTool\FieldMaps\FieldMapBase.cs:line 39
Error logged to Elmah.io!
!! Check for latest version - We fix issues constantly - If not, please create a discussion on https://github.com/nkdAgility/azure-devops-migration-tools/discussions so we can get this fixed !!

I suppose the error message tells me that the fields that I am trying to map to tags do not exist in the work item definition, but I triple checked and they do. The names are correctly spelled.

Am I misinterpreting the error message?

[khalito]

OK, kind of false alarm but I figured out a way for it to work. I had to replace sourceFields: [ ] (plural)with sourceField: "" (singular). Despite the documentation sample using plural.