使用不同的参考名称迁移工作项。有没有办法更改工作项类型的字段引用名称或设置自定义引用名称？

Posted 2023-03-22

【中文标题】使用不同的参考名称迁移工作项。有没有办法更改工作项类型的字段引用名称或设置自定义引用名称？

【英文标题】：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?

【发布时间】：2021-04-29 13:52:01

【问题描述】：

我正在尝试使用 VSTS 同步迁移器 (https://nkdagility.github.io/azure-devops-migration-tools) 将工作项从 TFS 服务器迁移到 Azure DevOps 云。我的大部分项目都能正常迁移，但我注意到描述没有出现。经过一番调查，我看到原始 TFS 服务器有一个“描述”字段，其引用名称为“Common.Descriptionhtml”。 ADO 云中“描述”的默认字段设置为“System.Description”。我认为这就是他们不同步的原因。 （见附图：顶部是 ADO 云，底部是原始 TFS 服务器）

有没有办法将 ADO 云中的字段引用名称修改/更改为“Common.DescriptionHtml”。如果没有，那么我可以创建一个新字段并将其字段引用名称自定义为“Common.DescriptionHtml”，以便将其与 TFS 服务器中的原始字段匹配。

如果上述不可行，如果我更改原始 TFS 服务器中“描述”字段的引用类型，是否会损坏或影响该 TFS 服务器上“描述”字段的原始数据？ 是的，我对此很陌生。

【问题讨论】：

您是否查看了该工具的文档并在 GitHub 项目的问题页面上提出了问题？

我做到了。只是想知道我是否可以更改或更新字段参考。

【参考方案1】：

您可以使用 VSTS 同步迁移器重新映射字段，方法是在迁移配置 json 文件中配置 FieldtoFieldMapConfig 字段映射。

在你的情况下，它看起来像这样：

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

他们在此处的文档中有更多可用的 FieldMap 示例：

https://nkdagility.github.io/azure-devops-migration-tools/getting-started.html

【参考方案2】：

我们建议您使用 migration guide and tool 将数据从 Azure DevOps Server 迁移到 Azure DevOps Services。

Azure DevOps 的数据迁移工具在给定时间支持两个最新版本的 Azure DevOps Server。版本包括更新和主要版本。目前支持导入以下版本的 Azure DevOps Server：

Azure DevOps 服务器 2020

Azure DevOps 服务器 2019.1.1

根据您分享的屏幕截图，您似乎使用的是 TFS2018，请参考此文档Upgrade your deployment to the latest version of Azure DevOps Server 更新您的 TFS 版本，然后参考此doc to migrate data from Azure DevOps Server to Azure DevOps Services。

更新1

我们无法更改或更新字段引用，在 TFS2019 和最新版本中，字段引用已重命名为System.Description，请查看下图。我们需要更新 TFS 版本，然后将数据从 Azure DevOps Server 迁移到 Azure DevOps Service。我们建议您关注此GitHub ticket 了解更多详情。

【讨论】：

负责原始 TFS 服务器的经理不想修改或更新它，所以这就是我走这条路的原因。

嗨@ErnieAndBert，我们无法更改或更新 Azure DevOps 服务器或 Azure DevOps 服务中的字段引用，我已经更新了答案，请检查更新1