文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试套管理/ 初始化测试任务执行记录 - InitExecuteTask
更新时间：2026-10-22 GMT+08:00
在线调试
CLI示例
查看PDF
分享

初始化测试任务执行记录 - InitExecuteTask

功能介绍

此接口用于初始化指定项目测试任务的执行记录，根据入参的project_uuid定位项目、task_uri指定测试任务，支持传入version_uri关联版本信息，实现测试任务的记录创建和初始化。

调用方法

请参见如何调用API。

URI

POST /v4/{project_id}/tasks/{task_uri}/results/init

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

task_uri

是

String

任务uri

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

release_dev

否

String

版本信息

version_uri

否

String

分支/迭代uri

is_query

否

Boolean

是否只查询，不初始化（如果不存在）

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

total

Integer

起始记录数 大于 实际总条数时， 值为0， 分页请求才有此值

value

ExecuteTaskVo object

实际的数据类型：单个对象，集合 或 NULL

reason

String

业务失败的提示内容

page_size

Integer

每页展示条数

page_no

Integer

页码

has_more

Boolean

是否有更多
表4 ExecuteTaskVo

参数

参数类型

描述

flag

Boolean

标志

uri

String

URI

task_result_vo

TaskResultVo object

实际的数据类型：单个对象，集合 或 NULL

update_case_uri_list

Array of strings

更新用例

test_case_result_list

Array of TestResultVo objects

用例结果列表
表5 TaskResultVo

参数

参数类型

描述

uri

String

URI

name

String

测试套名称

description

String

描述

owner

String

责任人

creator

String

创建人id

updator

String

更新人

task_uri

String

任务uri

owner_name

String

责任人名称

release_dev

String

发布版本号

version_uri

String

分支/迭代uri

creator_name

String

创建人名称

create_time

String

创建时间

create_time_timestamp

Long

创建时间时间戳

updator_name

String

更新人名称

update_time

String

更新时间

update_time_timestamp

Long

更新时间时间戳

start_time

String

开始时间

start_time_timestamp

Long

开始时间时间戳

end_time

String

结束时间

end_time_timestamp

Long

开始时间时间戳

result_code

Integer

执行结果Code

result_name

String

测试结果名称

finish_flg

Integer

测试任务是否执行完成（0：未完成，1：已完成）

project_uuid

String

项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
表6 TestResultVo

参数

参数类型

描述

uri

String

参数解释

用例执行结果的唯一标识URI

取值范围

11-34位字母及数字

name

String

参数解释

用例结果名称，用于标识本次用例执行的结果记录

取值范围

不涉及

author

String

参数解释

用例结果创建人的用户ID

取值范围

不涉及

rank

Integer

参数解释

用例的优先级级别

取值范围

  • 0：Priority 0

  • 1：Priority 1

  • 2：Priority 2

  • 3：Priority 3

  • 4：Priority 4

result

Integer

参数解释

测试结果Code，用于标识用例的执行结果

取值范围

不涉及

round

Integer

参数解释

用例执行的批次编号

取值范围

大于等于1的整数

preparation

String

参数解释

用例执行的前置条件

取值范围

不涉及

description

String

参数解释

用例结果描述

取值范围

不涉及

region

String

参数解释

用例结果所属的逻辑Region

取值范围

不涉及

steps

Array of ResultStepVo objects

参数解释

用例执行的步骤列表，每个步骤包含步骤内容、预期结果和实际结果，具体请参见ResultStepVo数据结构

取值范围

不涉及

number

String

参数解释

用例结果编号

取值范围

不涉及

author_name

String

参数解释

用例结果创建人的用户名称

取值范围

不涉及

begin_time

String

参数解释

用例执行的开始时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

begin_time_timestamp

Long

参数解释

执行开始时间的时间戳，单位为毫秒

取值范围

不涉及

end_time

String

参数解释

用例执行的结束时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

end_time_timestamp

Long

参数解释

执行结束时间的时间戳，单位为毫秒

取值范围

不涉及

creation_date

String

参数解释

用例结果创建时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

creation_date_timestamp

Long

参数解释

用例结果创建时间的时间戳，单位为毫秒

取值范围

不涉及

last_modified

String

参数解释

最后修改时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

last_modified_timestamp

Long

参数解释

最后修改时间的时间戳，单位为毫秒

取值范围

不涉及

last_change_time

String

参数解释

用例结果最后变更的时间，格式为yyyy-MM-dd HH:mm:ss

取值范围

不涉及

last_change_time_timestamp

Long

参数解释

最后变更时间的时间戳，单位为毫秒

取值范围

不涉及

dfx_test_result

String

参数解释

DFX测试结果

取值范围

不涉及

failure_cause

String

参数解释

用例执行失败的原因

取值范围

不涉及

parent_uri

String

参数解释

父节点的唯一标识，为分支用例URI或迭代用例URI，用于标识当前用例结果所属的父级用例

取值范围

不涉及

test_case_uri

String

参数解释

分支用例的唯一标识

取值范围

不涉及

test_case_name

String

参数解释

测试用例的名称

取值范围

不涉及

task_uri

String

参数解释

测试任务的唯一标识

取值范围

不涉及

result_name

String

参数解释

测试结果的中文名称，如通过、失败等

取值范围

不涉及

test_result_ae

String

参数解释

是否自动化执行

取值范围

  • '0'：非自动化执行

  • '1'：自动化执行

executor_id

String

参数解释

执行该用例的用户的唯一标识

取值范围

不涉及

executor_name

String

参数解释

执行该用例的用户名称

取值范围

不涉及

task_id

String

参数解释

执行机任务ID

取值范围

不涉及

execute_id

String

参数解释

执行ID

取值范围

不涉及

time_cost

Integer

参数解释

执行耗时，单位为毫秒

取值范围

不涉及

step_txt

String

参数解释

用例执行的测试步骤文本内容

取值范围

不涉及

step_expect

String

参数解释

测试步骤期望结果

取值范围

不涉及

step_actual

String

参数解释

测试步骤的实际执行结果描述

取值范围

不涉及

step_result

String

参数解释

测试步骤的执行结果状态

取值范围

不涉及

release_dev

String

参数解释

版本号

取值范围

不涉及

creation_version_uri

String

参数解释

创建版本URI

取值范围

不涉及

version_uri

String

参数解释

用例结果所属版本的唯一标识

取值范围

不涉及

project_uuid

String

参数解释

项目UUID，项目唯一标识

取值范围

固定长度32位字符（字母和数字）

report_url

String

参数解释

第三方过来的执行结果，返回跳转到第三方的url

取值范围

不涉及

test_case_number

String

参数解释

测试用例的编号，用于唯一标识用例

取值范围

不涉及

service_type

String

参数解释:

服务类型

取值范围:

  • -1：全量用例

  • 0：手工测试

  • 1：接口自动化

  • 7：功能自动化

  • 8：WebUI自动化

  • 100：自定义自动化(工厂)

  • 11：性能自动化
表7 ResultStepVo

参数

参数类型

描述

result

String

参数解释

测试步骤的执行结果状态码

取值范围

不涉及

test_step

String

参数解释

测试步骤的具体操作描述

取值范围

不涉及

expect_result

String

参数解释

测试步骤的预期执行结果

取值范围

不涉及

actual_result

String

参数解释

测试步骤的实际执行结果

取值范围

不涉及

result_name

String

参数解释

测试步骤执行结果的中文名称，如通过、失败等

取值范围

不涉及

状态码：400

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：401

表9 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：404

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码：500

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

初始化用例执行记录

post https://{endpoint}/v4/3d2378e0fc504c638f48b21377d6add1/tasks/v91k0000vrrn0ni4/results/init

{
  "version_uri" : "v91i0000vrpquipi",
  "is_query" : true
}

响应示例

状态码：200

{
  "value" : {
    "flag" : false,
    "uri" : "v91k0000vrrn0ni4",
    "test_case_result_list" : [ ]
  }
}

状态码

状态码

描述

200

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码。

父主题： 测试套管理

相关文档