3. 工作流基础与状态迁移
适用场景
本章适用于Jira项目管理员或流程负责人，需要在已有项目上定义新工作流或修改现有工作流，实现任务状态的标准化流转。典型场景包括：
- 从“待办”到“进行中”再到“完成”的简单线性流程
- 需要审批环节的非线性流程（如“评审”状态、驳回回退）
- 为不同问题类型（任务、缺陷、用户故事）配置不同状态路径
前置条件
- 拥有Jira项目管理员权限（Jira Administrators 或 Project Administrators）。
- 已创建或已有至少一个项目，且关联了默认工作流方案。
- 了解项目使用的问题类型（Issue Type），如Story、Bug、Task。
- 登录Jira，进入顶部导航 ⚙️ → Issues → Workflows。
操作步骤
以下步骤从零开始设计一个新工作流，并发布到项目中。
- 新建工作流：在Workflows页面点击 Add Workflow，输入名称（如“标准开发流程”），选择 Copy from an existing scheme 并选取默认模板（通常为
Simplified Workflow）。 - 设计状态：进入工作流编辑器，默认状态包括
To Do、In Progress、Done。点击画布空白处添加新状态：In Review（蓝色）、Reopened（橙色）、Closed（绿色）。每个状态需设定分类（Status Category）：To Do、In Progress、Done。 - 创建转换：从
To Do → In Progress（Start Progress），In Progress → In Review（Submit Review），In Review → Done（Approve），Done → Reopened（Reopen），Reopened → In Progress（Restart）。 - 设置转换条件：选中转换
In Review → Done，添加条件 Only assigned users（限定审批人为特定角色或组成员）。其他转换保持开放。 - 配置触发器与后处理功能（可选）：在转换上添加 Update issue field 后处理，如自动设置解决结果（Resolution）为“已修复”。
- 发布工作流：点击 Publish Draft，确认影响的问题数（注意：重大修改可能影响存量工单状态映射）。
- 关联到项目：进入项目 → 项目设置 → 工作流方案，将新工作流应用到对应问题类型，保存。
输入输出物
| 输入物 | 输出物 |
|---|---|
| 项目已有工作流方案（默认或现有） | 新工作流草稿（Draft Workflow） |
| 问题类型列表（Issue Types） | 已发布的工作流（Active Workflow） |
| 角色/用户组定义（用于条件） | 更新后的工作流方案变化记录（Audit Log） |
责任边界
- Jira管理员：负责工作流全局设计、转换条件配置、发布与方案关联。
- 项目管理员：在已分配的工作流方案范围内，可调整方案中问题类型与工作流的映射关系。
- 团队成员：使用工作流进行状态迁移，但不可修改工作流定义。
⚠️ 风险提示： 修改已发布的工作流可能影响当前进行中的工单。例如，删除某个状态会导致该状态下的工单无法正常映射。建议在测试项目（Test Project）中先验证，或选择 Draft 模式暂不发布。
记录材料
- 工作流名称、版本号（Jira自动生成）。
- 状态列表及对应的Status Category映射表。
- 每个转换的触发器、条件、后处理清单（可导出为PDF或截取编辑器截图）。
- 工作流方案关联文件（Project → Workflow Scheme 页面截图）。
异常处理
| 异常现象 | 原因分析 | 处理措施 |
|---|---|---|
| 发布工作流时提示“无法删除状态” | 该状态仍有工单占用 | 先批量迁移工单到其他状态；或使用 bulk change 工具强制映射 |
| 转换按钮对用户不可见 | 条件设置过于严格（无人满足角色/组） | 检查条件中的角色/组成员，或在条件中添加 Allow all users 备用分支 |
| 工作流发布后，现有工单状态显示错误 | 状态分类与新工作流不匹配 | 重新编辑工作流方案，调整状态映射（Map statuses） |
验收标准
- 在项目中点击工单，可在详情页看到所有预期状态和转换按钮。
- 测试每个转换：合法用户能正常执行，非法用户收到权限提示（如无审批权限）。
- 所有工单的状态迁移日志（History）完整记录操作人、时间、原状态和目标状态。
- 工作流方案中每个问题类型都能按预期路径流转，无死锁状态。