TFS2017 Server使用UpdateDefinitionAsync为批量生成定义添加步骤遇Steps空问题
TFS 2017 批量新增生成步骤的落地方案
核心问题原因
你遇到的Steps属性为空是16.153版本TFS客户端SDK的正常表现:该版本SDK中BuildDefinition.Steps属性已被官方标记为弃用,不再参与新旧生成定义schema的映射,所有实际存储生成步骤的节点都被归到Process属性下,对应你从服务端拉取的JSON中看到的存放在build属性下的流程内容,SDK反序列化时不会自动读取这块内容,所以直接转成强类型对象后必然拿不到原有步骤。
可落地的修改方案
- 调整反序列化逻辑,绕过SDK对旧版流程节点的自动映射缺陷
不要直接把拉取到的JSON裸转成BuildDefinition对象就提交,先用JObject手动操作流程节点内容,再转成SDK要求的强类型对象,避免原有步骤被过滤:- 把服务端返回的原始JSON解析为可操作的JObject,手动提取存了原有步骤的流程节点(也就是你看到的
build字段,对应SDK定义里的Process节点) - 按照TFS2017兼容的任务格式,构造要新增的生成步骤对象,包含任务ID、版本号、显示名、启用状态、输入参数这些必填字段
- 把新构造的步骤插入到原有步骤数组的末尾,修改完的流程节点重新塞回JObject中
- 最后再把修改后的JObject反序列化为SDK要求的
BuildDefinition对象,此时Process属性会被正常识别,原有步骤和新增步骤都会被保留
- 把服务端返回的原始JSON解析为可操作的JObject,手动提取存了原有步骤的流程节点(也就是你看到的
- 参考核心代码片段:
// 解析服务端返回的原始定义JSON var rawDefJson = JObject.Parse(downloadedDefinitionJson); // 提取原有流程节点,兼容旧版JSON的build字段和新版的process字段 var processNode = rawDefJson["process"] ?? rawDefJson["build"]; // 构造新增的生成步骤,格式完全匹配TFS2017的任务要求 var customStep = new JObject { ["enabled"] = true, ["displayName"] = "自定义生成步骤", ["task"] = new JObject { ["id"] = "目标任务的GUID值", ["versionSpec"] = "任务版本号,如1.*" }, ["inputs"] = new JObject() }; // 追加新步骤到原有步骤数组 (processNode["steps"] as JArray)?.Add(customStep); // 将修改后的流程节点写回JSON对象 rawDefJson["process"] = processNode; // 转为SDK要求的BuildDefinition对象,用于提交更新 var definitionToUpdate = rawDefJson.ToObject<BuildDefinition>();
批量处理500个生成定义的注意事项
- 提交更新时不要漏传
Revision字段:该字段是定义的当前版本号,从服务端拉取的原始JSON中自带该值,反序列化时不要丢失,否则会触发服务端的版本冲突校验,导致更新失败 - 控制请求并发量:按每批10-20个定义的频率处理,不要全量并发请求,TFS2017服务端的默认IIS连接数有限制,过高的并发会被直接拒绝
- 先做小范围验证:挑1-2个测试用的生成定义跑通全流程,确认提交后服务端的定义里正确出现新增步骤、原有步骤没有丢失,再跑全量批量任务
- 增加处理日志:每处理一个定义记录成功/失败状态和定义ID,遇到失败的单独重试,无需全量重复执行
注意:不要往弃用的
Steps属性里塞新增步骤内容,SDK在序列化请求时会自动过滤这个标记了Obsolete的属性,塞了也不会被提交到服务端。
内容的提问来源于stack exchange,提问作者arch
相关产品推荐
相关产品推荐

