# 查询版本级用例规范检查用例列表 - ShowVersionCheckTestCasesFour #### 功能介绍 此接口用于查询版本级用例规范检查用例列表,对应页面 测试 -\> 测试用例 -\> 列表右侧"更多" -\> 规范检查 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/versions/{version_uri}/rule-check/tasks/{task_uri}/violation-cases 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | version_uri | 是 | String | 分支版本uri | | task_uri | 是 | String | 任务uri | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | severity | 否 | Array of integers | 严重程度(1提示 2一般 3严重) | | page_size | 是 | Integer | 每页数量 | | page_no | 是 | Integer | 页码 | | case_name | 否 | String | 名称 | | sort_field | 否 | String | 排序字段 | | sort_type | 否 | String | **参数解释**: 排序方式 **约束限制**: 不涉及 **取值范围**: - ASC，升序。 - DESC，降序。 **默认取值**: 不涉及 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | Array of [TestCaseRuleCheckViolationCaseVo] objects | 结果详细 | | total | Integer | 符合条件的所有记录数 | | page_no | Integer | 页码 | | page_size | Integer | 每页展示条数 | 表4TestCaseRuleCheckViolationCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | 主键 | | severity | Integer | 严重程度 | | status | Integer | 问题状态 （0：未解决，1：已解决，2：忽略） | | suggestions | String | 修改意见 | | check_task_uri | String | 检查任务uri | | case_uri | String | 违规用例uri | | case_name | String | 违规用例名称 | | case_number | String | 违规用例编号 | | module_id | String | 违规用例模块id | | case_creator | String | 违规用例创建人id | | severity_name | String | 严重程度名称 | | violation_type | String | **参数解释**: 问题类型 **取值范围**: - 用例重复问题。 - 用例名称问题。 - 用例编号问题。 - 用例描述问题。 - 前置条件问题。 - 测试步骤问题。 - 步骤描述问题。 - 预期结果问题。 - 归属目录问题。 - 用例标签问题。 - 测试版本号问题。 - 脚本路径问题。 | | violation_cause | String | 问题原因 | | field_name | String | 违规用例字段名称 | | rule_link | String | 规则链接 | | rule_description | String | 规则描述 | | violation_content | String | 问题内容 | | repeated_testcase_count | Integer | 相似用例总数 | | repeated_case_list | Array of [TestCaseRuleCheckRepeatedRelationTestCaseVo] objects | 用例相似用例信息列表 | 表5TestCaseRuleCheckRepeatedRelationTestCaseVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 名称 | | number | String | 编号 | | rank | Integer | 级别 | | similarity | String | 用例相似度 | | service_type | Integer | **参数解释**: 服务类型 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 | | version_uri | String | 版本URI | | version_name | String | 版本名称 | **状态码：400** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 接口调用失败错误码 | | error_msg | String | 接口调用失败错误信息 | **状态码：401** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 接口调用失败错误码 | | error_msg | String | 接口调用失败错误信息 | **状态码：404** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 接口调用失败错误码 | | error_msg | String | 接口调用失败错误信息 | **状态码：500** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 接口调用失败错误码 | | error_msg | String | 接口调用失败错误信息 | #### 请求示例 ``` post https://{endpoint}/v4/704a12bbe517445ab75b855b77888d68/versions/v92t000107oi68nt/rule-check/tasks/v93400010ias0016/violation-cases { "page_size" : 10, "page_no" : 1 } ``` #### 响应示例 **状态码：200** OK ``` { "total" : 4, "value" : [ { "uri" : "v90800010s20eif5", "severity" : 3, "status" : 0, "suggestions" : "请编写测试步骤1描述", "check_task_uri" : "v90800010s20eia5", "case_uri" : "v90200010s1h66bp", "case_name" : "样例功能用例", "case_number" : "008", "case_creator" : "a17801c5d15f46e28112eec8a880683d", "severity_name" : "严重", "violation_type" : "步骤描述问题", "violation_cause" : "违反规则7.1.1，测试步骤1描述为空", "field_name" : "步骤描述", "rule_link" : "", "rule_description" : "规则7.1.1 测试步骤、预期结果为必填项。", "violation_content" : "{\"content\":\"\",\"num\":1}" }, { "uri" : "v90810s20eif5dbd", "severity" : 3, "status" : 0, "suggestions" : "请编写测试步骤1预期结果", "check_task_uri" : "v90800010s20eia5", "case_uri" : "v90200010s1h66bp", "case_name" : "样例功能用例", "case_number" : "008", "case_creator" : "a17801c5d15f46e28112eec8a880683d", "severity_name" : "严重", "violation_type" : "预期结果问题", "violation_cause" : "违反规则7.1.1，测试步骤1预期结果为空", "field_name" : "预期结果", "rule_link" : "", "rule_description" : "规则7.1.1 测试步骤、预期结果为必填项。", "violation_content" : "{\"content\":\"\",\"num\":1}" }, { "uri" : "v90800010s20eif4", "severity" : 3, "status" : 1, "suggestions" : "请编写测试步骤1描述", "check_task_uri" : "v90800010s20eia5", "case_uri" : "v90200010s1h65ik", "case_name" : "样例接口用例", "case_number" : "10010", "case_creator" : "a17801c5d15f46e28112eec8a880683d", "severity_name" : "严重", "violation_type" : "步骤描述问题", "violation_cause" : "违反规则7.1.1，测试步骤1描述为空", "field_name" : "步骤描述", "rule_link" : "", "rule_description" : "规则7.1.1 测试步骤、预期结果为必填项。", "violation_content" : "{\"content\":\"\",\"num\":1}" }, { "uri" : "v90810s20eif4dbc", "severity" : 3, "status" : 0, "suggestions" : "请编写测试步骤1预期结果", "check_task_uri" : "v90800010s20eia5", "case_uri" : "v90200010s1h65ik", "case_name" : "样例接口用例", "case_number" : "10010", "case_creator" : "a17801c5d15f46e28112eec8a880683d", "severity_name" : "严重", "violation_type" : "预期结果问题", "violation_cause" : "违反规则7.1.1，测试步骤1预期结果为空", "field_name" : "预期结果", "rule_link" : "", "rule_description" : "规则7.1.1 测试步骤、预期结果为必填项。", "violation_content" : "{\"content\":\"\",\"num\":1}" } ], "page_size" : 10, "page_no" : 1 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。