# 保存进度报表 - AddProgressReport #### 功能介绍 此接口用于添加进度报表,同页面 测试 -\> 测试质量看板 -\> 右侧重点数据看板最下方 -\> 进度报表 -\> 点击添加报表 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v5/{project_uuid}/versions/{version_uri}/progress-reports 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_uuid | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | 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 | **参数解释** 过滤条件 **约束限制** 不涉及 **取值范围** 不涉及 **默认取值** 不涉及 | 表3ReportFilter | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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** OK ``` { "is_async_operate" : true, "async_uri" : "0c897311d2884e0fa68c2ab7ac88674dv93600010u9q98br" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。