更新时间:2024-07-01 GMT+08:00
分享

查询用例修改历史记录

功能介绍

查询用例修改历史记录

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/{project_id}/testcases/{testcase_id}/histories/batch-query

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目UUID,项目唯一标识,固定长度32位字符(字母和数字)。获取方式请参见获取项目ID

最小长度:32

最大长度:32

testcase_id

String

用例uri,测试用例唯一标识,长度11-34位字符(字母和数字)。。

最小长度:11

最大长度:34

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度:1

最大长度:100000

表3 请求Body参数

参数

是否必选

参数类型

描述

offset

Integer

起始偏移量,表示从此偏移量开始查询,offset大于等于0,小于等于20000

最小值:0

最大值:20000

limit

Integer

每页显示的条目数量,最大支持200条

最小值:1

最大值:200

version_id

String

版本ID(分支ID或测试计划ID),长度11-34位字符(字母和数字)。

最小长度:11

最大长度:34

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total

Integer

起始记录数 大于 实际总条数时, 值为0, 分页请求才有此值

values

Array of ExternalTestCaseHistoryVo objects

实际的数据类型:单个对象,集合 或 NULL

表5 ExternalTestCaseHistoryVo

参数

参数类型

描述

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

表6 ResourceChangeExternalVo

参数

参数类型

描述

field_name

String

变更字段

custom_field_type

String

测试用例自定义字段类型

old_change_info

ElementResourceChangeExternalVo object

变更前的数据信息

new_change_info

ElementResourceChangeExternalVo object

变更后的数据信息

表7 ElementResourceChangeExternalVo

参数

参数类型

描述

tracker_name

String

工作项类型

value

String

key

String

key

object_value

Object

对象值

object_key

Object

对象key

tracker_names

Object

缺陷类型

board_info

Array of objects

归属看板信息,用例关联工作项信息使用

状态码: 400

表8 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码: 401

表9 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码: 404

表10 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码: 500

表11 响应Body参数

参数

参数类型

描述

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

错误码

请参见错误码

分享:

    相关文档

    相关产品