文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 报告与看板管理/ 保存进度报表 - SaveProgressReport
更新时间:2026-10-22 GMT+08:00
分享

保存进度报表 - SaveProgressReport

功能介绍

此接口用于保存进度报表

调用方法

请参见如何调用API。

URI

POST /v4/{project_uuid}/versions/{version_uri}/progress-reports

表1 路径参数

参数

是否必选

参数类型

描述

project_uuid

是

String

参数解释

项目UUID,项目唯一标识

取值范围

字符串

version_uri

是

String

参数解释

版本URI

取值范围

字符串

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

是

String

参数解释

报表名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

type

是

Integer

参数解释

报表类型

约束限制

不涉及

取值范围

1:首页用例库, 2:质量报告

默认取值

不涉及

workpiece_type

是

String

参数解释

工件类型

约束限制

不涉及

取值范围

(用例:case,测试套:suite)

默认取值

不涉及

analysis_dim_row

是

String

参数解释

分析维度

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

compare_dim_column

是

String

参数解释

对比维度

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

filter

是

ReportFilter object

参数解释

过滤条件

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表3 ReportFilter

参数

是否必选

参数类型

描述

creatorIds

否

String

参数解释

创建人

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

ownerIds

否

String

参数解释

所属人

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

ranks

否

String

参数解释

级别

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

releaseIds

否

String

参数解释

发布版本ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

status

否

String

参数解释:

状态

取值范围:

  • -1,删除。

  • 0,新建。

  • 5,设计中。

  • 6,测试中。

  • 7,完成。

  • -2,未设置。

moduleIds

否

String

参数解释

模块ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

results

否

String

参数解释

结果

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

labelIds

否

String

参数解释

标签

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

startTime

是

String

参数解释

开始时间,UTC时间格式yyyy-MM-dd HH:mm:ss

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

endTime

是

String

参数解释

结束时间,UTC时间格式yyyy-MM-dd HH:mm:ss

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

isAssociateIssue

否

String

参数解释

是否关联需求

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

featureUris

是

String

参数解释

目录uris

约束限制

不涉及

取值范围

数组元素个数不超过1000

默认取值

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

value

String

参数解释

resultObject

取值范围

不涉及

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

状态码:500

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

接口调用失败错误码

取值范围:

不涉及

error_msg

String

参数解释:

接口调用失败错误信息

取值范围:

不涉及

请求示例

保存进度报表

POST https://{endpoint}/v4/{project_uuid}/versions/{version_uri}/progress-reports

{
  "report_name" : "进度报表1",
  "report_type" : 1
}

响应示例

状态码:200

{
  "total" : 1,
  "value" : "report-uri-001",
  "reason" : "",
  "page_size" : 20,
  "page_no" : 1,
  "has_more" : false
}

状态码:400

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码:500

{
  "error_code" : "CLOUDTEST.00000001",
  "error_msg" : "返回的错误信息"
}

状态码

状态码

描述

200

OK

400

Bad Request

500

Internal Server Error

错误码

请参见错误码。

相关文档