jira项目管理系统使用指南.docx
《jira项目管理系统使用指南.docx》由会员分享，可在线阅读，更多相关《jira项目管理系统使用指南.docx（73页珍藏版）》请在冰豆网上搜索。
jira项目管理系统使用指南
JIRA工程管理系统
使用指南
文件编号
文件状态
[]草稿[]正式发布[√]正在修改
当前版本
V1.0
拟制
日期
审核
日期
批准
日期
XX市银骏科技XX
修订历史记录
A-增加M-修订D-删除
变更版本号
日期
变更类型〔A*M*D〕
修改人
摘要
备注
V1.0
1JIRA工程管理系统简介
JIRA工程管理系统是工程跟踪及管理的平台。
JIRA是澳大利亚Atlassian公司开发的一款优秀的问题跟踪及管理软件工具，可以对各种类型的问题进展跟踪管理，包括缺陷、任务、需求、改良等。
并能与testlink、SVN等工具进展整合，方便工程的管理。
JIRA采用J2EE技术，能够跨平台部署。
它正被广泛的开源软件组织，以及全球著名的软件公司使用。
本手册为工程管理者，开发人员（技术支持人员）、测试员以及其他使用JIRA的用户而编写。
如果你第一次接触JIRA，你可以从了解JIRA问题，工程，工作流等根本概念开场。
当你在JIRA中创立了一些问题，就可以搜索，浏览，输出这些问题，并为这些问题生成一些统计报告。
1.1系统涉及的角色
JIRA作为一个工程跟踪及管理系统，可以被企业管理人员，工程管理人员，开发人员，分析人员，测试人员和其他人员所广泛使用。
1.1.1企业管理人员
根据JIRA系统提供的数据，更加准确地了解工程的开发质量和状态，以及整个团队的工作效率。
1.1.2工程管理者
可以针对登记进JIRA系统中问题，进展评估；还可以通过JIRA系统的统计报告了解工程进展情况以及团队的工作量、工作效率等信息。
1.1.3开发人员
在JIRA系统中查看分配给自己的问题，及时进展处理，填写处理情况并提交工作量记录。
1.1.4测试人员
根据测试情况，在JIRA系统中及时快速的记录问题并对开发人员处理后的问题进展验证和跟踪。
1.1.5其他人员
在JIRA中查看工程进展情况，根据公司的规定在系统中提交和处理相关问题。
2JIRA的根本概念
本手册将主要说明JIRA中三个重要的概念：
问题、工程、工作流。
2.1什么是问题
不同的组织使用JIRA追踪不同类型的问题。
通常根据企业的具体需求来决定如何使用JIRA。
问题可以是软件的缺陷，一个工程的具体任务，一个需要解决的技术难题等。
JIRA的问题页面就像下面的截图：
图1
下面说明了一些重要的字段—“类型〞，“优先级〞，“状态〞和“解决结果〞：
2.1.1问题类型
JIRA可以为不同类型的问题单独设置相应的类型。
如JIRA为软件研发工程提供的默认类型：
“缺陷〞，“新需求〞，“改良意见〞，“任务〞。
JIRA管理员可以根据企业实际需求定制（Atlassian）问题类型，包括新增、删除、修改。
2.1.2优先级
优先级说明这个问题的重要性。
JIRA默认提供了“紧急〞，“严重〞，“一般〞，“次要〞，“无关紧要〞5个级别。
优先级别和具体描述可以由JIRA管理员根据具体需求定制。
2.1.3状态
每个问题在一个时刻都有一个状态，来说明这个问题在工作流中的处理进度。
JIRA默认提供的状态是：
一个问题是从〞开放〞开场，接下来的处理流程是“已解决〞然后再“被关闭〞；当然，JIRA系统管理员可以根据具体需要定制。
2.1.4解决结果
一个问题可以通过很多种方式解决，比方默认提供的解决结果有：
“已解决〞，“无需解决〞，“问题重复〞，“无法重现〞等。
JIRA管理员可以根据具体需求定制解决结果。
注意，一旦问题被解决了（即，问题的解决结果字段不为空），问题编号会以删除线形式显示。
2.2什么是工程
JIRA的工程是根据你的企业组织需要定制的，是问题的集合。
例如，一个JIRA工程可以是：
∙一个软件研发工程
∙一项市场推广活动
∙一个技术效劳/帮助台系统
∙一个需求管理系统
∙一个需求调查系统
每个问题必须属于一个工程。
每个工程都有工程名称（例如网页设计）以及一个工程关键字（例如WEB）。
工程关键字是工程中所有问题编号的前缀，例如WEB-101，WEB-102，等：
图2
2.2.1什么是模块?
一个工程模块是这个工程中问题的逻辑分类集合。
每个工程都可以根据你企业组织的要求设置多个模块（也可以不设置模块）。
例如，一个软件研发工程可以设置“参数设置〞、“数据召测〞、“档案管理〞、“数据查询分析〞等模块。
图3
工程中的问题可以隶属于一个或多个模块，当然也可以不属于任何模块。
2.2.2什么是版本?
对于一些工程类型来说，特别是软件研发工程，为问题关联产品的版本是非常有用的（例如1.0beta，1.0，1.2，2.0）。
一个问题可以设置两种类型的版本信息：
∙影响版本—可以清晰地反映出这个问题在哪个版本中出现错误。
例如，一个软件的缺陷可能影响了产品的1.1和1.2版。
∙修复版本—可以反映出报告的问题将在哪个版本，或已经在哪个版本中修复了。
例如，软件缺陷影响了产品的1.1和1.2版，这个缺陷已经在2.0版中修复了。
注意没有修复版本的问题会被归类到“无〞，就像上面截图显示的一样。
版本可以有3个状态：
已发布，未发布或已归档。
版本可以设置发布日期，而JIRA会自动将到期而还没有发布的版本高亮显示出来，并标注上〞超期〞标志。
2.3其他资源
∙查看“浏览工程〞获得更多关于工程构造和问题的信息。
2.4什么是工作流
工作流是按照一定的规那么和过程执行一个任务，在JIRA中表达在问题在生命周期内不同状态之间的变化。
下面的图像是JIRA默认的工作流程：
∙每个状态以矩形框表示
∙每个工作流跳转由箭头指引方向。
图4
JIRA的工作流还可以由系统管理员定制。
3使用JIRA
3.1登录到JIRA
一般情况下，公司会根据权限限制某些用户或用户组查看JIRA中的问题以及对问题的操作。
当用户还没有登录到JIRA时，会显示登录面板。
这时用户可以：
1.登录到JIRA：
要登录到JIRA，输入你的〞用户名〞和〞密码〞然后点击〞登录〞按钮。
点击〞这台计算机上记住我的登录信息〞这个检查框可以防止从JIRA中自动注销。
然而，你的会话不会保存，例如上一个搜索记录，当前使用的工程等。
2.重置密码：
要重置密码，点击〞无法登录〞。
在弹出的〞无法登录〞对话框中选择〞我忘记了密码〞。
在随后出现的〞用户名〞字段中输入你的用户名，JIRA会将重置密码发送到你在JIRA中登记的。
如果你忘记了地址，你只能联系JIRA系统管理员。
3.注册：
如果你还没有JIRA账号，并且JIRA允许公开注册，你就可以通过点击〞注册〞创立自己的JIRA账号。
在弹出的注册页面输入你的详细用户信息，并点击〞注册〞按钮。
请注意由于JIRA管理员可以对JIRA进展定制，所以你看到的页面可能会与截图有差异。
图5
3.2了解JIRA页面布局
面板是你登录JIRA后看到的第一个页面。
∙导航栏（在页面顶部）出现在JIRA所有页面上。
它包括让你使用JIRA功能的快速。
∙页面顶部导航栏下的白色区域，可以根据你的具体需要，定制显示不同类型信息的〞面板小工具〞。
图6
3.3工程的管理
工程的管理一般是由工程经理进展操作。
3.3.1工程的创立
由上级领导指定工程经理后，工程经理成了工程负责人。
登录后进入“管理员界面〞，可以进展工程的创立。
图7
3.3.2问题类型的设定
可以对各种问题类型所使用的工作流、字段配置、界面等信息进展设定。
图8
3.3.3工作流的设定
显示哪种问题类型使用了哪种工作流，可以对工作流对应的问题类型进展修改设置。
图9
3.3.4用户管理
管理工程各人员所属角色、分组情况。
可进展新增、删除等操作
图10
3.3.5权限管理
可以查看工程（已设定权限方案）里各角色或成员的使用权限。
也可以选择不同权限方案，前提是权限方案已经设置完成。
图11
3.3.6版本管理
可以对工程版本进展管理
图12
3.3.7模块管理
可以对工程所包含的模块进展管理，包括新增、修改、删除模块；指定模块负责人等。
图13
3.4问题的根本操作
3.4.1创立问题
要创立JIRA问题，你必须拥有相关工程的“创立〞权限。
如果你还没有这个权限，请联系JIRA系统管理员。
要创立一个新的JIRA问题：
1.点击页面顶部的“创立问题〞。
图14
2.弹出创立问题页面
图8
注意如果默认的工程或问题类型不会显示这个弹出框，例如
∙只有一个工程，并且这个工程只有一个问题类型。
∙如果你在浏览工程时点击“创立问题〞，而且浏览的工程只有一个问题类型。
∙如果你在浏览工程时点击“创立〞图标，例如：
图9
3.“输入问题详细信息〞页面会显示出来。
输入问题主题并完成所有标有带星号的斜体字体的必填字段。
图10
注意这个页面可能由于JIRA管理员的自定义设置而显示不同的字段。
4.点击页面底部的“创立〞按钮，这个新提交的问题就创立成功。
3.4.2上传附件
JIRA允许你为问题上传附件。
3.4.2.1为问题上传附件
要为JIRA问题上传附件：
1.翻开你需要上传附件的JIRA问题
2.在*更多操作*菜单中，选择“上传附件〞。
3.“上传附件〞对话框就会出现：
图11
4.点击〞浏览〞按钮查找需要上传的文件。
∙你可以一次上传多个附件：
一旦你选择了一个文件，文件名会显示在上传附件对话框上方，然后通过浏览按钮上传其他附件。
∙如果你选错了附件，取消对话框上方文件名前面的对勾。
∙默认情况下，每个上传文件的大小限制在10MB以内，当然那JIRA管理员可以改变文件大小的限制。
查看开启附件了解具体设置。
∙文件名不能包括以下字符：
〞\〞，〞/〞，〞\〞“，〞%〞，〞：
〞，〞$〞，〞?
〞，〞*〞。
5.你可以为附件输入一些补充说明。
如果你输入了备注，你就可以通过点击锁图标，选择这个备注可以让哪些用户查看。
默认地，备注可以被〞所有用户〞查看。
6.点击“上传〞按钮
3.4.2.2查看图像
默认情况下，JIRA会在查看问题页面显示上传的图像文件（如GIFs，JPGs，PNGs），包括问题的任何截图的“缩略图〞。
图12
如果JIRA管理员在JIRA中制止了附件中的缩率图功能，就不会显示图像缩略图，图像文件只会显示在附件列表中。
你可以点击图像缩略图在弹出框中预览大图。
图13
可以为问题上传了多个图像文件。
图14
3.4.2.3将问题的所有附件压缩下载
要将问题的所有附件（包括截图）压缩下载：
1.翻开要下载附件的JIRA问题。
2.点击附件局部右侧侧下箭头并选择下载全部菜单。
图15
3.4.2.4从问题中删除附件
要从一个JIRA问题中删除附件：
1.翻开需要删除附件的JIRA问题。
2.点击附件局部右侧的下箭头，并且选择管理附件菜单；
3.“管理附件〞页面会显示出来：
图16
4.找到需要删除的文件并点击“删除附件〞图标：
3.4.3上传截图
如果管理员为你配置了权限，你就可以为问题上传抓取的屏幕截图。
只有满足以下条件，你才能够使用这个功能：
1.JIRA管理员允许在JIRA中上传附件。
（同时你也需要在工程中具有“上传附件〞权限。
）
2.你使用的是Windows或Mac。
（如果你使用的是其他操作系统，你只能通过上传附件功能上传屏幕截图。
）
3.4.4处理问题
处理人员〔一般是经办人〕登录后，会在界面上看到分配给他的问题。
图17
没有的话，可通过
进展设置。
查看主题后，点击相应要处理的问题，弹出问题处理界面。
图18
此时问题处于正在处理状态，当问题处理完成后，点击“解决问题〞按钮，弹出“解决问题〞的界面。
图19
填写好相应信息好点“解决〞按钮。
此时问题处于“已解决〞状态。
3.4.5关闭问题
问题报告人或相关人员登录后，对工程处于“已解决〞状态的问题进展验证，如果验证通过，那么选择“关闭问题〞按钮，问题就处于“关闭〞状态；如果验证不通过，那么选择“恢复开启问题〞按钮，问题就处于“重新翻开〞状态。
图20
3.4.6为问题添加备注
为问题添加备注对搜集问题的相关信息非常有用，也有利于团队的沟通合作。
备注会显示在查看问题页面的“备注〞标签页面内。
你只要拥有下面两个权限就可以为问题添加备注：
∙“浏览工程〞权限—可以查看你要添加备注的问题
∙“添加备注〞权限—可以为问题添加备注
当你给问题添加备注时，你也可以决定这个备注让哪些工程角色或用户组成员查看；或允许所有用户查看。
要查看备注的用户，必须拥有〞浏览工程〞权限查看这个问题，还要属于添加备注用户是否允许你查看（查看“添加备注〞章节）。
3.4.7查看历史变动记录
问题的历史变动记录是记录问题的变动轨迹，包括：
∙更新了问题的字段
∙上传了附件
∙删除了备注
∙删除了工作日志
∙创立或删除了问题
每一项变化，都会记录以下信息：
∙更新记录的用户、
∙问题被更新的时间
∙如果一个问题的字段被更改正，字段的原值和更改后的新值
要查看一个问题的历史变动记录，
1.翻开需要查看的问题
2.点击“活动〞局部的“历史〞标签页
3.就会显示如同下面截图的问题变动的详细情况。
图21
3.4.8记录工作日志
3.4.8.1关于时间跟踪
只有当JIRA管理员给你赋予了工程和问题的记录工作日志权限后，你才能对问题添加工作日志。
注意：
任何具有浏览工程权限的用户，都可以查看问题的时间跟踪信息。
如果一个问题（或它的[子任务]）已经设置了初始预估时间，在查看问题时，就可以看到3种颜色条，分别显示时间跟踪的信息：
∙初始预估时间（蓝色）—初始预估的解决问题需要消耗的时间。
（查看问题使，标记为预估时间）
∙剩余预估时间（橙色）—解决这个问题还需要消耗的时间。
（查看问题时，标记为剩余时间）
∙消耗时间（绿色）—记录实际工作所消耗的时间.（查看问题时，标记为实际工作时间）
图22
如果这个问题有[子任务]，那么：
∙要包括[子任务]的时间信息，请确认选中了包括子任务选择框。
∙如果只需要查看主任务，确认没有选中包括子任务选择框。
当你为问题登记工作日志时（查看下面章节），你可以：
1.登记工作所消耗的时间，时间单位可以是周/日/小时/分钟（可以使用小数，例如〞5.5h〞）.
这个时间就会被添加到问题的总计消耗时间中。
2.输入工作的具体内容。
3.调整剩余预估时间（即要解决这个问题还需要多少时间）。
问题的工作日志会在浏览问题时，显示在活动局部的工作日志页面中：
另外，一旦为问题登记了工作日志，就可以基于时间跟踪信息生成多种时间相关的报告。
3.4.8.2设定预估时间
在为问题登记工作日志之前，你需要为问题设定初始预估时间（即预估完全解决这个问题所需要消耗的时间）。
当第一次为问题登记了工作日志，JIRA自动地以初始预估时间减去消耗时间（实际工作时间）计算出剩余预估时间。
当再次登记新的工作日志后，JIRA再从剩余预估时间中减去此次工作所消耗的时间，作为解决这个问题的剩余预估时间。
当然，在问题的解决周期内，你可以手动编辑初始预估时间或者剩余预估时间：
1.定位并查看一个问题，点击页面顶部的“编辑〞按钮。
或在页面右上角，点击“创立问题〞发起一个新的问题，并填写所有必要的字段编辑时间跟踪字段：
∙初始预估时间—解决这个问题预估需要多少时间。
通常，可以在创立问题或第一次登记工作日志之前设置这个时间值。
∙剩余预估时间—解决这个问题还需要多少时间。
2.在初始预估时间或剩余预估时间字段中输入具体的时间。
使用“w〞，“d〞，“h〞和“m〞时间单位来表示周，日，小时或分钟。
例如，要设置“6小时〞，输入“6h〞。
如果这两个字段都是必填项（标注了红色星号），你可以只输入其中一个字段值，而其他字段可以留空。
当你提交这个表单，你在其中一个字段中填写的值，会被复制到留空的字段。
3.点击页面底部的“更新〞按钮。
如果JIRA管理员在工作流中设置了时间跟踪，那么你就可以在执行工作流动作同时填写时间跟踪。
另外，如果JIRA管理员在JIRA界面设置了时间跟踪，你就可以在创立或编辑问题的时候维护时间跟踪信息。
3.4.8.3为问题登记工作日志
如果要在查看问题的同时登记工作日志：
1.浏览需要登记工作日志的问题.
2.从更多操作下拉菜单中选择“工作日志〞。
3.就会显示工作日志对话框。
4.在消耗时间字段中输入实际工作的时间。
通过添加“w〞，“d〞，“h〞以及“m〞等时间单位来表示周，日，小时或分钟。
例如，要记录工作了2个小时，输入“2h〞。
如果你输入的时间没有指明时间单位（比方，你输入的时间是“2〞而不是“2h〞），JIRA会自动使用默认时间单位。
5.在开场时间字段，点击日历图标，在弹出的日历选择框内选择开场工作的日期和时间。
你可以：
∙点击（“<“）或（“>“）图标选择上个月或下个月。
∙点击（“<<“）或（“>>“）图标选择上年或下一个年度。
如果你点击并按住左右图标，就会显示相应的下拉选项，允许你快速地选择年份或月份。
∙每次点击小时数，就会自动增加一小时（或按住点击就减少一小时）。
∙每次点击分钟数，就会自动增加一分钟（或按住点击就减少一分钟）。
∙点击“上午〞/“下午〞切换（12小时模式下适用）。
6.剩余预估时间字段根据下面的选项调整：
∙“自动调整〞—如果你希望剩余预估时间根据初始预估时间自动减去时间消耗自动计算，就选择此项。
∙“不设置预估时间〞—如果你不希望设置预估时间，选择此项。
只有当没有设置预估时间时才会显示此项
∙“使用现有预估时间...〞—如果你不想改变问题的剩余预估时间就选择此项。
只有当设置了预估时间才会显示此项。
∙“设置为...〞—手动将剩余预估时间设置为新值。
如果你选择了这个选项，输入预估时间。
使用“w〞，“d〞，“h〞和“m〞表示周，日，小时或分钟。
例如要输入“30分钟〞，输入“30m〞。
∙“缩减...〞—如果你想手动减少问题的剩余预估时间就选择此项。
如果你选择了这个选项，输入预估时间。
使用“w〞，“d〞，“h〞和“m〞表示周，日，小时或分钟。
例如要输入“30分钟〞，输入“30m〞。
7.在工作描述字段，输入此次工作的具体内容或注释。
8.点击锁图标，来决定哪些用户可以看到你输入的工作描述。
要查看工作日志，你必须拥有浏览工程权限查看这个问题，并且是指定备注可见性规定角色的成员。
9.点击〞记录〞按钮返回到问题页面，并确认：
∙问题页面的消耗时间已经更新。
∙剩余预估时间值也已经被更新。
3.4.8.4编辑工作日志
1.定位到需要维护工作日志的问题，并查看它的明细。
2.点击活动局部的“工作日志〞标签页。
3.找到需要编辑的工作日志。
4.点击工作日志右侧的“编辑〞图标。
5.会显示编辑工作日志页面。
#按照前面查看问题的同时登记工作日志章节描述的方法，编辑工作日志时间。
请注意，如果你正在编辑一条工作日志记录，将无法减少预估时间。
因此，“缩减...〞字段不会显示在编辑工作日志页面上。
6.点击“记录〞按钮，将返回问题页面，并确认：
∙已编辑字样显示在更新过的工作日志旁边。
你可以将鼠标悬停在这个字样上，就可以看到谁，何时编辑了这条工作日志。
∙消耗时间字段已经被更新
∙剩余预估时间值也被更新。
3.4.9问题
问题允许在2个相关的问题之间建立起关联关系。
例如：
∙一个问题可能与另一个问题之间有依存关系。
∙一个问题可能与另一个问题重复
∙一个问题可能影响到另一个问题。
（JIRA管理员可以定制的类型。
）
一个问题与其他问题，就像下面这样：
图23
注意已解决的问题会显示删除线，例如TEST-7.
3.4.9.1创立一个
要在问题之间创立一个：
1.查看需要创立的问题。
2.从“更多操作〞菜单中选择“〞。
就会显示“问题〞窗口。
选择类型以及当前问题需要的其他问题。
图24
3.你可以将一个问题到多个问题上。
有两种方法在问题框中指定你需要的问题：
∙输入完整的问题键值（例如ABC-123）—或用逗号分隔多个问题键值。
注意：
如果你之前浏览了一个问题，你只需输入问题键值的前几个字母或主题的局部内容，JIRA就会显示问题下拉列表：
图25
_或者：
∙点击〞选择问题〞翻开“问题选择器〞，可以让你选择最近浏览的问题或者从保存的问题过滤器中选择（点击选择器右上角的过滤器下拉列表）需要的问题。
∙要一个问题，点击问题键值
∙要多个问题，点击“选择多个问题〞。
会显示选择框，勾选需要的问题，选择问题后，点击“选择问题〞，关闭问题选择器，并返回“〞窗口。
4.点击“〞按钮。
3.4.9.2删除一个
要删除一个：
1.查看包含的问题，查看“问题〞局部（请参见本页面前面的截图）。
2.点击“管理〞（齿轮）图标。
3.在随后显示的页面中，点击右下角的删除图标进展删除。
3.4.9.3搜索的问题
你可以搜索到一个指定问题上的其他问题。
详细资料请高级搜索。
3.4.10复制问题
“复制〞问题，允许你在同一个工程中快速地将创立一个重复的问题。
复制的问题，包括与原问题同样的信息---例如主题，影响版本，模块等。
复制的问题也可以使用“克隆（复制品）〞类型到原来的问题。
复制的问题与原问题独立存在在JIRA中。
对原问题的任何操作都不会影响到复制的问题，反之亦然。
只有在两个问题之间（创立了）才会使原问题与复制的问题之间产生联系。
复制的问题保存了一下信息：
∙主题---带有可选的前缀（在jira-application.properties中指定）
∙描述
∙经办人
∙环境
∙优先级
∙问题类型
∙问题平安级别
∙报告人（请注意，如果你没有〞编辑报告人〞的权限，复制的问题将采用与原问题一样报告人）
∙模块
∙影响版本
∙修复版本
∙问题（可选）
∙附件（可选）
∙工程（请注意，一旦复制的问题被保存，你可以将按照[移动问题]章节中描述的方法，将这个问题移动到其他工程中）
相时间跟踪及备注的详细内容将不会被复制。
复制一个问题
1.翻开需要复制的问题.
2.从〞更多操作〞菜单中选择〞复制〞。
就会显示“复制问题〞对话框.
∙你可以编辑复制问题的主题.
∙如果原问题包含了与其他问题的，你可以选择复制的问题中是否需要这些.
∙如果原问题包含了[子任务]，你可以选择复制的问题中是否需要创立子任务.
∙如果远问题包含了附件，你可以选择复制的问题中是否需要包括附件.
3.点击“创立〞按钮.
3.5搜索问题
3.5.1简单搜索模式
JIRA提供强大的问题搜索功能。
你可以根据工程，版本和模块的区域范围设置搜索条件。
如果你需要根据时间跟踪的明细搜索问题，使用简单搜索模式就可以查到问题的工作日志。
JIRA还允许你将自定义字段作为搜索条件，甚至允许你自定义更多的搜索功能。
你可以将搜索条件保存起来，在需要的时候随时执行，或者共享给其他用户，让其他人分享你的搜索条件。
问题过滤器了解详细操作。
1.点击页面顶部导航栏的“问题〞。
升级会员 