能否将Testrail测试步骤同步至Azure DevOps缺陷的重现步骤?
实现Testrail测试步骤同步到Azure DevOps缺陷重现步骤的方法
这个需求完全可行,核心是通过编辑Testrail与Azure DevOps集成的自定义字段映射JSON配置实现,具体操作步骤如下:
1. 进入集成配置页面
登录Testrail后,依次进入「Admin」>「Integrations」,找到已配置的Azure DevOps集成,点击「Configure」进入配置页,定位到「Defect Fields Mapping」区域的「Edit Mapping」(一般是JSON编辑器入口)。
2. 编写字段映射规则
在JSON配置中,需要将Testrail的测试步骤数据映射到Azure DevOps缺陷工作项的「重现步骤」字段(ADO中默认内部名称为StepsToReproduce,如果是自定义字段需提前确认内部名称)。
核心配置示例
Testrail提供{{test_steps}}变量获取当前执行的结构化测试步骤数据,你需要将其格式化为ADO「重现步骤」支持的格式(该字段为富文本,优先用HTML渲染):
{ "defect_fields": [ { "testrail": "test_steps", "azure": "StepsToReproduce", "template": "<ol>{{#each test_steps}}<li><strong>步骤 {{index}}:</strong> {{content}}<br><em>预期结果:</em> {{expected}}</li>{{/each}}</ol>" }, // 保留已有的其他字段映射,比如标题、描述等 { "testrail": "title", "azure": "Title" } ] }
- 说明:用Handlebars模板语法遍历
{{test_steps}}数组,将每个步骤的操作内容和预期结果转为有序列表HTML,同步到ADO后会自动渲染为清晰的步骤结构。
如果ADO不支持HTML格式,可改用纯文本模板:
"template": "步骤列表:\n{{#each test_steps}}{{index}}. 操作: {{content}}\n 预期: {{expected}}\n{{/each}}"
3. 验证配置效果
保存JSON配置后,回到测试执行页面创建一个缺陷,检查Azure DevOps对应缺陷工作项的「重现步骤」区域,确认是否已正确填充Testrail的测试步骤。
注意事项
- 确认ADO字段内部名称:若使用自定义工作项模板,需在ADO的「Organization Settings」>「Process」>「缺陷」>「字段」中查看目标字段的内部名称。
- 检查Testrail版本兼容性:确保你的Testrail版本支持
{{test_steps}}变量,旧版本可能需要升级集成包。
4. 常见排障
- 同步后字段为空:检查JSON语法是否正确(比如括号、引号配对),或变量名称是否拼写错误。
- 格式混乱:调整Handlebars模板结构,匹配ADO富文本字段的渲染规则。
内容的提问来源于stack exchange,提问作者LiamPaddick
相关产品推荐
相关产品推荐

