使用 JIRA 搭建企业问题跟踪系统.docx

使用JIRA搭建企业问题跟踪系统JIRA是澳大利亚Atlassian公司开发的一款不错的商业问题跟踪工具，可以对各种类型的问题进行跟踪管理，包括缺陷、需求变更、评审记录等。笔者在进行缺陷跟踪工具的选型时，曾经试用了JIRA一段时间，个人感觉很不错。笔者结合试用过程中碰到的问题和个人体会，将试用记录进行了整理。本文主要介绍JIRA的个性化定制，介绍如何根据公司实际需求对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地址，即：16（内部邮箱），用户名为内部邮箱用户名（如：），执行下一步5) 完成安装。4系统配置该部分主要以某公司对问题跟踪系统的需求作为案例，介绍如何根据实际需求，在JIRA中进行配置。本案例中涉及到缺陷跟踪和需求变更的跟踪管理两部分。4.1设置问题类型问题来源描述缺陷（Default）系统本身的错误Improvement在系统需求范围内，但是对表现/实现方式进行了改进。RequirementChange对系统原先需求进行了变更，包括新增的需求、变更的需求Issue平常讨论过程中发现的问题记录Review评审中发现的问题记录NoncomplianceReportQA在审核过程中发现的不符合项记录设置问题类型步骤如下：1)“管理”“IssueSettings”“IssueType”，进入“ViewIssueTypes”界面2)进行问题类型的增加、编辑等操作，并点击“Default”设置默认值。4.2设置工作流方案1设置状态在某公司中，状态有Open、Assigned、Accepted、Pending、Closed、Sleeped等。步骤如下：1)选择“管理”“IssueSettings”“Statuses”，进入“ViewStatuses”界面2)进行状态的增加、编辑等操作。2设置工作流根据已定义的缺陷处理流程，在JIRA中新增一个工作流设置（不要在原来的工作流上修改），并设置如下。缺陷：StepName(id)LinkedStatusTransitions(id)ConditionsPostFunctionsOpen(1)Open分配缺陷(2)AssignedAssignee解决nullAssigned(2)Assingned接受本缺陷(4)AcceptedResolveIssuesAccepted(3)Accepted缺陷处理完毕(5)PendingResolveIssuesPending(4)Pending验证通过(701)ClosedTesters解决1（目的是close时，将解决改为Fixed）验证不通过缺陷(3)AssignedTesters解决null确认暂不处理本缺陷(711)SleepedAssignersClosed(6)Closed激活缺陷(3)AssignedTesters解决nullSleeped(7)Sleeped激活缺陷(721)AssignedResolveIssues解决null其中，“接受本缺陷”，选择“Noviewfortransition”，“验证通过”，选择“Noviewfortransition”，“确认暂不处理本缺陷”选择“Addcommentandassign”。需求变更StepName(id)LinkedStatusTransitions(id)ConditionsPostFunctionsOpen(1)Open完成需求变更评估(11)EvaluatedAnalystEvaluated(2)Evaluated审核通过(21)AssignedCCB审核不通过(31)OpenCCBAssigned(3)Assigned接受本需求变更(51)AcceptedResolveIssuesAccepted(4)Accepted需求变更实施完毕(61)PendingResolveIssuesPending(5)Pending验证通过(71)ClosedTesters解决1（目的是close时，将解决改为Fixed）验证不通过(81)ConfirmedResolveIssues解决nullClosed(6)ClosedTesters其中，“完成需求变更评估”、“审核通过”、“接受本需求变更”、“验证通过”，选择“Noviewfortransition”；“审核不通过”、“验证不通过”选择“Addcommentandassign”；“解决本需求变更”选择“Addcomment,assignandsetresolution”。3设置工作流节点的条件、功能点、合法性控制我们需要对不同的事务控制权限，或者是控制执行提交操作时要进行哪些操作，具体设置如上表“Conditions”、“PostFunctions”二列。例如，对于Verified步骤的事务“重新打开缺陷”执行时，要将“解决”的值清空。设置步骤如下：1）选择需要设置条件的事务，如Verified步骤的事务“重新打开缺陷”2）在界面下方的三个Tab页中，选择“PostFunctions”Tab页3）点击“Add”链接4）在进入的“AddPostFunctionToTransition”界面中，选择“UpdateIssueField”选项5）在进入的“AddParametersToFunction”页面中，“IssueField”选择“解决”，“FieldValue”设置为空，点击Add按钮这样，当缺陷从Verified状态被重新打开时，“解决”域的值就会被清空。这条缺陷，就可以出现在责任人首页的“分配给我”的清单中。4设置工作流配置文件步骤如下：1）选择“管理”“Schemes”“WorkflowSchemes”，进入“WorkflowSchemes”界面2）增加一个Workflow方案3）选择问题类型（如缺陷、Improvement），为该workflow方案分配已定义的Workflow。同理，为其他几种问题类型，都设置一个workflow，方便以后流程的升级。否则以后如果需要改流程，则需要将工作流配置文件先取消关联，然后才能修改该方案对应的工作流。这可能导致verified状态对应的缺陷被改变状态。如下图所示：问题类型问题类型选择的工作流DefectDefectTrackImprovementDefectTrackIssueIssueTrackRequirementChangeRequirementChangeTrackNoncomplianceReportNoncomplianceReportTrackReviewReviewTrack4.3问题属性1严重性严重性说明Blocker灾难导致系统失效，例如蓝屏或数据发生冲突Critical重要产品不可用，例如导致错误的答案和错误的报告Major(default)中等产品可用，客户说到影响Minor轻微产品可用，没有客户受到影响Trivial无足轻重如果时间允许则修复设置步骤如下：1）选择“管理”“IssueField”“CustomFields”，进入“ViewCustomFields”界面2）点击“AddCustomField”链接，进入“CreateCustomField”界面3）选择“SelectList”类型，选择“Globalallissues”选项，点击NEXT按钮4）在“FieldName”域输入“严重性”，在“ChooseSearchTemplate”项选择“SelectListSearcher”，点击Create按钮5）在“EditCustomFieldOptions”页面，增加下拉框选项（如上表所属内容)，完成后，点击Done按钮6）在“ViewCustomFields”界面，“严重性”行，点击“EditDefaults”链接，在弹出的页面中，选择该下拉框的默认值2优先级优先级分P1P5五个级别，其中，P1优先级最高，P5最低。优先级说明P1系统的正常业务流程无法通过，必须马上修改P2系统用户无法正确使用系统；导致用户对系统理解发生偏差；影响客户或公司的形象P3(default)系统用户无法使用部分非重要功能P4不影响系统的正常使用，发布后可以通过打补丁的方式解决问题P5问题对系统影响很小，可以不修改设置步骤如下：1）选择“管理”“IssueSetting”“Priorities”，进入“ViewPriorities”界面2）对选项值进行编辑，并点击“Default”设置默认值。3缺陷类别内容说明程序错误1.由于程序所引起的死机，非法退出2.由于程序未做错误控制而引发的缺陷，如直接进入HTTP404/500界面3.因错误操作导致的程序中断或退出4.程序接口错误功能实现偏差(default)1.功能未达到详细设计说明书中标明的功能2.功能超出了详细设计说明书指明的范围3.功能未达到详细设计说明书虽未指出但应达到的目标界面不友好1.功能可用，但是操作界面不友好、难于理解、不易使用、或者最终用户认为界面不好2.提示信息内容不友好、不准确3.界面不规范4.提示窗口文字未采用行业术语数据错误1.数据被损坏或未传送到目的地2.数据通讯错误文档缺陷1.文档所用的术语不适用于用户2.文档不完整3.文档未清楚的表达所描述的内容或内容不正确设置步骤如下：1）选择“管理”“IssueField”“CustomFields”，进入“ViewCustomFields”界面2）点击“AddCustomField”链接，进入“CreateCustomField”界面3）选择“SelectList”类型，Scope选择“IssueType-issuesofaspecifiedtype”选项，点击NEXT按钮4）在“FieldName”域输入“Bug类别”，在“ChooseSearchTemplate”项选择“SelectListSearcher”，点击Create按钮5）在“EditCustomFieldOptions”页面，增加下拉框选项（如上表所属内容)，完成后，点击Done按钮6）在“ViewCustomFields”界面，“Bug类别”行，点击“EditDefaults”链接，在弹出的页面中，选择该下拉框的默认值注意：该属性Scope只能选择“IssueType-issuesofaspecifiedtype”项。4解决方案解决方案描述Fixed(default)缺陷已正确解决，并经过验证Later该问题确实是个缺陷，但是本版本不解决Invalid问题的描述不是个缺陷WontFix该问题确实是个缺陷，但是不打算解决Duplicate问题的描述是一个已经存在的缺陷CannotReproduce按照描述的步骤，不能重现该问题设置步骤如下：1）选择“管理”“IssueSetting”“Resolutions”，进入“ViewResolutions”界面2）对选项值进行编辑，并点击“Default”设置默认值。5平台包括：DEC、HP、Macintosh、PC、SGI、Sun、Other。设置PC为默认值。设置步骤同上。6操作系统包括：Windows95、Windows98、WindowsMe、Windows2000、WindowsNT、WindowsXP、WindowsServer2003、MacSystem7.5、MacSystem7.6.1、MacSystem8.0、MacSystem8.5、MacSystem8.6、MacSystem9.x、MacOSX10.0、MacOSX10.1、MacOSX10.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申请人设置为：UserPicker10申请时间设置为：DatePicker11原始需求内容设置为：FreeTextField12业务分析结论包括：不采纳该需求变更、接受本需求变更、未达成一致意见，继续进行业务评估。13变更发生的业务背景设置为：FreeTextField14要求实现的功能设置为：FreeTextField15技术分析结论包括：无法实现、可以实现、未达成一致意见，继续进行技术分析16管理分析结论包括：允许实施、不允许实施、未达成一致意见，继续进行管理分析4.4用户组和权限控制用户组描述权限Administrators管理JIRA中的项目、人员、删除缺陷、管理关注者列表AdministerProjectsModifyReporterDeleteIssuesManageWatcherListAssigners修改缺陷、分配缺陷EditIssuesScheduleIssuesAssignIssuesDevelopers处理缺陷、填写缺陷原估算工作量、填写缺陷实际处理工作量、管理关注者列表AssignableUserResolveIssuesWorkOnIssuesViewVersionControlViewVotersandWatchersManageWatcherListTesters修改缺陷、移动缺陷、处理缺陷、管理关注者列表EditIssuesMoveIssuesResolveIssues（含ReopenIssues）CloseIssuesViewVersionControlViewVotersandWatchersManageWatcherListCCB变更控制委员会，进行需求变更的审核动作EditIssuesManageWatcherListAnalyst业务分析，进行需求变更的处理EditissueAssignableUserScheduleIssuescloseissueManageWatcherListjira-users浏览项目（含缺陷）、登记缺陷BrowseProjectsCreateIssuesAddCommentsCreateAttachmentsAnyone浏览项目（含缺陷）BrowseProjects1设置用户组设置步骤如下：1）选择“管理”“Users&Groups”“GroupBrowser”，进入“GroupBrowser”界面2）新增用户组：Administrators、Assigners、Developers、Testers2设置权限方案设置步骤如下：1）选择“管理”“Schemes”“PermissionSchemes”，进入“PermissionSchemes”界面2）新增一个权限方案（不要在默认权限方案上进行修改）3）在复制的权限方案上，点击“Permission”链接，进入“EditPermissions”界面4）根据上表的权限分配，进行增、删、改。注：只有Assigner角色可以分配缺陷。4.5设置邮件通知方案活动通知人员登记缺陷当前缺陷分配人该缺陷的所有关注者Bug更新/分配/解决/关闭/增加备注/重新打开/删除/移动当前缺陷分配人缺陷登记人该缺陷的所有关注者设置步骤如下：1）选择“管理”“Schemes”“NotificationSchemes”，进入“NotificationSchemes”界面2）复制DefaultNotificationScheme，并修改为合适的名称（不要在默认权限方案上进行修改）3）按照上述的说明，进行设置。4.6设置界面设计方案1开启时间跟踪功能设置步骤如下：1）选择“管理”“GlobalSettings”“TimeTracking”，进入“TimeTrackingSetting”界面2）将“HoursPerDay”设置为8，“DaysPerWeek”设置为5。3）点击Activate键，完成开启时间跟踪功能。2开启附件功能设置步骤如下：1）选择“GlobalSettings”“Attachments”，点击“EditConfiguration”链接，进入“AttachmentsSettings”界面，将“AllowAttachments”选项选择“On”，在“AttachmentPath”输入框输入附件的保存路径，如f:JiraTempAttachment2）选择“IssueFields”“FieldLayout(System)”，进入“ViewIssueFields”界面，选择“附件”项，点击“Show”链接3设置界面设计方案设置步骤如下：1）选择“管理”“IssueFields”“FieldLayoutSchemes”，进入“ViewSchemeIssueFields”界面2）执行Edit、Hide、Required等操作。按照下述的说明，进行设置。缺陷：顺序域是否必填项1概要是2问题类型是3严重性4优先级5模块6缺陷类别7影响版本8修复版本9描述10平台11操作系统12附件13分配给是14预期日期15时间跟踪估算一个问题解决的时间期限.格式是*w*d*h*m(表示星期,天,小时,分钟-*表示可以是任意数字)例如:4d,5h30m,60mand3w.16报告人是需求变更：顺序域是否必填项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,5h30m,60mand3w.21分配给是22预期日期23报告人是4.7界面1配置整体属性设置界面的默认语言、Title等信息。设置步骤如下：1）选择“管理”“GlobalSettings”“GeneralConfiguration”，进入“Settings”界面2）点击“EditConfiguration”链接，在进入的界面按下述设置执行修改。内容设置TitleWelcometoXXIssueTrackingSystemBaseURLhttp:/localhost:8080/jiraModeprivateCharacterEncodingUTF-8IndexingLanguageEnglishDefaultLanguage中文(中国)AllowunassignedissuesOFF2配置外部界面属性设置公司logo（将logo文件存放在服务器images目录下）、默认语言、Title。设置步骤如下：1）选择“管理”“GlobalSettings”“LookandFeel”，进入“Logo”界面2）点击“EditConfiguration”链接，在进入的界面按下述设置执行修改。内容设置URLhttp:/localhost:8080/jira/images/aboutus_1.gifLogoWidth170LogoHeight78TopBarColour#ffffffTopTextColour#0000004.8其他1修改timeout设置修改atlassian-jira/WEB-INF/web.xml60将60（分钟）修改需要的时间。2设置自动备份设置每天进行一次备份。设置步骤如下：1）选择“管理”“System”“Services”，进入“Services”界面2）在“AddService”部分，输入如下信息内容设置NameBackupServiceClasscom.atlassian.jira.service.services.export.ExportServiceDelay1440（即，24小时）3）点击AddService键，进入“EditService：BackupService”界面，输入如下信息，点击更新键，即完成服务设置内容设置Directorynamef:JiraTempbackupDateformatYYYY-MM-DD-HHmmBackupasZipDelay14405项目设置下面根据某公司实际项目的设置需求，对试点项目进行实际设置。项目设置主要从以下方面进行设置1创建项目输入项目名称、项目缩写、项目经理，选择邮件通知方案、权限设置方案2创建模块创建模块，并设置模块负责人3选择权限方案设置步骤如下：1)选择“管理”“Projects”“Projects”，进入“Project：项目名”界面2)在“PermissionScheme”部分，点击“selectscheme”链接，在进入的页面中选择需要的权限设置方案。4选择界面设计方案设置步骤如下：1)选择“管理”“Projects”“Projects”，进入“Project：项目名”界面2)在“FieldLayoutSchemes”部分，点击“manage”链接，进入“ManageFieldLayoutSchemeAssociations”界面3)点击“Bug”这一行的“AddAssociation”链接，选择合适的界面设计方案。对其他类型的问题进行类似操作5选择工作流设置方案设置步骤如下：1)选择“管理”“Projects”“Projects”，进入“Project：项目名”界面2)在“WorkflowScheme”部分，点击“selectscheme”链接，在进入的页面中选择需要的工作流设置方案。6创建用户，并分配用户组系统的权限分配如下： 项目经理：AssignerDevelopersjira-users 模块负责人（缺陷分配人员）：AssignerDevelopersjira-users 开发人员：Developersjira-users 测试人员：Testersjira-users 项目组其他人员（如SCM）：jira-users 项目外其他人员：Anyone7设置项目的DefaultAssignee系统默认是分配给项目负责人，即项目经理。可以根据需要选择默认为模块负责人。设置步骤如下：1)在Project页面下的“Components”部分，在“selectassigneesforcomponents”处，点击“Select”链接，进入“SelectComponentAssignee”界面2)选择模块的默认分配人。8创建版本9选择邮件通知方案设置步骤如下：1)选择“管理”“Projects”“Projects”，进入“Project：项目名”界面2)在“