JIRA 工作流就是事务在其生命周期中经历的一系列状态转换通常代表组织内的流程。存在无法编辑的默认内置工作流;但是,您可以复制这些工作流并使用它们创建自己的工作流。

此外,您还可以从头创建自己的工作流,或者从 Atlassian 应用商店导入工作流。通过使用工作流模型,可以将工作流与特定项目关联,也可以与特定事务类型关联(可选)。

您需要以具有“JIRA Administrators”全局权限的用户身份登录,才能访问和管理工作流。如果工作流不是默认工作流或未与其他项目共享,则项目管理员还拥有对工作流的有限编辑权限。

本页内容:

 下面是一个默认工作流示例:

状态和转换

状态表示事务在工作流中特定点的状态。一个事务在给定时间点只能处于一种状态。在定义状态时,您可以有选择性地指定属性

转换两种状态之间的链接,可使事务从一个状态变为另一个状态。要让事务在两个状态之间移动,则转换必须存在。

转换是单向的链接,因此,如果事务需要在两个状态之间来回移动,则需要创建两个转换。事务的可用工作流转换列于“View issue”屏幕上。

活动和非活动工作流

编辑非活动工作流与编辑活动工作流稍有不同。我们针对您可以对活动工作流进行的修改施加了限制,因为更改将会影响使用此工作流的项目和/或事务类型。

工作流状态说明

非活动工作流

非活动工作流是指当前未被任何项目使用的工作流。目前没有任何事务通过非活动工作流进行转换,因此,您可以直接编辑工作流的步骤转换。有关详情,请参见在文本模式下工作

活动工作流

活动工作流是指当前正被一个或多个项目使用的工作流。在编辑活动工作流时,JIRA 会先创建该工作流的草稿,然后您可以根据需要进行修改。完成后,您可以发布草稿,也可以有选择性地将原始工作流另存为非活动备份。

以下限制在编辑活动工作流的草稿时适用:

  • 如果工作流处于活动状态,则无法编辑工作流名称(只能编辑描述)。
  • 无法删除工作流状态。

要执行上面列出的任何修改,您需要复制工作流(请参见创建工作流),修改副本,然后将其激活。 

工作流设计器

工作流设计器是一个图形工具,可让您查看工作流的布局,并创建和编辑工作流的步骤和转换。您需要以具有“JIRA System Administrators”全局权限的用户身份登录,以访问下面介绍的功能。

借助工作流设计器,您可以:

  • 管理状态和转换:添加,单击并拖动,或选择编辑属性(工作流属性)以重命名或删除(从工作流中删除,但不是从 JIRA 删除)。
  • 添加允许工作流中的其他所有状态转换到选定状态的全局转换。选择转换属性面板中的 Allow all statuses to transition to this one
  • 更改转换使用的屏幕。请参见在文本模式下工作,了解详情。
  • 配置高级转换选项,如触发器、条件、验证程序和后期功能。请参见高级工作流配置页面
  • 状态是全局对象。如果更改一个工作流中某个状态的名称,则也将更改使用该状态的所有工作流中的相应状态名称。
  • 将鼠标光标悬停在某个转换或状态上,查看相关转换标签。 
  • 使用鼠标滚轮缩放图表。平移图表,方法是空白处单击并按住鼠标,然后将鼠标光标滑过图表。
  • 您无法在工作流设计器中克隆转换。
  • 您无法在工作流设计器中创建注释。
  • 您无法直接设置 issue.editable 属性。为此,只需将 issue.editable  属性添加到状态属性即可。
  • 工作流设计器将自动验证您的工作流,并突出显示没有传入或传出转换的任何状态。工作流验证程序还将突出显示具有 JIRA 中不可用的无效权限条件的所有转换。验证程序在您导入工作流或处理复杂工作流时特别有用。

创建工作流

您可以通过多种方法启动新的工作流。这些包括克隆现有工作流、创建新工作流和导入工作流。

克隆现有工作流

  1. 选择 > Issues。 
  2. 选择 Workflows 以打开“Workflows”页面,该页面将显示系统中的所有工作流。
  3. 使用“Operations”列(如上图所示)中的 Copy 链接复制现有工作流。输入名称和描述,然后选择 Copy 按钮。
  4. 通过添加或编辑步骤和转换对其进行自定义。

完成对工作流的自定义后,请参见管理工作流,了解有关如何将其 JIRA 项目配合使用的详情。

创建新工作流

(info) 适用于高级管理员

  1. 依次单击左侧导航面板中的 Workflows 和屏幕顶部的 Add Workflow
  2. 为工作流输入名称和描述。单击 Add
    工作流将在编辑模式下打开,其中包含名为 Open 的步骤和名为 Create 的传入转换。
  3. 通过添加和编辑步骤与转换,继续自定义工作流。

导入工作流

请参见有关导入工作流的文档。

配置工作流

编辑项目的工作流

无论何时创建新的 JIRA 项目,项目都将自动使用默认工作流模型。该模型会将项目中的所有可用事务类型与 JIRA 系统工作流关联。JIRA 系统工作流和默认工作流模型均不可编辑,因此,JIRA 将为您的项目创建可编辑的系统工作流和工作流模型副本。

  1. 选择 > Projects,然后选择相关项目。
  2. 在项目的 Administration 页面上,单击 Workflows
  3. 单击框右上方的“编辑”图标,JIRA 将会自动执行以下操作:
    • 创建名为“Your Project Name Workflow (Draft)”的系统工作流草稿副本。
    • 为工作流创建新的名为“Your Project Name Workflow Scheme”的工作流模型
    • 将项目中的所有现有事务与新的工作流关联。
  4. 现在,您可以编辑草稿工作流了。单击状态或转换,以查看出现的面板中的编辑选项。
  5. 完成后,单击 Publish Draft。借助此对话框,您可以发布草稿,也可以有选择性地将原始工作流另存为非活动备份。
  • 事务数量会影响工作流的配置速度:如果事务数量较少,则此过程相对较快;但是,如果 JIRA 项目中有多个(如数千个)现有事务,则此过程可能需要一些时间。
  • 此过程一旦开始,就不可以暂停或取消。在此过程中,请避免编辑或转换项目中的任何事务。

设置决议字段

在 JIRA 中,事务要么处于活动状态,要么处于关闭状态,具体取决于相应“Resolution”字段的值,而不是“Status”字段的值。

  • 如果事务的 Resolution 字段尚未设置,则它处于活动状态。
  • 如果事务的 Resolution 字段有值(如“Fixed”、“Cannot Reproduce”),则它处于关闭状态。

无论事务 Status 字段的当前值如何(“Open”、“In Progress”),都是如此。因此,如果您需要工作流将事务强制为活动或关闭状态,则需要在转换期间设置事务的 Resolution 字段。为此,您可以使用两种方法:

对工作流转换按钮重命名

如果您复制了系统工作流,并希望在 View Issue 页面上对工作流转换按钮重命名,则必须从已复制工作流的所有转换中删除以下属性:

  • jira.i18n.title
  • jira.i18n.description

否则,系统将继续采用默认名称(即这些属性的)。阅读有关转换属性的更多信息。

在文本模式下工作

文本模式是一种使用工作流的高级方式,可显示步骤和状态之间的不同。在文本模式下,您可以直接处理步骤。有关详情,请参见在文本模式下工作

高级工作流配置

请参见有关高级工作流配置的文档。