查询需求下的用例列表 - ShowTestCasesByIssue

功能介绍

此接口用于查询指定需求下的用例列表,同页面测试-> 测试用例 -> 左侧树状图选择需求 -> 选中需求查询需求下的用例

调用方法

请参见如何调用API。

URI

POST /v4/{project_id}/issues/{issue_id}/testcases/batch-query

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释项目UUID 约束限制 32位字母及数字取值范围项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 默认取值不涉及
issue_id	是	String	需求id 获取方法：从req系统获取

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
page_no	否	Integer	参数解释页码约束限制说明： 0 的正整数取值范围大于0小于100 默认取值不涉及
page_size	否	Integer	参数解释每页数量约束限制说明： 0 的正整数取值范围大于0小于20000 默认取值不涉及
sort_field	否	String	排序字段
sort_type	否	String	参数解释: 排序方式约束限制: 不涉及取值范围: ASC，升序。 DESC，降序。默认取值: 不涉及
version_uri	否	String	参数解释版本uri 约束限制 11-34位字母及数字取值范围 11-34位字母及数字默认取值不涉及
relate_type	否	String	参数解释: 关联关系类型约束限制: 不涉及取值范围: bug，缺陷。 requirement，需求。默认取值: 不涉及
key_word	否	String	参数解释关键字约束限制字符串取值范围 128位以内的字符串默认取值不涉及
rank_ids	否	Array of strings	参数解释用例等级ID集合约束限制不涉及取值范围集合内的数据可传0,1,2,3,4 默认取值不涉及
result_codes	否	Array of strings	参数解释结果Code集合约束限制不涉及取值范围可传1-5位的数字默认取值不涉及

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
value	QueryTestCasesByIssueVo object	请求返回的数据

表4 QueryTestCasesByIssueVo
参数	参数类型	描述
case_status_map	Map<String,String>	用例状态
new_create	Integer	新建态
designing	Integer	设计态
finished	Integer	完成态
testing	Integer	测试态
test_case_num	Integer	需求关联的用例数量
testcases	Array of TestCaseVo objects	用例详情
total_count	Integer	用例总数

表5 TestCaseVo
参数	参数类型	描述
uri	String	参数解释用例ID 取值范围不涉及
version_uri	String	参数解释版本URI 取值范围不涉及
parent_uri	String	参数解释父资源URI 取值范围不涉及
parent_path	String	参数解释父资源路径取值范围不涉及
type	String	参数解释资源类型取值范围不涉及
creation_version_uri	String	参数解释创建版本URI 取值范围不涉及
last_modifier	String	参数解释最后修改人取值范围不涉及
last_modified	String	参数解释最后修改时间取值范围 yyyy-MM-dd HH:mm:ss
last_change_time	String	参数解释最后变更时间取值范围 yyyy-MM-dd HH:mm:ss
number	String	参数解释用例编号取值范围不涉及
name	String	参数解释用例名称取值范围不涉及
rank	String	参数解释用例等级取值范围不涉及
case_type	Integer	参数解释用例类型取值范围不涉及
platform_type	Integer	参数解释执行平台类型取值范围不涉及
service_type	Integer	参数解释服务类型取值范围不涉及
test_step	String	参数解释测试步骤取值范围不涉及
expect_output	String	参数解释期望结果取值范围不涉及
auto_type	Integer	参数解释自动化类型取值范围非自动化:0, 是自动化:1
to_be_auto_exec	Integer	参数解释被自动化执行取值范围不涉及
dr_relation_id	String	参数解释工作项id 取值范围不涉及
automatically_executed	Integer	参数解释是否被自动化执行取值范围不涉及
is_contract_testcase	Integer	参数解释是否是契约用例取值范围 0:表示非契约用例, 1：表示契约用例
time_cost	Double	参数解释总共耗时取值范围不涉及
last_exe_author	String	参数解释最后一次执行用户取值范围不涉及
status_code	String	参数解释状态ID 取值范围不涉及
result_code	String	参数解释结果Code 取值范围不涉及
status_name	String	参数解释状态名称取值范围不涉及
author	String	参数解释创建人名称取值范围不涉及
author_id	String	参数解释创建人ID 取值范围不涉及
region	String	参数解释逻辑region 取值范围不涉及
owner	String	参数解释处理人名称取值范围不涉及
issue_id	String	参数解释工作项id 取值范围不涉及
issue_tracker_id	String	参数解释工作项类型id 取值范围不涉及
issue_assign_status	String	参数解释工作项分配状态取值范围不涉及
issue_name	String	参数解释工作项名称取值范围不涉及
issue_design_owner	String	参数解释工作项设计责任人取值范围不涉及
issue_design_owner_d	String	参数解释工作项设计责任人id 取值范围不涉及
tracker_name	String	参数解释工作项类型名称取值范围不涉及
defect_list	Array of NameAndIdVo objects	参数解释缺陷列表取值范围不涉及
result_name	String	参数解释结果名称取值范围不涉及
execute_latest_time	String	参数解释最后执行时间取值范围 yyyy-MM-dd HH:mm:ss
execute_duration	String	参数解释执行时长取值范围不涉及
is_keyword	Integer	参数解释是否关键用例取值范围不涉及
project_uuid	String	参数解释项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 取值范围不涉及
test_type	String	参数解释: 测试类型取值范围: 1，功能性测试。 2，兼容性测试。 4，性能测试。 15，易用性测试。 22，可靠性测试。 14，安全性测试。 21，可服务性测试。
creation_date	String	参数解释创建时间取值范围不涉及

表6 NameAndIdVo
参数	参数类型	描述
id	String	ID
name	String	名称

状态码：400

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 业务失败的错误码取值范围: 不涉及
error_msg	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：401

表8 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 业务失败的错误码取值范围: 不涉及
error_msg	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：404

表9 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 业务失败的错误码取值范围: 不涉及
error_msg	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：500

**表10** 响应Body参数
参数	参数类型	描述
error_code	String	参数解释: 业务失败的错误码取值范围: 不涉及
error_msg	String	参数解释: 业务失败的提示内容取值范围: 不涉及

请求示例

post https://{endpoint}/v4/projects/f3087a82b44744c29a1bd69ab6ada154/issues/1134703430181982208/testcases/batch-query

{
  "page_no" : 1,
  "page_size" : 100,
  "relate_type" : "bug",
  "sort_type" : "DESC"
}

响应示例

状态码：200

{
  "value" : {
    "case_status_map" : {
      "完成" : 1
    },
    "new_create" : 0,
    "designing" : 0,
    "finished" : 1,
    "testing" : 0,
    "test_case_num" : 1,
    "testcases" : [ {
      "uri" : "v90410b5o5ce22a7",
      "type" : "TestCase",
      "author" : "sec_admin——nich",
      "name" : "cx_2995",
      "rank" : 2,
      "region" : "roma-dev-2-arm",
      "owner" : "",
      "version_uri" : "v90200010aelu5om",
      "parent_uri" : "v90200010aelu5om",
      "parent_path" : "/407ac57de7ea44d28e47293a2b9cf15c/v90200010aelu5om/",
      "creation_version_uri" : "v90100010b5nubs0",
      "last_modifier" : "sec_admin——nich",
      "last_modified" : "2025-05-29 10:25:40",
      "last_change_time" : "2025-03-21 18:25:43",
      "creation_date" : "2025-03-21 18:25:04",
      "author_id" : "2ce06fffb4634271a377c1cd7c429704",
      "number" : "7417",
      "case_type" : 0,
      "platform_type" : 0,
      "service_type" : 0,
      "test_type" : 1,
      "test_step" : "[\"\"]",
      "expect_output" : "[\"\"]",
      "auto_type" : 0,
      "to_be_auto_exec" : 0,
      "automatically_executed" : 0,
      "is_contract_testcase" : 0,
      "time_cost" : 0,
      "last_exe_author" : "2ce06fffb4634271a377c1cd7c429704",
      "status_code" : "7",
      "result_code" : "1",
      "execute_latest_time" : "2025-05-29 10:25:40",
      "execute_duration" : "00:00:00.000",
      "is_keyword" : 0,
      "project_uuid" : "407ac57de7ea44d28e47293a2b9cf15c",
      "issue_id" : "[\"1134703430181982208\"]",
      "issue_tracker_id" : "[\"3\"]",
      "issue_assign_status" : "[null]",
      "issue_name" : "[\"史蒂文\"]",
      "issue_design_owner" : "[null]",
      "issue_design_owner_d" : "[null]",
      "tracker_name" : "[\"Bug\"]",
      "defect_list" : [ ],
      "result_name" : "失败",
      "status_name" : "完成"
    } ],
    "total_count" : 1
  }
}