获取测试套关联用例详情 - ShowTaskAssignCasesFour
功能介绍
此接口用于查询测试套下已关联的用例,同页面 测试 -> 测试执行 -> 点击测试套详情 -> 显示关联的用例
调用方法
请参见如何调用API。
URI
POST /v4/{project_id}/tasks/{task_uri}/testcases/batch-query
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID |
| task_uri | 是 | String | 任务uri |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| stage | 否 | Integer | 参数解释 测试用例在任务中的阶段，用于按阶段过滤用例 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| owners | 否 | Array of strings | 参数解释 处理人过滤数组，数组中每个元素为处理人ID，长度小于128个字符的字符串 约束限制 不涉及 |
| page_no | 否 | Integer | 参数解释 页码 约束限制 不涉及 取值范围 1-100的正整数 默认取值 不涉及 |
| page_size | 否 | Integer | 参数解释 页数量 约束限制 不涉及 取值范围 1-20000的正整数 默认取值 不涉及 |
| results | 否 | Array of strings | 参数解释 按用例执行结果过滤，数组中每个元素为结果Code，用于筛选指定执行结果的用例 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| status | 否 | Array of strings | 参数解释 按用例状态过滤，数组中每个元素为状态Code，用于筛选指定状态的用例 约束限制 不涉及 取值范围 不涉及 默认取值 不涉及 |
| version_uri | 否 | String | 参数解释 分支/迭代uri，用于指定查询用例所属的分支或测试计划。获取方式请参见获取分支列表接口或查询测试计划列表接口 约束限制 不涉及 取值范围 11-34位字母、数字组成的字符串 默认取值 不涉及 |
| release_dev | 否 | String | 参数解释 任务版本过滤条件，影响关联任务的结果查询，查询当前任务版本下的用例最新结果 约束限制 不涉及 取值范围 由字母、数字、特定符号或汉字组成，且长度限制在0到32个字符之间 默认取值 不涉及 |
| sort_field | 否 | String | 参数解释 排序字段，支持按用例名称、用例编号、结果等字段排序 约束限制 不涉及 取值范围 由字母、数字组成，长度小于128个字符的字符串 默认取值 不涉及 |
| sort_type | 否 | String | 参数解释: 排序方式 约束限制: 不涉及 取值范围: 默认取值: 无 |
| feature_uri | 否 | String | 参数解释 特性目录URI，用于按目录范围过滤用例。获取方式请参见获取特性树接口 约束限制 不涉及 取值范围 11-34位字母、数字组成的字符串 默认取值 不涉及 |
| task_result_uri | 否 | String | 参数解释 测试套结果uri，用于指定查询的测试套执行结果。获取方式请参见查询测试任务列表接口 约束限制 不涉及 取值范围 11-34位字母、数字组成的字符串 默认取值 不涉及 |
| rank_ids | 否 | Array of integers | 参数解释: 用例等级过滤数组，数组中每个元素为用例等级ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| key_word | 否 | String | 参数解释 关键字，用于模糊搜索用例名称或编号 约束限制 不涉及 取值范围 由中文字符、英文字母、数字及特殊字符组成，长度小于128个字符的字符串 默认取值 不涉及 |
| issue_id | 否 | String | 参数解释 关联的需求ID，用于过滤关联了指定需求的用例。获取方式请参见查询需求列表接口 约束限制 不涉及 取值范围 长度小于128个字符的字符串 默认取值 不涉及 |
| associated_issue | 否 | Boolean | 参数解释 是否关联需求 约束限制 不涉及 取值范围 （null：不限，false：未关联，true：已关联） 默认取值 不涉及 |
| select_all_pages | 否 | Boolean | 参数解释 是否全选所有页 约束限制 不涉及 取值范围 （null：不全选，false：不全选，true：全选），用于任务批量执行结果功能，只返回用例uri，不返回其他信息 默认取值 不涉及 |
| is_available | 否 | Boolean | 参数解释 用例是否可用 约束限制 不涉及 取值范围 true:可用 false:不可用 默认取值 不涉及 |
| is_script_exist | 否 | Boolean | 参数解释 用例脚本字段是否有值 约束限制 不涉及 取值范围 true:有值 false:无值 默认取值 不涉及 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| value | Array of TaskAssignCaseDetailVo objects | 获取测试套关联用例详情返回参数 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| uri | String | 参数解释 关联关系uri 取值范围 不涉及 |
| sort | Integer | 参数解释 排序顺序 取值范围 不涉及 |
| owner | String | 参数解释 责任人id 取值范围 长度小于128个字符的字符串 |
| stage | Integer | 参数解释 测试阶段 取值范围 不涉及 |
| project_uuid | String | 参数解释 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 取值范围 不涉及 |
| task_uri | String | 参数解释 任务uri 取值范围 11-34位字母、数字组成的字符串 |
| update_time | String | 参数解释 更新时间，格式为yyyy-MM-dd HH:mm:ss |
| updator_name | String | 参数解释 更新人 取值范围 长度小于128个字符的字符串 |
| updator | String | 参数解释 更新人id 取值范围 长度小于128个字符的字符串 |
| case_uri | String | 参数解释 用例uri 取值范围 11-34位字母、数字组成的字符串 |
| is_available | Integer | 参数解释 是否可用 取值范围 不涉及 |
| test_case_name | String | 参数解释 用例名称 取值范围 长度小于128个字符的字符串 |
| feature_uri | String | 参数解释 用例目录Uri 取值范围 11-34位字母、数字组成的字符串 |
| test_case_number | String | 参数解释 用例编号 取值范围 长度小于128个字符的字符串 |
| svn_script_path | String | 参数解释 脚本路径 取值范围 长度小于128个字符的字符串 |
| status_code | String | 参数解释 状态 取值范围 不涉及 |
| status_name | String | 参数解释 状态名称 取值范围 长度小于128个字符的字符串 |
| result_code | String | 参数解释 结果id 取值范围 不涉及 |
| result_name | String | 参数解释 结果名称 取值范围 长度小于128个字符的字符串 |
| owner_name | String | 参数解释 责任人名称 取值范围 长度小于128个字符的字符串 |
| execute_latest_time | String | 参数解释 最新执行时间，格式为yyyy-MM-dd HH:mm:ss |
| execute_duration | String | 参数解释 执行时长，单位为毫秒 取值范围 不涉及 |
| is_keyword | Integer | 参数解释 是否是关键用例 取值范围 不涉及 |
| net_work_script_name | String | 参数解释 脚本名称 取值范围 长度小于128个字符的字符串 |
| rank_id | Integer | 参数解释 用例等级 取值范围 不涉及 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 接口调用失败错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 接口调用失败错误信息 取值范围: 不涉及 |
请求示例
post https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/tasks/v90100010gmi4h0j/testcases/batch-query
{
"page_no" : 1,
"page_size" : 15,
"results" : [ ],
"status" : [ ],
"version_uri" : "v90200010aelu5om",
"owners" : [ ],
"rank_ids" : [ ]
} 响应示例
状态码：200
{
"value" : [ {
"uri" : "v90100010gmi4sgs",
"sort" : 1,
"owner" : "",
"stage" : 1,
"project_id" : "407ac57de7ea44d28e47293a2b9cf15c",
"task_uri" : "v90100010gmi4h0j",
"update_time" : "2025-05-29 10:25:40",
"updator_name" : "sec_admin——nich",
"updator" : "2ce06fffb4634271a377c1cd7c429704",
"case_uri" : "v90410b5o5ce22a7",
"is_available" : 1,
"test_case_name" : "cx_2995",
"test_case_number" : "7417",
"status_code" : "7",
"status_name" : "完成",
"result_code" : "1",
"result_name" : "失败",
"is_keyword" : 0,
"rank_id" : 2
}, {
"uri" : "v90110gmi4sgsf2e",
"sort" : 2,
"owner" : "",
"stage" : 1,
"project_id" : "407ac57de7ea44d28e47293a2b9cf15c",
"task_uri" : "v90100010gmi4h0j",
"update_time" : "2025-05-29 10:25:39",
"updator_name" : "sec_admin——nich",
"updator" : "2ce06fffb4634271a377c1cd7c429704",
"case_uri" : "v90200010gmhoo73",
"is_available" : 1,
"test_case_name" : "sdw",
"test_case_number" : "7421",
"status_code" : "0",
"status_name" : "新建",
"result_name" : "未执行",
"is_keyword" : 0,
"rank_id" : 2
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 401 | Unauthorized |
| 404 | Not Found |
| 500 | Internal Server Error |
错误码
请参见错误码。
