求助：Jira自动化创建Test类型问题时Zephyr Test Step字段报错

核心原因 #

Test类型问题绑定了Zephyr插件的Zephyr Test Step自定义字段（ID为xx），这个字段属于Zephyr的结构化字段，不在Jira自动化的可视化字段列表里，必须通过JSON高级模式配置才能填充。

具体解决步骤 #

1. 确认自定义字段ID #

• 打开Jira后台，进入设置 > 问题 > 自定义字段
• 找到Zephyr Test Step字段，点击「编辑」或查看详情，从URL里提取customfield_xxxx格式的ID（比如customfield_10012）

2. 切换到JSON模式配置创建问题的操作 #

在自动化规则的「创建问题」步骤里，点击切换到高级模式（JSON），替换成以下格式的内容：

{
  "fields": {
    "project": {
      "key": "PROJKEY" // 替换成你的项目KEY
    },
    "summary": "自动生成的测试用例",
    "issuetype": {
      "name": "Test"
    },
    "customfield_xxxx": [ // 替换成你的字段ID
      {
        "index": 1,
        "step": "执行测试步骤1的描述",
        "data": "测试输入数据（可选）",
        "result": "预期结果1"
      },
      {
        "index": 2,
        "step": "执行测试步骤2的描述",
        "data": "",
        "result": "预期结果2"
      }
    ]
  }
}

• 每个测试步骤是一个对象，index是步骤序号，step写步骤内容，result必须填写（因为是必填项的一部分），data可以留空

3. 验证和调试 #

保存规则后，手动触发一次状态流转测试。如果创建失败：

• 检查字段ID是否正确，不要写错数字
• 如果是Zephyr版本差异导致格式不兼容，可以先手动创建一个Test问题，然后调用Jira的REST API /rest/api/2/issue/{问题ID} 获取该问题的JSON结构，参考里面customfield_xxxx的格式来调整自动化配置

内容的提问来源于stack exchange，提问作者Skirmante Valentaite