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"]