TestRail迁移至Jira X-Ray云版：API关联测试用例与前置条件疑问

针对你遇到的X-Ray云版测试用例和前置条件关联问题，有两个可行的适配云版环境的方案：

1. 使用X-Ray云版GraphQL API关联 #

X-Ray云版官方推荐用GraphQL API处理这类专属关联操作，服务器版的REST API确实不适配云版。你可以调用linkPreconditionToTest mutation来建立关联：

mutation {
  linkPreconditionToTest(
    testIssueId: "TEST-123",  # 替换为你的测试用例Issue ID
    preconditionIssueId: "PRE-456"  # 替换为你的前置条件Issue ID
  ) {
    success  # 返回true表示关联成功
    warnings # 关联过程中的警告信息
  }
}

调用该接口后，测试用例与前置条件的关联关系会被X-Ray系统记录，在测试用例的X-Ray面板中即可看到关联的前置条件。

2. 通过Jira REST API更新测试用例的自定义字段 #

X-Ray云版会给测试用例添加一个专门存储前置条件的自定义字段，字段名通常为Preconditions，你可以通过Jira的字段查询接口（GET /rest/api/3/field）找到对应的字段ID（格式类似customfield_xxxxxx）。

找到字段ID后，用Jira标准REST API更新测试用例的这个字段，传入前置条件的Issue Key数组即可：

curl -X PUT \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JIRA_CLOUD_TOKEN" \
  "https://your-domain.atlassian.net/rest/api/3/issue/TEST-123" \
  -d '{
    "fields": {
      "customfield_xxxxxx": ["PRE-456"]  # 替换为你的前置条件Issue Key，支持多个值
    }
  }'

补充说明 #

你之前查看XML未找到关联记录，是因为X-Ray云版的测试用例与前置条件的关联并非存储在Jira的标准问题链接中，而是存在X-Ray专属字段或GraphQL维护的关联关系里，常规XML导出不会包含这些专属数据。

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