文档首页/ 需求管理 CodeArts Req/ API参考/ API/ IPD统计概览/ 获取统计面板数据
更新时间：2024-11-30 GMT+08:00
查看PDF
分享

获取统计面板数据

功能介绍

获取需求/缺陷统计面板数据，数据会有5~10分钟延迟

调试

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

URI

POST /v1/ipdprojectservice/projects/{project_id}/statistic/dashboard

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目Id
表2 Query参数

参数

是否必选

参数类型

描述

classification

是

String

标识统计类型，可选值为requirement，bug

classification=requirement 查询需求统计

classification=bug 查询缺陷统计

请求参数

表3 请求Body参数

参数

是否必选

参数类型

描述

plan

否

PlanFilter object

统计概览按PI迭代过滤条件

created_date

否

DateFilter object

按创建时间统计时，起止时间过滤条件
表4 PlanFilter

参数

是否必选

参数类型

描述

plan_pi

否

String

按PI统计时，被统计的PI的id

plan_iteration

否

String

按PI下迭代统计时，迭代的id
表5 DateFilter

参数

是否必选

参数类型

描述

start_date

否

String

工作项创建时间不早于此时间，日期d的0点时间戳

end_date

否

String

工作项创建时间不晚于此时间，日期d+1的0点时间戳

响应参数

状态码： 200

表6 响应Body参数

参数

参数类型

描述

result

Array of DashboardSimpleVO objects

统计结果

status

String

请求状态

message

String

请求失败信息
表7 DashboardSimpleVO

参数

参数类型

描述

category

String

工作项类型，系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug，独立软件类项目可选值为:RR/SF/IR/US/Task/Bug，云服务类项目可选值为:RR/Epic/FE/US/Task/Bug

total

Integer

工作项总数

processing

Integer

处理中的工作项数量

completed

Integer

已完成的工作项数量

expired

Integer

已超期的工作项数量

remain_di

Double

缺陷的遗留DI，统计范围为该项目下所有非关闭态、非草稿态的缺陷

DI计算规则: DI=提示0.1 + 一般1 +严重3 + 致命10

category_name

String

统计面板名称

状态码： 400

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

http://localhost:8083/ipdprojectservice/v3/projects/0f516b2816e044efb51f301dd55941a2/statistic?classification=bug

{ }

响应示例

状态码： 200

统计成功响应

{
  "status" : "success",
  "message" : null,
  "result" : [ {
    "category" : "RR",
    "total" : 0,
    "processing" : 0,
    "completed" : 0,
    "expired" : 0,
    "category_name" : "原始需求"
  }, {
    "category" : "SF",
    "total" : 2,
    "processing" : 1,
    "completed" : 0,
    "expired" : 0,
    "category_name" : "系统特性"
  }, {
    "category" : "IR",
    "total" : 2,
    "processing" : 1,
    "completed" : 0,
    "expired" : 1,
    "category_name" : "初始需求"
  }, {
    "category" : "SR",
    "total" : 1,
    "processing" : 0,
    "completed" : 0,
    "expired" : 0,
    "category_name" : "系统需求"
  }, {
    "category" : "AR",
    "total" : 1,
    "processing" : 0,
    "completed" : 0,
    "expired" : 0,
    "category_name" : "分配需求"
  }, {
    "category" : "Task",
    "total" : 1,
    "processing" : 0,
    "completed" : 0,
    "expired" : 0,
    "category_name" : "任务"
  }, {
    "category" : "Bug",
    "total" : 5,
    "processing" : 0,
    "completed" : 0,
    "expired" : 0,
    "category_name" : "缺陷"
  } ]
}

状态码： 400

统失败响应

{
  "error_code" : "PM.02175302",
  "error_msg" : "服务繁忙:ISSUE_SERVICE"
}

状态码

状态码

描述

200

统计成功响应

400

统失败响应

错误码

请参见错误码。

父主题： IPD统计概览

相关文档