配置工作项字段与工作流

约束与限制

• 标题、状态、归属项目、当前责任人、实际工时等部分系统字段不支持删除操作。
• 系统默认工作流不支持编辑或删除。

前提条件

用户需要具有Tenant Administrator角色权限。为用户授予Tenant Administrator角色权限的操作方法请参考创建用户组并授权。

为工作项类型添加字段

1. 访问CodeArts Req服务首页，单击。
2. 选择“租户设置”。
3. 单击“工作项管理 > 基础配置 > 工作项字段与工作流”，进入工作项字段与工作流字段页面。
4. 在“工作项类型”中选择一个需要添加字段的工作项类型，页面中显示该工作项类型中已有的字段。
5. 单击“添加字段”，在添加字段窗口中单击“请选择”。
6. 添加已有字段或新建字段。
   • 添加已有字段
     1. 选择待添加的已有字段。您可以通过在“请输入名称搜索”中输入待添加的字段名称进行选择，也可以在弹出的窗口中滑动鼠标滚轮选择待添加的字段。
     2. 单击“发布”列表中将显示新添加的字段。
   • 新建字段
     1. 在弹出的窗口中单击“新建字段”。
     2. 输入字段名，选择字段类型，设置描述信息。
     3. 单击“发布”列表中将显示新建字段。

        列表中的字段分页展示，可以通过搜索字段名称查询新建的字段。

   对新创建的字段或新添加的字段，可以进行删除操作：

   1. 单击。
   2. 在弹框中单击“确定”根据提示信息输入REMOVE。
   3. 单击“删除”即可删除此字段。
      

      删除后，该字段将在所有工作项中被删除并清空字段值。 这是一个不可恢复的操作，请谨慎对待。

为工作项类型新建工作流方案

1. 访问CodeArts Req服务首页，单击。
2. 选择“租户设置”。
3. 单击“工作项管理 > 基础配置 > 工作项字段与工作流”，进入工作项字段与工作流字段页面。
4. 单击“工作流方案”，在“工作项类型”中选择一个待配置的工作项类型。

   可以配置该工作项类型可能使用的工作流。您可以配置多个工作流，并在搭建工作项类型模板时，选择某个工作项类型具体使用的工作流。

5. 单击“新建工作流方案”。弹出工作流配置画布。

   

6. 设置工作流名称和描述信息

   在弹出的工作流画布中单击，在弹出的编辑工作流窗口中设置工作流名称和描述信息，单击“确定”。

7. 选择节点状态。
   自定义工作流的节点主要有三种状态：开始态、进行态和结束态。每一类状态又分系统默认的节点和租户自定义节点。您可以通过选择已有状态或添加新增节点状态两种方式来选择待添加的节点状态。

   • 选择已有状态

     选中状态菜单栏中的状态，拖至画布中对应的位置。

   • 添加节点状态
     1. 单击左侧抽屉菜单展开状态抽屉。

        

     2. 在展开的状态抽屉中，单击，添加状态，如果没有新状态，可新增状态后再添加。
     3. 在状态抽屉中的“租户自定义”状态区域查看新增的状态，且新增状态也会显示在画布中。

        

8. 编辑工作流状态节点。
   1. 单击需要编辑的状态节点，弹出“状态信息”页面。
   2. 编辑状态信息。“是否支持挂起/取消挂起”开关默认关闭。
      以“分析”状态为例，将“是否支持挂起/取消挂起”开关打开，则当对应的自定义工作项（例如SG）进入分析状态时，单击详情页面右上角会有“挂起”按钮，填写“挂起原因”之后，则该工作项SG会进入挂起状态，工作项列表中会标识该工作项已挂起。

      图1 工作项SG被挂起

      

      也可取消挂起，工作项名称上的挂起标识消失。单击详情页右上角的“取消挂起”，该工作项可以继续往下走流程。

   3. 编辑状态配置。
      • “允许任何状态流转至该状态”开关默认关闭，打开开关则允许任何状态流入至该状态。
      • “字段配置”开关默认打开，如果关闭，则不可对字段进行编辑。
      • 每一类状态节点有默认的字段，如需新增，可单击“添加字段”在弹出的“添加字段”窗口进行添加，详细操作请参见6 。
      • 配置字段编辑约束规则，当前责任人默认可以编辑，不参与权限校验。根据用户需要选择“且”关系或者“或”关系来设置某个字段的编辑权限，默认为“或”关系。

        “或”关系：操作人满足以下任意条件之一，才能编辑某个字段。

        “且”关系：操作人必须同时满足以下所有条件，才能编辑某个字段。未选择任何角色时，默认为全选所有角色。

        1. 条件一：“拥有当前工作项类型的「编辑」权限”。
           • 若在“归属项目”操作，将校验操作人在“归属项目”的“编辑”权限。
           • 若在“提出项目”操作（需开启“允许提出项目操作”），将校验操作人在“提出项目”的“编辑”权限 。
        2. 条件二：“属于下方列表选择的角色（每个字段将分别校验角色）”

        

      • 字段配置项。配置在该状态下工作项字段的显示、编辑和必填，以及可编辑字段的角色。

        表1 字段配置项

        字段配置	说明
        是否显示	是否显示在工作项详情页中。当勾选了该配置之后，才可以配置其它配置。
        是否可编辑	在当前状态的工作项中该字段是否可编辑。
        是否必填	在当前状态的工作项中该字段是否是必填字段，如必填，在工作项中会被标记*。
        角色	下拉选择角色。此处选择的角色将用于字段编辑约束规则的校验。 可选范围：仅包括当前状态流归属项目的临时角色。

9. 编辑状态流流转线。
   1. 单击状态流转线，弹出“流转线信息”页面。
   2. 设置流转线信息。

      流转线信息区域显示该流转线的“开始状态”、“目标状态”和“流转线名称”。流转线名称在工作项详情页上单击“查看状态流”进行查看。

      图2 状态流在工作项详情上的表现

      

   3. 配置流转前校验。在操作该流转项之前，只有配置的校验项满足条件，才可执行该流转操作。校验项配置如下：

      表2 流转前校验项配置

      校验项	说明
      验证操作权限	配置状态流转约束规则，当前责任人默认可以流转，不参与权限校验。 根据用户需要选择“且”关系或者“或”关系来设置状态是否可流转，默认为“或”关系。 “或”关系：操作人满足以下任意条件之一，才能流转。 “且”关系：操作人必须同时满足以下所有条件，才能流转。 条件一：“拥有当前工作项类型的「状态设置」权限”。 权限校验以发起状态流转操作的项目为准： 若在“归属项目”操作，将校验操作人“在归属项目”的“状态设置”权限； 若在“提出项目”操作（需开启流转线开始状态的“允许提出项目操作”），将校验操作人在“提出项目”的“状态设置”权限 。 条件二：“属于下列角色”。 下拉选择角色。 可选范围：仅包括当前状态流归属项目的临时角色。
      验证字段信息	可选。“验证字段信息”开关默认打开，即默认需要验证。也可关闭“验证字段信息”开关，选择不验证。开关打开，单击“添加字段”在弹出的“添加字段”窗口进行添加，详细操作请参见6 。配置完成后，在状态流转前校验字段满足字段值时，允许使用流转来变更工作项状态。
      验证关联项信息	可选。默认需要验证，也可关闭“验证关联项信息”开关，选择不验证。开关打开，单击“添加关联项”，弹出“添加关联项”窗口，选择需要添加的关联项，勾选“判断条件”，默认“无”，单击“确定”即可。

   4. 设置流转中界面配置。

      在状态流转过程中，需要额外填写的信息，提交后才能继续执行后续步骤。“流转中界面配置”开关默认打开，可关闭。如果开关打开，单击“添加字段”，弹出“添加字段”页面，下拉选择需要添加的字段，单击“确定”，会显示在字段列表中。

      图3 配置的字段列表

      
      
      

      添加字段时，如果勾选了必填，则字段列表中字段名称后标记*。

   5. 配置流转后置动作。

      流转动作执行成功后，将自动执行配置的后置动作。流转后置动作配置如下：

      表3 流转后置动作配置项

      配置项	说明
      更新字段	流转成功后更新指定字段的值。 单击“添加后置动作”，弹出“添加后置动作”窗口。 选择“更新字段”并单击“确定”，弹出“添加字段”窗口。 在“选择字段”文本框中下拉选择需要添加的字段。 设置已选择字段的判断条件，默认值等信息。 单击“确定”。该字段会显示在流转后置动作列表中。
      基线相关操作	流转成功后更新目标对象的基线状态。如果目标对象的当前基线状态与流转成功后更新的基线状态相同，则该后置动作不会执行。例如，对于已基线的工作项配置了“基线当前工作项”的后置动作，则不会执行该动作。 说明： 系统预置的RR、Bug工作项类型不支持“基线当前工作项”和“取消基线当前工作项”。 单击“添加后置动作”，弹出“添加后置动作”窗口。 选择“基线相关操作”并单击“确定”，弹出“基线相关操作”窗口。 在“执行操作”文本框中下拉选择需要执行的操作。 基线当前工作项：需要同时满足以下条件时该后置动作才会执行。 工作项不处于基线评审中 工作项不处于变更评审中。 取消基线当前工作项：需要同时满足以下条件时该后置动作才会执行。 工作项不处于基线评审中 工作项不处于变更评审中。 当工作项归属于某个迭代时，该迭代状态不为已基线。 当工作项不归属于任何迭代但归属于某个发布时，该发布状态不为已基线。 基线关联项：需要同时满足以下条件时该后置动作才会执行。 关联工作项不处于基线评审中 关联工作项不处于变更评审中。 取消基线关联项：需要同时满足以下条件时该后置动作才会执行。 关联工作项不处于基线评审中 关联工作项不处于变更评审中。 当关联工作项归属于某个迭代时，该迭代状态不为已基线。 当关联工作项不归属于任何迭代但归属于某个发布时，该发布状态不为已基线。 填写“描述”信息。 单击“确定”。该基线操作会显示在流转后置动作列表中。
      快照相关操作	流转成功后对当前工作项或关联项进行快照。 单击“添加后置动作”，弹出“添加后置动作”窗口。 选择“快照相关操作”并单击“确定”，弹出“快照相关操作”窗口。 在“执行操作”文本框中下拉选择需要执行的操作。 给当前工作项打快照 给关联工作项打快照 当执行操作为“给关联工作项打快照”时，需要在“打快照的关联工作项类型”文本框中下拉选择需要关联的工作项类型。 填写“描述”信息。 单击“确定”。该快照操作会显示在流转后置动作列表中。

10. 配置完成后，单击“发布”。
    发布完成后在“工作项管理 > 基础配置 > 工作项字段与工作流”下的“工作流方案”页签列表中将展示该工作流方案。且该方案的“发布状态”为“已发布”，后续可以在使用该工作项的项目中使用。

    

    • 单击“保存”可以保存该工作流方案的草稿，需要在发布后才能生效。
    • 单击“还原”可以还原当前工作流默认配置或最近一次发布时的配置。
    • 单击“取消”可以取消该工作流方案的修改。
    对新创建的工作流方案，可以完成以下操作：

    表4 管理工作流方案

    操作	说明
    编辑工作流方案	单击，可以修改该工作流方案的名称以及状态配置等信息。
    复制工作流方案	单击可以复制新建工作流。
    删除工作流方案	单击，在弹框中输入DELETE，单击“删除”，即可删除此工作流方案。