保存进度报表 - AddProgressReport

功能介绍

此接口用于添加进度报表,同页面测试 -> 测试质量看板 -> 右侧重点数据看板最下方 -> 进度报表 -> 点击添加报表

调用方法

请参见如何调用API。

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_uuid	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
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	参数解释 releaseId 约束限制不涉及取值范围不涉及默认取值不涉及
status	否	String	参数解释: 状态取值范围: -1，删除。 0，新建。 5，设计中。 6，测试中。 7，完成。 -2，未设置。
moduleIds	否	String	参数解释级别约束限制不涉及取值范围不涉及默认取值不涉及
results	否	String	参数解释结果约束限制不涉及取值范围不涉及默认取值不涉及
labelIds	否	String	参数解释标签约束限制不涉及取值范围不涉及默认取值不涉及
startTime	是	String	参数解释开始时间约束限制不涉及取值范围不涉及默认取值不涉及
endTime	是	String	参数解释结束时间约束限制不涉及取值范围不涉及默认取值不涉及
isAssociateIssue	否	String	参数解释是否关联需求约束限制不涉及取值范围不涉及默认取值不涉及
featureUris	是	String	参数解释目录uris 约束限制不涉及取值范围大小限制1000内默认取值不涉及

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
is_async_operate	Boolean	是否异步.固定为true:需要在调异步进度接口(/v4/testhub/progress/{operation_uri})获取此次请求的最终处理结果
async_uri	String	异步进度uri,需要在调异步进度接口(/v4/testhub/progress/{operation_uri}获取此次请求的最终处理结果
return_value	String	请求返回的数据,需要调用异步解读接口(/v4/testhub/progress/{operation_uri})获取此次请求的最终处理结果

状态码：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}/v5/75681cbb7c324e15a9eb8ee74a96a474/versions/2dopbu6aaf/progress-reports

{
  "type" : "2",
  "workpiece_type" : "progress",
  "analysis_dim_row" : "progress",
  "name" : "ggsa",
  "compare_dim_column" : "name",
  "filter" : {
    "startTime" : "2025-10-01 23:59:59",
    "endTime" : "2025-10-18 23:59:59",
    "featureUris" : [ "v90200010p0d465u" ]
  }
}

响应示例

状态码：200

{
  "is_async_operate" : true,
  "async_uri" : "0c897311d2884e0fa68c2ab7ac88674dv93600010u9q98br"
}

状态码

状态码	描述
200	OK
400	Bad Request
401	Unauthorized
404	Not Found
500	Internal Server Error

错误码

请参见错误码。

父主题： 报告管理

上一篇：报告管理

下一篇：修改单个自定义报表 - updateReport