JIRA工作流介绍

\"工作流\"是一个问题经过其生命周期的若干阶段和阶段的变迁. 问题的工作流典型的代表了业务处理和开发的周作流,同时对相应的概念进行解释. 如果你已经定义了一个工作流, 请参见 激活工作流 一节来进行使用. 所有的JIRA版本都带有一个 默认的工作流 . JIRA企业版和专业版允许 通过JIRA工作流编辑器对工作流进行定特定项目或项目问题类型相关的多个工作流. JIRA专业版仅支持一个活动的工作流. 即在JIRA专业版中用户可以统中的所有问题 只能使用其中的一个工作流.

步骤和变迁

工作流由 步骤 和 变迁组成.

一个工作流的步骤 代表了在工作流中针对一个问题的一个阶段. 在某一时刻一个问题只能 存在于一个在步骤步骤叫做初始步骤. 同时一个问题被创建并被放置 到该步骤中. 每个工作流步骤有一个\"链接\" 状态 . 当一个新为该步骤已经被\"链接\"的状态.

每个工作流步骤可以具有 变迁 ,从而使一个问题从一个步骤移动到另外一个步骤. 为了使一个问题能够从一变迁将这两个步骤联系起来. 一个变迁是在两个步骤之间的 单方向链接 . 这表明如果一个问题需要在两个步迁.

对一个问题现有的工作流步骤已经在问题的 View Issue 页面列出:

用户可以通过点击其中一个链接来执行一个工作流的过度(使问题通过一个工作流).

创建工作流

创建一个新的工作流,可以在 View Workflows 页面中通过如下步骤来实现:

1.Login as a user with global administrator access.

2.Bring up the administration page by clicking either on the \"Administration\" link on the top

Administration box on the dashboard:

3.如果左边的Global Settings的子菜单没有打开, 请点击并从列表中选择Workflows.

Page:1/9

Shanghai Digital Talent Technology Co., Ltd. http://www.fangwai.net View Workflows 页面中列出了当前系统中全部定义的工作流, 管理员可以对这些工作流进行管理.

Note

这个屏幕截图显示了JIRA企业版中的页面情况. JIRA专业版不支持 Workflow Schemes , 因此在工作

在JIRA可以用不同方式来创建一个新的工作流:

1.在View Workflows页面通过Add New Workflow form来创建一个空白的工作流. 2.通过点击现有工作流的\"Copy\"链接来拷贝一个现有的工作流.

3.在XML中手动创建一个workflow definition , 并将其导入到JIRA中.

一旦完成了一个新工作流的创建, 用户很可能会对其进行编辑(尤其当用户创建了一个空白工作流)或者 激活

工作流的编辑

工作流的编辑可以通过 View Workflows 页面, 来点击想要编辑的工作流 旁边的\"Steps\"链接. 然后就会转

Page:2/9

Shanghai Digital Talent Technology Co., Ltd. http://www.fangwai.net 在 Workflow Steps 页面, 用户可以创建, 编辑和删除工作流步骤, 并且可以增加和删除工作流的变迁.

Note

只有非激活 的工作流可以被编辑. 如果一个活动的工作流需要修改, 拷贝一个活动的工作流, 修改这

工作流步骤

加入新的工作流步骤时, 需要在 Workflow Steps页面底部的 Add New Step form中输入步骤名, 然后选择如果全部现有的状态都已经在被编辑的工作流中被使用, 那么新的状态将会被 创建 .

Note

如果一个工作流步骤是一个变迁的目标, 那么它不能被删除..

在 View Workflow Step页面中点击步骤名就可以看到步骤的整体情况:

Page:3/9

Shanghai Digital Talent Technology Co., Ltd. http://www.fangwai.net 在 View Workflow Step 页面列出了全部针对步骤的操作, 以及全部进出的变迁. 每个变迁的详细情况可以通

工作流变迁

为了使一个问题从一个步骤进展到另外一个步骤, 我们必须创建一个工作流变迁. 通过点击在组织新的变迁步一个新的工作流变迁. 点击后将会产生一个Add Workflow Transition页面:

这里你可以指定:

llll

变迁的名字 - 变迁的名字将会作为一个可用于问题上的操作出现在 View Issue 页. 描述 - 简短的文字来描述变迁的目的.

目标步骤 - 执行当前变迁后, 问题将会被移动到的步骤.

变迁视图 - 在变迁被执行前,该 界面 将会显示给用户来提供输入. 其中的选项有: 1.变迁没有显示 - 没有页面显示给用户, 变迁将会立即执行.

2.选择已经存在的视图 - 在变迁执行前选择一个视图. 可以选择一个已经存在的视图. 关于视窗的更

定制工作流变迁

在工作流中可以进行:

l

当一个问题从一个步骤进行到另外一个步骤时,可以执行任意一个过程. 例如, 更新问题的 某些域并将functions来完成.

Page:4/9

Shanghai Digital Talent Technology Co., Ltd. http://www.fangwai.net ll

对可以进行变迁操作的用户加以(即能够看到变迁链接的人). 该操作可以用 Conditions来完成. 假设用户能够进行变迁操作(通过了Conditions), 可以对提供的所有输入参数在其传入 Post functions的数值是否被输入. 这个检查可以通过 Validators来完成.

Post functions, Conditions 和 Validators 可以在 View Workflow Transition 页面中进行设置, 如下所示

条件

条件了一个工作流变迁的执行, 直到某些条件得到了满足. 如果这些条件没有得到满足, 用户将不能在ViewJIRA预置了一些常用了条件:

Permission ConditionOnly Assignee Condition

User Is In GroupSub-Task Blocking

Condition

允许用户只有在某些特定许可下进行变迁的条件.只允许被分配到任务的用户执行变迁的条件.只允许特定组里面的用户执行变迁的条件.阻止依赖于子任务状态的父问题变迁的条件.

通过插件系统, 用户可以建立自己的条件并在JIRA的工作流编辑器中使用. 关于如何实施您自己的条件,查看 在变迁中加入条件: 1.2.3.4.

进入到 View Workflow Transition 页面 选择Conditions标签

点击 \"Add\" 链接. JIRA中全部当前条件将会列出.

从列表中选择一个条件, 然后点击\"Add\"按钮. 如果一个条件需要一个或多个设置参数 一个Condition

加入到变迁的条件可以通过点击其描述旁边的\"Delete\"链接来移除. 如果变迁具有一个或多个参数, 它们可以通

校验器

校验器能够保证传入到变迁的Post functions的运行参数是合法的. 例如, 一个校验器能够保证 用户在变迁视图

Page:5/9

Shanghai Digital Talent Technology Co., Ltd. http://www.fangwai.net 个校验器无效, 那么变迁的Post Functions 就不能被执行. 问题也就不能进行到变迁的目标步骤.

条件和校验器和角色经常容易使人误解. 条件是用来决定变迁是否被允许执行. 因此它不能用来输入 由用户在用户不能执行变迁, 因此就不会有变迁视图出现.

另一方面, 校验器能够访问在变迁视窗中从用户得到的输入. 因此, 能够对输入进行校验.

如同条件一样, JIRA预置了一些校验器的例子. 通过JIRA的插件系统, 用户可以开发校验器并将其插入到JIRA在工作流变迁中加入一个校验器与加入一个条件非常相似 1.2.3.4.

进入到 View Workflow Transition 页面 选择 \"Validators\" 标签

点击 \"Add\" 链接. 现有的校验器将会列出.

从列表中选择一个校验器, 然后点击\"Add\"按钮.

加入到变迁的校验器可以通过点击其描述旁边的\"Delete\"链接来移除. 如果校验器具有一个或多个参数, 它们

Post Functions

当一个变迁执行后, 后处理函数将会立即执行一些处理, 如更新问题域, 生成问题的变更历史, 给问题加入注释作流中得到处理.

某些后处理函数不能被编辑, 删除和定制. 他们必须在每个变迁中被执行. 这些后处理函数对JIRA的问题生命周会打折扣.

如同条件和校验器一样, JIRA预置了一些后处理函数, 定制的后处理函数可以通过JIRA的 插件系统来进行实现您自己的后处理函数的详细信息可以查看 工作流指南 . 后处理函数能够按以下方式加入到变迁中: 1.2.3.4.

进入到 View Workflow Transition 页面 旋转 \"Post Functions\" 标签

点击 \"Add\" 链接. JIRA中的后处理函数将会列出. 从列表中选择一个后处理函数, 然后点击\"Add\"按钮.

加入到变迁的后处理函数可以通过点击其描述旁边的\"Delete\"链接来移除. 如果后处理函数具有一个或多个参数编辑..

后处理函数排序可以通过点击列表中的每个后处理函数旁边的上下箭头来进行. 请注意, 关键的后处理函数不能间\"插入\"一个后处理函数是可以的.

初始变迁

初始变迁是在一个问题建立时被执行的一个变迁. 这个变迁将问题\"放入\"到\"初始\"的工作流步骤中.

每个工作流必须具有仅限一个初始变迁. 只要一个工作流被创建, 该变迁会被自动创建(除非工作流从XML导入当工作流中创建一个问题后,有时候需要执行一些逻辑. 这可以通过在工作流的初始变迁中添加后处理函数来作流动\"初始\"步骤,然后在查看工作流的界面上点击工作流变迁.

公共变迁

对于那些熟悉 OSWorkflow的用户, JIRA所使用的工作流系统更接近于Common Actions. Common Actio

Page:6/9

Shanghai Digital Talent Technology Co., Ltd. http://www.fangwai.net 中仅定义一次的变迁, 然后它被引用到多个工作流步骤中. 这意味着common transition可以具有一个或多个在一个位置更新, 同时更新将会影响变迁的全部初始步骤.

JIRA的默认工作流使用Common Transitions. 虽然 JIRA的工作编辑器不提供创建Common TransitionsTransitions编辑的支持. 因此, 如果用户创建了一个JIRA的默认工作流, 他仍然可以对其拷贝进行编辑.

在系统间拷贝工作流

有时候更有效的方式是在一个测试系统中创建一个工作流.然后将其拷贝到一个产品系统中. 将这些存档的最佳XML中. 该操作可以通过点击在 View Workflows 页面列表中的工作流旁边的\"XML\"链接, 然后将输出存入文然后, 点击\"import workflow from XML\"链接来导入文件, 并将工作流文件内容粘贴到当前页面的文本区.用户也可以拷贝文件到运行JIRA的机器中, 然后提供文件的整个路径. 这样就无须粘贴它的内容到文本区.

活动和非活动工作流

JIRA的工作流有活动和非活动两种状态.

非活动 是指存在于系统中但不和任何项目或(企业版中)工作流方案相关联. JIRA的专业版只有一个 活动的工作流 - 被全部项目所使用.

在JIRA企业版中, 非活动流没有和任何工作流方案相关联, 或者已经和 Workflow Schemes 相关联但没有被活动 工作流是指那些当前被使用的工作流.

请注意只有 非活动 工作流才能被更改. 如果一个活动工作流需要被更改, 需要将其拷贝, 然后改动这个拷贝

Restricting Issue Updates

在特定的工作流步骤中可以对问题的编辑. 例如,在JIRA系统中默认的工作流中 处于关闭状态的问题不能被限. 注意:在使用批量修改功能过程中 也不能对问题进行编辑和更新.

在特定的步骤中阻止对问题的编辑, 查看 jira.issue.editable 步骤的属性是 false. 如要设置此属性链接在 工作流编辑器的View Workflow Step 页面,通过界面底部的表单来添加属性. 请注意您要编辑工作流状态, 否则是不能进行工作流的编辑.

作为JIRA系统的默认工作流是不能被编辑的, 如果您想允许处于关闭状态的问题可以被编辑, 您需要拷贝默认jira.issue.editable 属性. 然后再 激活 这个工作流.

工作流解决方案

JIRA通过一定数量的状态对问题进行处理来模拟问题的生命周期. 每个状态代表了生命周期的一个阶段,通常由

lll

OPEN - 问题打开, 但是工作还没有开始

IN PROGRESS - 问题打开, 工作还已经开始 CLOSED - 问题关闭, 工作已经完成

但是, 对于实际的 打开 和 关闭 问题, JIRA并不加以区分. 如果一个问题和一个OPEN状态相关联,JIRA不决CLOSED状态相关联的问题, JIRA也不决定它是 关闭 的.

在JIRA中, 真正决定一个问题是 打开 的还是 关闭 的 是通过 Resolution的域来决定的. 如果一个关联的

Page:7/9

Shanghai Digital Talent Technology Co., Ltd. http://www.fangwai.net 打开的, 反之, 问题则是 关闭 的.

大部分的portlet过滤器都可以在JIRA中找到 - 如所有打开的问题 - 用于解决方案的设置 来决定一个问题是当一个解决方案需要通过工作流编辑器来进行设置或删除时, 工作流程设计工具能够实现这一操作. 该操作可以

ll

工作流变迁后处理函数 工作流变迁查看界面

工作流变迁后处理函数

1.2.3.4.

对于一个工作流中的特殊步骤, 建立一个变迁将问题改变成为 关闭 状态 (如. 关闭, 解决, 等等.). 对变迁视图选择 添加注释并指派 或者 No View For Transition .

编辑新建的变迁,加入一个新的后处理函数 Update Issue Field. 从下拉列表中选择 Resolution完成后, 后处理函数列表将如下所示:

为了建立一个删除解决方案的变迁 - 遵循相同的步骤,但是不要在解决方案的 Update Issue Field界面中明:

问题的解决方案将会被清除.

每次选择工作流变迁操作时 - 问题的解决方案将被自动设置或删除.

Workflow Transition View Screen

Page:8/9

Shanghai Digital Talent Technology Co., Ltd. http://www.fangwai.net 当一个变迁执行时, 将会出现一个工作流变迁界面. 该窗口可以通过创建一个 field screen来得到. 在这个例子窗口来将其想显示的域加入到窗口中.

工作流和通知

每个 workflow transition 具有一个 Fire Issue Event post function 该函数负责在变迁每次执行时发起一知并调用listeners.

当变迁执行时, JIRA将会用触发事件来查找与问题项目相关联的 Notification Scheme, 然后向该方案事件中述, 触发事件也将会传递到全部注册的listeners.

通过编辑触发事件 后处理函数和选择其中一个JIRA的事件, 用户可以选择哪个事件在工作流变迁中被触发. JIRA中没有作为默认使用的Generic Event.

技术信息

JIRA使用灵活可定制的工作流引擎 OSWorkflow, JIRA的工作流编辑器生成OSWorkflow的XML定义文件一些JIRA工作流编辑器中所没有的OSWorkflow特征, 那么他可以在XML中定义工作流, 然后导入到JIRA中

Note

JIRA工作流编辑器能够显示大多数OSWorkflow定义, 即使它不支持对这些定义的创建和编辑. 例如Workflow Transition页面的Other标签中. 如果一个变迁的单元不被编辑器直接支持, 那么该标签仅

Warning

JIRA的XML工作流定义包含指向JIRA meta特性的参考. 例如, 每一个工作流步骤的已链接JIRA状态储于步骤的定义中. 因此, 当用户在XML手动创建工作流时, 应在将工作流导入到JIRA前确信全部参考外

Page:9/9