CODEWITHSUNDEEP
azureazure-devopstfs-workitemworkitemazure-devops-migration-tools
ErnieAndBert
ErnieAndBert

Reputation: 1702

Migrating work items over with different ref names. Is there a way to change a field ref name for a work item type or set up a custom ref name?

I am trying to migrate work items from a TFS server to Azure DevOps cloud using the VSTS Sync Migrator(https://nkdagility.github.io/azure-devops-migration-tools). I have most of the items migrating properly but I noticed that the descriptions were not coming over. After some investigating I see the the original TFS server has the "Description" field with a ref name "Common.DescriptionHtml". The default field for "Description" in ADO cloud is set to "System.Description". I assume that is why they are not syncing. (see attached image: top is ADO cloud and bottom it original TFS server)

Is there a way to modify/change the field reference name in ADO cloud to be "Common.DescriptionHtml". If not then can I create a new field and customize its field reference name to be "Common.DescriptionHtml" so I can match it up with the original in the TFS server.

If the above is not possible, if I change the ref type for the "Description" field in the original TFS server will it corrupt or effect the original data on that TFS server for the "Description" field? Yes, I am very new to this.

enter image description here

Upvotes: 0

Views: 811

Answers (2)

Max Morrow
Max Morrow

Reputation: 1336

You can remap fields using the VSTS Sync Migrator by configuring a FieldtoFieldMapConfig field map within your migration configuration json file.

In your case, it would look something like this:

{
    "$type": "FieldtoFieldMapConfig",
    "WorkItemTypeName": "*",
    "sourceField": "Common.DescriptionHtml",
    "targetField": "System.Description",
    "defaultValue": null
}

They have more examples of the FieldMaps available within their documentation here:

Upvotes: 1

Vito Liu
Vito Liu

Reputation: 8308

We recommend that you use migration guide and tool to migrate data from Azure DevOps Server to Azure DevOps Services.

The data migration tool for Azure DevOps supports the two latest releases of Azure DevOps Server at a given time. Releases include updates and major releases. Currently the following versions of Azure DevOps Server are supported for import:

  • Azure DevOps Server 2020

  • Azure DevOps Server 2019.1.1

Depending on the screenshot you shared, it seems that you are using TFS2018, please refer to this doc Upgrade your deployment to the latest version of Azure DevOps Server to update your TFS version and then refer to this doc to migrate data from Azure DevOps Server to Azure DevOps Services.

Update1

We cannot change or update the fields reference, in the TFS2019 and latest version, the field reference has been renamed to the System.Description, check the pic below. We need to update the TFS version and then migrate data from Azure DevOps Server to Azure DevOps Service. We recommend that you follow this GitHub ticket for more details.

enter image description here

Upvotes: 0

Related Questions