You need to enable JavaScript to run this app. Jenkins中Xray连接器插件导入JUnit结果时如何为测试Issue设置自定义字段
优惠活动
大模型
产品
解决方案
定价
更多

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补充自定义字段:
    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'])
    
    这个配置生效的前提是Xray连接器插件版本不低于2.10,该版本开始会保留请求中的testFields节点并透传给Xray后端,低版本插件会自动丢弃这部分自定义节点。
  • 低版本插件的兜底实现方案
    如果当前使用的Xray连接器插件版本较低,无法透传testFields参数,可以在导入步骤执行完成后,通过流水线内的脚本调用Jira公开接口完成字段批量更新:
    1. 从Xray导入的返回结果中提取本次生成的Test Execution issue key
    2. 拉取该Test Execution下关联的全部Test issue key列表
    3. 循环调用Jira Issue更新接口,为每个Test issue写入需要补充的自定义字段值
      这个方案不受插件版本限制,适配性更强,仅会增加数秒的流水线执行耗时。

注意事项:不要把Test issue专属的字段(比如测试类型、步骤定义等)直接混写到Test Execution对应的fields节点中,Xray后端会自动校验字段所属的Issue类型,混写会直接触发接口参数校验错误,导致整个导入流程失败。插件文档没有对这部分透传逻辑做明确说明,也是很多用户遇到配置不生效的核心原因——插件仅默认把fields节点的内容绑定到Test Execution,对testFields这类Xray原生支持的参数没有做文档层面的同步。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.01 07:06:03