相关操作 对新创建的工作项，可以执行以下操作。 表2 工作项基本操作 操作项 说明 查看工作项详情 在工作项列表中，单击目标工作项的标题或编号，可以查看工作项详情。 编辑工作项标题 在工作项列表中，单击目标工作项所在行的，可以编辑工作项标题。 快速新建子工作项 在工作项列表中，单击目标工作项所在行的，可以输入子工作项标题完成快速新建子工作项流程。 Epic/Feature/Story类型工作项下可新建子工作项，Task/Bug类型工作项下不可新建子工作项。 关注工作项 在工作项列表中，单击目标工作项所在行操作栏中的，关注成功后图标变为，再次单击可取消关注。 复制工作项 单击目标工作项右侧下的“复制”，可以将当前工作项复制到目标项目中。 项目内复制仅支持工作项基本信息、自定义字段和项目内附件的复制，跨项目复制仅支持工作项基本信息。 归档工作项 单击目标工作项右侧下的“归档”，可以将当前工作项归档。仅对状态为结束态的工作项才能进行归档。 编辑工作项 在工作项列表中，单击目标工作项所在行的字段值，即可修改编辑对应工作项字段。 在工作项详情页中，单击需要修改工作项对应参数值并保存。 删除工作项 在工作项列表中，单击目标工作项所在行操作栏中的，选择“删除”，可以删除目标工作项及其下的子任务。 在工作项详情页中，单击右上角下的“删除”，可以删除目标工作项及其下的子任务。 Scrum项目工作项的删除为彻底删除，一旦删除后，不可恢复。 批量操作 选择多个工作项，可进行如下操作。 批量复制 项目内复制仅支持工作项基本信息、自定义字段和项目内附件的复制，跨项目复制仅支持工作项基本信息。 批量编辑 批量归档 仅对状态为结束态的工作项才能进行归档。 批量删除 批量导出

相关操作 对于新建的仪表盘，可以执行以下操作。 表2 仪表盘相关操作 操作项 说明 查看仪表盘 单击仪表盘名称，可从下拉框中选择目标仪表盘进行查看。 导出仪表盘 单击仪表盘主页右上角的“导出仪表盘”，可将当前仪表盘导出为pdf格式文件。 删除仪表盘 单击仪表盘主页右上角的“删除仪表盘”，可将当前仪表盘进行删除。默认仪表盘不支持删除。 仪表盘设置 单击仪表盘主页右上角的“仪表盘设置”，可进入仪表盘设置页面，执行以下操作。 新建仪表盘：单击右上角“新建仪表盘”，新建流程参考新建自定义仪表盘。 编辑仪表盘：单击仪表盘行操作的，可对当前仪表盘进行编辑。 删除仪表盘：单击仪表盘行操作的，可对当前仪表盘进行删除。 设置仪表盘默认为首页：单击选择仪表盘左侧，可将该仪表盘默认为首页。

新建自定义仪表盘 仪表盘除默认仪表盘外，您可以根据需要新建自定义仪表盘。 访问CodeArts Req服务首页。 进入Scrum项目，进入“仪表盘”页面，单击右上角下的“新建仪表盘”，配置以下信息。 表1 新建仪表盘 参数项 说明 仪表盘名称 仪表盘的标题，支持中英文字符、数字、下划线、中划线，输入范围：1~128个字符。 描述 仪表盘的描述，支持中英文字符、数字、下划线、中划线，不超过128个字符。 单击“确定”，可完成新建仪表盘。

后续操作 完成新建迭代后，可以执行以下操作： 图2 迭代页面的工作项列表 表2 管理迭代 操作项 说明 约束与限制 编辑迭代 单击迭代卡片右上角下的“编辑迭代”，可对迭代的名称，计划时间，描述进行编辑。 操作成员需拥有迭代的“编辑”权限。 更改迭代状态 针对“未启动”状态的迭代，单击迭代卡片右上角下的“启动迭代”，变更迭代状态由“未启动”变为“进行中”。仅当迭代下的工作项不为空时，才可进行“启动迭代”操作。 针对“进行中”状态的迭代： 单击迭代卡片右上角下的“设为未启动”，变更迭代状态由“进行中”变为“未启动”； 单击迭代卡片右上角下的“结束迭代”，变更迭代状态由“进行中”变为“已结束”。 针对“已结束”状态的迭代，单击迭代卡片右上角下的“重新启动”，变更迭代状态由“已结束”变为“进行中”。 操作成员需拥有迭代的“状态设置”权限。 删除迭代 单击迭代卡片右上角下的“删除迭代”，可删除当前迭代。 删除后不可恢复。 迭代删除后，系统自动将该迭代下全部工作项移入至“未规划的工作项”中。 操作成员需拥有迭代的“删除”权限。 规划迭代 可以勾选未规划的工作项或其他迭代下的工作项，拖拽将其规划至目标迭代中。 操作成员需拥有迭代的“编辑”权限。 查看并管理迭代 单击迭代工作项右上角，可以切换迭代下工作项显示方式。 单击切换到列表模式。 单击切换到树形模式。 单击切换到卡片模式。 单击切换到成员模式。 单击上方展开迭代详情，查看工作项统计、燃尽图和项目成员等。 单击“新建”可以新建“Story”、“Task”或“Bug”类型工作项。 可在列表页对显示出来的字段直接进行编辑。 查看迭代全体项目成员均可操作； 在迭代下新建工作项需拥有工作项的“新建(复制)”权限。 在迭代列表中修改工作项需拥有工作项的“编辑”权限。 编辑迭代中的工作项 详细操作请参考对工作项的基本操作、在工作项列表页管理工作项和在工作项详情页中管理工作项。 并在项目中拥有工作项的相关权限。权限设置请参考管理CodeArts项目级权限。

使用示例项目创建CodeArts项目 单击服务首页的“新建项目”。 进入“选择模板”页面，可以选择下方示例项目来创建项目，目前支持的示例项目如表1所示。 表1 示例项目 项目模板类别 示例项目名称 使用场景 Scrum项目 DevOps全流程示例项目 针对敏捷开发全生命周期、DevOps持续交付的模板，模板内预置了思维导图、并实例化了Scrum工作项（如促销管理、会员管理，订单管理）、代码仓库、代码检查任务、编译构建任务、流水线任务等，实现全流程的研发交付自动化。 Scrum项目 鸿蒙应用的一站式开发项目 面向全场景的一站式 集成开发环境 ，提供一站式的分布式应用开发平台，支持分布式多端开发、分布式多端调测、多端模拟仿真，提供全方位的质量与安全保障。 IPD项目 IPD-系统设备示例项目 针对嵌入式软件场景，其特点为软件持续迭代，硬件平台也在持续演进，比如通信设备、汽车、家电、消费电子等涉及到软硬件复杂产品。 IPD-独立软件示例项目 针对IT应用及平台类软件，硬件标准化或不依赖专有硬件，软件频繁迭代场景，比如ERP软件、CRM、数据库、网管软件等。 IPD-云服务全流程示例项目 针对云服务开发、微服务架构、自运营软件场景，比如公有云、互联网应用软件。 IPD项目 【车联网示例项目】车联网云服务 车联网示例项目的子项目。承接云服务开发相关的系统需求，并管理云服务软件程序的开发、测试与交付。 IPD项目 【车联网示例项目】TBOX车载设备应用 车联网示例项目的主项目。进行流程管理与原始需求与系统需求维护，同时在此项目中进行车载硬件设备的嵌入式程序开发管理。 看板项目 客户联合敏捷交付(JAD)项目 针对研发类轻量级敏捷项目的管理，助力初创团队、小型组织任务协作，快速提升工作效率。 客户线索管理项目 针对市场营销类客户线索管理，搭建了科学的营销体系模板，推动客户转化。 招聘管理项目 针对HR类招聘进度管理，覆盖人力管理核心流程，实现科学规范化管理。 团建3+1项目 针对团建类项目的管理，助力团队活动建设。 选择相应的示例项目，进入“新建项目”页面，配置相关参数。 表2 新建项目 参数名 参数说明 项目名称 根据自己需求设置。 同一租户下的项目，名称不能重复。 支持大小写英文字母、数字、“_”，不超过128个字符。 项目代号 针对第三方业务。设置项目代号后，便于业务管理。 支持字母、数字、下划线和连字符，不超过200个字符。 项目描述 对项目的简要说明。 支持大小写英文字母、数字、“_”，不超过1024个字符。 单击“确定”，项目创建成功，页面自动跳转至到项目内。

Scrum项目典型迭代操作流程 本操作流程介绍完成一个Scrum迭代的基本步骤，依此可以重复使用在每个迭代管理中做到持续规划与交付。Scrum开发流程与项目管理对应操作流程如下： 表1 Scrum典型迭代流程与项目管理对应操作说明 操作 说明 新建Scrum项目 新建Scrum项目详细操作步骤请参见：创建CodeArts项目。项目创建成功后可进行公共配置管理。 项目创建成功后，请根据实际情况邀请成员加入项目。添加成员请参见：添加CodeArts项目成员。 需求规划 根据项目分解需求，进行思维导图或甘特规划，详细信息请参见：新建思维导图规划和新建甘特规划。 新建工作项 规划好需求后，需要新建工作项。详细操作步骤请参见：在Scrum项目中新建工作项、在思维导图中新建工作项和在甘特图中新建工作项。 管理迭代 对迭代进行规划与管理，详细操作步骤请参见：配置Scrum项目迭代计划。 自定义工作流（可选） 根据需要自定义工作流，详细操作步骤请参见：Scrum项目公共配置管理。 迭代回顾 迭代工作完成后，可以对每次迭代进行总结，方便下次迭代改进，详细操作步骤请参见：跟踪Scrum项目进展。

后续操作 完成新建自定义报表或通过系统预置报表模板新建报表后，拥有报表的“编辑报表”、“删除报表”、“移动报表”“导出报表”权限的成员，可以执行以下操作： 对于新创建的报表，可以进行如下的操作。 表3 报表基本操作 操作项 说明 报表的图形和表格显示切换 单击报表卡片右上角的，可以切换报表的显示形式。 全屏查看报表 单击报表卡片右上角，可以全屏查看报表。 保存图表 单击报表卡片右上角下的“保存图表”，可以将当前报表保存为png图片。 导出表格 单击报表卡片右上角下的“导出表格”，可以将当前报表数据导出为Excel文件。 编辑报表 单击报表卡片右上角下的“编辑报表”，可以进入报表详情页进行编辑。 移动报表 单击报表卡片右上角下的“移动报表”，可以将当前报表移动至其他报表分类中。 删除报表 单击报表卡片右上角下的“删除报表”，可以将当前报表进行删除。删除后不可恢复。

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

新建文件库 通过知识库主页进入个人文件库。 单击左侧导航个人文件库，进入文件库列表页面。 单击页面中的“新建文件库”，进入新建文件库窗口。 设置名称和公开性，文件库不能重名。 公开性请根据实际情况设置。默认属性为“个人可见”。 单击“确定”。 创建好的文件库显示在列表中。 在文件库列表中，可以根据需要修改名称、并进行分享、收藏或删除操作等。 进入文件库后，单击个人文件库右上角“更多”，可以根据需要查看批量下载记录、分享、收藏或删除文件库。 更多文件操作请参见文件操作。

CodeArts Req最佳实践汇总 表1 CodeArts Req常用最佳实践 实践 描述 对IPD系统设备类项目的智能手表研发项目进行原始需求管理 成功产品的核心特征是满足客户需求。CodeArts Req打破了传统需求管理工具仅在研发阶段发挥作用的限制，将客户与市场需求也同步覆盖，提供了完整的客户需求采集、价值需求决策、交付与验收流程，让需求进展和动态客户实时透明，市场需求流动提速70%。 在CodeArts Req的原始需求管理中，用户可以将客户诉求提交至目标组织，目标组织对需求进行决策、分析、交付及后续验收流程全程实时透明化，可以加速客户诉求的交付速率，提升产品在市场上的竞争力。 对IPD系统设备类项目的智能手表研发项目进行缺陷管理 在整个产品生命周期管理中，缺陷管理是非常关键的一环。无论是硬件系统还是软件开发，都难免遇到不计其数的缺陷，如果缺陷管理不善，产品质量势必大打折扣。华为基于多年沉淀的质量运营管理经验，打造出一套行之有效的缺陷管理优秀实践，为团队提供统一、高效、风险可视的缺陷跟踪平台，确保每一个缺陷都被高质高效闭环。 某公司计划推出一款智能手表，研发周期较长，研发过程涉及多个部门、多团队的协作，如何保证缺陷在多个组织间的流转、最终达到有效闭环呢？下面请跟随我们，一起遍历整个缺陷生命周期管理实践。 对IPD系统设备类的智能手表研发项目进行基线评审管理 产品从规划到上市要经过复杂的研发过程，CodeArts Req提供了基线评审和变更管理能力，实现需求基线-受控变更-变更评审-变更管理的过程化管理，让基线变更如门禁一样，达到阈值才能启动下一步，确保产品研发“做正确的事”。 某公司计划推出一款智能手表，涉及多部门、多团队的协作，且已经过前期的多轮需求沟通与澄清，将研发需求分配到各产研团队。为保障产品如期保质交付，需要确保不同研发生产团队都忠实执行任务，按照既定的需求进行研发落地。这时就需要对需求进行基线管控，基线后的需求不允许随意更改。下面我们以该公司为例，介绍如何实施需求基线管控。 对看板项目的商城管理项目进行需求规划 CodeArts Req提供的看板项目是一种业界流行的轻量、灵活和简单的团队协作方法，它将项目的需求、缺陷和任务可视，让每个人一目了然地掌握每项工作的状态，团队通过移动工作卡片的方式更新工作进展，及时暴露风险和问题。 用户可以创建看板项目对项目进行需求规划，通过新建工作项、分配工作项、处理工作项等来实现项目的需求规划与交付。 对IDP系统设备类的智能手表研发项目进行特性树管理 产品的核心资产就是系统特性，一旦上市系统特性就会不断的增长，CodeArts Req提供产品全量系统特性管理，通过特性树可以更好管理系统特性，实现产品资产不丢失，让跨代的系统特性快速继承和发展。 使用IPD系统设备类管理智能手表研发项目的变更评审 产品从规划到上市要经过复杂的研发过程，CodeArts Req提供了工作项基线受控与变更管理能力，实现工作项受控变更-变更评审-变更管理的过程化管理，把控变更门禁，实现产品研发过程可控，基线契约化，审批留痕，确保决策依据可查，责任可追溯。

步骤三：审批人决策跨项目协同缺陷的评审单 当评审专家完成评审后，缺陷提出项目测试经理Bob作为评审单的审批人会收到待办通知，收到通知后，Bob将前往项目进行处理。 进入服务首页，单击右上角“待办中心”，进入待决策的CR单详情页。 图17 代办中心 在评审单详情页，单击每个变更对象操作列的审批人决策按钮，或勾选待我决策的变更对象，单击右上角的“审批人决策”按钮，弹出审批人决策弹框。 图18 变更评审单决策详情 按照表10填写后，单击“确定”，变更评审单状态为“已完成”。 表10 审批人决策信息说明 参数 解释 取值样例 决策处理 根据需要选择，当选择为“转他人处理”时，会出现“审批人”选择框，且必填。 同意 决策意见 当“决策处理”选择为“同意/拒绝”时，该信息必填。 同意 评审阶段结果 此处展示评审阶段的最终结果。 已通过 评审专家意见 此处展示参与评审阶段的评审专家给出的评审结果和评审意见信息。 -- 图19 审批人决策页面

跨项目协同的缺陷变更评审 对于跨项目协同的缺陷，变更过程有所不同。 表6 跨项目协同的缺陷变更管理实践操作流程说明 流程 说明 步骤一：触发跨项目协同缺陷变更评审 进入缺陷详情页，编辑带有图标的字段，在弹窗中单击“确定”。 步骤二：评审跨项目协同缺陷的评审单 评审专家完成变更评审单的评审操作等。 步骤三：审批人决策跨项目协同缺陷的评审单 审批人完成变更评审单的决策操作等。 步骤四：评审通过的缺陷自动刷新变更的字段值 变更评审结束后，根据变更评审结论，自动修改相应字段。 跨项目协同的缺陷变更涉及以下项目角色，如表7所示。 表7 跨项目协同的缺陷变更涉及项目角色列表 项目成员 项目角色 工作职责 Sarah 当前项目创建人（产品负责人） 负责项目的创建和项目团队的组建。 Bob 缺陷提出项目测试经理 负责担任变更评审单的审批人。 Bree 当前项目开发人员 负责发起变更评审。 Eddie 缺陷提出人 负责担任变更评审单的评审专家。 Paul 缺陷提出项目测试人员 负责担任变更评审单的评审专家。 Zach 缺陷提出项目开发人员 负责担任变更评审单的评审专家。

无需跨项目协同的缺陷变更评审 表1 无需跨项目协同的缺陷变更管理实践操作流程说明 流程 说明 步骤一：触发无需跨项目协同缺陷变更评审 进入缺陷详情页，编辑带有图标的字段，在弹窗中单击“确定”。 步骤二：评审专家评审无需跨项目协同的评审单 评审专家完成变更评审单的评审操作等。 步骤三：审批人决策无需跨项目协同的评审单 审批人完成变更评审单的决策操作等。 步骤四：评审通过的缺陷自动修改变更的字段值 变更评审结束后，根据变更评审结论，自动修改相应字段。 无需跨项目协同的缺陷变更评审实践涉及以下项目角色，如表2所示。 表2 项目角色列表 项目成员 项目角色 工作职责 Sarah 项目创建人（产品负责人） 负责项目的创建和项目团队的组建。 Caleb 测试经理 负责担任变更评审单的审批人。 Gabby 开发人员 负责发起变更评审。 Sam 测试人员 负责担任变更评审单的评审专家。 Betty 测试人员 负责担任变更评审单的评审专家。 Tom 测试人员 负责担任变更评审单的评审专家。

跟踪项目状态 每日站立会议跟踪任务进度。 迭代开始后，项目组通过每日站立会议沟通每个工作项的当前进展，并对工作项状态进行更新。 使用卡片模式能够简单直观的查看迭代中各工作项的当前状态。 进入“迭代”页面，单击图标，切换到卡片模式。页面中展示了处于每种状态下的工作项卡片，通过拖拽工作项卡片即可更新其状态。 迭代评审会议验收迭代成果。 在到达迭代的预计结束时间前，项目组召开迭代评审会议，展示当前迭代的工作成果。 “迭代”页面提供了迭代统计图表，团队可以方便的统计当前迭代的进度情况，包括需求完成情况、迭代燃尽图、工作量等。 进入“迭代”页面，单击“统计”，即可展开迭代进度视图。

响应示例 状态码：200 OK { "actual_work_hours" : 0, "assigned_cc_user" : [ { "id" : 4091, "name" : "user_name_demo", "nick_name" : "nick_name_demo" } ], "assigned_user" : { "id" : 4091, "name" : "user_name_demo", "nick_name" : "nick_name_demo" }, "begin_time" : "2020-09-12", "creator" : { "id" : 4091, "name" : "user_name_demo", "nick_name" : "nick_name_demo" }, "custom_fields" : [ { "name" : "customField16", "value" : "多选框", "new_name" : "custom_field16" } ], "new_custom_fields" : [ { "custom_field" : "custom_field16", "field_name" : "field_name", "value" : "select1,select2" } ], "developer" : { "id" : 4091, "name" : "user_name_demo", "nick_name" : "nick_name_demo" }, "domain" : { "id" : 14, "name" : "性能" }, "done_ratio" : 0, "end_time" : "2020-09-19", "expected_work_hours" : 9, "id" : 4567, "project" : { "project_id" : "526cefde62004de2b62b5e8dd2c2b3af", "project_name" : "testDemo", "project_num_id" : 78953 }, "iteration" : { "id" : 456, "name" : "iteration_1" }, "module" : { "id" : 456, "name" : "Project" }, "parent_issue" : { "id" : 123, "name" : "paren_issue_demo" }, "priority" : { "id" : 1, "name" : "低" }, "severity" : { "id" : 12, "name" : "一般" }, "status" : { "id" : 1, "name" : "新建" }, "tracker" : { "id" : 7, "name" : "story" } }