JIRA7.3.3产品使用指南.doc

目录第一章JIRA简介21.1 什么是JIRA21.2 JIRA的主要功能21.3JIRA的主要特点31.3.1JIRA的优点31.3.2 JIRA的缺点31.4相关版本3第二章JIRA的安装和配置32.1安装准备42.2安装流程42.2.1jdk的安装和配置42.2.2MySQL的安装52.2.3JIRA的安装和配置62.3浏览器要求142.4操作系统要求152.5JIRA支持的服务152.6JIRA支持的数据库15第三章JIRA的基本概念153.1 JIRA 中涉及的角色153.1.1 管理人员153.1.2 项目管理者163.1.3 开发人员163.1.4 测试人员163.2 问题163.2.1问题类型163.2.2优先级（Priority Levels）173.2.3状态（Status）173.2.4解决（Resolutions）173.3项目173.3.1项目版本183.3.2项目组件183.4分配给183.5上传附件或屏幕截图183.6问题投票183.7件事问题18第四章 JIRA的使用184.1登录和注册194.2创建新项目204.3创建项目类别224.4添加新用户234.5添加组234.6创建问题244.7 浏览项目264.8查找问题27第五章 项目设置285.1添加项目285.2添加项目模块295.3添加项目版本295.4选择项目权限方案305.5设置项目的Default Assignee315.6选择邮件通知方案32第六章 JIRA系统的权限336.1全局权限336.2 系统缺省权限模型34第七章 附录和备注357.1技术支持367.2备注36 第一章JIRA简介1.1 什么是JIRA JIRA 是目前比较流行的基于Java架构的管理系统，由于Atlassian公司对很多开源项目实行免费提供缺陷跟踪服务，因此在开源领域，其认知度比其他的产品要高得多，而且易用性也好一些。同时，开源则是其另一特色，在用户购买其软件的同时，也就将源代码也购置进来，方便做二次开发。JIRA功能全面，界面友好，安装简单，配置灵活，权限管理以及可扩展性方面都十分出色。1.2 JIRA的主要功能 问题追踪和管理：用它管理项目，跟踪任务、bug、需求，通过jira的邮件通知功能进行协作通知，在实际工作中使工作效率提高很多 问题跟进情况的分析报告：可以随时了解问题和项目的进展情况 项目类别管理功能：可以将相关的项目分组管理 组件/模块负责人功能：可以将项目的不同组件/模块指派相应的负责人，来处理所负责的组件的Issues 项目email地址功能：每个项目可以有不同的email（该项目的通知邮件从该地址发出） 无限制的工作流：可以创建多个工作流为不同的项目使用1.3JIRA的主要特点1.3.1JIRA的优点用它管理项目，跟踪任务、bug，通过JIRA的邮件通知功能进行协作通知，在实际工作中使工作效率提高很多，效果非常不错！安全性、可扩展性方面发挥到了极致！JIRA不仅仅是一个缺陷跟踪系统，通过Jira，可以整合客户、开发人员、测试人员，各人各司其职，信息很快得到交流和反馈，让大家感到软件开发在顺利快速的进行，朝意想的目标迈进。eclipse和IDEA下的Jira插件，主要为开发人员服务，实时将信息反馈给开发人员，开发人员同时迅速地将修复的结果信息反馈到跟踪系统中，最后通过持续集成，软件迅速地完成了更新，这些方便便捷的操作会极大地鼓舞软件开发中的各方人员，甚至包括客户，及时响应，相信是每一个客户都会欣赏的。跟同类软件产品TestTracker、ClearQuest、TestDirector相比，JIRA的性价比最好！1.3.2 JIRA的缺点对于测试需求、测试用例等都没有提供直接的方式进行管理。不过可以利用JIRA的Issue Type的可定制性,来进行需求和测试用例方面的管理,也可以与Testlink集成。1.4相关版本JIRA 4.0版本之后，不再按照功能区分版本。取消了以前的标准版，专业版，企业版之分；取而代之的是按照用户数量来划分：25、50、100、无限制用户。 所有的版本都具有之前企业版的功能！JIRA不限制创建项目数和Issue的数量，购买之后可以永久使用；并且一年内免费更新版本。 第二章JIRA的基本概念2.1 JIRA 中涉及的角色JIRA 作为一个缺陷跟踪管理系统，可以被企业管理人员，项目管理人员，开发人员，分析人员，测试人员和其他人员所广泛使用。2.1.1 管理人员根据 JIRA 系统提供的数据，更加准确地了解项目的开发质量和状态，以及整个团队的工作效率。2.1.2 项目管理者可以针对登记进 JIRA 系统中问题，进行评估，分配缺陷；还可以通过 JIRA 系统的统计报告了解项目进展情况以及团队的工作量、工作效率等信息。2.1.3 开发人员在 JIRA 系统中查看分配给自己的问题，及时进行处理，填写处理情况并提交工作量记录。2.1.4 测试人员根据测试情况，在 JIRA 系统中及时快速的记录问题并对开发人员处理后的问题进行验证和跟踪。2.2 问题一个问题可以是软件的缺陷，一个项目的具体任务，一个需要解决的技术难题或者是需要审批的报销单据等。 JIRA 跟踪问题（Issue），这些问题可以是 bug，功能请求或者任何其他想要跟踪的的任务；每一个问题有一些关联的信息： 问题类型（Issue Type） 摘要（summary） 问题描述（description） 问题所属的项目 问题关联的项目组件（component） 问题影响的项目版本（affect version） 问题将被解决的项目版本（resolved version） 问题发生的环境 问题的优先级 问题的报告者 问题的指派处理人 问题的当前状态 问题相关的历史记录2.2.1问题类型JIRA 系统可以用于跟踪多种不同类型的问题。系统管理员可以根据需要添加。JIRA系统缺省提供的问题类型如下： Bug 缺陷：测试过程、维护过程发现影响系统运行的缺陷 New Feature新需求 ：对系统提出的新功能 Task任务 ：需要完成的任务 Improvement改进意见 ：对现有系统功能的改进2.2.2优先级（Priority Levels）在 JIRA 系统中用优先级来表示问题的严重级别。系统管理员可以在 JIRA 系统中添加优先级，JIRA 系统缺省的优先级为紧急，严重，一般，次要，无关紧要5个级别：级别参考描述Blocker 阻塞开发或测试的工作进度，或影响系统无法运行的错误Critical 系统崩溃，丢失数据或内存溢出等严重错误、或者必需完成的任务Major 主要的功能无效、新增功能建议Minor 功能部分无效或对现有系统的改进Trivial拼写错误，文本未对齐等2.2.3状态（Status）每个问题有一个状态，用来表明问题所处的阶段，问题通过开始于 open 状态，然后开始处理/Progress，再到解决/Resolved，然后被关闭/Closed。根据情况的不同，您可以根据项目来定制问题状态以及工作流。JIRA 系统提供的缺省状态如下： Open ：表示问题被提交等待有人处理。 In Progress ：问题在处理当中，尚未完成。 Resolved ：问题曾解决，但解决结论未获认可，需要重新分派解决。 Reopened ：问题解决，等待结果确认，确认的结果是“Reopened”或者“Closed”。 Closed ：问题处理结果确认后，置于关闭状态。2.2.4解决（Resolutions） 一个问题可以用多种方式解决，系统管理员是可以在 JIRA 系统中定制解决方式。JIRA系统默认的解决方式如下： Fixed ：问题已经解决。 Wont Fix ：问题未解决 - 将不会解决的问题。 Duplicate ：重复的问题。 Incomplete ：问题描述得不够准确、完全。 Cannot Reproduce ：问题重现失败，或者无足够的信息重现问题。2.3项目JIRA的项目是根据你的企业组织需要定制的，是问题的集合。 例如,一个JIRA项目可以是:一个软件研发项目一项市场推广活动一个技术服务/帮助台系统一个需求管理系统一个网站需求调查系统每一个问题属于一个项目。每一个项目有一个名字和一个关键字（如：WEB），以后属于这个项目的问题的关键字就会包含 WEB（如：WEB-100，WEB-101）。值得注意的是，在 JIRA 系统中有一个权限Administer Projects，通常将这个权限赋给项目负责人，拥有这个权限的 JIRA 用户就可以管理项目的版本和组件。2.3.1项目版本在一个项目上，一般会有多个版本，如：1.0alpha、1.0beta、1.0、1.2、2.0。JIRA 系统中的问题涉及到两个版本字段：影响版本 可以清晰地反映出这个问题在哪个版本中出现错误。例如, 一个软件的缺陷可能影响了产品的1.1和1.2版。修复版本 可以反映出报告的问题将在哪个版本，或已经在哪个版本中修复了。例如, 软件缺陷影响了产品的1.1和1.2版，这个缺陷已经在2.0版中修复了。注意没有修复版本的问题会被归类到未规划。版本可以有3个状态: 已发布,未发布或已归档。版本可以设置发布日期,而JIRA会自动将到期而还没有发布的版本高亮显示出来，并标注上超期标志。2.3.2项目模块一个项目模块是这个项目中问题的逻辑分类集合。每个项目都可以根据你企业组织的要求设置多个模块 (也可以不设置模块)。例如, 一个软件研发项目可以设置文档,邮件系统,用户界面等模块。一个网页设计项目可以设置产品,联系我们,专业服务等模块:项目中的问题可以隶属于一个或多个模块，当然也可以不属于任何模块。第三章 JIRA的使用3.1登录和注册在成功安装配置完成后，浏览器输入地址：http:/10.0.7.105:9000/secure/Dashboard.jspa打开 JIRA 的登录界面：输入系统管理员的用户名和密码就可以登录 JIRA 系统。输入系统管理员帐号信息后登录 JIRA 系统，界面如下图：3.2创建新项目 在刚刚配置完的 JIRA 系统中是没有任何项目的，通常开始使用 JIRA 首先是创建项目，在项目的界面上点击“创建项目”，选择项目类型这里选择scrum软件开发，使用此项目对敏捷开发工作进行管理，能够完成新建后备任务、在冲刺阶段中组织工作、用多种报告检测进度等功能，此项目包含了一个Scrum板、一个基本敏捷工作流任务类型的配置，这些配置都能够再进行修改。点击下一步，弹出说明界面：点击选择，弹出项目信息输入界面：输入项目名称、关键字、项目负责人等信息，点击提交，进入新建项目backlog界面：3.2.1创建项目模块可以在项目的详细信息界面上，为项目创建组件/模块（Components）,管理项目的版本。如要创建组件，可点击模块菜单，输入模块信息及经办人点击添加：如要管理项目的版本（Versions），可点击创建版本链接：注意：新项目创建完成后，项目的关键字/key（如：上面界面图中项目的 Key：WH）是不能修改的。如果要继续创建新项目，则可以点击菜单栏的“项目”下拉菜单，然后再点击“创建项目”菜单。如下图：3.2.2创建项目迭代 在使用JIRA过程中，会有越来越多的任务被添加到项目中，这时候可以利用Sprint来管理项目任务。在项目详细信息界面上可以点击“创建Sprint”按钮，创建Sprint。3.2.3创建项目类型在使用JIRA过程中，会有越来越多的项目被添加到JIRA系统中，这时候可以利用JIRA系统的项目类别功能（Project Categories），定义一些项目类别名称，然后将同类的项目归到一个类别里面，方便管理。在项目详细信息界面上可以找到项目类型按钮，点击项目类型，输入类别名称和描述，这样就把项目添加到项目类别里了。3.2.5选择通知方案设置步骤如下：1) 点击“管理”“项目”，点击项目名称链查看项目详细信息界面；2) 点击通知方案菜单，在进入的页面中选择添加通知方案。3.2.6选择项目权限方案设置步骤如下：1) 点击“管理”“项目 ”，点击项目名称链查看项目详细信息界面；2) 点击权限菜单，在进入的页面中选择编辑权限。 3.2.6添加工作流工作流是按照一定的规则和过程执行一个任务，在JIRA中体现在问题在生命周期内不同状态之间的变化。每个状态以矩形框表示。每个工作流跳转由箭头指引方向。设置步骤如下：1) 点击“管理”“项目 ”，点击项目名称链查看项目详细信息界面；2) 点击工作流菜单，在进入的页面中选择添加工作流或者选择现有的流程进行编辑。3）选择流程点击编辑按钮对流程进行编辑：点击添加状态添加一个流程节点；点击添加转换添加一条连线，可以设置开始状态和目标状态：通过连线条件设置流程处理人权限，处理状态等：3.4添加新用户 在安装完 JIRA 系统后，系统中只有一个系统管理员帐号；在创建完项目后，通常需要在 JIRA 系统中添加其他的用户帐号，在管理界面上点击左侧的 用户管理菜单，在用户界面上再点击创建用户就可以添加新用户了。注意：不要使用汉字作为用户名。如下图：3.5添加组JIRA 系统的用户是通过 Group 来管理的，通过给组的授权，达到管理用户的目的。添加组的步骤：在管理界面上点击左侧的用户管理-组菜单，打开组界面，输入组名点击添加组按钮。3.6创建问题创建问题第一个步骤是选择项目，然后点击“打开创建对话框”填写问题的详细信息。 下图是创建问题的第二步，填写或选择创建的问题详细信息，主要包括：项目、问题的概要描述、优先级、问题详细信息描述。问题创建完成后，可以对问题进行分配，即指定给某个团队成员去处理：分配到问题的用户登录 JIRA 系统后，在分配给我的问题列表中点击问题链接后，在问题的详细信息界面上就可以进行根据可选工作流程进行操作。问题详细信息界面图如下，从图中可以看出这个目前对这个问题可以进行的操作有三个：开始进行、解决问题和关闭问题。 问题创建后，您除了可安装可选工作流程对问题进行处理外，还可以给问题上传附件，填写备注，复制和编辑问题，如果有权限的话，还可以删除问题，创建子任务等。第四章 JIRA系统的权限JIRA 系统中的权限管理分为：系统级别、项目级别、问题级别以及注释级别。系统级是通过”全局权限（Global Permissions）”来管理的，影响 JIRA 系统中所有的项目和问题。针对个别项目来说，您还可以通过 JIRA 系统中的权限模型（Permission Scheme）进一步配置项目级别的权限。下面将分别介绍全局权限和基于项目的权限模型。4.1全局权限设置步骤：1) 以 JIRA 系统管理员登录系统；2) 点击系统-全局权限。界面如下图： 4.2 项目权限打开项目，点击项目权限，项目权限如下图所示：第五章 JIRA常用术语术语术语翻译及说明SCRUMSCRUM 是一个用于开发和维持复杂产品的框架Scrum 是一个用于开发和维持复杂产品的框架 ，是一个增量的、迭代的开发过程。Agile敏捷Sprint原意为冲刺，Scrum中的Sprint无对应中文翻译，指一个迭代一个短的迭代周期称为一个Sprint，每个Sprint的建议长度是2到4周在Sprint中，Scrum团队从产品Backlog中挑选最高优先级的需求进行开发。Backlog待办列表Sprint BacklogSprint待办列表，指Sprint任务清单。挑选的需求在Sprint计划会议上经过讨论、分析和估算得到相应的任务列表，称它为Sprint backlogProduct Backlog产品待办列表，指需求清单在Scrum中，使用产品Backlog来管理产品的需求，产品backlog是一个按照商业价值排序的需求列表，列表条目的体现形式通常为用户故事。Scrum团队总是先开发对客户具有较高价值的需求User Story 用户故事，指一条需求