JIRA简明使用手册.doc

中信网络科技股份有限公司

JIRA简明操作手册
（仅供内部使用）

质量和项目管理部
2011年 7月

修订记录
版本号
变更日期
变更理由/变更内容
编制人
审批人

3
目录
一、手册内容 3
二、JIRA介绍 4
（一）JIRA特性 4
（二）JIRA角色 4
三、JIRA安装 6
（一）安装文件 6
（二）配置系统属性 6
（二）配置系统管理员信息 6
（三）配置系统邮件通知参数 7
四、JIRA管理使用 9
（一）项目管理（Projects） 9
1、新建项目 9
2、添加项目模块 12
3 、添加项目版本 12
4、选择项目权限方案 13
5、设置项目的 Default Assignee 14
6、选择邮件通知方案 15
（二）问题管理 16
1、问题类型 16
2、优先级（Priority Levels） 16
3、状态（Status） 17
4、解决（Resolutions） 17
5、创建问题 17
6、修改问题 0
7、查找问题 2
五、其他 3

一、手册内容

此文档是基于Jira官方帮助文档整理而成。旨在说明Jira 在 windows 下的安装、管理、日常一般使用操作。以达到对项目过程中发现的bug进行统一管理。项目组应用过程中涉及一些更细节的应用可参看Jira官方帮助文档。
此文档供参考使用，如果文档中有纰漏之处，敬请读者指出。

二、JIRA介绍

跟踪并管理在项目开发和维护过程中出现的问题(如：缺陷，新特性，任务，改进等)是项目管理很重要的任务，但是很少有团队能做的很好。JIRA作为一个专业的问题跟踪系统可以帮助您把缺陷管理起来，让跟踪和管理在项目中发现的问题变得简单，而且充分利用JIRA的灵活配置和扩展性，可以将JIRA作为一个项目管理系统或者IT支持系统。
（一）JIRA特性
1. 管理缺陷，新特性，任务，改进或者其他任何问题
2. 人性化使用的用户界面
3. 灵活的工作流定制
4. 全文搜索和强大的过滤器
5. 企业级的权限和安全控制
6. 非常灵活的邮件通知配置
7. 可以创建子任务
8. 方便的扩展及与其他系统集成：包括email、LDAP和源码控制工具等
9. 丰富的插件库
10. 项目类别和组件/模块管理
11. 可以在几乎所有硬件，操作系统和数据库平台运行
（二）JIRA角色
JIRA作为一个缺陷跟踪管理系统，可以被企业管理人员，项目管理人员，开发人员，分析人员，测试人员和其他人员所广泛使用。
1. 管理人员
根据JIRA系统提供的数据，更加准确地了解项目的开发质量和状态，以及整个团队的工作效率
2. 项目管理者
可以针对登记进JIRA系统中问题，进行评估，分配缺陷；还可以通过JIRA系统的统计报告了解项目进展情况以及团队的工作量，工作效率等信息。
3. 开发人员
在JIRA系统中查看分配给自己的问题及时进行处理，填写处理情况并提交工作量记录。
4. 测试人员
根据测试情况，在JIRA系统中及时快速的记录问题并对开发人员处理后的问题进行验证和跟踪。
三、JIRA安装
（一）安装文件
JIRA是一个简单易用的Issue管理和跟踪的工具，运行在JAVA平台上，而且还可以为JIRA配置单独的外包数据库(可以使用的数据库有MySQL、MS SQL、Oracle等)。
通过官网下载JIRA在windows平台下的安装文件（
安装之后要在服务器上通过http://localhost:8080来对服务进行配置(8080是jira的缺省端口)。具体经过以下三个配置步骤：
（二）配置系统属性

（三）配置系统管理员信息

（四）配置系统邮件通知参数

四、JIRA管理使用
（一）用户管理
1、登陆
在成功安装配置完成后的界面上点击“登录到 JIRA”,就会看到 JIRA 的登录界面了：

输入系统管理员的用户名和密码就可以登录 JIRA 系统:

输入系统管理员帐号信息后登录 JIRA 系统，界面如下图：

2、新建用户
输入系统管理员帐号信息后登录 JIRA 系统后，通过“新建用户”来创建新用户：
1）点击新建用户

2）输入用户信息

3）创建成功

创建成功后，可以选择“Edit Groups”为新用户设置相应角色：

也可以通过选择“View Project Roles”，为新用户在单独的项目中设置权限：

3、添加角色组
JIRA 系统的用户是通过 Group 来管理的，通过给组的授权，达到管理用户的目的。

在管理界面上点击左侧的 Users&Groups->“Group Browser”链接，在 Group Browser 界面右侧名称输入框中输入组名，然后点击“Add Group”按钮即可。注意： 不要使用汉字作为组名。

（二）项目管理（Projects）
1、新建项目
点击Projects—> View All Project进入到项目列表

点击Dashboards->新建，创建项目（只有管理组成员才可以创建项目）

点击新建（ADD Project）后输入项目名称(name),关键字(key)，选择开发项目负责人(lead Developer)，填写描述（Description），通知计划（Notification Scheme），许可计划（Permission Scheme:）和问题安全策略（Issue Security Scheme）如图所示：

项目的信息填写完成后，点击“增加”按钮就会看到您在 JIRA 系统中创建的新项目的详细信息界面：

注意：新项目创建完成后，项目的关键字/key（如：上面界面图中项目的 Key：IC）是不能修改的。
如果您想要继续创建新项目，则可以点击左侧的“项目”链接，然后再点击“Add
Project”链接。如下图：

2、添加项目模块
在项目的详细信息界面上，为项目创建组件/模块（Components）,管理项目的版本。如要创建组件，可点击 Component 下方的“Add”链接。界面图如下：

点击“Add”链接后，即可创建该项目下的组件/模块：

填好后，模块列表即可显示出来，如下图：

3、添加项目版本
设置步骤如下：
在 Project 页面下的“ Versions ”部分，点击“ Manage ”Versions，进入管理版本界面， 可以为项目添加版本、版本描述、设置发布日期

填好后，版本情况即可显示出来，如下图：

4、选择项目权限方案
设置步骤如下：
1) 点击“管理”－“项目 ”，点击项目名称链查看项目详细信息界面；
2) 在“ Permission Scheme ”部分，点击“选择”/“编辑”链接，在进入的页面中选择需要的权限设置方案，如下图：

3）选择：

4）编辑：

5、设置项目的 Default Assignee
系统默认是分配给项目负责人，即项目经理。可以根据需要选择默认为模块负责人。
设置步骤如下：
1) 在 Project 页面下的“ Components ”部分，在“ select assignees for components ”处，点击“ Select ”链接，进入“ Select Component Assignee ”界面
2) 选择模块的默认分配人。

6、选择邮件通知方案
设置步骤如下：
1) 选择“管理”－“ Projects ”－“ Projects ”，进入项目详细信息界面 ；
2) 在“ Notification Scheme ”部分，点击“ select scheme ”链接，在进入的页面中选择需要的邮件通知方案。

（三）问题管理
JIRA 跟踪问题（Issue），这些问题可以是 bug，功能请求或者任何其他您想要跟踪的 的任务；每一个问题有一些关联的信息：
问题类型（Issue Type）
摘要（summary）
问题描述（description）
问题所属的项目
问题关联的项目组件（component）
问题影响的项目版本（affect version）
问题将被解决的项目版本（resolved version）
问题发生的环境
问题的优先级
问题的报告者
问题的指派处理人
问题的当前状态
问题相关的历史记录

1、问题类型
JIRA 系统可以用于跟踪多种不同类型的问题。系统管理员可以根据需要添加。JIRA
系统缺省提供的问题类型如下：

Bug
测试过程、维护过程发现影响系统运行的缺陷
New Feature
对系统提出的新功能
Task
需要完成的任务
Improvement
对现有系统功能的改进

2、优先级（Priority Levels）
在 JIRA 系统中用优先级来表示问题的严重级别。系统管理员可以在 JIRA 系统中添加 优先级，JIRA 系统缺省的优先级如下：
级别
参考描述
Blocker
阻塞开发或测试的工作进度，或影响系统无法运行的错误
Critical
系统崩溃，丢失数据或内存溢出等严重错误、或者必需完
成的任务
Major
主要的功能无效、新增功能建议
Minor
功能部分无效或对现有系统的改进
Trivial
拼写错误，文本未对齐等

3、状态（Status）
每个问题有一个状态，用来表明问题所处的阶段，问题通过开始于 open 状态，然后开 始处理/Progress，再到解决/Resolved，然后被关闭/Closed。根据情况的不同，您 可以根据项目来定制问题状态以及工作流。JIRA 系统提供的缺省状态如下：
Open
表示问题被提交等待有人处理。
In Progress
问题在处理当中，尚未完成。
Resolved
问题曾解决，但解决结论未获认可，需要重新分派解决。

Reopened
问题解决，等待结果确认，确认的结果是“Reopened”
或者“Closed”。
Closed
问题处理结果确认后，置于关闭状态。

4、解决（Resolutions）
一个问题可以用多种方式解决，系统管理员是可以在 JIRA 系统中定制解决方式。JIRA
系统默认的解决方式如下：
Fixed
问题已经解决。
Won’t Fix
问题未解决 - 将不会解决的问题。
Duplicate
重复的问题。
Incomplete
问题描述得不够准确完全。
Cannot Reproduce
问题重现失败，或者无足够的信息重现问题。

5、创建问题
创建问题第一个步骤是选择项目和问题类型，然后点击“下一步”填写问题的详细信息。

下图是创建问题的第二步，填写或选择创建的问题详细信息，主要包括：问题的概要描
述、优先级、逾期日期、所属模块、问题影响的版本、问题修复的版本、分配给哪个人员、问题出现的环境描述、问题详细信息描述。填写完成后，点击“创建”按钮。

6、修改问题
问题创建完成后，分配到问题的用户将会收到通知邮件，登录 JIRA 系统后，在分配给 我的问题列表中点击问题链接后，在问题的详细信息界面上就可以进行根据可选工作流程进行操作。
问题详细信息界面图如下，从图中上方的菜单可以看出，在收到问题后可以对这个问题进行一些操作；

编辑— 点击此菜单可以将问题重新编辑；
分配— 此功能可以将问题重新分配给其他人；
备注— 可以给问题加备注说明；
More Action— 点击此菜单有很多功能，详见下图；

开始进行— 如果此问题确定是自己的，点击此按钮，问题状态就转为进行中，此时按钮会转为“停止进行”，再次点击时，问题又回到原来的状态。JIRA系统默认的问题状态见 四（二）3；
问题解决— 点击此按钮，可以选择问题的解决方式。JIRA系统默认的解决方式见四（二）4；
Workflow—当问题解决或确认不是问题时，报告者按此按钮进行关闭问题；

7、查找问题
在查找问题界面上，您可以在界面左侧进行查询条件的设置，JIRA 提供了强大的查询 功能，在您设定好查询条件后，还可以将查询条件保存起来，定义为过滤器，供以后 的重复使用，甚至可以将保存的过滤器共享给团队的其他成员。下图为”查找问题”的界面截图：

五、JIRA的在线帮助功能

Jira提供了详细的在线帮助文档，供使用者学习、参考。

另外，JIRA 有在线演示和中文论坛供使用者学习、参考
JIRA 的在线演示站点 URL：
JIRA 的中文技术论坛 URL：