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

功能介绍

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

调用方法

URI

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID
issue_id	是	String	需求id

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
page_no	否	Integer	页码
page_size	否	Integer	每页数量
sort_field	否	String	排序字段
sort_type	否	String	参数解释: 排序方式约束限制: 不涉及取值范围: ASC，升序。 DESC，降序。默认取值: 不涉及
version_uri	否	String	版本uri
relate_type	否	String	参数解释: 关联关系类型约束限制: 不涉及取值范围: bug，缺陷。 requirement，需求。默认取值: 不涉及
key_word	否	String	关键字
rank_ids	否	Array of strings	用例等级ID集合
result_codes	否	Array of strings	结果Code集合

响应参数

状态码：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 取值范围不涉及
number	String	参数解释用例编号取值范围不涉及
name	String	参数解释用例名称取值范围不涉及
rank	String	参数解释用例等级取值范围不涉及
dr_relation_id	String	参数解释工作项id 取值范围不涉及
status_code	String	参数解释状态ID 取值范围不涉及
status_name	String	参数解释状态名称取值范围不涉及
author	String	参数解释创建人名称取值范围不涉及
author_id	String	参数解释创建人ID 取值范围不涉及
owner	String	参数解释处理人名称取值范围不涉及
project_uuid	String	参数解释项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 取值范围不涉及
test_type	String	参数解释: 测试类型取值范围: 1，功能性测试。 2，兼容性测试。 4，性能测试。 15，易用性测试。 22，可靠性测试。 14，安全性测试。 21，可服务性测试。
creation_date	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/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
  }
}