自定义工作流(继承的流程)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

每个工作项类型都与一个工作流相关联,该工作流支持跟踪从创建到完成的工作状态。 若要支持业务和团队流程,可以将自定义状态添加到大多数工作项类型 (WIT) 。 例如,你可能想要插入 bug 的会审状态,或者插入功能或用户情景的设计状态。

此处已自定义 Bug WIT 以支持会审状态。 状态和原因字段显示在工作项表单的标题区域。

Bug 工作项表单、标头区域、添加状态

本文介绍支持的工作流自定义选项以及如何自定义工作流。 具体来说,将学习以下内容:

  • 支持的工作流自定义方案
  • 自定义工作流时对团队板的影响
  • 端到端工作流自定义步骤
  • 如何添加或删除自定义工作流状态
  • 如何隐藏或取消隐藏继承的工作流状态
  • 如何查看状态模型的图形描述

有关生成和发布 DevOps 任务的工作流的文档,请参阅 使用 Azure Pipelines

重要

本文适用于 Azure DevOps Services 和 Azure DevOps Server 2019 及更高版本。 若要自定义针对 TFS 2018 或更早版本的集合定义的任何项目,请参阅 本地 XML 进程模型

重要

只能对配置为支持继承过程模型的项目集合上定义的项目使用继承过程模型。 如果本地集合配置为使用本地 XML 进程模型,则只能使用该进程模型来自定义工作跟踪体验。 若要了解详细信息,请参阅 自定义工作跟踪、为项目集合选择流程模型

若要自定义针对 TFS 2018 或更早版本的集合定义的任何项目,请参阅 本地 XML 进程模型

支持的自定义项

可以通过隐藏继承状态或添加自定义状态, (WIT) 自定义任何工作项类型的工作流。 继承的状态因系统进程(敏捷、基本、Scrum 或 CMMI)而异,你选择从中创建自定义进程。

每个 WIT 的每个默认工作流定义两到四个状态,并指定以下工作流操作:

  • 每个状态之间的向前和向后转换
  • 每个状态转换的默认原因

例如,基本流程“问题 WIT”的特点是三种状态:“要执行”、“ 正在执行”和“ 完成”,以及如下图所示的转换。

基本流程、问题工作项类型、工作流状态模型


状态类型

支持的自定义项


继承的图标 继承的状态

自定义状态


工作流状态必须符合以下规则

  • 必须为 “建议 ”或“ 正在进行 ”状态类别至少定义一个状态

    注意

    在添加工作流状态之前,请查看 工作流状态和状态类别 ,了解工作流状态如何映射到状态类别。

  • 必须至少定义两个工作流状态
  • 每个工作项类型最多可以定义 32 个工作流状态

不支持的工作流自定义项

  • 不能修改继承的状态, (不能更改其名称、颜色或类别) ,但可以隐藏它
  • 已完成 ”状态类别中只能有一个状态。 如果将自定义状态添加到“已完成”类别,则会删除或隐藏任何其他状态
  • 无法更改自定义状态的名称
  • 不能为状态指定原因,而是定义默认原因,例如 已移动到状态会审移出状态会审
  • 无法更改窗体上“状态”和“原因”字段的位置
  • 无法自定义状态类别名称
  • 不能修改继承的状态, (不能更改其名称、颜色或类别) ,但可以隐藏它
  • 已完成 ”状态类别中只能有一个状态。 系统不允许向此类别添加任何自定义状态
  • 无法更改自定义状态的名称
  • 无法更改状态的顺序,状态会根据工作项窗体的下拉列表中的状态类别在其自然序列中列出
  • 不能为状态指定原因,而是定义默认原因,例如 已移动到状态会审移出状态会审
  • 无法更改窗体上“状态”和“原因”字段的位置
  • 不能限制转换,所有转换都是从任何状态到另一个状态定义的。

状态下拉菜单序列

状态 ”下拉菜单列出了每个状态类别中排序顺序中的状态。 对于新添加的工作项, “建议 ”类别中的第一个状态被分配为默认状态。

下图演示了为用户情景定义的状态序列及其相应的下拉菜单。

用户情景状态序列用户情景状态下拉菜单

在每个类别中,可以向上或向下移动自定义状态。

工作流更改对团队的影响

进行以下自定义时,团队可能需要更新看板配置:

  • 添加自定义状态
  • 更改自定义状态的类别
  • 将自定义或继承的工作项类型添加到积压工作级别 (自定义积压工作或板)

添加到任务 WIT 的状态会将列添加到任务板。 如果 跟踪 bug 以及任务,则添加到 bug WIT 的状态也会向任务板添加列。 你不必向其中每个 WIT 添加相同的状态,但是,你可能希望这样做,以便以相同的方式更新状态,并最大程度地减少添加的列数。

先决条件

在自定义流程之前,建议查看配置和自定义Azure Boards,其中提供了有关如何自定义Azure Boards以满足业务需求的指导。 有关不同积压工作和板的说明,请参阅 积压工作、板、任务板和计划支持的任务

打开“设置”>“流程”

从“组织设置”>“流程”创建、管理以及自定义流程。

  1. 选择 Azure DevOps 徽标以打开“项目”。 然后选择“组织设置”。

    “打开项目”>“组织设置”。

  2. 然后,选择“流程”。

    然后,选择“流程”。

    重要

    如果未看到“流程”,则表示你使用的是 TFS-2018 或更低版本。 不支持“流程”页。 必须使用本地 XML 流程模型支持的功能。

从“集合设置”>“流程”创建、管理以及自定义流程。

  1. 选择 Azure DevOps 徽标以打开“项目”。 选择要自定义其流程的项目集合,然后选择“集合设置”。

    “打开项目”>“组织设置”

  2. 然后,选择“流程”。

    然后,选择“流程”。

从“管理员设置”>“流程”创建、管理以及自定义流程。

  1. 选择 Azure DevOps 徽标以打开“项目”。 然后选择“管理员设置”。

    “打开项目”>“组织设置”。

  2. 然后,选择“流程”。

    然后,选择“流程”。

注意

自定义继承的过程时,使用该过程的所有项目都会自动更新以反映自定义项。 出于此原因,建议在进行大量自定义时创建测试过程和测试项目,以便在向组织推出自定义项之前对其进行测试。 若要了解详细信息,请参阅 创建和管理继承的进程

添加工作流状态

添加的状态显示在工作项窗体和查询编辑器中显示的“状态”字段的下拉菜单中。 将创建一个到和从你添加的州到其他每个状态的转换。 此外,还定义了默认原因,例如 已移到状态会审移出状态会审

  1. 从“ 工作项类型 ”页中,选择要修改的工作项类型,选择“ 州”,然后选择“ 新建状态”。

    “处理”页、“Bug WIT”、“状态”选项卡、“添加状态”

    如果禁用了 “新建状态 ”选项,则你没有编辑进程所需的权限。 请参阅 设置工作跟踪的权限和访问权限、自定义继承的进程

  2. 输入“州”的名称,选择其类别和颜色,然后单击“ 保存”。 指定的颜色将在整个产品中显示,包括工作项窗体上以及“状态”字段出现在积压工作、版块、查询结果等上时。

    工作项窗体中的“状态”菜单

    注意

    添加到“正在进行”或“已解决”状态类别的任何工作流状态都将导致“激活日期/”和“解决的/解决日期”字段更新这些类别的工作流状态更改。 若要了解详细信息,请参阅 按分配或工作流更改进行查询、激活者/日期和解决日期/日期字段

  3. (可选) 若要在下拉菜单中更改“状态”的顺序,请选择 上下文菜单图标,然后选择“ 上移 ”或“ 下移”。

    上移状态

  4. 完成为 WIT 添加状态后,请通过刷新浏览器并打开自定义类型的工作项来验证更改。

    此处显示了“状态”下拉菜单,其中选择了“会审”。

    Bug 表单,已添加会审状态

  5. 请记住,将状态添加到与积压工作级别关联的 WIT 时,每个使用看板的团队都需要 更新其列设置

编辑状态

可以编辑自定义状态的类别或颜色。 但是,无法更改自定义状态的名称。

  1. 从...中选择“编辑” 要修改的状态的上下文菜单。

    Bug WIT,编辑自定义状态

  2. 修改类别或颜色,然后选择“ 保存”。

  3. 如果更改类别,使用看板的团队需要更新其 列设置

隐藏或删除自定义状态

隐藏或删除状态时:

  • 状态不再显示在 WIT 的“状态”下拉菜单中
  • 工作项历史记录未发生任何更改
  • 现有工作项保留其状态值,但处于无效状态。 如果要对工作项进行更改,必须先更新状态值。 可能需要创建查询并执行批量更新,以将受影响的工作项移动到有效状态。 如果将状态添加回工作项类型,则工作项还原有效状态。

隐藏或取消隐藏继承的状态

可以隐藏团队在其工作流过程中不使用的继承状态。 但是,必须为每个类别至少定义一个状态。

  1. 打开…… 要隐藏的状态的上下文菜单,然后选择“ 隐藏” 选项。

    此处隐藏 Bug WIT 的已解决状态。

    隐藏继承状态

    注意

    如果隐藏在看板上跟踪的 WIT 的状态,则每个使用看板的团队都需要 更新其列设置

  2. 若要取消隐藏,请打开... 上下文菜单,然后选择 “取消隐藏 ”选项。

删除自定义状态

  1. 打开…… 要删除的状态的上下文菜单,然后选择 “删除”。 只能删除自定义状态。

  2. 在“删除状态”对话框中,单击“ 删除”。

    “删除状态警告”对话框

查看状态工作流模型

可以通过安装状态模型 可视化市场 扩展来查看状态工作流模型。 此扩展可在“面板”下添加一个具有“状态可视化工具”标签的新中心。 在该页上,可以选择工作项类型,并查看工作流状态模型。

注意

状态模型可视化扩展是 Azure Boards 不支持的功能,因此不受产品团队支持。 有关使用扩展时出现的问题、建议或问题,请访问 扩展页

例如,下图显示了已自定义为具有 会审状态的 Bug 工作流。 此视图演示工作流模型的默认转换。 所有状态都可以从一种状态转换为另一种状态。

已自定义为具有会审状态的 Bug 工作流。

可以放大和缩小视图。 此外,还可以四处移动状态节点,以便更好地了解状态模型。

注意

可以通过审核日志查看对继承进程所做的更改。 若要了解详细信息,请参阅 访问、导出和筛选审核日志