如何从TFS迁移单个工作项至DevOps？查询配置异常问题咨询

完全可以迁移单个工作项，你遇到的问题大概率是WIQL查询的配置或语法未生效，按下面的方法调整即可：

• 先验证WIQL查询的有效性
  先在TFS的工作项查询编辑器里直接运行完整WIQL语句，确认只返回目标工作项：

  SELECT [System.Id], [System.Title], [System.WorkItemType] 
  FROM WorkItems 
  WHERE [System.Id] = 71863
  

  要是这里能正确返回单个项，说明查询本身没问题，问题出在迁移工具的配置上。

• 调整迁移工具的配置

  1. 优先用直接指定ID的方式：大部分迁移工具（比如Azure DevOps Migration Tool）支持在配置文件里直接定义WorkItemIDs数组，写法如下：

     "WorkItemIDs": [71863]
     

     这种方式比WIQL更直接，完全不会出现范围过滤错误的问题。
  2. 如果必须用WIQLQueryBit：检查配置里的基础查询是否和你的附加条件冲突。另外注意转义字符是否正确，把配置里的"替换为实际双引号，确保工具能正确解析，同时可以去掉工作项类型过滤（ID本身是唯一的，没必要多此一举）：

     "WIQLQueryBit": "AND [System.Id] = 71863"
     

• 排查加载大量工作项的原因
  如果还是加载大量项，说明你的WIQL条件没被正确应用：要么是配置项的键名错误（比如应该用WIQLQuery而非WIQLQueryBit，前者是完整查询，后者是附加到基础查询的条件），要么是工具配置优先级问题，比如你同时配置了查询范围和单个ID，工具优先读取了范围配置。

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