JIRA使用手册范本

JIRA 是澳大利亚 Atlassian 公司开发的一款不错的商业问题跟踪工具，可以对各种类型的问题进行跟踪管理，包括缺陷、需求变更、评审记录等。

笔者在进行缺陷跟踪工具的选型时，曾经试用了 JIRA 一段时间，个人感觉很不错。

笔者结合试用过程中碰到的问题和个人体会，将试用记录进行了整理。

本文主要介绍 JIRA 的个性化定制，介绍如何根据公司实际需求对JIRA 进行定制，适用于管理员。

至于说 JIRA 的基本使用方法，和普通的缺陷跟踪工具类似，本文不做重点介绍。

您可在 JIRA 官方.atlassian./jira 上了解到 JIRA 更为详细的信息。

1背景在试用 JIRA 前，公司使用 Bugzilla 作为缺陷跟踪工具。

在使用初期，Bugzilla 确实发挥了一定的作用，但随着公司强化项目管理的需要， Bugzilla 开始不够用了。

项目组使用 Bugzilla 时，存在几个问题：项目组需要对不同类型的问题进行记录，如任务分配、评审所发现的问题、需求变更记录，缺陷等。

虽然可以在 Bugzilla 中也可以将这些各种类型的问题当作缺陷记录，但是这会混淆缺陷跟踪流程，因为这些不同类型的问题的处理流程是不一样的，但是 Bugzilla 中无法在系统中定制多个问题跟踪流程。

项目管理者无法记录缺陷的预期修复完成时间项目管理者不能批量分配、编辑缺陷无法记录开发人员处理缺陷所花的工作量，并且所花工作量缺少对比。

开发人员无法快速、直观的清楚分配给自己的缺陷，对于正在进行处理的缺陷也没有很直观的表现。

测试人员不知道缺陷修复预期对应的版本，导致缺陷回归时围不清晰。

不方便升级，升级成本大。

其它细节问题，如界面不友好，用户无法上传附件等。

2介绍跟踪并管理在项目过程中呈现出来的问题（如缺陷、新特性、需求变更、QA 审计问题等）是项目管理很重要的任务，但是很少有团队能做的很好。

JIRA 虽然是一个问题跟踪系统，但是只要稍加改造，便可以成为一个项目管理软件。

是一个问题跟踪和项目管理应用系统，目的是为了让跟踪和管理在项目过程中呈现出来的问题变得简单。

JIRA 具有以下特性：管理缺陷，新特性、任务、改进或者其他任何问题干净和强大的用户界面方便商业或技术用户理解工作流定制全文搜索和强大的过滤器（可定制的，可保存的，可共享的，可预定的过滤器）可定制的工作台和实时统计企业级的权限和安全控制方便的扩展及与其他系统集成（包括 email 、 RSS 、Excel 、 XML 和源码控制工具）非常高的通知选项配置可以在几乎所有硬件、操作系统和数据库平台下运行 JIRA 可以根据你的需要提供所需要的信息。

下面以缺陷为例，介绍各个角色成员在 Jira 中可以获得的信息和可以做的事情。

管理人员——根据缺陷数据统计结果，了解项目状态查看项目整体问题分布情况查看项目整体问题工作量与进度情况查看某一开发人员在不同项目的开发工作量情况查看项目某个版本的工作量情况及每个用户的缺陷及剩余工作量情况项目管理者——评估缺陷和分配缺陷查看分配给我的问题看某个问题的详细信息分配问题填写问题的预期修复时间及修复估算工作量开发人员——处理缺陷，提交工作量记录接受问题，准备开始处理问题问题处理后，准备在系统上填写处理情况填写处理情况完成处理信息的填写后，准备填写处理问题所花的工作量填写处理问题所花的工作量测试人员——快速的提交缺陷，跟踪缺陷提交问题填写问题详细信息根据不同过滤条件查看不同的问题，准备进行问题的跟踪处理根据不同过滤条件列出的查询结果验证问题处理情况，根据不同工作流节点选择不同的操作3安装相比 Bugzilla ， JIRA 有个很突出的优点：不用花数小时或数天来搭建你的问题跟踪系统， JIRA 可以在小于 30 秒搭建并运行在你的系统上。

下面，笔者向您介绍 JIRA 的安装步骤。

1．执行 /bin 目录下的 startup.bat 文件，进入安装2．选择一个索引目录，并输入 licence ，执行下一步3．输入创建的管理员信息，执行下一步4．在设置服务器页面，其他信息都很容易故不多说。

强调的是，在 SMTP 服务器输入框，要输入 IP 地址，即： 192.168.168.116 （部），用户名为部用户名（如： xfshen@xx. ），执行下一步5．完成安装。

4系统配置该部分主要以某公司对问题跟踪系统的需求作为案例，介绍如何根据实际需求，在 JIRA 中进行配置。

本案例中涉及到缺陷跟踪和需求变更的跟踪管理两部分。

问题来源描述缺陷（ Default ）系统本身的错误Improvement 在系统需求围，但是对表现 / 实现方式进行了改进。

Requirement Change 对系统原先需求进行了变更，包括新增的需求、变更的需求Issue 平常讨论过程中发现的问题记录Review 评审中发现的问题记录NoncomplianceReportQA 在审核过程中发现的不符合项记录1) “管理”－“ Issue Settings ”－“ Issue Type ”，进入“ ViewIssue Types ”界面2) 进行问题类型的增加、编辑等操作，并点击“ Default ”设置默认值。

4.2设置工作流方案1．设置状态在某公司中，状态有Open、Assigned、Accepted、Pending、Closed、Sleeped等。

步骤如下：1)选择“管理”－“ Issue Settings ”－“ Statuses ”，进入“ View Statuses ”界面2)进行状态的增加、编辑等操作。

2．设置工作流根据已定义的缺陷处理流程，在 JIRA 中新增一个工作流设置（不要在原来的工作流上修改），并设置如下。

Step Name(id) LinkedStatusTransitions (id) ConditionsPostFunctionsOpen (1) Open 分配缺陷 (2)>>AssignedAssignee 解决＝ nullAssigned (2) Assingned 接受本缺陷 (4)>> AcceptedResolveIssuesAccepted (3) Accepted 缺陷处理完毕 (5)>> PendingResolveIssuesPending (4) Pending 验证通过 (701)>> Closed Testers 解决＝ 1（目的是close 时，将解决改为Fixed ）验证不通过缺陷(3)>> AssignedTesters 解决＝ null确认暂不处理本缺陷 (711)>> SleepedAssignersClosed (6) Closed 激活缺陷 (3)>> AssignedTesters 解决＝ nullSleeped (7) Sleeped 激活缺陷 (721)>> Assigned ResolveIssues解决＝ null通过”，选择“ No view for transition ”，“确认暂不处理本缺陷”选择“ Add comment and assign ”。

Step Name(id) LinkedStatusTransitions (id) ConditionsPostFunctionsOpen (1) Open 完成需求变更评估 (11)>> EvaluatedAnalyst Evaluated Evaluated 审核通过 (21) CCB审核通过”接受本需求变更”“验证通过”，选择“ 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 状态对应的缺陷被改变状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．优先级1）选择“管理”－“ Issue Setting ”－“ Priorities ”，进入“ View Priorities ”界面2）对选项值进行编辑，并点击“ Default ”设置默认值。