DevOps工作项迁移后Stakeholder字段与看板列未更新的修复咨询

1. 检查迁移工具的字段映射配置 #

• 确认Stakeholder（identity类型）的字段映射是否正确：
  • 核对源环境和目标环境的字段引用名（而非显示名，自定义字段通常为Custom.Stakeholder格式）是否完全匹配
  • 确认迁移工具支持identity类型字段同步，部分工具需显式开启身份字段同步开关
• 以Azure DevOps Migration Tools为例，可在配置文件中添加/修正映射规则：

  {
    "FieldMaps": [
      {
        "ObjectType": "VstsSyncMigrator.Engine.Configuration.FieldMap.IdentityFieldMapConfig",
        "SourceField": "Custom.Stakeholder",
        "TargetField": "Custom.Stakeholder",
        "MergeType": "Merge",
        "DisplayName": "Stakeholder Identity Map"
      }
    ]
  }
  

2. 修正看板列与状态的关联配置 #

• 看板列依赖工作项State字段绑定，先确认目标环境看板列已和对应工作项状态正确关联：
  进入目标项目看板设置，检查每个列绑定的工作项状态是否与源环境一致
• 配置迁移工具的状态映射规则，确保源状态能对应到目标看板列关联的状态：

  {
    "WorkItemTypeDefinition": {
      "Bug": {
        "StateMaps": [
          {
            "SourceState": "New",
            "TargetState": "New",
            "TargetColumn": "New"
          }
        ]
      }
    }
  }
  

3. 强制触发全量迁移 #

• 多数迁移工具默认跳过已迁移工作项（通过ID或迁移标记判断），需强制重新处理：
  • 删除工具的迁移缓存文件（如Azure DevOps Migration Tools的MigrationState.json）
  • 在运行参数中添加强制更新开关（如--force），或修改配置文件中ReplayRevisions为true

4. 验证目标环境的权限与字段配置 #

• 确认迁移服务账号拥有目标环境的权限：
  • 工作项自定义字段的编辑权限
  • 看板列配置与工作项状态分配权限
• 检查Stakeholder字段是否已添加到目标工作项类型的布局中，确保字段可见且可编辑

5. 手动测试排查单个工作项 #

• 选一个未正确更新的工作项，手动尝试设置Stakeholder字段并分配到对应看板列：
  • 若手动操作失败，说明目标环境的字段/看板配置存在问题（如字段未关联工作项类型、看板列未绑定状态）
  • 若手动操作成功，说明迁移工具配置或运行逻辑有问题，需进一步查看工具日志定位错误

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