获取测试套关联用例详情 - ShowTaskAssignCasesFour

功能介绍

此接口用于查询测试套下已关联的用例,同页面测试 -> 测试执行 -> 单击测试套详情 -> 显示关联的用例

调用方法

URI

POST /v4/{project_id}/tasks/{task_uri}/testcases/batch-query

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
task_uri	是	String	任务uri

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
stage	否	Integer	测试用例在任务中的阶段
owners	否	Array of strings	处理人过滤数组
page_no	否	Integer	页码
page_size	否	Integer	页数量，取值范围[1,1000]
results	否	Array of strings	结果过滤
status	否	Array of strings	状态过滤
version_uri	否	String	分支/迭代uri
release_dev	否	String	任务版本过滤条件，影响关联任务的结果查询，查询当前任务版本下的用例最新结果
sort_field	否	String	排序字段
sort_type	否	String	参数解释: 排序方法约束限制: 不涉及取值范围: ASC，升序。 DESC，降序。默认取值: 不涉及
feature_uri	否	String	特性目录URI
task_result_uri	否	String	测试套结果uri
rank_ids	否	Array of integers	用例等级ID集合
key_word	否	String	关键字
issue_id	否	String	需求id
associated_issue	否	Boolean	是否关联需求（null：不限，false：未关联，true：已关联）
select_all_pages	否	Boolean	是否全选所有页（null：不全选，false：不全选，true：全选），用于任务批量执行结果功能，只返回用例uri，不返回其他信息
is_available	否	Boolean	用例是否可用
is_script_exist	否	Boolean	用例脚本字段是否有值
is_contain_child	否	Boolean	是否包含子目录,默认为true

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
value	Array of TaskAssignCaseDetailVo objects	获取测试套关联用例详情返回参数

表4 TaskAssignCaseDetailVo
参数	参数类型	描述
uri	String	关联关系uri
sort	Integer	排序顺序
owner	String	责任人id
stage	Integer	测试阶段
project_id	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
task_uri	String	任务uri
update_time	String	更新时间
updator_name	String	更新人
updator	String	更新人id
case_uri	String	用例uri
is_available	Integer	是否可用
test_case_name	String	用例名称
feature_uri	String	用例目录Uri
test_case_number	String	用例编号
svn_script_path	String	脚本路径
status_code	String	状态
status_name	String	状态名称
result_code	String	结果id
result_name	String	结果名称
owner_name	String	责任人名称
execute_latest_time	String	最新执行时间
execute_duration	String	执行时长
is_keyword	Integer	是否是关键用例
net_work_script_name	String	脚本名称
rank_id	Integer	用例等级
remark	String	描述

状态码：400

表5 响应Body参数
参数	参数类型	描述
error_code	String	接口调用失败错误码
error_msg	String	接口调用失败错误信息

状态码：401

表6 响应Body参数
参数	参数类型	描述
error_code	String	接口调用失败错误码
error_msg	String	接口调用失败错误信息

状态码：404

表7 响应Body参数
参数	参数类型	描述
error_code	String	接口调用失败错误码
error_msg	String	接口调用失败错误信息

状态码：500

表8 响应Body参数
参数	参数类型	描述
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
  } ]
}