Jenkins中Xray连接器插件导入JUnit结果时如何为测试Issue设置自定义字段
XrayImportBuilder 自动生成Test issue的字段配置方案
首先明确你当前遇到的配置边界:现有importInfo参数的JSON结构仅作用于Test Execution issue的字段填充,这是Xray连接器插件的默认运行逻辑,并非配置错误。要实现自动生成Test issue的自定义字段补充,可通过以下几种可落地的方式实现:
- 利用Xray内置的测试元数据映射能力
JUnit类型的测试结果导入流程中,Xray支持从surefire报告的XML元数据中提取自定义值,在自动创建/关联Test issue时自动回填对应字段。你只需要在Jira侧的Xray全局导入配置中,提前定义好元数据值到Test issue自定义字段的映射规则,不需要修改Jenkins流水线脚本:- 针对单条测试用例差异化的字段值(比如不同用例的测试优先级、归属模块),可以在Java测试代码中通过JUnit注解、自定义测试属性的方式把值写入surefire报告的XML元数据节点,导入时会自动按规则匹配到对应Test issue的字段
- 针对所有本次导入的Test issue统一生效的固定字段值,可以直接调整
importInfo的JSON结构,在顶层追加独立的testFields节点。这个节点下定义的字段配置,会被插件透传给Xray后端,在创建Test issue时自动填充。
可以参考如下调整后的配置示例,给自动生成的Test issue补充自定义字段:
这个配置生效的前提是Xray连接器插件版本不低于2.10,该版本开始会保留请求中的step([$class: 'XrayImportBuilder', endpointName: '/junit/multipart', testPlanKey: 'CL-25466', importFilePath: '**/target/surefire-reports/**/*.xml', importInfo: '''{ "fields": { "project": { "key": "CL" }, "components": [{ "name": "123" }], "summary": "Test Execution for java junit" }, "testFields": { "customfield_10086": "Jenkins流水线自动导入", "customfield_10090": { "value": "核心业务域" } } }''', importToSameExecution: 'true', inputInfoSwitcher: 'fileContent', serverInstance: '123435567678123435567678123435567678'])testFields节点并透传给Xray后端,低版本插件会自动丢弃这部分自定义节点。 - 低版本插件的兜底实现方案
如果当前使用的Xray连接器插件版本较低,无法透传testFields参数,可以在导入步骤执行完成后,通过流水线内的脚本调用Jira公开接口完成字段批量更新:- 从Xray导入的返回结果中提取本次生成的Test Execution issue key
- 拉取该Test Execution下关联的全部Test issue key列表
- 循环调用Jira Issue更新接口,为每个Test issue写入需要补充的自定义字段值
这个方案不受插件版本限制,适配性更强,仅会增加数秒的流水线执行耗时。
注意事项:不要把Test issue专属的字段(比如测试类型、步骤定义等)直接混写到Test Execution对应的
fields节点中,Xray后端会自动校验字段所属的Issue类型,混写会直接触发接口参数校验错误,导致整个导入流程失败。插件文档没有对这部分透传逻辑做明确说明,也是很多用户遇到配置不生效的核心原因——插件仅默认把fields节点的内容绑定到Test Execution,对testFields这类Xray原生支持的参数没有做文档层面的同步。
内容的提问来源于stack exchange,提问作者Jake2Finn
相关产品推荐
相关产品推荐

