查询用例修改历史记录
功能介绍
查询用例修改历史记录
URI
POST /v1/{project_id}/testcases/{testcase_id}/histories/batch-query
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID。 |
testcase_id |
是 |
String |
用例uri,测试用例唯一标识,长度11-34位字符(字母和数字)。。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
offset |
是 |
Integer |
起始偏移量,表示从此偏移量开始查询,offset大于等于0,小于等于20000 |
limit |
是 |
Integer |
每页显示的条目数量,最大支持200条 |
version_id |
是 |
String |
版本ID(分支ID或测试计划ID),长度11-34位字符(字母和数字)。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
total |
Integer |
起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值 |
values |
Array of ExternalTestCaseHistoryVo objects |
实际的数据类型:单个对象,集合 或 NULL |
参数 |
参数类型 |
描述 |
---|---|---|
author |
String |
资源历史记录创建人ID |
region |
String |
逻辑region |
changes |
Array of ResourceChangeExternalVo objects |
历史记录字段变更列表 |
id |
String |
历史记录id |
testcase_id |
String |
用例uri,长度11-34位字符(字母和数字)。 |
creation_date |
String |
创建时间 |
create_date_timestamp |
Long |
创建时间时间戳 |
author_name |
String |
创建人名称 |
project_id |
String |
项目id |
参数 |
参数类型 |
描述 |
---|---|---|
field_name |
String |
变更字段 |
custom_field_type |
String |
测试用例自定义字段类型 |
old_change_info |
变更前的数据信息 |
|
new_change_info |
变更后的数据信息 |
参数 |
参数类型 |
描述 |
---|---|---|
tracker_name |
String |
工作项类型 |
value |
String |
值 |
key |
String |
key |
object_value |
Object |
对象值 |
object_key |
Object |
对象key |
tracker_names |
Object |
缺陷类型 |
board_info |
Array of objects |
归属看板信息,用例关联工作项信息使用 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
接口调用失败错误码 |
error_msg |
String |
接口调用失败错误信息 |
状态码: 401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
接口调用失败错误码 |
error_msg |
String |
接口调用失败错误信息 |
状态码: 404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
接口调用失败错误码 |
error_msg |
String |
接口调用失败错误信息 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
接口调用失败错误码 |
error_msg |
String |
接口调用失败错误信息 |
请求示例
查询用例修改历史记录
post https://{endpoint}/v1/efdb403066474ab08836b9eeaaa23bca/testcases/u4joiwueroiysx/histories/batch-query { "offset" : 0, "limit" : 10, "version_id" : "932opbuaarweqf" }
响应示例
状态码: 200
查询成功。示例1:获取用例历史记录基础示例。示例2:获取用例历史记录,目录(cataName)、状态(statusName)、等级(rank)、处理人(owner)、迭代(versionName)、模块(moduleName)、版本号(releaseDev)、缺陷(defectId)、需求(issueId)、测试步骤(steps)、描述(description)、预置条件(preparation)均有变更的返回示例。
-
示例 1
{ "total" : 1, "values" : [ { "author" : "10001", "region" : "szv", "changes" : [ { "field_name" : "name", "custom_field_type" : "text", "old_change_info" : { "tracker_name" : "AR", "value" : "aaaaa", "key" : "ddddd", "object_value" : { }, "object_key" : { }, "tracker_names" : { }, "board_info" : [ { } ] }, "new_change_info" : { "tracker_name" : "AR", "value" : "aaaaa", "key" : "ddddd", "object_value" : { }, "object_key" : { }, "tracker_names" : { }, "board_info" : [ { } ] } } ], "id" : "001s90u5o2d1", "testcase_id" : "001s16gt6q5", "creation_date" : "2022-11-09 16:37:24", "create_date_timestamp" : 1660617231016, "author_name" : "名称", "project_id" : "p45e51b060f1b4e82916f9d2c33e8eb28" } ] }
-
示例 2
{ "total" : 1, "values" : [ { "author" : "10001", "region" : "szv", "changes" : [ { "field_name" : "cataName", "old_change_info" : { "value" : "222", "key" : "v9080000upm45j32" }, "new_change_info" : { "value" : "新增子目录(1)", "key" : "v9040000u4e90spg" } }, { "field_name" : "statusName", "old_change_info" : { "value" : "测试中", "key" : "6" }, "new_change_info" : { "value" : "设计中", "key" : "5" } }, { "field_name" : "rank", "old_change_info" : { "value" : "P2", "key" : "2" }, "new_change_info" : { "value" : "P1", "key" : "1" } }, { "field_name" : "owner", "old_change_info" : { "value" : "Anna", "key" : "2053b1fb30fadwad2a4120ac1569870" }, "new_change_info" : { "value" : "Bob", "key" : "2053b1fb30fd434686a4120ac1569870" } }, { "field_name" : "versionName", "old_change_info" : { "value" : "迭代1", "key" : "26016449" }, "new_change_info" : { "value" : "迭代3", "key" : "26016459" } }, { "field_name" : "moduleName", "old_change_info" : { "value" : "功能1-子功能1", "key" : "752015" }, "new_change_info" : { "value" : "功能2-子功能1", "key" : "752017" } }, { "field_name" : "releaseDev", "old_change_info" : { "value" : "2.0.0.1", "key" : "2.0.0.1" }, "new_change_info" : { "value" : "1.0.0", "key" : "1.0.0" } }, { "field_name" : "defectId", "old_change_info" : { "key" : "7213756,7213755", "object_value" : [ "功能自动化关联缺陷", "不关联的bug" ], "object_key" : [ "7213756", "7213755" ], "tracker_names" : [ "Bug", "Bug" ], "board_info" : [ ] }, "new_change_info" : { "key" : "7213751,7213750,7213756,7213755", "object_value" : [ "缺陷1", "用例关联的缺陷", "功能自动化关联缺陷", "不关联的bug" ], "object_key" : [ "7213751", "7213750", "7213756", "7213755" ], "tracker_names" : [ "Bug", "Bug", "Bug", "Bug" ], "board_info" : [ ] } }, { "field_name" : "issueId", "old_change_info" : { "tracker_name" : "Story", "value" : "1", "key" : "7289959", "board_info" : [ ] }, "new_change_info" : { "tracker_name" : "Story", "value" : "3", "key" : "7289957", "board_info" : [ ] } }, { "field_name" : "steps", "old_change_info" : { "object_value" : [ { "expect_output" : "", "test_step" : "" } ] }, "new_change_info" : { "object_value" : [ { "expect_output" : "<p>awda</p>", "test_step" : "<p>awd</p>" }, { "expect_output" : "<p>dawdaw</p>", "test_step" : "<p>awd</p>" } ] } }, { "field_name" : "name", "old_change_info" : { "value" : "ces10" }, "new_change_info" : { "value" : "ces10123" } }, { "field_name" : "description", "old_change_info" : { "value" : "awda" }, "new_change_info" : { "value" : "awdawawdawdwdawdadwa" } }, { "field_name" : "preparation", "old_change_info" : { "value" : "awdaw" }, "new_change_info" : { "value" : "awdawaawwwadd" } } ], "id" : "001s90u5o2d1", "testcase_id" : "001s16gt6q5", "creation_date" : "2022-11-09 16:37:24", "create_date_timestamp" : 1660617231016, "author_name" : "名称", "project_id" : "p45e51b060f1b4e82916f9d2c33e8eb28" } ] }
状态码
状态码 |
描述 |
---|---|
200 |
查询成功。示例1:获取用例历史记录基础示例。示例2:获取用例历史记录,目录(cataName)、状态(statusName)、等级(rank)、处理人(owner)、迭代(versionName)、模块(moduleName)、版本号(releaseDev)、缺陷(defectId)、需求(issueId)、测试步骤(steps)、描述(description)、预置条件(preparation)均有变更的返回示例。 |
400 |
Bad Request |
401 |
Unauthorized |
404 |
Not Found |
500 |
Internal Server Error |
错误码
请参见错误码。