批量创建工作项 - BatchCreateIpdIssuesV2

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

32个字符，由英文字母和数字组成。

默认取值：

不涉及。

X-Auth-Token

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

10~32768个字符。

默认取值：

不涉及。

[数组元素]

是

Array of IssueCreateEntity objects

工作项创建对象

title

是

String

参数解释：

工作项标题。

约束限制：

不涉及。

取值范围：

2~256个字符。

默认取值：

不涉及。

description

是

String

参数解释：

工作项描述字段。

约束限制：

不涉及。

取值范围：

0~500000个字符。

默认取值：

不涉及。

category

是

String

参数解释：

工作项类型编码。编辑工作项时，此字段必填、值为当前工作项正确的工作项类型，但不会更新此字段。

约束限制：

不涉及。

取值范围：

支持多种工作项类型，使用英文逗号分隔。

• 系统设备类项目：RR、SF、IR、SR、AR、Task、Bug

• 独立软件类项目：RR、SF、IR、US、Task、Bug

• 云服务类项目：RR、Epic、FE、US、Task、Bug

默认取值：

不涉及。

category_layer_id

是

String

参数解释：

工作项类型层级关系ID，此参数影响工作项的层级显示。通过获取模型树配置信息获取，根据参数中的category在响应消息体中category_layer_config中找到对应的category_code，和category_code同级的id就是工作项类型层级关系ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

parent_id

是

String

参数解释：

父工作项ID。

约束限制：

创建子工作项时必填，其他场景非必填。

取值范围：

不涉及。

默认取值：

不涉及。

status

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

assignee

是

UserEntity object

参数解释：

工作项责任人。

约束限制：

Bug必填。其他工作项类型非必填，默认责任人为当前用户。

recipient

否

Array of UserEntity objects

参数解释：

原始需求承接人。

约束限制：

当工作项类型为RR时字段必填，其他工作项类型无此字段。

assigned_cc

否

Array of UserEntity objects

参数解释：

工作项抄送人，支持多个抄送人。

约束限制：

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

plan_end_date

否

String

参数解释：

工作项计划结束日期。

约束限制：

0~13个字符的数字字符串，可选负号前缀。

取值范围：

时间戳。

默认取值：

不涉及。

workload

否

String

参数解释：

工作项计划工时。

约束限制：

不涉及。

取值范围：

0~999999999.9中的数字字符串。

默认取值：

不涉及。

link

否

String

参数解释：

工作项关联项ID。

约束限制：

多个关联项用英文逗号分隔，同一工作项最多支持50个关联项。

取值范围：

不涉及。

默认取值：

不涉及。

labels

否

Array of LabelEntity objects

参数解释：

工作项标签。

约束限制：

不涉及。

custom_fields

否

Array of FieldCodeValuePair objects

参数解释：

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

约束限制：

不涉及。

ir2feature

否

String

参数解释：

IR和SF的关联字段。

约束限制：

IR可以填写该字段。

取值范围：

不涉及。

默认取值：

不涉及。

priority

否

String

参数解释：

工作项优先级。

约束限制：

RR、SF、FE、IR、SR、AR、Task、Bug可以填写该字段。

取值范围：

• 低：低优先级。

• 中：中优先级。

• 高：高优先级。

默认取值：

不涉及。

related_network_security

否

String

参数解释：

是否涉及网络安全。

约束限制：

仅研发需求有此字段。

取值范围：

• yes：涉及网络安全。

• no：不涉及网络安全。

默认取值：

不涉及。

collaboratives

否

String

参数解释：

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

约束限制：

协同任务ID。IR、SR、AR、US有此字段。

取值范围：

不涉及。

默认取值：

不涉及。

business_domain

否

String

参数解释：

领域字段。

约束限制：

FE、SF、IR、SR、AR、Bug有此字段。

取值范围：

• software

• soft-hardware

• hardware

• 性能

• 功能

• 运维

• 运营

• 用户体验

• 隐私保护

• 合规

• 韧性(可靠性/可用性)

• 韧性(危险检测与相应恢复)

• 透明

• 无害

• 安全

• API

• 成本

• 可维护性

• 其他DFX

• 可用性

• others

默认取值：

不涉及。

plan_pi

否

String

参数解释：

工作项发布计划ID。

约束限制：

默认SR、AR、US、Task、Bug有此字段。

取值范围：

不涉及。

默认取值：

不涉及。

submitted_by

否

Array of UserEntity objects

参数解释：

工作项提出人。

约束限制：

仅RR、Bug有此字段。

ir2rr

否

String

参数解释：

IR关联的RR的Id。

约束限制：

仅IR有此字段，多选时用英文逗号分隔。

取值范围：

不涉及。

默认取值：

不涉及。

feature_set

否

String

参数解释：

特性集ID。

约束限制：

仅SF/FE有此字段。

取值范围：

不涉及。

默认取值：

不涉及。

id

否

String

参数解释：

用户ID，可通过查询项目成员列表接口获取，响应消息体中的id字段的值就是用户ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

name

否

String

参数解释：

用户名称。

约束限制：

不涉及。

取值范围：

2~64个字符。

默认取值：

不涉及。

nick_name

否

String

参数解释：

用户昵称。

约束限制：

不涉及。

取值范围：

2~30个字符。

默认取值：

不涉及。

id

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

18~19个字符的数字字符串。

默认取值：

不涉及。

category_types

否

Array of strings

参数解释：

标签所属工作项类型编码。

约束限制：

不涉及。

默认取值：

不涉及。

label_type

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

• raw requirement：原始需求

• feature：系统特性

• requirement：研发需求

• task：任务

• bug：缺陷

默认取值：

不涉及。

color

否

String

参数解释：

标签颜色RGB。

约束限制：

0~16个字符。

取值范围：

可选颜色代码与对应中文描述如下：

• #86CAFF：浅蓝色

• #6DDEBB：青绿色

• #A6DD82：黄绿色

• #FAC20A：金黄色

• #FA9841：橙色

• #F66F6A：珊瑚红

• #F3689A：粉红色

• #A97AF8：淡紫色

• #71757F：中性灰

• #5E7CE0：宝蓝色

• #207AB3：深蓝色

• #169E6C：翠绿色

• #6CA83B：草绿色

• #B58200：棕黄色

• #B54E04：赭石色

• #B02121：朱红色

• #AD215B：玫红色

• #572DB3：深紫色

• #4F4F4F：深灰色

• #3C51A6：靛蓝色

默认取值：

不涉及。

title

否

String

参数解释：

标签标题。

约束限制：

1~30个字符。

取值范围：

不涉及。

默认取值：

不涉及。

code

否

String

参数解释：

工作项自定义字段code值。可选值可以通过查询字段模板列表接口获取，响应体中的code就是字段唯一标识。

约束限制：

0~32个字符。

取值范围：

不涉及。

默认取值：

不涉及。

value

否

String

参数解释：

工作项自定义字段值。

约束限制：

为多选时用英文逗号分隔。

取值范围：

不涉及。

默认取值：

不涉及。

result

Array of IssueCreateResponse objects

参数解释：

创建的工作项返回值。

status

String

参数解释：

返回状态。

取值范围：

success：响应成功。

error：响应失败

message

String

参数解释：

失败原因。

取值范围：

不涉及。

id

String

参数解释：

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

取值范围：

不涉及。

title

String

参数解释：

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

取值范围：

不涉及。

description

String

参数解释：

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

取值范围：

不涉及。

type

String

参数解释：

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

取值范围：

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

number

String

参数解释：

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

取值范围：

不涉及。

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。

取值范围：

不涉及。

project_id

String

参数解释：

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

取值范围：

不涉及

status

String

参数解释：

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

取值范围：

不涉及。

state

String

参数解释：

工作项的生命周期，可选值为"正在工作"，"作废"，可通过查询树状工作项接口获取，响应消息体中的state字段的值就是工作项的生命周期。

取值范围：

正在工作，作废。

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。

workload_sum

String

参数解释：

工作项实际工时。

取值范围：

0~999999999.9。

tenant_id

String

参数解释：

工作项所属租户ID，可通过查询树状工作项接口获取，响应消息体中的tenant_id字段的值就是工作项所属租户ID。

取值范围：

不涉及。

link

String

参数解释：

工作项关联项ID，可通过查询树状工作项接口获取，响应消息体中的link字段的值就是工作项关联项ID。

取值范围：

不涉及。

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

参数解释：

工作项的子工作项集合。

path

String

参数解释：

子工作项的路径。

取值范围：

不涉及。

ir2feature

String

参数解释：

IR和SF的关联字段。

取值范围：

不涉及。

need_break

String

参数解释：

工作项是否需要分解。

取值范围：

• yes：需要分解

• no：不需要分解

break_status

String

参数解释：

分解状态。

已分解（decomposed）

未分解（undecomposed）

不涉及（ --）。

取值范围：

decomposed，undecomposed，--。

baseline

String

参数解释：

工作项基线状态。

取值范围：

• null：未基线

• baselined：已基线

• baseline-reviewing：基线评审中

priority

String

参数解释：

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

取值范围：

• 低：低优先级。

• 中：中优先级。

• 高：高优先级。

related_network_security

String

参数解释：

是否涉及网络安全。

取值范围：

不涉及。

取值范围：

• yes：涉及网络安全。

• no：不涉及网络安全。

collaboratives

String

参数解释：

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

取值范围：

不涉及。

business_domain

String

参数解释：

领域字段。

取值范围：

• software

• soft-hardware

• hardware

• 性能

• 功能

• 运维

• 运营

• 用户体验

• 隐私保护

• 合规

• 韧性(可靠性/可用性)

• 韧性(危险检测与相应恢复)

• 透明

• 无害

• 安全

• API

• 成本

• 可维护性

• 其他DFX

• 可用性

• others

plan_pi

String

参数解释：

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

取值范围：

不涉及。

plan_iteration

String

参数解释：

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

取值范围：

不涉及。

change_status

String

参数解释：

工作项变更状态。

变更评审中（change-reviewing）

已变更（changed）

未变更（unchange或null）。

取值范围：

change-reviewing，changed，unchange，null。

no_break_reason

String

参数解释：

无需分解原因。

取值范围：

0~512个字符。

submitted_by

Array of UserEntity objects

参数解释：

工作项提出人。

ir2rr

String

参数解释：

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

取值范围：

不涉及。

feature_set

String

参数解释：

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

取值范围：

不涉及。

expected_repair_date

String

参数解释：

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

取值范围：

不涉及。

found_pi

String

参数解释：

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

取值范围：

不涉及。

found_iteration

String

参数解释：

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

取值范围：

不涉及。

reason_analysis

String

参数解释：

分析原因。

取值范围：

0~50000个字符。

repair_solution

String

参数解释：

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

取值范围：

不涉及。

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。

id

String

参数解释：

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

取值范围：

18~19位的数字字符串(工作项的id字段对应的字符串)。

title

String

参数解释：

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

取值范围：

1~256个字符。

description

String

参数解释：

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

取值范围：

1~500000个字符。

type

String

参数解释：

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

取值范围：

• requirement：研发需求

• bug：缺陷

• task：任务

• feature：特性

• raw_requirement：原始需求

number

String

参数解释：

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

取值范围：

不涉及。

category

String

参数解释：

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

取值范围：

支持多种工作项类型，使用英文逗号分隔。

• 系统设备类项目：RR、SF、IR、SR、AR、Task、Bug

• 独立软件类项目：RR、SF、IR、US、Task、Bug

• 云服务类项目：RR、Epic、FE、US、Task、Bug

category_layer_id

String

参数解释：

工作项类型层级关系ID，此参数影响工作项的层级显示。通过获取模型树配置信息获取，根据参数中的category在响应消息体中category_layer_config中找到对应的category_code，和category_code同级的id就是工作项类型层级关系ID。

取值范围：

不涉及。

parent_id

String

参数解释：

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

取值范围：

18~19位的数字字符串(父工作项的id字段对应的字符串)。

project_id

String

参数解释：

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

取值范围：

通过查询IPD项目列表接口获取的32个字符的项目唯一标识。

status

String

参数解释：

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

取值范围：

2~32个字符。

state

String

参数解释：

工作项的生命周期，可选值为“正在工作”，“作废”，可通过查询树状工作项接口获取，响应消息体中的state字段的值就是工作项的生命周期。

取值范围：

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

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

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

assignee

UserEntity object

参数解释：

工作项责任人。

assigned_cc

Array of UserEntity objects

参数解释：

工作项抄送人，支持多个抄送人。数组元素为UserEntity对象。

取值范围：

不涉及。

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。

workload_sum

String

参数解释：

工作项实际工时。

取值范围：

0~999999999.9。

tenant_id

String

参数解释：

工作项所属租户ID，可通过查询树状工作项接口获取，响应消息体中的tenant_id字段的值就是工作项所属租户ID。

取值范围：

32个字符。

link

String

参数解释：

工作项关联项ID。

取值范围：

0~2048个字符。

suspended

Boolean

参数解释：

工作项是否已挂起。

取值范围：

• true：表示已挂起

• false：表示未挂起

status_modified_time

String

参数解释：

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

取值范围：

不涉及。

labels

Array of LabelEntity objects

参数解释：

工作项标签。数组元素为LabelEntity对象。

取值范围：

不涉及。

custom_fields

Array of FieldCodeValuePair objects

参数解释：

工作项自定义字段映射，用户添加的系统字段也在此列，格式为{"code":"字段code","value":"字段值"}。数组元素为FieldCodeValuePair对象。

取值范围：

不涉及。

children

Array of IssueEntity objects

参数解释：

工作项的子工作项集合。数组元素为IssueEntity对象。

取值范围：

不涉及。

path

String

参数解释：

子工作项的路径。

取值范围：

0~256个字符。

ir2feature

String

参数解释：

IR和SF的关联字段。

取值范围：

不涉及。

need_break

String

参数解释：

工作项是否需要分解。

取值范围：

• yes：需要分解

• no：不需要分解

break_status

String

参数解释：

分解状态。

取值范围：

• decomposed：已分解

• undecomposed：未分解

• 置空：不涉及

baseline

String

参数解释：

工作项基线状态。

取值范围：

• null：未基线

• baselined：已基线

• baseline-reviewing：基线评审中

priority

String

参数解释：

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

取值范围：

• 低：低优先级。

• 中：中优先级。

• 高：高优先级。

related_network_security

String

参数解释：

是否涉及网络安全。

取值范围：

• yes：涉及网络安全。

• no：不涉及网络安全。

collaboratives

String

参数解释：

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

取值范围：

0~256个字符。

business_domain

String

参数解释：

领域字段。

取值范围：

• software

• soft-hardware

• hardware

• 性能

• 功能

• 运维

• 运营

• 用户体验

• 隐私保护

• 合规

• 韧性(可靠性/可用性)

• 韧性(危险检测与相应恢复)

• 透明

• 无害

• 安全

• API

• 成本

• 可维护性

• 其他DFX

• 可用性

• others

plan_pi

String

参数解释：

工作项发布计划ID。通过发布/迭代计划列表查询接口查询计划列表，返回参数中PlanVO里面的category=PI的对象的id字段就是迭代计划的ID。

取值范围：

18~19个字符的数字字符串。

plan_iteration

String

参数解释：

工作项完成的迭代计划ID，在Bug中为修复迭代计划ID。通过发布/迭代计划列表查询接口查询计划列表，返回参数中PlanVO里面的category=Iteration的对象的id字段就是迭代计划的ID。

取值范围：

18~19个字符的数字字符串。

change_status

String

参数解释：

工作项变更状态。

取值范围：

• change-reviewing：变更评审中

• changed：已变更

• unchange：未变更

• null：未变更

no_break_reason

String

参数解释：

无需分解原因。

取值范围：

0~512个字符。

submitted_by

Array of UserEntity objects

参数解释：

工作项提出人。数组元素为UserEntity对象。

取值范围：

不涉及。

ir2rr

String

参数解释：

IR关联的RR ID，可以通过查询工作项列表或者查询树状工作项接口获取，响应消息体中的id字段的值就是工作项ID。

取值范围：

0~1024个字符。

feature_set

String

参数解释：

特性集ID，可以通过查询特性集接口获取，响应消息体中的id字段的值就是特性集ID。

取值范围：

18~19个字符的数字字符串。

expected_repair_date

String

参数解释：

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

取值范围：

11~19个字符。

found_pi

String

参数解释：

缺陷发现发布计划ID，预设字段中，仅Bug有此字段。通过发布/迭代计划列表查询接口查询计划列表，返回参数中PlanVO里面的category=PI的对象的id字段就是迭代计划的ID。

取值范围：

18~19个字符的数字字符串。

found_iteration

String

参数解释：

缺陷发现迭代计划ID，预设字段中，仅Bug有此字段。通过发布/迭代计划列表查询接口查询计划列表，返回参数中PlanVO里面的category=Iteration的对象的id字段就是迭代计划的ID。

取值范围：

18~19个字符的数字字符串。

reason_analysis

String

参数解释：

分析原因。

取值范围：

0~50000个字符。

repair_solution

String

参数解释：

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

取值范围：

0~50000个字符。

test_report

String

参数解释：

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

取值范围：

0~50000个字符。

sys_no_repair_reason

String

参数解释：

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

取值范围：

0~50000个字符。

sys_activation_reason

String

参数解释：

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

取值范围：

0~50000个字符。

sys_return_reason

String

参数解释：

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

取值范围：

0~50000个字符。

test_failures_times

Integer

参数解释：

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

取值范围：

0~999999。

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

参数解释：

工作项分析责任人。负责工作项的需求分析和技术分析。

plan_start_date

String

参数解释：

计划开始时间。工作项的计划启动日期，用于项目进度管理和排期。

取值范围：

11~19个字符的时间戳字符串，单位为毫秒（ms）。

expect_delivery_time

String

参数解释：

期望完成时间。工作项的预期交付日期，用于跟踪工作项是否按期完成。

取值范围：

11~19个字符的时间戳字符串，单位为毫秒（ms）。

plan_test_end_date

String

参数解释：

计划测试结束时间。Bug类型工作项的计划测试完成日期，用于跟踪Bug修复后的测试进度。

取值范围：

11~19个字符的时间戳字符串，单位为毫秒（ms）。

severity

String

参数解释：

严重程度。Bug类型工作项的严重级别，用于评估Bug的影响范围和修复优先级。

取值范围：

• 致命：系统崩溃、数据丢失等严重影响

• 严重：主要功能无法使用

• 一般：次要功能异常，有替代方案

• 提示：界面优化、建议性问题

promised

String

参数解释：

是否承诺。RR（原始需求）类型工作项的承诺状态标识，用于标记需求是否已承诺交付。

取值范围：

• yes：已承诺

• no：未承诺

recipient

Array of UserEntity objects

参数解释：

承接人。RR（原始需求）类型工作项的需求承接责任人，负责需求的分析和转化。

取值范围：

不涉及。

sys_no_develop_reason

String

参数解释：

无需研发原因。RR（原始需求）类型工作项不需要进行研发的原因说明。

取值范围：

0~50000个字符。

val_feature

String

参数解释：

价值特性。SF/FE类型工作项对应的业务价值特性描述，用于关联业务价值和技术实现。

取值范围：

• yes：是

• no：否

function_scene

String

参数解释：

功能场景。SF/FE类型工作项的功能应用场景描述，用于说明特性的使用场景和用户故事。

取值范围：

0~512个字符。

id

String

参数解释：

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

取值范围：

18~19个字符的数字字符串。

category_types

Array of strings

参数解释：

标签所属工作项类型编码。

label_type

String

参数解释：

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

取值范围：

• raw requirement：原始需求

• feature：系统特性

• requirement：研发需求

• task：任务

• bug：缺陷

color

String

参数解释：

标签颜色RGB。

取值范围：

可选颜色代码与对应中文描述如下：

• #86CAFF：浅蓝色

• #6DDEBB：青绿色

• #A6DD82：黄绿色

• #FAC20A：金黄色

• #FA9841：橙色

• #F66F6A：珊瑚红

• #F3689A：粉红色

• #A97AF8：淡紫色

• #71757F：中性灰

• #5E7CE0：宝蓝色

• #207AB3：深蓝色

• #169E6C：翠绿色

• #6CA83B：草绿色

• #B58200：棕黄色

• #B54E04：赭石色

• #B02121：朱红色

• #AD215B：玫红色

• #572DB3：深紫色

• #4F4F4F：深灰色

• #3C51A6：靛蓝色

title

String

参数解释：

标签标题。

取值范围：

不涉及。

code

String

参数解释：

工作项自定义字段code值。可选值可以通过查询字段模板列表接口获取，响应体中的code就是字段唯一标识。

取值范围：

不涉及。

value

String

参数解释：

工作项自定义字段值。

取值范围：

不涉及。

id

String

参数解释：

用户ID，可通过查询项目成员列表接口获取，响应消息体中的id字段的值就是用户ID。

取值范围：

不涉及。

name

String

参数解释：

用户名称。

取值范围：

2~64个字符。

nick_name

String

参数解释：

用户昵称。

取值范围：

2~30个字符。

error_code

String

参数解释：

错误码。

取值范围：

不涉及。

error_msg

String

参数解释：

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

取值范围：

不涉及。

200

OK

400

请求失败的响应。例如无操作权限、项目不存在。