# ticc查询用例列表接口 - ListTiccTestCases #### 功能介绍 此接口用于ticc查询用例列表接口，根据入参的过滤条件（如项目ID、状态、模块、负责人时间范围等）实现灵活的测试用例分页查询功能。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。 #### URI POST /v4/testcases/batch-query/used-for-automation #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | keyword | 否 | String | 关键字查询，用例名或编号 | | exeplatforms | 否 | Array of strings | 执行平台 | | own | 否 | Boolean | 是否是我的 | | conditions | 否 | Array of [SearchCondition] objects | 搜索条件 | | queryByDisplayCfg | 否 | Boolean | 是否表头配置查询 | | useOffset | 否 | Boolean | 使用offset分页 | | project_uuid | 是 | String | 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) | | version_uri | 否 | String | 版本URI | | case_uris | 否 | Array of strings | 用例URI集合 | | owner_ids | 否 | Array of strings | 处理者ID集合 | | status_codes | 否 | Array of strings | 状态Code集合 | | rank_ids | 否 | Array of strings | 用例等级ID集合 | | module_ids | 否 | Array of strings | 模块ID集合 | | issue_id | 否 | String | 需求编号 | | creator_ids | 否 | Array of strings | 创建者ID集合 | | result_codes | 否 | Array of strings | 结果Code集合 | | iteration_ids | 否 | Array of strings | 归属迭代ID集合 | | create_start_time | 否 | String | 创建开始时间 | | create_end_time | 否 | String | 创建结束时间 | | associated_issue | 否 | Boolean | 是否关联需求（null：不限，false：未关联，true：已关联） | | associated_defects | 否 | Boolean | 是否关联缺陷（null：不限，false：未关联，true：已关联） | | include_sub_issue | 否 | Boolean | 是否查询子需求关联的用例，默认true | | include_sub_feature | 否 | Boolean | 是否查询子目录的用例，默认true | | label_ids | 否 | Array of strings | 标签ID集合 | | execute_start_time | 否 | String | 执行开始时间 | | execute_end_time | 否 | String | 执行结束时间 | | executor_ids | 否 | Array of strings | 执行者ID集合 | | test_types | 否 | Array of strings | 类型 | | is_keyword | 否 | Boolean | 是否组合关键字 | | issue_tree_search | 否 | Boolean | 是否是需求树点击的查询关联用例 | | service_type | 否 | Integer | **参数解释**: 服务类型 **约束限制**: 不涉及 **取值范围**: - -1，全量用例。 - 0，手工测试。 - 1，接口自动化。 - 7，功能自动化。 - 8，WebUI自动化。 - 100，自定义自动化(工厂)。 - 11，性能自动化。 **默认取值**: 不涉及 | | service_types | 否 | Array of integers | 服务类型集合 | | stage_type | 否 | Integer | 阶段过程（2：测试设计，3：测试执行，4：质量报告） | | feature_uri | 否 | String | 目录URI | | sort_field | 否 | String | 排序字段 | | sort_type | 否 | String | **参数解释**: 排序方式 **约束限制**: 不涉及 **取值范围**: - ASC，升序。 - DESC，降序。 **默认取值**: 不涉及 | | page_no | 否 | Integer | 当前页数 | | page_size | 否 | Integer | 每页条数 | | case_type | 否 | Integer | **参数解释**: 用例类型 **约束限制**: 不涉及 **取值范围**: - 0，手工测试。 - 1，接口自动化。 - 2，性能用例。 **默认取值**: 不涉及 | | custom_field_info | 否 | Array of [QueryCustomFieldsInfo] objects | 用例自定义字段信息 | | task_uri | 否 | String | 测试套uri | | associate_issue_detail | 否 | Boolean | 是否返回需求具体信息（返回需求名称，需求id） | | not_assign_task | 否 | Boolean | 该字段为false,则查询全量用例，为true表示查询未分配测试套的用例 | | test_designs | 否 | Array of booleans | 是否来自测试设计（null或者\[true, false\]：不限，\[true\]：来自测试设计，\[false\]：否来自测试设计） | | review_status | 否 | Integer | **参数解释**: 用例评审状态 **取值范围**: - 0，未评审。 - 1，已评审。 | | just_return_id | 否 | Boolean | 部分字段是否仅返回ID，默认为false，为true时部分字段仅返回ID | | iterator_uri_condition | 否 | String | 迭代uri搜索条件 | 表2SearchCondition | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | field_name | 否 | String | 字段名 | | field_value | 否 | String | 字段值 | | operator | 否 | String | 数据库字段操作 | | sour_value | 否 | String | 源值 | | tar_value | 否 | String | 目标值 | | field_type | 否 | String | **参数解释**: 字段类型 **约束限制**: 不涉及 **取值范围**: - richText，富文本。 - text，单行文本。 - textArea，多行文本。 - radio，单选框。 - checkBox，多选框。 - date，日期时间。 - onlyDate，日期。 - date，日期时间。 - number，数字（整数）。 - double，数字（小数）。 - checkBoxUser，多选用户。 - user，单选用户。 **默认取值**: 不涉及 | 表3QueryCustomFieldsInfo | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | id | 否 | Integer | **参数解释**: 测试用例自定义字段Id **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及 | | values | 否 | Array of strings | **参数解释**: 测试用例自定义字段值 **约束限制**: 不涉及 **取值范围**: 不涉及 **默认取值**: 不涉及 | | field_name | 否 | String | **参数解释**: 自定义字段名 **约束限制**: 不涉及 **取值范围**: 优先取id再取fieldName **默认取值**: 不涉及 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | total | Integer | **参数解释** 总数 **取值范围** 不小于1的正整数 | | page_no | Integer | **参数解释** 分页编码 **取值范围** 大于0且小于100的正整数 | | page_size | Integer | **参数解释** 分页大小 **取值范围** 大于零且小于20000的正整数 | | value | Array of [TestCaseListVo] objects | 请求返回的数据 | 表5TestCaseListVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | uri | String | **参数解释**: 用例URI **取值范围**: 字符串类型，长度11-34位字符 | | name | String | **参数解释**: 用例名称 **取值范围**: 字符串类型，小于128位字符 | | owner | [NameAndIdVo] object | **参数解释**: 处理者 **取值范围**: 字符串类型，小于128位字符 | | status | [NameAndIdVo] object | **参数解释**: 状态 **取值范围**: 不涉及 | | result | [NameAndIdVo] object | **参数解释**: 结果 **取值范围**: 不涉及 | | module | [NameAndIdVo] object | **参数解释**: 模块 **取值范围**: 不涉及 | | iteration | [NameAndIdVo] object | **参数解释**: 迭代 **取值范围**: 不涉及 | | exeplatform | String | **参数解释**: 执行平台 **取值范围**: apittest,其他三方执行平台 | | number | String | **参数解释**: 用例编号 **取值范围**: 字符串类型，小于128位字符 | | description | String | **参数解释**: 用例描述 **取值范围**: 字符串类型，小于256位字符 | | rank_id | String | **参数解释**: 用例等级 **取值范围**: - 0，Priority 0。 - 1，Priority 1。 - 2，Priority 2。 - 3，Priority 3。 - 4，Priority 4。 | | feature_uri | String | **参数解释**: 目录URI **取值范围**: 字符串类型，11-34位字符 | | release_dev | String | **参数解释**: 版本号 **取值范围**: 3-32位字符，允许：汉字、字母（a-z, A-Z）、数字（0-9）、下划线（_）、连字符（-）、点号（.）、破折号（---） | | is_keyword | Boolean | **参数解释**: 是否组合关键字 **取值范围**: - true: 组合关键字 - false:不组合关键字 | | script_url | String | **参数解释**: 脚本路径 **取值范围**: 字符串类型，如"/script/test.py"路径 | | report_url | String | **参数解释**: 实时报告地址 **取值范围**: 字符串类型，返回一个url | | project_uuid | String | **参数解释**: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-testman/cloudtest_03_4003.html) **取值范围**: 字符串类型，长度等于32位，包含大小写字母、数字 | | service_type | [NameAndIdVo] object | **参数解释**: 服务类型信息 **取值范围**: 不涉及 | | test_type | [IntegerIdAndNameVo] object | **参数解释**: 测试类型信息 **取值范围**: 不涉及 | | create_info | [CreateInfoVo] object | **参数解释**: 创建信息 **取值范围**: 不涉及 | | execute_info | [ExecuteInfoVo] object | **参数解释**: 执行信息 **取值范围**: 不涉及 | | associate_issue_info | [AssociateIssueInfoVo] object | **参数解释**: 关联需求信息 **取值范围**: 不涉及 | | associate_defect_info | [AssociateDefectInfoVo] object | **参数解释**: 关联缺陷信息 **取值范围**: 不涉及 | | case_type | Integer | **参数解释**: 用例类型 **取值范围**: - 0，手工测试。 - 1，接口自动化。 - 2，性能用例。 | | labels | String | **参数解释**: 用例标签名称列表 **取值范围**: 不涉及 | | custom_field_info | Array of [CustomFieldVo] objects | **参数解释**: 自定义字段信息 **取值范围**: 不涉及 | | is_test_design | Boolean | **参数解释**: 是否来自测试设计 **取值范围**: - null：不限 - false：否来自测试设计 -true：来自测试设计 | | last_modified | Long | **参数解释**: 最后修改时间 **取值范围**: 时间戳，单位：毫秒 | | review_status | Integer | 用例评审状态 **取值范围**: - 0，未评审。 - 1，已评审。 | | case_create_date | Long | 用例创建时间（null：不限） | | confidentiality_code | String | **参数解释** 资源密级等级编码，只有在涉密开关打开时，且资源设置了密级等级，才会返回 **取值范围** 不涉及 | 表6NameAndIdVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释** ID **取值范围** 不涉及 | | name | String | **参数解释** 名称 **取值范围** 不涉及 | 表7IntegerIdAndNameVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释** 数据库存储数字 **取值范围** 不涉及 | | name | String | **参数解释** 页面显示值 **取值范围** 不涉及 | 表8CreateInfoVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | time | String | **参数解释**: 创建时间 **取值范围**: 不涉及 | | timestamp | Long | **参数解释**: 创建时间时间戳 **取值范围**: 不涉及 | | user_id | String | **参数解释**: 用户ID **取值范围**: 不涉及 | | user_name | String | **参数解释**: 用户名称 **取值范围**: 不涉及 | 表9ExecuteInfoVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | time | String | **参数解释**: 执行开始时间 **取值范围**: 不涉及 | | timestamp | Long | **参数解释**: 执行开始时间时间戳 **取值范围**: 不涉及 | | duration | String | **参数解释**: 执行时长 **取值范围**: 不涉及 | | user_id | String | **参数解释**: 用户ID **取值范围**: 不涉及 | | user_name | String | **参数解释**: 用户名称 **取值范围**: 不涉及 | | execute_times | Integer | **参数解释**: 执行次数 **取值范围**: 不涉及 | 表10AssociateIssueInfoVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | associate | Boolean | **参数解释**: 是否已关联 **取值范围**: true: 已关联 false:未关联 | | issue_id | String | **参数解释**: 需求ID **取值范围**: 不涉及 | | tracker_id | String | **参数解释**: 需求类型 **取值范围**: 不涉及 | | board_id | String | **参数解释**: 工作项层级ID **取值范围**: 不涉及 | | tracker_name | String | **参数解释**: 需求类型名称 **取值范围**: 不涉及 | 表11AssociateDefectInfoVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | associate | Boolean | **参数解释**: 是否已关联 **取值范围**: true:已关联 false:未关联 | | associate_count | Integer | **参数解释**: 关联缺陷数 **取值范围**: 不涉及 | 表12CustomFieldVo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释**: 字段类型 **取值范围**: - 单行文本text - 多行文本textArea - 单选框radio - 多选框checkBox - 日期date - 数字number - 单选用户user | | value | String | **参数解释**: 测试用例自定义字段值 **取值范围**: 字符串类型 | | custom_field_param | String | **参数解释**: 项目用例自定义字段入参或者返回参数名称 **取值范围**: 不涉及 | | user_name | String | **参数解释**: 用户名 **取值范围**: user类型测试用例自定义字段对应用户名，其它类型字段不返回 | #### 请求示例 ``` post https://{endpoint}/v4/testcases/batch-query/used-for-automation { "keyword" : "用例名", "exeplatforms" : [ "string" ], "own" : true, "conditions" : [ { } ], "queryByDisplayCfg" : true, "useOffset" : true, "project_uuid" : "03d55a9eb29643809f4120cd628968fa", "version_uri" : "005t8asecn21", "case_uris" : [ "001rv9521lf1" ], "owner_ids" : [ "efdb403066474ab08836b9eeaaa23bca" ], "status_codes" : [ "0", "1" ], "rank_ids" : [ "1", "2" ], "module_ids" : [ "-2" ], "issue_id" : "3917852", "creator_ids" : [ "efdb403066474ab08836b9eeaaa23bca" ], "result_codes" : [ "0", "1" ], "iteration_ids" : [ "2000adec0b854306bf013e84f7b5f9ea" ], "create_start_time" : "2021-11-04 00:00:00", "create_end_time" : "2021-11-04 23:59:59", "associated_issue" : true, "associated_defects" : true, "include_sub_issue" : false, "include_sub_feature" : false, "label_ids" : [ "17220c4560ab4e5b913aaa40895183fb" ], "execute_start_time" : "2021-11-04 00:00:00", "execute_end_time" : "2021-11-04 23:59:59", "executor_ids" : [ "efdb403066474ab08836b9eeaaa23bca" ], "test_types" : [ "1" ], "is_keyword" : false, "issue_tree_search" : false, "service_type" : 3, "service_types" : [ 0, 1, 6 ], "stage_type" : 2, "feature_uri" : "004s6kfel2q", "sort_field" : "testCaseNumber", "sort_type" : "ASC", "page_no" : 1, "page_size" : 10, "case_type" : 0, "custom_field_info" : [ { } ], "task_uri" : "taskUri", "associate_issue_detail" : true, "not_assign_task" : true, "test_designs" : [ true ], "review_status" : 0, "just_return_id" : true, "iterator_uri_condition" : "string" } ``` #### 响应示例 **状态码：200** OK ``` { "value" : [ { "uri" : "001rv8lk4he", "name" : "测试用例", "owner" : { }, "status" : { }, "result" : { }, "module" : { }, "iteration" : { }, "exeplatform" : "apittest", "number" : "10010", "description" : "用例描述", "rank_id" : "2", "feature_uri" : "001rv8u6cts1", "release_dev" : "1.0.1", "is_keyword" : false, "script_url" : "/script/test.py", "report_url" : "{url}", "project_uuid" : "bcfb102f3bef45ab87f0f9ea6fc4f49c", "service_type" : { }, "test_type" : { }, "create_info" : { }, "execute_info" : { }, "associate_issue_info" : { }, "associate_defect_info" : { }, "case_type" : 0, "labels" : "46a5dbfd770f445da87b1a50ee37a86b", "custom_field_info" : [ { } ], "is_test_design" : true, "last_modified" : 1705580778, "review_status" : 1 } ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | | 404 | Not Found | | 500 | Internal Server Error | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。