You need to enable JavaScript to run this app. VstsSyncMigrator V11.9.20如何配置以仅迁移指定状态的工作项
优惠活动
大模型
产品
解决方案
定价
更多

VstsSyncMigrator V11.9.20如何配置以仅迁移指定状态的工作项

问题根因

你当前的配置存在核心认知偏差:

  • 你编写的FieldValueMapConfig属于字段值转换规则,仅在工作项被选中进入迁移流程后,对指定字段的源值做匹配转换,完全不参与“哪些工作项需要被拉取迁移”的筛选环节。
  • 工具的默认拉取逻辑是:没有显式配置工作项查询规则时,直接拉取源端项目下的全量工作项,再逐字段应用映射规则做值转换。因此即便你只在映射规则里保留了Active的匹配项,工具依然会把所有状态的工作项拉取迁移,遇到不在映射列表里的状态(Proposed、Resolved)时,工具只会把对应字段的值置空,不会跳过该工作项,这就是迁移结果不符合预期的直接原因。
指定状态工作项的正确配置方式

V11.9.20版本的VstsSyncMigrator,对工作项迁移范围的筛选是通过WorkItemMigrationConfig节点下的WIQLQuery参数实现的,该参数直接对接源端TFS/Azure DevOps的工作项查询语法,支持任意自定义筛选条件,具体操作流程:

  1. 打开完整迁移配置文件,定位到WorkItemMigrationConfig配置段
  2. 找到该段下的WIQLQuery参数,替换为匹配你筛选需求的查询语句
  3. 保存配置后重新执行迁移即可

常见筛选需求的查询示例

  • 仅迁移Active状态的工作项:
"WIQLQuery": "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.State] = 'Active' AND [System.TeamProject] = '你的源端项目名称' ORDER BY [System.Id]"
  • 同时迁移多个指定状态(如Active、Resolved)的工作项:
"WIQLQuery": "SELECT [System.Id], [System.Title], [System.State] FROM WorkItems WHERE [System.State] IN ('Active', 'Resolved') AND [System.TeamProject] = '你的源端项目名称' ORDER BY [System.Id]"
配置注意事项
  • 之前使用的FieldValueMapConfig不需要为了筛选需求调整,它的作用是匹配源端和目标端的字段值差异(比如源端状态名是“In Progress”,要映射成目标端的“Active”时才需要配置),和筛选逻辑完全独立
  • 11.9.20版本如果未显式配置WIQLQuery,工具默认拉取源端指定项目下的全部工作项,和你之前执行全量迁移的默认逻辑一致
  • 配置查询时要替换为实际的源端项目名称,避免因为范围过大拉取其他项目的无关工作项
  • 如果要结合增量迁移场景,只需要在WIQL的WHERE条件中追加[System.ChangedDate] >= '上次全量迁移的完成时间',即可实现只拉取指定状态、且在指定时间后有变更的工作项

内容的提问来源于stack exchange,提问作者user14315777

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 01:45:04