文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试套管理/ 查询测试任务列表 - ShowTasks
更新时间:2025-12-27 GMT+08:00
分享

查询测试任务列表 - ShowTasks

功能介绍

此接口用于查询测试套列表,对应页面 测试 -> 测试执行 -> 测试套列表页

调用方法

请参见如何调用API

URI

POST /v4/{project_id}/versions/{version_uri}/tasks/batch-query

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

version_uri

String

版本URI

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

uris

Array of strings

测试任务URI集合

keyword

String

关键字查询,任务名或编号

tags

Array of strings

标签集合

service_type

Integer

参数解释:

服务类型

约束限制:

不涉及

取值范围:

  • -1,全量用例。

  • 0,手工测试。

  • 1,接口自动化。

  • 7,功能自动化。

  • 8,WebUI自动化。

  • 100,自定义自动化(工厂)。

  • 11,性能自动化。

默认取值:

不涉及

release_dev_list

Array of strings

发布版本号集合

result_codes

Array of strings

结果Code集合

status_codes

Array of strings

状态Code集合

owner_ids

Array of strings

责任人ID集合

executor_ids

Array of strings

执行者ID集合

creator_ids

Array of strings

创建者ID集合

sort_field

String

排序字段

sort_type

String

参数解释:

排序方式

约束限制:

不涉及

取值范围:

  • ASC,升序。

  • DESC,降序。

默认取值:

不涉及

page_no

Integer

当前页数

page_size

Integer

每页条数

is_polling_query

Boolean

是否轮询查询

is_query_associated_case_list

Boolean

是否获取关联用例列表

plan_start_start_timestamp

Long

计划开始时间过滤起始时间戳

plan_start_end_timestamp

Long

计划开始时间过滤结束时间戳

plan_end_start_timestamp

Long

计划结束时间过滤起始时间戳

plan_end_end_timestamp

Long

计划结束时间过滤结束时间戳

expiration_status_list

Array of integers

测试套超期状态过滤,超期状态值分别为:无状态(null)、未超期(0)、即将超期(1)、已超期(2)、延期完成(3)、按期完成(4)

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

value

TaskListVo object

查询测试任务列表结果

表4 TaskListVo

参数

参数类型

描述

tasks

Array of TaskVo objects

测试任务集合

running_count

Integer

正在执行任务数

表5 TaskVo

参数

参数类型

描述

uri

String

测试任务URI

name

String

测试任务名称

stage

String

测试阶段

number

String

编号

tags

String

标签

description

String

描述

region

String

区域

author_id

String

创建人ID

author_name

String

创建人名称

owner_id

String

责任人ID

owner_name

String

责任人名称

parent_uri

String

父任务URI

parent_path

String

父任务路径

origin_uri

String

源任务URI

version_uri

String

版本URI

version_name

String

版本名称

creation_date

String

创建时间

create_date_timestamp

Long

创建时间时间戳

update_time

String

更新时间

update_time_timestamp

Long

更新时间时间戳

relation_change_time

String

关联关系修改时时间

relation_change_time_timestamp

Long

关联关系修改时间时间戳

test_case_condition

String

动态任务用例过滤条件

updator_id

String

修改人Id

updator_name

String

修改人名称

relation_changer_id

String

关联关系修改人Id

service_type

Integer

参数解释:

服务类型ID

取值范围:

  • -1,全量用例。

  • 0,手工测试。

  • 1,接口自动化。

  • 7,功能自动化。

  • 8,WebUI自动化。

  • 100,自定义自动化(工厂)。

  • 11,性能自动化。

service_type_name

String

服务类型名称

tag_list

Array of strings

标签名称集合

module_id

String

模块ID

module_name

String

模块名称

module_path

String

模块path

module_path_name

String

模块路径名称

release_dev

String

发布版本号

ext_param

String

扩展参数

execute_way

Integer

执行方式(1:串行,2:并行)

execute_type

Integer

执行类型(0:冒烟,1:定时)

status_code

Integer

生命周期状态Code

status_name

String

生命周期状态名称

result_code

Integer

执行结果Code

result_name

String

执行状态名称

execute_status_code

Integer

Echo执行状态Code

execute_status_name

String

Echo执行状态名称

executor_id

String

执行人ID

executor_name

String

执行人名称

execute_latest_time

String

最近执行时间

execute_latest_time_timestamp

Long

最近执行时间时间戳

execute_duration

String

执行时长

execute_times

Integer

执行次数

project_id

String

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

case_operation_info

CaseOperationVo object

任务关联用例信息

assign_case_num

Integer

关联用例数

finish_case_num

Integer

已完成用例数量

assign_defect_num

Integer

关联缺陷数量

task_assign_msg

String

任务关联用例变更提示信息

iterator_version_uri

String

测试套所属迭代uri,非迭代下创建的测试套返回null

result_number_list

Array of NameAndValueVo objects

用户自定义结果对应的用例数目

finish_date

String

测试套完成时间

finish_date_timestamp

Long

测试套完成时间戳

plan_start_date

String

计划开始时间

plan_start_timestamp

Long

计划开始时间戳

plan_end_date

String

计划结束时间

plan_end_timestamp

Long

计划结束时间戳

expiration_status

Integer

测试套超期状态值,分别为:无状态(null)、未超期(0)、即将超期(1)、已超期(2)、延期完成(3)、按期完成(4)

expiration_status_name

String

测试套超期状态名称,分别为:无状态(不显示状态)、未超期(Unexpired)、即将超期(About to expire)、已超期(Expired)、延期完成(Delayed completion)、按期完成(On schedule completion)

表6 CaseOperationVo

参数

参数类型

描述

test_cases_info

Array of TaskAssignCaseVo objects

用例关联信息

set_up_cases_info

Array of TaskAssignCaseVo objects

前置用例关联信息

tear_down_cases_info

Array of TaskAssignCaseVo objects

后置用例关联信息

表7 TaskAssignCaseVo

参数

参数类型

描述

sort

Integer

排序顺序

case_uri

String

用例uri

is_available

Integer

是否可用

test_case_name

String

用例名称

test_case_number

String

用例编号

表8 NameAndValueVo

参数

参数类型

描述

name

String

参数解释:

名称

取值范围:

不涉及

value

Integer

参数解释:

取值范围:

不涉及

状态码:400

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:401

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:404

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

状态码:500

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

接口调用失败错误码

取值范围

不涉及

error_msg

String

参数解释

接口调用失败错误信息

取值范围

不涉及

请求示例

post https://{endpoint}/v4/9a5b66157ff44f6f80ce5f0fd1709f21/versions/v92s00010cmov0d6/tasks/batch-query

{
  "page_no" : 1,
  "page_size" : 15,
  "service_type" : -1
}

响应示例

状态码:200

OK

{
  "value" : {
    "tasks" : [ ],
    "running_count" : 0
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码

相关文档