# 导出测试用例 - ExportTestCaseList #### 功能介绍 此接口用于导出测试用例，同页面 测试 -\> 测试用例 -\> 右侧展示用例列表，选择用例 -\> 右上角点击更多，点击导出 -\> 筛选导出字段，点击导出 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/{project_id}/versions/{version_uri}/testcases/export 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | version_uri | 是 | String | 分支或者迭代uri | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | owners | 否 | Array of strings | 处理者 | | authors | 否 | Array of strings | 创建者 | | ranks | 否 | Array of strings | 用例等级 | | test_case_uris | 否 | Array of strings | 用例Uris | | service_type | 否 | Integer | **参数解释**: 服务类型 **约束限制**: 不涉及 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 **默认取值**: 不涉及 | | task_uri | 否 | String | 任务/测试套Uri | | feature_uri | 否 | String | 目录Uri | | key_word | 否 | String | 关键字 | | sort_field | 否 | String | 排序字段 | | sort_type | 否 | String | 升序/降序 | | start_index | 否 | String | 起始位置 | | end_index | 否 | String | 结束位置 | | start_time | 否 | String | 创建日期范围起始时间 | | end_time | 否 | String | 创建日期范围结束时间 | | last_exe_authors | 否 | Array of strings | 最后一次执行用户 | | module_ids | 否 | Array of strings | 模块id | | release_ids | 否 | Array of strings | 迭代id | | status_codes | 否 | Array of strings | 用例状态 | | result_codes | 否 | Array of strings | 执行结果Code | | issue_id | 否 | String | 需求id | | execute_start_time | 否 | String | 最近执行时间范围起始时间 | | execute_end_time | 否 | String | 最近执行时间范围结束时间 | | label_ids | 否 | Array of strings | 标签Id | | include_sub_issue | 否 | Boolean | 是否查询子需求关联的用例，默认true | | include_sub_feature | 否 | Boolean | 是否查询子目录的用例，默认true | | case_type | 否 | Integer | **参数解释**: 用例类型 **约束限制**: 不涉及 **取值范围**: - 0，手工测试。 - 1，接口自动化。 - 2，性能用例。 **默认取值**: 不涉及 | | associated_issue | 否 | Boolean | 是否关联需求（null：不限，false：未关联，true：已关联） | | associated_defects | 否 | Boolean | 是否关联缺陷（null：不限，false：未关联，true：已关联） | | is_keyword | 否 | Boolean | 是否组合关键字 | | issue_tree_search | 否 | Boolean | 是否是需求树点击的查询关联用例 | | service_types | 否 | Array of integers | 服务类型集合 | | stage_type | 否 | Integer | 阶段过程（2：测试设计，3：测试执行，4：质量报告） | | custom_field_info | 否 | Array of [QueryCustomFieldsInfo] objects | 用例自定义字段信息 | | is_async | 否 | Boolean | 是否异步执行 | | test_designs | 否 | Array of booleans | 是否来自测试设计（null或者\[true, false\]：不限，\[true\]：来自测试设计，\[false\]：否来自测试设计） | | not_assign_task | 否 | Boolean | 该字段为false,则查询全量用例，为true表示查询未分配测试套的用例 | | test_types | 否 | Array of strings | 类型 | | review_status | 否 | Integer | **参数解释**: 用例评审状态 **取值范围**: - 0，未评审。 - 1，已评审。 **默认取值**: 不涉及 | | last_modified_start_time | 否 | String | 资源最后修改时间范围起始时间，需要和 资源最后修改时间范围结束时间 一起查询，单独一个不生效 | | last_modified_end_time | 否 | String | 资源最后修改时间范围结束时间，需要和 资源最后修改时间范围开始时间 一起查询，单独一个不生效 | 表3QueryCustomFieldsInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | id | 否 | Integer | **参数解释**: 测试用例自定义字段Id **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及 | | values | 否 | Array of strings | **参数解释**: 测试用例自定义字段值 **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及 | | field_name | 否 | String | **参数解释**: 自定义字段名 **约束限制**: 不涉及 **取值范围**: 优先取id再取fieldName **默认取值**: 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | value | String | **参数解释** 请求返回的数据 **取值范围** 不涉及 | **状态码：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 | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 | #### 请求示例 ``` { "start_index" : 1, "end_index" : 2, "key_word" : "", "sort_field" : "", "sort_type" : "", "test_case_uris" : [ ], "is_async" : true, "feature_uri" : "v90200010s1h6476" } ``` #### 响应示例 **状态码：200** OK ``` { "value" : "1b7179edc79a431f9711434124ac9f28v90500010scqt88v" } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。