更新时间:2025-09-11 GMT+08:00
分享

批量更新工作项

功能介绍

批量更新工作项

调用方法

请参见如何调用API

URI

PUT /v1/ipdprojectservice/projects/{project_id}/issues/batch

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

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

约束限制:

必传。

取值范围:

最小长度:10,最大长度:32768。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

id

Array of strings

参数解释:

需要更新的工作项id数组,可通过高级查询工作项接口获取,响应消息体中的id字段的值就是工作项id

约束限制:

正则表达式,^([0-9]{18,19})$

取值范围:

最小长度:18,最大长度:19

默认取值:

不涉及

attribute

IssueEntity object

参数解释:

更新的工作项内容

表4 IssueEntity

参数

是否必选

参数类型

描述

id

String

参数解释:

需要更新的工作项id,可通过查询树状工作项接口获取,响应消息体中的id字段的值就是工作项id。

约束限制:

正则表达式,^([0-9]{18,19})$

取值范围:

不涉及。

默认取值:

不涉及。

title

String

参数解释:

工作项标题,可通过查询树状工作项接口获取,响应消息体中的title字段的值就是工作项标题。

约束限制:

最小长度:1,最大长度:256。

取值范围:

不涉及。

默认取值:

不涉及。

description

String

参数解释:

工作项描述字段,可通过查询树状工作项接口获取,响应消息体中的description字段的值就是工作项描述字段。

约束限制:

最小长度:1,最大长度:50000。

取值范围:

不涉及。

默认取值:

不涉及。

type

String

参数解释:

工作项大分类定义。工作项创建、编辑无此字段,仅作展示用,可通过查询树状工作项接口获取,响应消息体中的type字段的值就是工作项大分类定义。

约束限制:

最小长度:0,最大长度:128。

取值范围:

requirement(研发需求),bug(缺陷),task(任务),feature(特性),raw_requirement(原始需求)。

默认取值:

不涉及。

number

String

参数解释:

工作项编号,可通过查询树状工作项接口获取,响应消息体中的number字段的值就是工作项编号

约束限制:

最小长度:0,最大长度:128。

取值范围:

不涉及。

默认取值:

不涉及。

category

String

参数解释:

工作项类型,可通过查询树状工作项接口获取,响应消息体中的category字段的值就是工作项类型

约束限制:

不涉及。

取值范围:

系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug。

独立软件类项目可选值为:RR/SF/IR/US/Task/Bug。

云服务类项目可选值为:RR/Epic/FE/US/Task/Bug。

默认取值:

不涉及。

parent_id

String

参数解释:

父工作项id,可通过查询树状工作项接口获取,响应消息体中的parent_id字段的值就是父工作项id

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

project_id

String

参数解释

项目的32位uuid,项目唯一标识,通过查询项目列表接口获取,响应消息体中的project_id字段的值就是项目ID。

约束限制

正则表达式,[A-Za-z0-9]{32}。

取值范围:

不涉及

默认取值

不涉及。

status

String

参数解释:

工作项状态code,可通过查询树状工作项接口获取,响应消息体中的status字段的值就是工作项状态code。

约束限制:

最小长度:2,最大长度:32。

取值范围:

不涉及。

默认取值:

不涉及。

assignee

UserEntity object

参数解释:

工作项责任人。

assigned_cc

Array of UserEntity objects

参数解释:

工作项抄送人,支持多个抄送人。同一工作项最多支持50个抄送人。

created_by

UserEntity object

参数解释:

工作项创建人。

created_time

String

参数解释:

工作项创建时间,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

modified_by

UserEntity object

参数解释:

工作项最近更新人。

modified_time

String

参数解释:

工作项最近更新时间,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

plan_end_date

String

参数解释:

工作项计划结束日期,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

close_time

String

参数解释:

工作项关闭时间,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

workload

String

参数解释:

工作项计划工时,保留一位小数,取值范围为0~999999999.9。

约束限制:

不涉及。

取值范围:

0~999999999.9。

默认取值:

不涉及。

link

String

参数解释:

工作项关联项id,多个关联项用英文逗号分隔,同一工作项最多支持50个关联项,可通过查询树状工作项接口获取,响应消息体中的link字段的值就是工作项关联项id。

约束限制:

最小长度:0,最大长度:2048。

取值范围:

不涉及。

默认取值:

不涉及。

suspended

Boolean

参数解释:

工作项是否已挂起。

约束限制:

不涉及。

取值范围:

true,false。

默认取值:

不涉及。

status_modified_time

String

参数解释:

工作项状态改变时间,可用于计算工作项在当前状态停留天数,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

labels

Array of LabelEntity objects

参数解释:

工作项标签。

custom_fields

Array of FieldCodeValuePair objects

参数解释:

工作项自定义字段映射,用户添加的系统字段也在此列

{

"code":"字段code",

"value":"字段值"

}。

children

Array of IssueEntity objects

参数解释:

工作项的子工作项集合。

ir2feature

String

参数解释:

IR和FE的关联字段,工作项类型为IR时,有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

need_break

String

参数解释:

工作项是否需要分解,仅可以分解的工作项类型有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

break_status

String

参数解释:

分解状态,

已分解(decomposed)

未分解(undecomposed)

不涉及( --)。

约束限制:

不涉及。

取值范围:

decomposed,undecomposed,--。

默认取值:

不涉及。

baseline

String

参数解释:

工作项基线状态,

未基线(null)

已基线(baselined)

基线评审中(baseline-reviewing)。

约束限制:

不涉及。

取值范围:

null,baselined,baseline-reviewing。

默认取值:

不涉及。

priority

String

参数解释:

工作项优先级,部分工作项有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

related_network_security

String

参数解释:

是否涉及网络安全。预设字段中,仅研发需求有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

collaboratives

String

参数解释:

研发需求协同信息,协同任务id,可通过查询树状工作项接口获取,响应消息体中的collaboratives字段的值就是研发需求协同信息,协同任务id。

约束限制:

最小长度:0,最大长度:256。

取值范围:

不涉及。

默认取值:

不涉及。

business_domain

String

参数解释:

领域字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

plan_pi

String

参数解释:

工作项发布计id,可通过查询树状工作项接口获取,响应消息体中的plan_pi字段的值就是工作项发布计id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

plan_iteration

String

参数解释:

工作项完成的迭代计划id,在Bug中为修复迭代计划id,可通过查询树状工作项接口获取,响应消息体中的plan_iteration字段的值就是迭代计划id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

change_status

String

参数解释:

工作项变更状态,

变更评审中(change-reviewing)

已变更(changed)

未变更(unchange或null)。

约束限制:

最小长度:0,最大长度:32。

取值范围:

change-reviewing,changed,unchange,null。

默认取值:

不涉及。

no_break_reason

String

参数解释:

无需分解原因,need_break=no时有此字段

约束限制:

最小长度:0,最大长度:512。

取值范围:

不涉及。

默认取值:

不涉及。

submitted_by

Array of UserEntity objects

参数解释:

工作项提出人。

ir2rr

String

参数解释:

IR关联的RR id,多选时用英文逗号分隔。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

feature_set

String

参数解释:

特性集id,可通过查询树状工作项接口获取,响应消息体中的feature_set字段的值就是特性集id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

expected_repair_date

String

参数解释:

期望修复时间。预设字段中,仅Bug有此字段,unix时间戳,单位:毫秒。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

found_pi

String

参数解释:

缺陷发现发布计划id,预设字段中,仅Bug有此字段,可通过查询树状工作项接口获取,响应消息体中的found_pi字段的值就是缺陷发现发布计划id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

found_iteration

String

参数解释:

缺陷发现迭代计划id,预设字段中,仅Bug有此字段,可通过查询树状工作项接口获取,响应消息体中的found_iteration字段的值就是缺陷发现迭代计划id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

reason_analysis

String

参数解释:

分析原因。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

repair_solution

String

参数解释:

修复方案。预设字段中,仅Bug有此字段。

约束限制:

最小长度:0,最大长度:50000。

取值范围:

不涉及。

默认取值:

不涉及。

test_report

String

参数解释:

测试报告。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

sys_no_repair_reason

String

参数解释:

无需修复原因。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

sys_activation_reason

String

参数解释:

激活原因。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

sys_return_reason

String

参数解释:

退回原因。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

test_failures_times

Integer

参数解释:

回归不通过次数。预设字段中,仅Bug有此字段。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

close_type

String

参数解释:

关闭类型。预设字段中,仅Bug有此字段,可选值为problem_solved,problem_to_requirement,duplicate_problem,not_a_problem。分别对应问题解决关闭,问题转需求关闭,重复问题关闭,非问题关闭。

约束限制:

不涉及。

取值范围:

problem_solved,problem_to_requirement,duplicate_problem,not_a_problem。

默认取值:

不涉及。

plan_owner

UserEntity object

参数解释:

工作项规划责任人。

doing_owner

UserEntity object

参数解释:

工作项实现责任人。

delivered_owner

UserEntity object

参数解释:

工作项交付责任人。

checking_owner

UserEntity object

参数解释:

工作项验收责任人。

test_owner

UserEntity object

参数解释:

工作项测试责任人。

develop_owner

UserEntity object

参数解释:

工作项开发责任人。

processing_owner

UserEntity object

参数解释:

工作项处理中责任人。

fixed_owner

UserEntity object

参数解释:

工作项修复责任人。

researchanddevelop_owner

UserEntity object

参数解释:

工作项研发责任人。

analyse_owner

UserEntity object

参数解释:

工作项分析责任人。

表5 LabelEntity

参数

是否必选

参数类型

描述

id

String

参数解释:

标签id,可通过查询标签列表接口获取,响应消息体中的id字段的值就是标签id。

约束限制:

正则表达式,^([0-9]{18,19})$。

取值范围:

不涉及。

默认取值:

不涉及。

label_type

String

参数解释:

标签所属工作项类型,对应工作项的type字段。

约束限制:

最小长度:0,最大长度:32。

取值范围:

不涉及。

默认取值:

不涉及。

color

String

参数解释:

标签颜色RGB。

约束限制:

最小长度:0,最大长度:16。

取值范围:

不涉及。

默认取值:

不涉及。

title

String

参数解释:

标签标题。

约束限制:

最小长度:2,最大长度:256。

取值范围:

不涉及。

默认取值:

不涉及。

表6 FieldCodeValuePair

参数

是否必选

参数类型

描述

code

String

参数解释:

工作项字段code值。

约束限制:

最小长度:0,最大长度:32。

取值范围:

不涉及。

默认取值:

不涉及。

value

String

参数解释:

工作项自定义字段值,为多选时用英文逗号分隔。

约束限制:

最小长度:0,最大长度:10000。

取值范围:

不涉及。

默认取值:

不涉及。

表7 UserEntity

参数

是否必选

参数类型

描述

id

String

参数解释:

用户id,可通过获取当前用户信息接口获取,响应消息体中的id字段的值就是用户id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

name

String

参数解释:

用户名称。

约束限制:

最小长度:2,最大长度:64。

取值范围:

不涉及。

默认取值:

不涉及。

nick_name

String

参数解释:

用户昵称。

约束限制:

最小长度:2,最大长度:30。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表8 响应Body参数

参数

参数类型

描述

result

Array of IssueBatchOperateEntitiesResult objects

参数解释:

批量编辑的结果

status

String

参数解释:

操作状态

取值范围:

不涉及

message

String

参数解释:

操作失败原因

取值范围:

不涉及

表9 IssueBatchOperateEntitiesResult

参数

参数类型

描述

success

Array of IssueOperateResult objects

参数解释:

成功的结果

failed

Array of IssueOperateResult objects

参数解释:

失败的结果

表10 IssueOperateResult

参数

参数类型

描述

id

String

参数解释:

变更的工作项id

取值范围:

不涉及

operator

String

参数解释:

工作项变更人id

取值范围:

不涉及

state

String

参数解释:

工作项变更后生命周期状态

取值范围:

不涉及

operate_time

String

参数解释:

工作项变更时间

取值范围:

不涉及

状态码:400

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

批量更新研发需求

PUT https://{endpoint}/v1/ipdprojectservice/projects/8e70d806a8f04d018ea6af6b6ffe7b96/issues/batch

{
  "id" : [ "957294446158852096", "957315051394478080" ],
  "attribute" : {
    "category" : "IR",
    "priority" : "低",
    "submitted_by" : [ {
      "id" : "a360371833bf4c558f796fd707b44daf"
    } ],
    "labels" : [ {
      "id" : "956308025419804673"
    }, {
      "id" : "956308025419804673"
    } ],
    "custom_fields" : [ {
      "code" : "c7073388365101674496",
      "value" : "881467547473321986,881467547473321987"
    }, {
      "code" : "c7148504958125613056",
      "value" : "我是一个项目自定义字段"
    }, {
      "code" : "module",
      "value" : "956584293264568320"
    }, {
      "code" : "c7148512434669625344",
      "value" : "956591616891461634"
    } ]
  }
}

响应示例

状态码:200

OK

{
  "status" : "success",
  "result" : [ {
    "success" : [ {
      "id" : "957294446158852096",
      "operator" : "a360371833bf4c558f796fd707b44daf",
      "operate_time" : "2024-01-29T21:26:11Z"
    }, {
      "id" : "957315051394478080",
      "operator" : "a360371833bf4c558f796fd707b44daf",
      "operate_time" : "2024-01-29T21:26:11Z"
    } ],
    "failed" : [ ]
  } ]
}

状态码:400

错误原因

{
  "error_code" : "PM.02175000",
  "error_msg" : "系统繁忙,请稍后再试"
}

状态码

状态码

描述

200

OK

400

错误原因

错误码

请参见错误码

相关文档