# 保存自定义模板报表设置 - SaveCustomTemplateReport #### 功能介绍 此接口用于测试质量看板中保存自定义模板报表设置,同页面 测试 -\> 测试质量看板 -\> 自定义分布报表 -\> 添加报表 -\> 新建模板后保存模板 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/versions/{version_uri}/custom-template-reports 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html)。 | | version_uri | 是 | String | 版本uri | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | uri | 否 | String | 报表id | | name | 是 | String | 报表名称 | | type | 否 | Integer | 报表类型 1：首页用例库， 2：质量报告 | | workpiece_type | 否 | String | 工件类型(用例：case,测试套：suite) | | template_config | 是 | [CustomTemplateFilter] object | 模板配置 | | data | 否 | Array of [CustomTemplateReportData] objects | 统计结果 | 表3CustomTemplateFilter | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | feature_uris | 是 | Array of strings | 目录uri | | template_name | 否 | String | 模板名称 | | template_uri | 否 | String | 模板uri | | column_configs | 否 | Array of [ReportTemplateColumnConfig] objects | 字段配置 | 表4ReportTemplateColumnConfig | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | filter | 否 | [LogicFilterOperator] object | 过滤条件 | | column_name | 否 | String | 字段名称 | 表5LogicFilterOperator | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | logic_operator | 否 | String | 逻辑操作 | | field_name | 否 | String | 字段名称值 | | field_name_key | 否 | String | 字段名称key | | field_value | 否 | String | 字段值 | | field_value_key | 否 | String | 字段key | | field_operator | 否 | String | 字段操作 | | logic_filters | 否 | Array of [LogicFilterOperator] objects | 过滤条件 | 表6CustomTemplateReportData | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | feature_name | 否 | String | 目录名称 | | data | 否 | Array of [ColumnDataVo] objects | 列数据 | 表7ColumnDataVo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | column_name | 否 | String | 列名 | | value | 否 | String | 列的值 | #### 响应参数 **状态码：200** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | String | 请求结果 | **状态码：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/a5eb0d410ea341a192f7c12483568985/versions/v90100010gpop318/custom-template-reports { "uri" : "v90100010hehfl0r", "name" : "11111111111111111", "type" : 0, "workpiece_type" : "case", "template_config" : { "feature_uris" : [ "v90100010hehfl0r", "", "v90100010gpop318" ], "column_configs" : [ { "column_name" : "条目1", "filter" : { "logic_operator" : "", "logic_filters" : [ { } ] } } ] } } ``` #### 响应示例 **状态码：200** 保存自定义模板报表设置返回体 ``` { "value" : "v90800010seug37j" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 保存自定义模板报表设置返回体 | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。