JIRA使用手册.doc

JIRA 是澳大利亚 Atlassian 公司开发的一款不错的商业问题跟踪工具，可以对各种类型的问题进行跟踪 管理，包括缺陷、需求变更、评审记录等。笔者在进行缺陷跟踪工具的选型时，曾经试用了 JIRA 一段时间，个人感觉很不错。笔者结合试用过程中碰到的问题和个人体会，将试用记录进行了整理。 本文主要介绍 JIRA 的 个性化定制，介绍如何根据公司实际需求对 JIRA 进行定制，适用于管理员。至于说 JIRA 的基本使用方法，和普通的缺陷跟踪工具类似，本文不做重点介绍。 您可在 JIRA 官 方网站 /jira 上了解到 JIRA 更 为详细的信息。 1 背景 在试用 JIRA 前， 公司使用 Bugzilla 作为缺陷跟踪工具。在使用初期， Bugzilla 确实发挥了一定的作用，但随着公司强化项目管理的需要， Bugzilla 开始不够用了。 项目组使用 Bugzilla 时，存在几个问题： l 项目组需要对不同类型的问题进行记录，如任务分配、评审所发现的问 题、需求变更记录，缺陷等。虽然可以在 Bugzilla 中也可以将这些各种类型 的问题当作缺陷记录，但是这会混淆缺陷跟踪流程，因为这些不同类型的问题的处理流程是不一样的，但是 Bugzilla 中无法在系统中定制多个问题跟踪流程。 l 项目管理者无法记录缺陷的预期修复完成时间 l 项目管理者不能批量分配、编辑缺陷 l 无法记录开发人员处理缺陷所花的工作量，并且所花工作量缺少对比。 l 开发人员无法快速、直观的清楚分配给自己的缺陷，对于正在进行处理 的缺陷也没有很直观的表现。 l 测试人员不知道缺陷修复预期对应的版本，导致缺陷回归时范围不清 晰。 l 不方便升级，升级成本大。 l 其它细节问题，如界面不友好，用户无法上传附件等。 2 介绍 跟踪并管理在项目过程中呈现出来的问题（如缺陷、新特性、需求变更、 QA 审计问题等）是项目管理很重要的任务，但是很少有团队能做的很好。 JIRA 虽然是一个问题跟踪系统，但是只要稍加改造，便可以成为一个项目管理软件。是一个问题跟踪和项目管理 应用系统，目的是为了让跟踪和管理在项目过程中呈现出来的问题变得简单。 JIRA 具有以下特性： l 管理缺陷，新特性、任务、改进或者其他任何问题 l 干净和强大的用户界面方便商业或技术用户理解 l 工作流定制 l 全文搜索和强大的过滤器（可定制的，可保存的，可共享的，可预定的 过滤器） l 可定制的工作台和实时统计 l 企业级的权限和安全控制 l 方便的扩展及与其他系统集成（包括 email 、 RSS 、 Excel 、 XML 和源码控制工具） l 非常高的通知选项配置 l 可以在几乎所有硬件、操作系统和数据库平台下运行 JIRA 可以根据你的需要提供所需要的信息。下面以缺陷为例，介绍各个角色成员在 Jira 中可以获得的信息和可以做的事情。 l 管理人员根据缺陷数据统计结果，了解项目状态 n 查看项目整体问题分布情况 n 查看项目整体问题工作量与进度情况 n 查看某一开发人员在不同项目的开发工作量情况 n 查看项目某个版本的工作量情况及每个用户的缺陷及剩余工作量情况 l 项目管理者评估缺陷和分配缺陷 n 查看分配给我的问题 n 看某个问题的详细信息 n 分配问题 n 填写问题的预期修复时间及修复估算工作量 l 开发人员处理缺陷，提交工作量记录 n 接受问题，准备开始处理问题 n 问题处理后，准备在系统上填写处理情况 n 填写处理情况 n 完成处理信息的填写后，准备填写处理问题所花的工作量 n 填写处理问题所花的工作量 l 测试人员快速的提交缺陷，跟踪缺陷 n 提交问题 n 填写问题详细信息 n 根据不同过滤条件查看不同的问题，准备进行问题的跟踪处理 n 根据不同过滤条件列出的查询结果 n 验证问题处理情况，根据不同工作流节点选择不同的操作 3 安装 相比 Bugzilla ， JIRA 有个很突出的优点：不用花数小时或数天来搭建你的问题跟踪系统， JIRA 可以在小于 30 秒 内搭建并运行在你的系统上。下面，笔者向您介绍 JIRA 的安装步骤。 1 执行 /bin 目录下的 startup.bat 文件，进入安装 2 选择一个索引目录，并输入 licence ，执行下一步 3 输入创建的管理员信息，执行下一步 4 在设置邮件服务器页面，其他信息都很容易故不多说。强调的是，在 SMTP 服务器输入框，要输入 IP 地 址，即： 16 （内部邮箱），用户名为内部邮箱用户名（如： ），执行下一步 5 完成安装。 4 系统配置 该部分主要以某公司对问题跟踪系统的需求作为案例，介绍如何根据实际需求，在 JIRA 中进行配置。本案例中涉及到缺陷跟踪和需求变更的跟踪管理两部分。 4.1 设置问题类型 问题来源 描述 缺陷（ Default ） 系统本身的 错误 Improvement 在系统需求 范围内，但是对表现 / 实现方式进行了改进。 Requirement Change 对系统原先 需求进行了变更，包括新增的需求、变更的需求 Issue 平常讨论过 程中发现的问题记录 Review 评审中发现 的问题记录 Noncompliance Report QA 在审核过程中发现的不符合 项记录 设置问题类型步骤如下： 1) “管理”“ Issue Settings ”“ Issue Type ”，进入“ View Issue Types ”界面 2) 进行问题类型的增加、编辑等操作，并点击“ Default ”设置默认值。 4.2 设置工作流方案 1 设置状态 在某公司中，状态有Open、Assigned、Accepted、Pending、Closed、Sleeped等。 步骤如下： 1) 选择“管 理”“ Issue Settings ”“ Statuses ”，进入“ View Statuses ”界面 2) 进行状态的 增加、编辑等操作。 2 设置工作流 根据已定义的 缺陷 处理流程 ，在 JIRA 中新增一个工作流设置（不要在原来的工作流上修改），并设置如下。 l 缺陷： Step Name (id) Linked Status Transitions (id) Conditions Post Functions Open (1) Open 分配缺陷 (2) Assigned Assignee 解决 null Assigned (2) Assingned 接受本缺陷 (4) Accepted Resolve Issues Accepted (3) Accepted 缺陷处理完毕 (5) Pending Resolve Issues Pending (4) Pending 验证通过 (701) Closed Testers 解决 1 （目的是 close 时，将解决改为 Fixed ） 验证不通过缺陷 (3) Assigned Testers 解决 null 确认暂不处理本缺陷 (711) Sleeped Assigners Closed (6) Closed 激活缺陷 (3) Assigned Testers 解决 null Sleeped (7) Sleeped 激活缺陷 (721) Assigned Resolve Issues 解决 null 其中，“接受本缺陷”，选择“ No view for transition ” ，“验证通过”，选择“ No view for transition ”，“确认暂不处理本缺陷”选择“ Add comment and assign ”。 l 需求变更 Step Name (id) Linked Status Transitions (id) Conditions Post Functions Open (1) Open 完成需求变 更评估 (11) Evaluated Analyst Evaluated (2) Evaluated 审核通过 (21) Assigned CCB 审核不通过 (31) Open CCB Assigned (3) Assigned 接受本需求变更 (51) Accepted Resolve Issues Accepted (4) Accepted 需求变更实施完毕 (61) Pending Resolve Issues Pending (5) Pending 验证通过 (71) Closed Testers 解决 1 （目的是 close 时，将解决改为 Fixed ） 验证不通过 (81) Confirmed Resolve Issues 解决 null Closed (6) Closed Testers 其中，“完成需求变更评估”、“ 审核通过 ”、“ 接受本需求变更 ”、“ 验证通过 ”，选择“ No view for transition ”；“ 审核不通过 ”、“ 验证 不 通过 ” 选择“ Add comment and assign ”；“ 解决本需求变更 ”选择“ Add comment, assign and set resolution ”。 3 设置工作流节点的条件、功能点、合法性控制 我们需要对不同的事务控制权限，或者是控制执行提交操作时要进行哪些操作，具体设置如上表“ Conditions ”、“ Post Functions ” 二列。例如，对于 Verified 步骤的事务“重新打开缺陷”执行时，要将“解决”的值清空。 设置步骤如下： 1） 选择需要设置条件的事务，如 Verified 步骤的事务“重新打开缺陷” 2） 在界面下方的三个 Tab 页中，选择“ Post Functions ” Tab 页 3） 点击“ Add ” 链接 4） 在进入的“ Add Post Function To Transition ”界面中，选择“ Update Issue Field ”选项 5） 在进入的“ Add Parameters To Function ”页面中，“ Issue Field ”选择“解决”，“ Field Value ”设置为空，点击 Add 按钮 这样，当缺陷从 Verified 状态被重新打开时，“解决”域的值就会被清空。这条缺陷，就可以出现在责任人首页的“分配给我”的清单中。 4 设置工作流配置文件 步骤如下： 1） 选择 “管理”“ Schemes ”“ Workflow Schemes ”，进入“ Workflow Schemes ”界面 2）增加一个Workflow方案 3） 选择问题类型（如缺陷、 Improvement ），为该 workflow 方案分配已定义的 Workflow 。 同理，为其他几种问题类型，都设置一个 workflow ，方便以后流程的升级。否则以后如果需要改流程，则需要将工作流配置文件先取消关联，然后才能修改该 方案对应的工作流。这可能导致 verified 状态对应的缺陷被改变状态。如下图所示： 问题类型 选择的工作流 Defect Defect Track Improvement Defect Track Issue Issue Track Requirement Change Requirement Change Track Noncompliance Report Noncompliance Report Track Review Review Track 4.3 问题 属性 1 严重 性 严重性 说明 Blocker 灾难导致系统失效，例如蓝屏或数据发生 冲突 Critical 重要产品不可用，例如导致错误的答案和 错误的报告 Major (default) 中等产品可用，客户说到影响 Minor 轻微产品可用，没有客户受到影响 Trivial 无足轻重如果时间允许则修复 设置步骤如下： 1） 选择 “管理”“ Issue Field ”“ Custom Fields ”，进入“ View Custom Fields ”界面 2） 点击 “ Add Custom Field ”链 接，进入“ Create Custom Field ”界面 3） 选择 “ Select List ”类型，选择“ Global all issues ”选项，点击 NEXT 按 钮 4） 在“ Field Name ”域输入“严重性”，在“ Choose Search Template ”项选择“ Select List Searcher ”，点击 Create 按 钮 5） 在“ Edit Custom Field Options ”页 面，增加下拉框选项（如上表所属内容 ) ，完成 后，点击 Done 按钮 6） 在“ View Custom Fields ”界 面，“严重性”行，点击“ Edit Defaults ”链 接，在弹出的页面中，选择该下拉框的默认值 2 优先 级 优先级分 P1 P5 五个 级别，其中， P1 优先级最高， P5 最 低。 优先级 说明 P1 系统的正常业务流程无法通过，必须马上修改 P2 系统用户无法正确使用系统；导致用户对系统 理解发生偏差；影响客户或公司的形象 P3 (default) 系统用户无法使用部分非重要功能 P4 不影响系统的正常使用，发布后可以通过打补 丁的方式解决问题 P5 问题对系统影响很小，可以不修改 设置步骤如下： 1） 选择 “管理”“ Issue Setting ”“ Priorities ”，进入“ View Priorities ”界面 2） 对选 项值进行编辑，并点击“ Default ”设置 默认值。 3 缺陷 类别 内容 说明 程序错误 1. 由于程序所引起的死机，非法退出 2. 由于程序未做错误控制而引发的缺陷，如直接进入HTTP404/500界 面 3. 因错误操作导致的程序中断或退出 4. 程序接口错误 功能实现偏差 (default) 1. 功能未达到详细设计说明书中标明的功能 2. 功能超出了详细设计说明书指明的范围 3. 功能未达到详细设计说明书虽未指出但应达到的目标 界面不友好 1. 功能可用，但是操作界面不友好、难于理解、不易使用、或者最终用户认为界面不好 2. 提示信息内容不友好、不准确 3. 界面不规范 4. 提示窗口文字未采用行业术语 数据错误 1. 数据被损坏或未传送到目的地 2. 数据通讯错误 文档缺陷 1. 文档所用的术语不适用于用户 2. 文档不完整 3. 文档未清楚的表达所描述的内容或内容不正确 设置步骤如下： 1） 选择 “管理”“ Issue Field ”“ Custom Fields ”，进入“ View Custom Fields ”界面 2） 点击 “ Add Custom Field ”链 接，进入“ Create Custom Field ”界面 3） 选择 “ Select List ”类型， Scope 选择 “ Issue Type - issues of a specified type ”选 项，点击 NEXT 按钮 4） 在“ Field Name ”域输入“ Bug 类 别”，在“ Choose Search Template ”项选 择“ Select List Searcher ”，点 击 Create 按钮 5） 在“ Edit Custom Field Options ”页 面，增加下拉框选项（如上表所属内容 ) ，完成 后，点击 Done 按钮 6） 在“ View Custom Fields ”界 面，“ Bug 类别”行，点击“ Edit Defaults ”链接，在弹出的页面中，选择该下拉框的默认值 注意：该属性 Scope 只能选择“ Issue Type - issues of a specified type ”项。 4 解决 方案 解决方案 描述 Fixed (default) 缺陷已正确解决，并经过验证 Later 该问题确实是个缺陷，但是本版本不解决 Invalid 问题的描述不是个缺陷 Wont Fix 该问题确实是个缺陷，但是不打算解决 Duplicate 问题的描述是一个已经存在的缺陷 Cannot Reproduce 按照描述的步骤，不能重现该问题 设置步骤如下： 1） 选择 “管理”“ Issue Setting ”“ Resolutions ”，进入“ View Resolutions ”界面 2） 对选 项值进行编辑，并点击“ Default ”设置 默认值。 5 平台 包括： DEC 、 HP 、 Macintosh 、 PC 、 SGI 、 Sun 、 Other 。 设置 PC 为默认值。设置步骤同上。 6 操作 系统 包括： Windows 95 、 Windows 98 、 Windows Me 、 Windows 2000 、 Windows NT 、 Windows XP 、 Windows Server 2003 、 Mac System 7.5 、 Mac System 7.6.1 、 Mac System 8.0 、 Mac System 8.5 、 Mac System 8.6 、 Mac System 9.x 、 Mac OS X 10.0 、 Mac OS X 10.1 、 Mac OS X 10.2 、 Linux 、 BSD/OS 、 FreeBSD 、 NetBSD 、 OpenBSD 、 AIX 、 BeOS 、 HP-UX 、 IRIX 、 Neutrino 、 OpenVMS 、 OS/2 、 OSF/1 、 Solaris 、 SunOS 、 Other 。 设置 WinXP 为默认值。设置步骤同上。 7 变更 方式 包括：新增、修改 8 发生 阶段 包括：计划、需求、设计、编码、测试、实施、运行 9 申请 人 设置为： User Picker 10 申请 时间 设置为： Date Picker 11 原始 需求内容 设置为： Free Text Field 12 业务 分析结论 包括：不采纳该需求变更、接受本需求变更、未达成一致意见，继续进行业务评估。 13 变更 发生的业务背景 设置为： Free Text Field 14 要求 实现的功能 设置为： Free Text Field 15 技术 分析结论 包括：无法实现、可以实现、未达成一致意见，继续进行技术分析 16 管理 分析结论 包括：允许实施、不允许实施、未达成一致意见，继续进行管理分析 4.4 用户 组和权限控制 用户组 描述 权限 Administrators 管理 JIRA 中的项目、人员、删除缺陷、管理关注者列表 Administer Projects Modify Reporter Delete Issues Manage Watcher List Assigners 修改缺陷、 分配缺陷 Edit Issues Schedule Issues Assign Issues Developers 处理缺陷、 填写缺陷原估算工作量、填写缺陷实际处理工作量、管理关注者列表 Assignable User Resolve Issues Work On Issues View Version Control View Voters and Watchers Manage Watcher List Testers 修改缺陷、 移动缺陷、处理缺陷、管理关注者列表 Edit Issues Move Issues Resolve Issues （含 Reopen Issues ） Close Issues View Version Control View Voters and Watchers Manage Watcher List CCB 变更控制委 员会，进行需求变更的审核动作 Edit Issues Manage Watcher List Analyst 业务分析， 进行需求变更的处理 Edit issue Assignable User Schedule Issues close issue Manage Watcher List jira-users 浏览项目 （含缺陷）、登记缺陷 Browse Projects Create Issues Add Comments Create Attachments Anyone 浏览项目 （含缺陷） Browse Projects 1 设置用户组 设置步骤如下： 1） 选择“管理”“ Users & Groups ”“ Group Browser ”， 进入“ Group Browser ”界面 2） 新增用户组： Administrators 、 Assigners 、 Developers 、 Testers 2 设置权限方案 设置步骤如下： 1） 选择“管理”“ Schemes ”“ Permission Schemes ”，进入“ Permission Schemes ”界面 2） 新增一个权限方案（不要在默认权限方案上进行修改） 3） 在复制的权限方案上，点击“ Permission ”链接，进入“ Edit Permissions ”界面 4） 根据上表的权限分配，进行增、删、改。 注：只有 Assigner 角色可以分配缺陷。 4.5 设置 邮件通知方案 活动 通知人员 登记缺陷 当前缺陷分 配人 该缺陷的所 有关注者 Bug 更新 / 分配 / 解决 / 关闭 / 增加备注 / 重新打开 / 删除 / 移动 当前缺陷分 配人 缺陷登记人 该缺陷的所 有关注者 设置步骤如下： 1） 选择“管理”“ Schemes ”“ Notification Schemes ”，进入“ Notification Schemes ”界面 2） 复制 Default Notification Scheme ，并修改为合适的名称（不要在默认权限方案上进行修改） 3） 按照上述的说明，进行设置。 4.6 设置 界面设计方案 1 开启时间跟踪功能 设置步骤如下： 1） 选择“管理”“ Global Settings ”“ Time Tracking ”， 进入“ Time Tracking Setting ”界面 2） 将“ Hours Per Day ”设 置为 8 ，“ Days Per Week ” 设置为 5 。 3） 点击 Activate 键，完成开 启时间跟踪功能。 2 开启附件功能 设置步骤如下： 1） 选择“ Global Settings ”“ Attachments ”，点击“ Edit Configuration ”链接，进入“ Attachments Settings ”界面，将“ Allow Attachments ”选项选择“ On ”， 在“ Attachment Path ”输入框输入附件的保存路径，如 f:JiraTempAttachment 2） 选择“ Issue Fields ”“ Field Layout (System) ”，进入“ View Issue Fields ”界面，选择“附件”项，点击“ Show ”链接 3 设置界面设计方案 设置步骤如下： 1） 选择“管理”“ Issue Fields ”“ Field Layout Schemes ”，进入“ View Scheme Issue Fields ”界面 2） 执行 Edit 、 Hide 、 Required 等操作。按照下 述的说明，进行设置。 l 缺陷： 顺序 域 是否必填项 1 概要 是 2 问题类型 是 3 严重性 4 优先级 5 模块 6 缺陷类别 7 影响版本 8 修复版本 9 描述 10 平台 11 操作系统 12 附件 13 分配给 是 14 预期日期 15 时间跟踪 估算一个问题解决的时间期限.格式是 *w *d *h *m (表示星期,天,小时,分钟 - * 表示可以是任意数字)例如: 4d, 5h 30m, 60m and 3w. 16 报告人 是 l 需求变更： 顺序 域 是否必填项 1 概要 是 2 问题类型 是 3 变更方式 是 4 优先级 5 模块 6 影响版本 7 修复版本 8 发生阶段 是 9 申请人 是 10 申请时间 是 11 原始需求 12 平台 13 操作系统 14 附件 15 变更类别 16 变更发生的 业务背景 17 要求实现的 功能 18 业务、技 术、管理分析结论 19 严重性 20 时间跟踪 估算一个问题解决的时间期限.格式是 *w *d *h *m (表示星期,天,小时,分钟 - * 表示可以是任意数字)例如: 4d, 5h 30m, 60m and 3w. 21 分配给 是 22 预期日期 23 报告人 是 4.7 界面 1 配置整体属性 设置界面的默认语言、 Title 等信息。 设置步骤如下： 1） 选择“管理”“ Global Settings ”“ General Configuration ”，进入“ Settings ”界面 2） 点击“ Edit Configuration ”链接，在进入的界面按下述设置执行修改。 内容 设置 Title Welcome to XX Issue Tracking System Base URL http:/localhost:8080/jira Mode private Character Encoding UTF-8 Indexing Language English Default Language 中文 ( 中国 ) Allow unassigned issues OFF 2 配置外部界面属性 设置公司 logo （将 logo 文件存放在服务器 images 目录下）、默认语言、 Title 。 设置步骤如下： 1） 选择“管理”“ Global Settings ”“ Look and Feel ”， 进入“ Logo ”界面 2） 点击“ Edit Configuration ”链接，在进入的界面按下述设置执行修改。 内容 设置 URL http:/localhost:8080/jira/images/aboutus_1.gif Logo Width 170 Logo Height 78 Top Bar Colour #ffffff Top Text Colour #000000 4.8 其他 1 修改 timeout 设置 修改 atlassian-jira/WEB-INF/web.xml 60 将 60 （分钟）修改需要的时间。 2 设置自动备份 设置每天进行一次备份。 设置步骤如下： 1） 选择“管理”“ System ”“ Services ”，进入“ Services ”界面 2） 在“ Add Service ”部分， 输入如下信息 内容 设置 Name Backup Service Class com.atlassian.jira.service.services.export.ExportService Delay 1440 （即， 24 小时） 3） 点击 Add Service 键， 进入“ Edit Service ： Backup Service ”界面，输入如下信息，点击更新键，即完成服务设置 内容 设置 Directory name f:JiraTempbackup Date format YYYY-MM-DD-HHmm Backup as Zip Delay 1440 5 项目设置 下面根据某公司实际项目的设置需求，对试点项目进行实际设置。项目设置主要从以下方面进行设置 1 创建项目 输入项目名称、项目缩写、项目经理，选择邮件通知方案、权限设置方案 2 创建模块 创建模块，并设置模块负责人 3 选择权限方案 设置步骤如下： 1) 选择“管理”“ Projects ”“ Projects ”，进入“ Project ：项目名”界面 2) 在“ Permission Scheme ”部分，点击“ select scheme ”链接，在进入的页面中选择需要的权限设 置方案。 4 选择界面设计方案 设置步骤如下： 1) 选择“管理”“ Projects ”“ Projects ”，进入“ Project ：项目名”界面 2) 在“ Field Layout Schemes ”部分，点击“ manage ”链接，进入“ Manage Field Layout Scheme Associations ”界面 3) 点击“ Bug ”这一行的“ Add Association ”链接，选择合适的界面设计方案。对其他类型的问题进行类似操作 5 选择工作流设置方案 设置步骤如下： 1) 选择“管理”“ Projects ”“ Projects ”，进入“ Project ：项目名”界面 2) 在“ Workflow Scheme ” 部分，点击“ select scheme ”链接，在进入的页面中选择需要的工作流设 置方案。 6 创建用户，并分配用户组 系统的权限分配如下： l 项目经理： Assigner Developers jira-users l 模块负责人（缺陷分配人员）： Assigner Developers jira-users l 开发人员： Developers jira-users l 测试人员： Testers jira-users l 项目组其他人员（如 SCM ）： jira-users l 项目外其他人员： Anyone 7 设置项目的 Default Assignee 系统默认是分配给项目负责人，即项目经理。可以根据需要选择默认为模块负责人。 设置步骤如下： 1) 在 Project 页面下的“ Components ”部分，在“ select assignees for components ”处，点击“ Select ”链接，进入“ Select Component Assignee ”界面 2) 选择模块的默认分配人。 8 创建