文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试套管理/ 获取测试套关联用例详情 - ShowTaskAssignCasesFour
更新时间：2025-12-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

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

功能介绍

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

调用方法

请参见如何调用API。

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

OK

{
  "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

错误码

请参见错误码。

父主题： 测试套管理

相关文档