响应示例 状态码： 200 OK { "records" : [ { "work_item_record_id" : "7401906a85de466c81fd90e22824eb19", "work_item_id" : "4633454879781163008", "project_id" : "526cefde62004de2b62b5e8dd2c2b3af", "work_item_statuses" : [ { "id" : "7401906a85de466c81fd90e22824eb19", "status" : { "id" : "d25fe91f7f6b489db5f804e66ac3b360", "name" : "7401906a85de466c81fd90e22824eb19", "type" : "BACK LOG ", "description" : "demo", "parent_status_id" : "7401906a85de466c81fd90e22824aaaa" } } ] } ], "total" : 1 }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 records Array of WorkitemStatusRecords objects 操作历史 total Integer 总数 表5 WorkitemStatusRecords 参数 参数类型 描述 work_item_record_id String 工作项的记录id，一个工作项对应一条记录 最小长度：32 最大长度：32 work_item_id String 工作项id project_id String devcloud项目的32位id 最小长度：32 最大长度：32 work_item_statuses Array of WorkitemStatus objects 操作历史 表6 WorkitemStatus 参数 参数类型 描述 id String 工作项状态变更记录的id,每次变更产生一条新的记录id 最小长度：1 最大长度：32 status status object 工作项的状态 表7 status 参数 参数类型 描述 id String 工作项的状态id 最小长度：1 最大长度：32 name String 状态名称 最小长度：1 最大长度：60 type String 工作项状态的类型， BACKLOG( "初始化"), READY("待启动"), IN_PROGRESS("进行中"), COMPLETE("已完成"), DONE("已结束"), description String 工作项状态的描述 parent_status_id String 工作项状态的父状态id 最小长度：1 最大长度：32 状态码： 400 表8 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表9 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

URI GET /v4/projects/{project_id}/work-items/status-records 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String devcloud项目的32位id 最小长度：32 最大长度：32 表2 Query参数 参数 是否必选 参数类型 描述 offset 否 Integer 偏移量 从0开始 最小值：0 缺省值：0 limit 否 Integer 每页数量 最小1,最大100 最小值：1 最大值：100 缺省值：100

响应参数 状态码： 200 表8 响应Body参数 参数 参数类型 描述 result Array of IssueEntity objects 创建的工作项返回值 status String 操作状态 message String 失败原因 表9 IssueEntity 参数 参数类型 描述 id String 工作项id title String 工作项标题 description String 工作项描述字段 type String 工作项大分类定义 requirement(研发需求)、bug(缺陷)、task(任务)、feature(特性)、raw_requirement(原始需求) number String 工作项编号 category String 工作项类型，系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug，独立软件类项目可选值为:RR/SF/IR/US/Task/Bug，云服务类项目可选值为:RR/Epic/FE/US/Task/Bug。 编辑工作项时，此字段必填、值为当前工作项正确的工作项类型，但不会更新此字段 parent_id String 父工作项id project_id String 工作项所属的项目id status String 工作项状态code state String 工作项的生命周期，可选值为"正在工作","作废" assignee UserEntity object 工作项责任人 assigned_cc Array of UserEntity objects 工作项抄送人，支持多个抄送人。同一工作项最多支持50个抄送人 created_by UserEntity object 工作项创建人 created_time String 工作项创建时间 modified_by UserEntity object 工作项最近更新人 modified_time String 工作项最近更新时间 plan_end_date String 工作项计划结束日期，时间戳 close_time String 工作项关闭时间 workload String 工作项计划工时，保留一位小数，取值范围为0~999999999.9 workload_sum String 工作项计划工时，保留一位小数，取值范围为0~999999999.9，不可编辑 tenant_id String 工作项所属租户id link String 工作项关联项id，多个关联项用英文逗号分隔，同一工作项最多支持50个关联项 suspended Boolean 工作项是否已挂起 status_modified_time String 工作项状态改变时间，可用于计算工作项在当前状态停留天数 labels Array of LabelEntity objects 工作项标签 custom_fields Array of FieldCodeValuePair objects 工作项自定义字段映射，用户添加的系统字段也在此列 { "code":"字段code", "value":"字段值" } children Array of IssueEntity objects 工作项的子工作项集合 path String 子工作项的路径 ir2feature String IR和FE的关联字段，工作项类型为IR时，有此字段 need_break String 工作项是否需要分解,仅可以分解的工作项类型有此字段 break_status String 分解状态 已分解—decomposed 未分解—undecomposed 不涉及— -- baseline String 工作项基线状态 未基线 —— null 已基线 —— baselined 基线评审中——baseline-reviewing priority String 工作项优先级，部分工作项有此字段 related_network_security String 是否涉及网络安全。预设字段中，仅研发需求有此字段 collaboratives String 研发需求协同信息，协同任务id business_domain String 领域字段 plan_pi String 工作项发布(老版本名为PI) id plan_iteration String 工作项完成的迭代，在Bug中为修复迭代 change_status String 工作项变更状态 变更评审中——change-reviewing 已变更——changed 未变更-unchange或null no_break_reason String 无需分解原因，need_break=no时有此字段 submitted_by Array of UserEntity objects 工作项提出人 ir2rr String IR关联的RR id，多选时用英文逗号分隔 feature_set String 特性集id expected_repair_date String 期望修复时间。预设字段中，仅Bug有此字段 found_pi String 缺陷发现发布。预设字段中，仅Bug有此字段 found_iteration String 缺陷发现迭代。预设字段中，仅Bug有此字段 reason_analysis String 分析原因。预设字段中，仅Bug有此字段 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有此字段;可选值为 问题解决关闭,问题转需求关闭,重复问题关闭,非问题关闭 表10 UserEntity 参数 参数类型 描述 id String 用户Id name String 用户名称 nick_name String 用户昵称 表11 LabelEntity 参数 参数类型 描述 id String 标签id label_type String 标签所属工作项类型，对应工作项的type字段 color String 标签颜色RGB title String 标签标题 表12 FieldCodeValuePair 参数 参数类型 描述 code String 工作项字段code值 value String 工作项自定义字段值，为多选时用英文逗号分隔 状态码： 400 表13 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of IssueCreateEntity objects 批量创建的工作项参数，每批最大创建10条 表3 IssueCreateEntity 参数 是否必选 参数类型 描述 title 是 String 工作项标题 description 是 String 工作项描述字段 category 是 String 工作项类型，系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug，独立软件类项目可选值为:RR/SF/IR/US/Task/Bug，云服务类项目可选值为:RR/Epic/FE/US/Task/Bug。 编辑工作项时，此字段必填、值为当前工作项正确的工作项类型，但不会更新此字段 parent_id 是 String 父工作项id，创建子工作项时必填，其他场景非必填 status 是 String 工作项状态code assignee 是 UserEntity object 工作项责任人。Bug必填。其他工作项类型非必填，默认责任人为当前用户 recipient 否 Array of UserEntity objects 原始需求承接人，当工作项类型为RR时字段必填，其他工作项类型无此字段 assigned_cc 否 Array of UserEntity objects 工作项抄送人，支持多个抄送人。同一工作项最多支持50个抄送人 plan_end_date 否 String 工作项计划结束日期，时间戳 workload 否 String 工作项计划工时，保留一位小数，取值范围为0~999999999.9 link 否 String 工作项关联项id，多个关联项用英文逗号分隔，同一工作项最多支持50个关联项 labels 否 Array of LabelEntity objects 工作项标签 custom_fields 否 Array of FieldCodeValuePair objects 工作项自定义字段映射，用户添加的系统字段也在此列 { "code":"字段code", "value":"字段值" } children 否 Array of IssueEntity objects 工作项的子工作项集合。RR/IR/SR/Task有此字段 ir2feature 否 String IR和SF/FE的关联字段，IR有此字段 priority 否 String 工作项优先级，RR/SF/FE/IR/SR/AR/Task/Bug有此字段 related_network_security 否 String 是否涉及网络安全。仅研发需求有此字段 collaboratives 否 String 研发需求协同信息，协同任务Id. IR/SR/AR/US有此字段 business_domain 否 String 领域字段, FE,SF/IR/SR/AR/Bug有此字段 plan_pi 否 String 工作项发布(老版本名为PI) 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有此字段 表4 IssueEntity 参数 是否必选 参数类型 描述 id 否 String 工作项id title 否 String 工作项标题 description 否 String 工作项描述字段 type 否 String 工作项大分类定义 requirement(研发需求)、bug(缺陷)、task(任务)、feature(特性)、raw_requirement(原始需求) number 否 String 工作项编号 category 否 String 工作项类型，系统设备类项目可选值为:RR/SF/IR/SR/AR/Task/Bug，独立软件类项目可选值为:RR/SF/IR/US/Task/Bug，云服务类项目可选值为:RR/Epic/FE/US/Task/Bug。 编辑工作项时，此字段必填、值为当前工作项正确的工作项类型，但不会更新此字段 parent_id 否 String 父工作项id project_id 否 String 工作项所属的项目id status 否 String 工作项状态code assignee 否 UserEntity object 工作项责任人 assigned_cc 否 Array of UserEntity objects 工作项抄送人，支持多个抄送人。同一工作项最多支持50个抄送人 created_by 否 UserEntity object 工作项创建人 created_time 否 String 工作项创建时间 modified_by 否 UserEntity object 工作项最近更新人 modified_time 否 String 工作项最近更新时间 plan_end_date 否 String 工作项计划结束日期，时间戳 close_time 否 String 工作项关闭时间 workload 否 String 工作项计划工时，保留一位小数，取值范围为0~999999999.9 link 否 String 工作项关联项id，多个关联项用英文逗号分隔，同一工作项最多支持50个关联项 suspended 否 Boolean 工作项是否已挂起 status_modified_time 否 String 工作项状态改变时间，可用于计算工作项在当前状态停留天数 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 priority 否 String 工作项优先级，部分工作项有此字段 related_network_security 否 String 是否涉及网络安全。预设字段中，仅研发需求有此字段 collaboratives 否 String 研发需求协同信息，协同任务id business_domain 否 String 领域字段 plan_pi 否 String 工作项发布(老版本名为PI) id plan_iteration 否 String 工作项完成的迭代，在Bug中为修复迭代 change_status 否 String 工作项变更状态 变更评审中——change-reviewing 已变更——changed 未变更-unchange或null no_break_reason 否 String 无需分解原因，need_break=no时有此字段 submitted_by 否 Array of UserEntity objects 工作项提出人 ir2rr 否 String IR关联的RR id，多选时用英文逗号分隔 feature_set 否 String 特性集id expected_repair_date 否 String 期望修复时间。预设字段中，仅Bug有此字段 found_pi 否 String 缺陷发现发布。预设字段中，仅Bug有此字段 found_iteration 否 String 缺陷发现迭代。预设字段中，仅Bug有此字段 reason_analysis 否 String 分析原因。预设字段中，仅Bug有此字段 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有此字段;可选值为 问题解决关闭,问题转需求关闭,重复问题关闭,非问题关闭 表5 UserEntity 参数 是否必选 参数类型 描述 id 否 String 用户Id name 否 String 用户名称 nick_name 否 String 用户昵称 表6 LabelEntity 参数 是否必选 参数类型 描述 id 否 String 标签id label_type 否 String 标签所属工作项类型，对应工作项的type字段 color 否 String 标签颜色RGB title 否 String 标签标题 表7 FieldCodeValuePair 参数 是否必选 参数类型 描述 code 否 String 工作项字段code值 value 否 String 工作项自定义字段值，为多选时用英文逗号分隔

响应示例 状态码： 200 ok { "added_work_hours" : [ { "work_hours_id" : "7da14cf9f3c111eda5a5fa163ec9f6c1", "issue_id" : 123456, "user_name" : "user_name", "user_nick_name" : "O_O", "work_date" : "2023-05-15", "work_hours" : "2.0", "work_hours_type_name" : "研发设计" } ] }

请求示例 Post https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb2/issues/123456/work-hours { "start_date" : "2023-05-15", "due_date" : "2023-05-15", "work_hours" : 2.0, "work_hours_type_id" : 21 }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 参数解释：用户Token。通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 约束限制：不涉及 取值范围：最小长度：10，最大长度：32768 默认取值：不涉及 表3 请求Body参数 参数 是否必选 参数类型 描述 start_date 是 String 参数解释：工时开始日期，年-月-日 约束限制：正则表达式， ^\d{4}-\d{2}-\d{2}$ 取值范围：匹配格式为 YYYY-MM-DD 的日期字符串，MM 是两位数的月份限制取值01-12，DD是两位数的日期限制取值01-31 默认取值：不涉及 due_date 是 String 参数解释：工时结束日期，年-月-日 约束限制：正则表达式， ^\d{4}-\d{2}-\d{2}$ 取值范围：匹配格式为 YYYY-MM-DD 的日期字符串，MM 是两位数的月份限制取值01-12，DD是两位数的日期限制取值01-31 默认取值：不涉及 work_hours 是 Double 参数解释：工时总数（若工时日期范围包含多天，单日工时将设为“工时总数/天数”） 约束限制：不涉及 取值范围：最小值：0.0，最大值：100000000 默认取值：不涉及 work_hours_type_id 否 Integer 参数解释：工时类型id （项目预设工时类型id及名称对照：21:研发设计，22:后端开发，23:前端开发(Web)，24:前端开发(小程序)，25:前端开发(App)， 26:测试验证，27:缺陷修复，28:UI设计，29:会议，30:公共事务，31:培训，32:研究，33:其它，34:调休请假） 约束限制：不涉及 取值范围：最小值：21，最大值：34 默认取值：不涉及

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 added_work_hours Array of added_work_hours objects 已添加的工时列表 表5 added_work_hours 参数 参数类型 描述 work_hours_id String 工时id issue_id Integer 添加工时对应的工作项id user_name String 工时添加用户的用户名 user_nick_name String 工时添加用户的用户昵称 work_date String 工时日期 年-月-日 work_hours Double 工时数 work_hours_type_name String 工时类型名称 （项目预设工时类型id及名称对照：21:研发设计，22:后端开发，23:前端开发(Web)，24:前端开发(小程序)，25:前端开发(App)， 26:测试验证，27:缺陷修复，28:UI设计，29:会议，30:公共事务，31:培训，32:研究，33:其它，34:调休请假） 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_msg String 错误描述 error_code String 错误码

URI POST /v4/projects/{project_id}/issues/{issue_id}/work-hours 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 参数解释：项目的32位uuid，项目唯一标识，可以通过ListProjectsV4接口查询项目列表 约束限制：正则表达式， ^[A-Za-z0-9]{32}$ 取值范围：字符串，最小长度：32，最大长度：32 默认取值：不涉及 issue_id 是 Integer 参数解释：工作项id，可通过ListIssuesV4接口高级查询工作项 约束限制：正则表达式，[0-9]{1,10}$ 取值范围：最小长度：1，最大长度：10 默认取值：不涉及

在工作项详情页中管理工作项 在编辑工作项详情页面，您除了可以修改工作项的描述、优先级、责任人等，还可以添加标签、添加附件、关联工作项、查看评审记录、添加工时和查看操作历史。 图2 工作项详情页 表2 详情页相关管理操作 操作项 操作步骤 备注 编辑工作项 在工作项详情页中单击需要修改的字段取值框，在输入框中输入目标值或在下拉框中选择目标值，可即时保存已修改内容。 操作成员需拥有工作项的“编辑”权限。 修改工作项状态 进入工作项详情页面，单击工作项“状态”字段，可根据需要将工作项流转至目标状态。 操作成员需拥有工作项的“状态设置”权限。 上传附件 附件类型支持图片、工作簿、文稿、文本文件等类型。每个工作项可容纳的附件个数不超过100个，附件总容量不得超过50MB。 进入工作项详情，单击“附件”页签。 单击“点击或拖拽文件到此处上传”，选择本地文件，将文件上传至工作项中作为附件。 支持将本地文件直接拖拽到输入框中。当上传进度条达到100%，系统提示附件上传成功。 将鼠标放在上传成功的文件上，会显示可执行的操作。 单击，可以下载文件到本地存放。 单击，可以删除上传的文件。 操作成员需拥有工作项的“上传附件”权限。 添加并查看关联项 工作项可以与项目内的其它类型工作项建立关联关系。 进入工作项详情页面，选择“关联项”页签。 完成关联操作。 父工作项：工作项所归属的父工作项。 说明： FE可以关联Epic。 US可以关联FE。 Task可以关联US。 Bug可以关联US。 子工作项：当前工作项分解的子工作项。 支持批量分解，一次最多只能分解10条。默认一条，且不能删除。 1. 单击“分解”，弹出“分解子工作项”窗口。 2. 输入子工作项的信息。单击图标，可以展开及配置更多信息。 3. 单击“确定”，子工作项分解成功。 该子工作项会自动显示在工作项列表中所属父工作项下。 4. （可选）单击，可取消关联。 说明： 仅Epic、FE、US类型工作项才支持分解子工作项操作。 关联工作项：与本项目中其他类型的工作项，直接建立关联关系。 Epic、US、Task工作项中支持新建和关联Epic、FE、US、Task、Bug，新建操作可参见新建工作项。 FE、Bug工作项中支持关联Epic、RR、FE、US、Task、Bug。 协同缺陷：当前项目的缺陷可以下发给其他项目。 支持批量下发，一次最多只能下发10条。默认一条，且不能删除。 1. 单击“协同下发”，弹出“协同下发”窗口。 2. 输入缺陷下发的基本信息。单击图标，可以展开及配置更多信息。 3. 单击“确定”，缺陷下发成功。 4. （可选）单击，可取消关联。 文件：当前工作项相关的文件。 选择与当前工作项相关联的文件，支持上传本地文件。 Wiki：当前工作项相关的Wiki。 选择与当前工作项相关联的Wiki，支持新建Wiki。 代码提交记录：当前工作项相关的代码提交记录。 仅当代码提交时，关联了当前工作项单号，才会显示相关信息。 代码分支：当前工作项相关的代码分支。 仅当代码分支关联了当前工作项单号，才会显示相关信息。 测试用例：当前工作项相关的测试用例。 说明： 仅Epic、FE、US、Task类型工作项支持关联测试用例。 在测试管理中选择与测试用例相关联的工作项。 测试计划：当前工作项相关的测试计划。 说明： 仅Task类型工作项支持关联测试用例。 选择与本缺陷相关联的测试计划。 操作成员需拥有工作项的“分解/关联/取消关联子工作项”、“关联/取消关联父工作项”、“新建/关联/取消关联工作项”、“关联/取消关联文件”、“关联/取消关联wiki”权限。 添加工时 进入工作项详情页面，选择“工时”页签。 单击“新增工时”，弹出“新增工时”窗口。 填写工时信息。 工时的结束日期不能早于开始日期。 是否勾选“包含周末”，如果不勾选，则工时记录中不会生成周末的记录。 “工时”可以选择“总数”或“每天”。 “工时类型”包括后端开发、前端开发、UI设计、调休请假、缺陷修复、公共事务等，还支持自定义取值，具体步骤参考添加IPD自运营/云服务类项目工作项的工时类型 单击“确定”，工时新增成功。 系统会自动根据填写的工时日期和工时天数生成对应的记录。 工时支持编辑、删除操作。 添加工时操作，成员需拥有工作项的“新增工时”权限。 编辑、删除工时操作默认是谁添加就谁可以操作，项目管理员默认可以编辑、删除所有工时数据。 查看历史记录 历史记录展示了用户的所有操作日志，包括：创建、状态流转、发起评审、关联工作项、新增工时等。 进入工作项详情页面。 选择“历史记录”页签，查看工作项所有的修改操作。 单击或，可以按操作时间的正序或倒序查看历史记录信息。 通过设置查询条件，可以查询到符合条件的历史记录。 操作成员需拥有工作项的“查看”权限。 给工作项打标签 进入工作项详情页面，单击页面上方“标签”后面的，选择“新建标签”。 添加的标签显示在“标签”中。 在弹出的“新建标签”窗口中，输入“标签名称”和选择“标签颜色”。 单击“确定”，标签新建成功。 在原始需求列表中对应需求的编号后会显示新增的标签。 （可选）隐藏标签。 单击“标签”后面的，在弹出窗口中去掉标签的√，则会隐藏标签。 图3 隐藏标签01 将鼠标放在标签名称上，单击，则会隐藏标签。 图4 隐藏标签02 说明： 当有多个工作项需要添加标签时，您可以选择在工作项列表中勾选需要添加标签的需求，单击页面下方的“批量编辑”，选择“标签”字段进行添加。 操作成员需拥工作项的“编辑”权限。 添加评论 进入工作项详情页面。 在“详情”页签，单击“评论”输入框。 图5 添加评论 输入评论内容。 评论支持上传图片、输入链接、关联工作项、@项目成员等操作。 单击“发表”，评论成功。 发表后的评论支持回复、编辑、置顶、删除操作。 操作成员需拥有工作项的“查看”权限。

处理方法 在工作项文件中删除之前超出300条数据量的空行后，再重新导入工作项数据。 在工作项文件中删除了几条工作项数据后，如果需要再补充到300条，则建议执行如下操作： 直接导入删除数据后的工作项文件。 检查导入成功的工作项条数是否跟工作项文件中的一致。 如果一致，未统计删除的几条工作项，则可在另一份工作项文件中填写需要增加的工作项数据后再导入。 如果不一致，统计了删除的几条工作项，则需要在需求管理服务中删除同等条数的工作项数据后，再重新导入一份工作项文件。

相关操作 对新创建的工作项，可以执行以下操作。 以下操作针对工作项的列表视图。 表2 工作项基本操作 操作项 说明 快捷编辑工作项 在工作项列表中，单击目标工作项标题右侧的“修改标题”或按快捷键T，可以编辑工作项标题。 在工作项列表中，单击目标工作项标题右侧的“修改处理人”或按快捷键A，可以快捷修改工作项处理人。 在工作项列表中，单击目标工作项标题右侧的“修改为自己”或按快捷键空格，可以将工作项处理人快速修改为自己。 在工作项列表中，单击目标工作项标题右侧的“修改结束日期”或按快捷键D，可以快捷修改工作项的结束日期。 编辑工作项 在工作项列表中，单击目标工作项所在行的字段值，即可修改编辑对应工作项字段。 快速新建子工作项 在工作项列表中，单击目标工作项标题右侧的“新建XX”，可以输入子工作项标题完成快速新建子工作项流程。 说明： 最底层工作项层级面板下的工作项不支持新建子工作项。 批量创建子 在工作项列表中，单击目标工作项标题右侧的“批量创建子”，可以输入多条子工作项标题完成快速批量创建子工作项流程。 说明： 最底层工作项层级面板下的工作项不支持新建子工作项。 关注工作项 在工作项列表中，单击目标工作项标题右侧的“关注工作项”，关注成功后操作按钮变成“取消关注工作项”，再次单击可取消关注。 复制工作项 在工作项列表中，单击目标工作项标题右侧的“复制工作项”，可以将当前工作项复制到目标项目中，目标项目类型仅支持看板项目。 拆分工作项 当前工作项若分解的不合理，您可以根据需要对其进行拆分。 在工作项列表中，单击目标工作项标题右侧的“拆分工作项”，可以将当前工作项拆分出2个或3个工作项，拆分出新工作项是源工作项的“被拆原工作项”，源工作项是拆分出新工作项“拆出新工作项”。 设置阻塞 当前工作项研发过程中遇到了风险阻塞，可以将该工作项设为阻塞。 在工作项列表中，单击目标工作项标题右侧的“设为阻塞”，可以选择“阻塞类型”和输入详细说明后，将工作项设为阻塞。 说明： 已阻塞工作项不支持更改状态。 已阻塞工作项不支持归档。 归档工作项 在工作项列表中，单击目标工作项标题右侧的“归档工作项”，可以将当前工作项归档。 已归档工作项可在下的“已归档工作项”中查看。 已归档工作项可进行“取消归档”操作。 删除工作项 在工作项列表中，单击目标工作项标题右侧的“归档工作项”，可以删除目标工作项。 说明： 工作项删除后，会进回收站。 进入回收站的工作项可以在“回收站”中还原和彻底删除，在回收站中还原后，工作项状态恢复至状态流的第一个状态。

在代码托管控制台提交代码并关联工作项 进入仓库详情页。 新建一个文件，如下图所示，在填写“提交信息”时以fix #708206209开头，其他信息任意即可。 708206209是task02的编号。 单击“确定”按钮，此时系统相当于在代码托管仓库上执行了以下操作： 新建文件写入内容 git add . git commit -m "fix #708206209 Task02" 也就是将一个新建的文件进行了一次commit，并通过-m参数中的“fix”关键字关联到了task02工作项。 验证。 此时您再去查看task02工作项时，如下图所示： 其状态已经置于“已解决”。 增加了一条关联得代码提交记录，单击提交编号可以前往查看提交详情。 增加了一条自动生成的评论以说明本次工作项关联。

在本地提交代码并关联工作项 首先您需要在本地具备Git环境，详细请参考Git客户端安装与配置，在可以访问仓库时（已经关联到了对应的远程仓库），可以开始进行以下操作。 在本地的master分支上新建一个文件，将其推送到远程仓库，在推送时-m里使用“fix”关键字去关联工作项task01。 本示例直接修改master分支，是为了缩短流程减少杂音让开发者更快的了解本地提交关联工作项的操作和原理。 在实际代码开发中，尽量不要直接修改master分支，推荐新建一个分支进行文件操作，操作完后再合并到master分支并将master推送到远程仓库。（这是一种默认规则和良好习惯） 在本地仓库文件夹下单击鼠标右键，打开Git Bash客户端。 确认远程仓库地址绑定是否成功。 git remote -v #该命令可以查看目前本地仓库所绑定的远程仓库地址。 如下图返回内容中，红线部分是本地仓所关联的远程仓库地址，地址之前是远程仓库在本地的别名。 如果发现绑定的仓库并非需要关联的仓库，或者没有绑定仓库，推荐直接将想绑定的仓库Clone到本地。 Clone成功以后再次执行“git remote -v”查看确认绑定正确即可。 （上步骤已Clone的仓库可跨过此步）用status命令查看下目前仓库的状态，切换到master分支。 git status #查看当前仓库状态，可以看到目前处于哪个分支、该分支有没有未暂存、未提交、未推送的修改 git checkout master #切换到master分支，如果当前没有处于master分支时使用 在本地仓库文件夹下新建一个文件，本示例中将其命名为“fileFor708206208”。 在Git Bash中将新建的文件添加到暂存区。 git add fileFor708206208 在Git Bash中将本次操作提交。 git commit -m "fix #708206208 Task01" #/本次提交用fix关键字关联了编号为708206208的task01 708206208是task01的编号。 在Git Bash将提交的内容推送到关联的代码托管仓库。 git push 如下图为推送成功，不同仓库结构返回会略有不同，只要看到所有步骤都100%、done就是推送成功了，如果推送失败一般是您的密钥问题。 验证关联结果。 上述操作完成后，进入工作项列表，找到编号为708206208的工作项，进入查看详情，如下图所示： 其状态已经置于“已解决”。 增加了一条关联的代码提交记录，单击提交编号可以前往查看提交详情。 增加了一条自动生成得评论以说明本次工作项关联。