VstsSyncMigrator V11.9.20如何配置以仅迁移指定状态的工作项
问题根因
你当前的配置存在核心认知偏差:
- 你编写的
FieldValueMapConfig属于字段值转换规则,仅在工作项被选中进入迁移流程后,对指定字段的源值做匹配转换,完全不参与“哪些工作项需要被拉取迁移”的筛选环节。 - 工具的默认拉取逻辑是:没有显式配置工作项查询规则时,直接拉取源端项目下的全量工作项,再逐字段应用映射规则做值转换。因此即便你只在映射规则里保留了Active的匹配项,工具依然会把所有状态的工作项拉取迁移,遇到不在映射列表里的状态(Proposed、Resolved)时,工具只会把对应字段的值置空,不会跳过该工作项,这就是迁移结果不符合预期的直接原因。
指定状态工作项的正确配置方式
V11.9.20版本的VstsSyncMigrator,对工作项迁移范围的筛选是通过WorkItemMigrationConfig节点下的WIQLQuery参数实现的,该参数直接对接源端TFS/Azure DevOps的工作项查询语法,支持任意自定义筛选条件,具体操作流程:
- 打开完整迁移配置文件,定位到
WorkItemMigrationConfig配置段 - 找到该段下的
WIQLQuery参数,替换为匹配你筛选需求的查询语句 - 保存配置后重新执行迁移即可
常见筛选需求的查询示例
- 仅迁移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
相关产品推荐
相关产品推荐

