批量更新工作项 - BatchUpdateIpdIssues

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

最小长度：10，最大长度：32768。

默认取值：

不涉及。

id

是

Array of strings

参数解释：

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

约束限制：

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

取值范围：

最小长度：18，最大长度：19

默认取值：

不涉及

attribute

是

IssueEntity object

参数解释：

更新的工作项内容

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。可通过查询工作项状态接口获取，响应消息体中的code字段的值就是工作项工作项状态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：未分解

• 置空：不涉及

默认取值：

不涉及。

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

参数解释：

工作项变更状态。

约束限制：

最小长度：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

参数解释：

关闭类型。

约束限制：

不涉及。

取值范围：

• 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

参数解释：

工作项分析责任人。

id

否

String

参数解释：

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

约束限制：

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

取值范围：

不涉及。

默认取值：

不涉及。

label_type

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

• raw requirement：原始需求

• feature：系统特性

• requirement：研发需求

• task：任务

• bug：缺陷

默认取值：

不涉及。

color

否

String

参数解释：

标签颜色RGB。

约束限制：

最小长度：0，最大长度：16。

取值范围：

不涉及。

默认取值：

不涉及。

title

否

String

参数解释：

标签标题。

约束限制：

最小长度：2，最大长度：256。

取值范围：

不涉及。

默认取值：

不涉及。

code

否

String

参数解释：

工作项字段code值。

约束限制：

最小长度：0，最大长度：32。

取值范围：

不涉及。

默认取值：

不涉及。

value

否

String

参数解释：

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

约束限制：

最小长度：0，最大长度：10000。

取值范围：

不涉及。

默认取值：

不涉及。

id

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

name

否

String

参数解释：

用户名称。

约束限制：

不涉及。

取值范围：

最小长度：2，最大长度：64。

默认取值：

不涉及。

nick_name

否

String

参数解释：

用户昵称。

约束限制：

不涉及。

取值范围：

最小长度：2，最大长度：30。

默认取值：

不涉及。

result

Array of IssueBatchOperateEntitiesResult objects

参数解释：

批量编辑的结果

status

String

参数解释：

返回状态。

取值范围：

• success：响应成功

• error：响应失败

message

String

参数解释：

操作失败原因

取值范围：

不涉及

success

Array of IssueOperateResult objects

参数解释：

成功的结果

failed

Array of IssueOperateResult objects

参数解释：

失败的结果

id

String

参数解释：

变更的工作项id

取值范围：

不涉及

operator

String

参数解释：

工作项变更人id

取值范围：

不涉及

state

String

参数解释：

工作项的作废标识，枚举类型。

取值范围：

• 正在工作：可正常操作的工作项

• 作废：软删除后的工作项，可在回收站恢复

• 删除：彻底删除后的工作项，无法恢复

operate_time

String

参数解释：

工作项变更时间

取值范围：

不涉及

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

错误描述，对error_code的补充解释。

取值范围：

不涉及。

200

OK

400

错误原因