文档首页/ 测试计划 CodeArts TestPlan/ API参考/ API/ 测试计划管理/ 查询某测试计划下的操作历史
更新时间:2023-06-26 GMT+08:00

查询某测试计划下的操作历史

功能介绍

查询某测试计划下的操作历史

URI

GET /v1/projects/{project_id}/plans/{plan_id}/journals

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id,项目唯一标识,固定长度32位字符

plan_id

String

测试计划id,测试计划的唯一标识,长度11-34位字符

表2 Query参数

参数

是否必选

参数类型

描述

offset

Long

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

最小值:0

最大值:999

缺省值:0

limit

Long

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

最小值:1

最大值:200

缺省值:200

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

响应参数

状态码: 201

表4 响应Body参数

参数

参数类型

描述

[数组元素]

Array of TestPlanJournalList objects

项目下查询测试计划操作历史返回结构

表5 TestPlanJournalList

参数

参数类型

描述

detail

Array of TestPlanJournalDetail objects

历史记录详情

operate_time

String

变更时间

operator

NameAndId object

测试计划迭代编号与迭代名称

plan_id

String

测试计划id

project_id

String

项目id,项目唯一标识,固定长度32位字符

表6 TestPlanJournalDetail

参数

参数类型

描述

added

Array of NameAndId objects

测试计划资源的添加记录(工作项或者测试用例)

deleted

Array of NameAndId objects

测试计划资源的移除记录(工作项或者测试用例)

journalized_type

String

表明该条变更记录的具体变更类型,例如测试用例(testCase),需求(issue)

type

String

表明该条变更记录属于基础信息变更还是资源(需求添加移除、用例添加移除)变更

updated

Array of AttributeChange objects

测试计划基础信息变更,包括计划名称,测试类型,计划处理者、版本号、关联迭代、开始日期、截至日期、描述

表7 NameAndId

参数

参数类型

描述

id

String

对象编号

name

String

对象名称

表8 AttributeChange

参数

参数类型

描述

attribute_type

String

发生变更的测试计划属性

new_value

String

变更后的取值

old_value

String

变更前的取值

状态码: 400

表9 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码: 401

表10 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码: 404

表11 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

状态码: 500

表12 响应Body参数

参数

参数类型

描述

error_code

String

接口调用失败错误码

error_msg

String

接口调用失败错误信息

请求示例

get https://{endpoint}/v1/projects/efdb403066474ab08836b9eeaaa23bca/plans/9b26f58ec29943f681804a6628779a23/journals?offset=1&limit=10

响应示例

状态码: 201

OK

[ {
  "detail" : [ {
    "added" : [ {
      "id" : "ID",
      "name" : "名称"
    } ],
    "deleted" : [ {
      "id" : "ID",
      "name" : "名称"
    } ],
    "journalized_type" : "plan",
    "type" : "resource/attribute",
    "updated" : [ {
      "attribute_type" : "name",
      "new_value" : "tester",
      "old_value" : "test"
    } ]
  } ],
  "operate_time" : "2021-07-10",
  "operator" : {
    "id" : "ID",
    "name" : "名称"
  },
  "plan_id" : "c7c2ddf2ea914164ac6ee76bf11a30ea",
  "project_id" : "9b26f58ec29943f681804a6628779a23"
} ]

状态码

状态码

描述

201

OK

400

Bad Request

401

Unauthorized

404

Not Found

500

Internal Server Error

错误码

请参见错误码