Azure DevOps工作项迁移时「ReflectedWorkItemIDFieldName」配置错误的正确值获取咨询

针对你用azure-devops-migration-tools迁移Parts Unlimited项目时碰到的TF51005错误，我整理了一套针对性的排查和解决步骤——毕竟这个项目是Azure DevOps Demo Generator生成的定制化Scrum项目，默认可能没有迁移所需的字段：

1. 先确认目标项目里有没有这个字段 #

首先得去你的目标Azure DevOps项目里查一下，是否已经存在ReflectedWorkItemId相关字段：

• 登录目标项目，进入项目设置 → 工作 → 工作项类型
• 选你要迁移的工作项类型（比如User Story、Bug），切换到字段标签页
• 搜索字段的时候注意：显示名称可能是带空格的Reflected Work Item ID，而工具配置需要的是字段引用名（比如Custom.ReflectedWorkItemId这种格式）

2. 获取正确的字段引用名 #

如果找到了这个字段，一定要用它的引用名来配置，而不是显示名称：

• 点击字段名称进入详情页，复制页面上的「引用名」
• 把这个值粘贴到你的configuration.json的"ReflectedWorkItemIDFieldName"中，比如：

  "ReflectedWorkItemIDFieldName": "Custom.ReflectedWorkItemId"
  

3. 没有字段就手动创建一个 #

如果目标项目里完全找不到这个字段，那你需要先创建一个自定义字段：

• 进入项目设置 → 工作 → 字段 → 新建字段
• 字段名称填Reflected Work Item ID，类型选「字符串」，然后勾选所有需要迁移的工作项类型
• 创建完成后，同样复制它的引用名，填入配置文件

4. 针对Parts Unlimited的额外提醒 #

因为这个项目是Demo Generator生成的定制版Scrum项目，默认是不带迁移所需的ReflectedWorkItemId字段的，所以大概率你需要走步骤3来创建字段。另外要注意，Azure DevOps的字段引用名是区分大小写的，复制的时候要完全匹配，别写错大小写导致工具找不到字段。

修改完配置后重启迁移工具，应该就能解决这个查询错误了。

内容的提问来源于stack exchange，提问作者bcochofel