JIRA不完全手册 【转】
上一篇 / 下一篇 2008-12-30 10:26:23 / 个人分类：JIRA
过word编写的一个文档，很多图片粘帖不方便，只能把文字贴上51Testing软件测试网0P/g"OPk W9Xkq
51Testing软件测试网 X
x%OZ
})a l
1JIRA简介51Testing软件测试网 d8W-Xg{
1.1 概要介绍51Testing软件测试网4H;P ES!{?MM
Q/x:DZ Qk0JIRA的生产者把JIRA定义为Professional Issue Tracker，即它是一个专业的问题跟踪管理的软件。这里的”问题”对应的英文单词是Issue，所以含义比较广，包括Bug,Task,Enhancement,Improvement等等跟软件开发相关的名词。跟踪管理即对问题的整个生命周期进行记录和管理。一个问题从创建到解决到关闭涉及到很多相关信息，包括是什么问题，谁发现的问题，谁处理了这个问题，如何处理的，相应的代码有什么改变等等，JIRA可以方便的记录这些信息，并且在问题的不同状态呈现在相应的责任人面前。相似的软件有Bugzilla,Trac,Mantis,Clear Quest, Streber, 等。
&v5^*z`8r0进行问题跟踪管理的好处是：
4V Z F qu9H Td8a01. 让系统来记住Task，Bug等等信息，而不仅仅靠项目经理和程序员的脑袋来记忆。人脑记忆的东西往往是不准确的。
Q-\7c*@
z^8H:P\B02. 问题跟踪管理可以定制流程，可以有效提高工作效率
K#Ck e;^
pRJ03. 用专业的系统来进行问题跟踪管理能带来更多的好处，详细见下面JIRA的优点51Testing软件测试网
lD {$n|c7V
1.2JIRA的优点
L EY9B0{0JIRA有很多专业特性，不愧为介绍中说的Professional这个词。
6q*ULhO2L9N01. 针对问题其默认定义了丰富的字段来记录问题的各种信息，包括Issue Type, Issue summary, Issue Descrīption, priority, assignee, reporter, resolutions等等51Testing软件测试网+w[\h
L d
2. 强大的自定义字段功能，自定义字段自带有22中类型可以选择，而且还可以通过JIRAExtension来支持更多类型。22种类型如下图所示：
Z0L i#o5o ~m8OK0
i/U_#{+J _ jx }03. 针对每个字段都能进行屏幕,项目,问题类型等配置，可以方便的控制字段应该出现在哪里，而不应该出现哪里。
n.MB,PH!O04. 默认定义了工作流的一些状态: new, open, defer, pending, resolved, reopened, closed。 默认定义了一个简易的工作流, open-in progress-resolved-closed
;q PoX:q2z?Y5q ]0l05. 强大的自定义工作流功能，针对不同的流程节点可以定义不同的权限、字段、后续可供选择的处理方式。51Testing软件测试网4B)F0m4~)P4q0n2O e
6. 丰富的权限管理配置，可以针对项目、用户、用户组、项目角色、操作定义各种组合定义
U5^|%V e l6I07. 支持附件，同时针对图片附件有特别支持，可以图片附件直接在网页中显示，如下图
#xCC} qb.@ ~3n051Testing软件测试网 zWG_6T"K"f.e%i
8. 可方便地定制查询(Filter)，不同的查询可以快速找到你关注的问题。查询条件可以对绝大部分字段设定条件。
)pm,Yi?Q4a09. 用户首页可以定制，并且可以定制的查询放入首页，这样可以方便查看关注的内容。首页被定义为一个Portal，可供加入的Portlet有很多，如下图所示51Testing软件测试网 t.\6O7L(o-fH
51Testing软件测试网 ~T1`+y;j#dI4D|(w
10. 支持邮件通知，邮件通知可以同工作流中和工作流之外的事件关联
@ e+@)yP"Rz!w011. 支持Time Tracking功能，这个功能用于项目管理中的任务管理是很方便的51Testing软件测试网%A/T pY-xz*A
12. 支持CVS、SVN代码库的整合，同时支持Fisheye，这样可以让问题和代码关联51Testing软件测试网 DM*T%]b;S
51Testing软件测试网|$?u'C/bk#`
DwV
13. 自带备份机制，不用担心数据丢失。况且JIRA运行非常稳定，使用2年以来从未发生系统性故障
;\$SW6d^Q
lJ014. 导入导出功能很完善，可以导出为XML文件，方便将数据从不同数据库之间迁移。
$sX,e$UzX u5G015. 系统性能非常不错，在一台普通PC上，只分配了256M内存，整个系统有1000多个Issue，92个用户(同时在线使用应该有20个用户)，同时还将JIRA需要的数据库安装在一起可以很流畅的运行。同时这台PC还运行了CVS,VSS等等服务。
_$](T!o
mD/R G3_-Q016. 支持多种数据库,mysql, ms sqlserver, oracle等等，自带有内存数据库hsql db已经可以让JIRA运转起来。 配合MySQL已经足够应付40个人规模的项目。JIRA的数据库很简练，附件是作为文件形式存放的。
ui5x mb0S,b017. 支持Plugin功能，如果有什么没有实现的功能，或许通过plugin可以实现，JIRA的网站上有很多plugin来下载
LW
_-c9JPI f |018.JIRA针对开源项目是提供免费license的，所以其用户群很庞大，相应的你得到支持也是很多的，包括官方详尽的文档、Wiki，用户论坛等等51Testing软件测试网9d
z @ P If Du
R,R
19. 更多特性有待你来发掘
E/D9z5p0` r"[N'B01.3JIRA的缺点
%bz5uy;`01.JIRA是个商业软件,而Bugzilla、Mantis是开源免费的
/\KM:W2Ae H02. 对clear case没有官方支持，有一个plugin，但是状态时unsupported51Testing软件测试网2?
Q_6Kq [d
3. 专业性也带来了配置的复杂，建立一套完善的custom fields, workflow, permission scheme并不是一件容易的事情
@M ` pV q(X(y oE02JIRA的安装
1Y ^;X+N-S&wr h0JIRA是一个Java Web Application, 自带的web server是Tomcat，所以熟悉J2EE开发的人来安装JIRA应该是轻车熟路的。JIRA3.12版本之后已经提供windows installer形式的安装包，安装起来也变得很简单。以下介绍以windows安装包的形式来介绍51Testing软件测试网Z.?0K;@ F
h?
2.1 安装步骤
9A}O+D#T&L*bP0JIRA提供stanalone, war包,installer等的安装方式,以下安装以最简单的installer来介绍51Testing软件测试网6nC"Aw+SY qt
1. 下载Windows installer, Atlassian的网站提供下载。安装包有56M，这个包已经包括了JRE和Tomcat，所以可见JIRA的安装文件并不肥大。
X Z&Q N-X Z02. 双击EXE文件开始安装，安装路径可以任意选择。
D s5H;W9[9e6W^03. 安装向导结束后双击%JIRA_HOME%/bin/startup.bat可以启动JIRA，通过http://localhost:8080 访问JIRA应用，如果成功打开了页面则表明安装成功51Testing软件测试网7N&`7RL y(yXP
2.2 安装配置
OE#t$i3sIY7q3]01. 安装数据库，自带的hsqldb是不赞成使用的，我们以mysql为例进行配置。首先安装mysql，安装过程见相关文档，一般不需要有特殊选项51Testing软件测试网UK(sPU m7m4]|8}
2. 建立数据库，用root用户登录mysql，创建一个名为jira的数据库(数据库名可以任意),字符集用如下图的选项：
ve+L*r3H6GMG3V0
*Y%sW"xPn'M1[eq03. 建立数据库用户，如下图所示，如果数据库和JIRA在同一台机器，主机那栏填localhost51Testing软件测试网xecc4R
51Testing软件测试网-q A(mL*| q*q I-?M)`
并将jira数据库的所有权限赋予给jira用户(JIRA初始化数据库时需要比较大的权限)51Testing软件测试网q,HG.Ar
51Testing软件测试网&U*H @q$C!D$l
4. 下载mysql jdbc driver的jar包，并放入%JIRA_HOME%/common/lib目录。Mysql的jdbc驱动有很多版本，请下载适合你的mysql server的最新驱动，不然会产生一些意料不到的问题。51Testing软件测试网cA'Kgag$J.G)y&m F D
5. 将%JIRA_HOME%/atlassian-jira\WEB-INF\classes\entityengine.xml中的datasource name="defaultDS" field-type-name="hsqldb" 改为mysql
` FO+M9p:h@$B?06. 将%JIRA_HOME%/conf/server.xml中的jdbc/JiraDS 修改为如下形式
){6N5gm%~L a9R0<Resource name="jdbc/JiraDS" auth="Container" type="javax.sql.DataSource"
}PO e{*`.x{0username="jira"
-jW*s S.p2\$?J0password="jira"
(gmF*E;Z
QA{R
C0driverClassName="com.mysql.jdbc.Driver"
6c~({ hgw,Y!pi0url="jdbc:mysql://localhost/jira?autoReconnect=true&useUnicode=true&characterEncoding=UTF8"
}f2G z?;`,E0C3Do0maxActive="20" />
Wa
S zm(N X%h n07. 将JIRA安装为NT服务。在CMD窗口运行bin/service.bat install即可安装，service.bat remove进行卸载。安装好打开服务如下图所示，点击“启动”按钮即可启动JIRA51Testing软件测试网"wzGK'N F
51Testing软件测试网 z.Z}-Y(l.@7^q
8. 配置语言及通用选项。JIRA第一次启动会提示你选择语言项，最好选择英语，因为中文汉化不很完善，有些链接不会显示会导致功能缺陷。Index, attachment, backup等目录可以如下图所示来建立
*`3[PZ;n\ S7t051Testing软件测试网f.M/W"u,P E5}E U
到此JIRA就已经全部安装好了。
.DY7bvz03 Quick Start
i)h3Q$AL03.1 创建Project51Testing软件测试网;jS
O7ZTn
JIRA默认的管理员是admin，密码也是admin，使用这个用户登录后来创建Project。没有project的JIRA菜单很少，如下图所示：51Testing软件测试网| J]&K#J1c.E$H
51Testing软件测试网c(Z#Jx Kn-q
1. 点击菜单中的ADMINISTRATION进入管理页面，点击Projects-Add Project来添加Project51Testing软件测试网WHO"BD7u}[L*N1T
51Testing软件测试网+I)J1pr1y4]'?8mywB Z
2. 如下图填写必填项，key这个选项填完之后就不能修改了，所以想清楚填什么值最好，并且建议填3个字母以内的缩写。Project lead是必填的，但是这个时候只有admin一个用户，只能填admin了，增加用户后可以修改project lead为别人。后面的选项都用默认。最后点击Add则完成了Project的创建51Testing软件测试网j2}5a ][ap a
51Testing软件测试网]3[H6Qq5C i
Project创建完成后，我们可以发现JIRA的菜单栏多了三个菜单：BROWSE PROJECT, FIND ISSUES, CREATE NEW ISSUE，功能分别是查看项目汇总统计信息，查询，创建新问题，详细使用在后面描述。
Ga)xn%h3{ } D
n3N03.2 查看用户组51Testing软件测试网6E%`N'\$`1?s
点击Group Browser可以看到JIRA默认提供的三个Group,在Quick Start中我们用这个三个用户组就可以了。管理Group也是通过这个界面来进行
tH W
k)X0
4O9p ` Gu
[ S03.3 创建用户
}-PSO%lNj01. 如下图通过User Browser-Add User来添加User51Testing软件测试网 Q%}e4P9i+}q
51Testing软件测试网H1u KV9cn ^:p
2. 下图中的Username是用户的登录名，将不能修改。Full Name是显示名，可以进行修改51Testing软件测试网 k z dX&P d:k ~
%v$~#y i0f \03. 点Create后创建成功，如下图
&@ UR hKq-e^ ^&^0
W)J [NMbVI0点击Edit Groups可以编辑用户所在的组，用户默认的组是jira-users。51Testing软件测试网
Id"z7p%uO6^_#M6U5c ~
4. 选择jira-developers然后点击如下图中的Join>> ，arthur将被加入jira-developers这个group
E)aJs{E@u0
_oog0Ub05. 改变TST Project的project lead。(Admin用户是超级管理员，最好不要在任何项目中担当角色)
7EV9R,RzY0从ADMINISTRATION-Project进入，如下图点击Edit
FV%e`#l~2U mit3h0
!Ej!ch,q/B&R0在Project Lead 栏输入arthur（jira3.12.3版本系统会通过AJAX快速查询到用户进行选择）51Testing软件测试网lI/Y"r1v k
?N,g } E8z;f0一个项目不能只有一个project lead，我们按照上述方法创建两个jira-developers的用户：Carol, Ben 创建两个jira-users用户：Chris, Mike。Jira-developers组是开发人员，职责是解决问题，jira-users组是测试组，职责是发现问题并创建问题测试问题
7O#UV5|9zF03.4 创建Issue51Testing软件测试网8O$g0yx t
Y
用arthur这个用户登录JIRA，点击CREATE NEW ISSUE进行问题创建。如下图，这个界面中有两个下拉框可以选择，Project中因为只有一个项目，所以没得选择，Issue Type有四个选项51Testing软件测试网"G"W\!v z!M
Bug: 软件中的缺陷
2dN]*p'dGcV0New Feature: 需求之外增加的新功能
%E/B t}E0Task： 计划中的任务
Gx!L,zP3B,R4D0Improvement：针对已经实现的功能的改进
l D)I~$Pa S&^!t0
x jr*Nc5m
D aK`0我们选择Task,创建一个任务：Project Lead分配一个任务给Carol,内容是让Carol来做8月14日的早餐。如下填写信息：
$E uv
z [*F [ _vz1D0Summary中填写概要信息，详细信息填写在Descrīption中，比如错误日志、详细需求等等51Testing软件测试网6]5r'af eExy(Z,~ N
Due Date是指何时需要完成
4}z3so%z i y8HfF0Assignee填写指派人
O \Hh'i]#P
X~/s0Components和Version的信息目前都是Unknown，因为针对Test Project我们没有配置这两个信息
g5n(v)CF!Z0Environment一般填写Bug发生的环境，Bug往往是因为其环境有特殊性而导致51Testing软件测试网w4accpS{
Priority默认有5个选项：51Testing软件测试网s@1r4I"u0EBi
kb@$aK#} N0从图标可以看出其代表不同的优先级
O.?LO \ Zw6\%W051Testing软件测试网B1d9w.L+L@&v
点击Create进行创建，之后可以看到如下图的结果：
[3UM:s ^ uu0JIRA系统自动分配了一个Issue Key ：TST-1，这个Key是唯一标识issue的编号，其他信息如图所示51Testing软件测试网]P.{u/W,a~D5_!G
(P4S
r/m6qU9d'Z03.5 处理Issue51Testing软件测试网\ co I-h II ? M
Carol登录JIRA后在她的首页可以看到如下信息：51Testing软件测试网N w%o&ON!Lf
51Testing软件测试网
s
ggvJ.^q2X)y:P#i
可以看到右边的Assigned To Me列表中有一条记录，这表示是需要处理的Issue，点击TST-1的链接进入如下界面：51Testing软件测试网5kt.| r4G+P&]
or&hB%B3Psy}]R0Available Workflow Actions中的链接是不同处理Issue的步骤，在开始做早餐之前，Carol应该点击Start Progress，之后TST-1的status变为 In progress， 半小时后Carol做完了早餐，她就应该点击Resolve Issue,之后进入如下界面：
g@F5QU(]k&d0
-| Pc ^Y*WAD
_%b k K0Resolution有如下选项：51Testing软件测试网#L&UOW{4w
Fixed：已经解决
#o7rf"S5[J6E D r0Cannot Reproduce：问题无法重现
c` D
VW P*uP0~ W0Won’t Fix：无法解决51Testing软件测试网 @~.zmC&{
N od
Incomplete：未完成，未完成还还能叫做Resolved?51Testing软件测试网^,]f;^%A{
s L*mm-{8[
Duplicate：重复问题，选择这个的时候最好在Comment中写上重复的Issue KEY
8D3t[ LpKgqO0Assignee填确认这个问题是否解决的人，一般填问题创建者
bR7\+uo8ll0点击Resolve之后Issue状态变成了Resolved51Testing软件测试网#h/tO#O n _0O
用arthur登陆JIRA，在Quick Search中输入TST-1可以快速找到TST-1这个Issue，经过严格测试之后可以确认问题已经解决，则可以选择Close Issue。
8[P D2KTu|0在Available Workflow Actions点击Close Issue，在下一个界面填写Comment，之后Issue status变成了Closed，到此Issue处理结束。
vq t$b']-m'^0当然如果这个Issue经过测试再次发生问题，可以选择Reopen Issue, Reopened的Issue后续处理同open状态的issue是一致的。
#N/}!jmLa04 定制你的JIRA(For Users)51Testing软件测试网l$k8HHr QH]+mK
4.1JIRA操作界面介绍
SH"O8p&f)Dp01. 下图是首页界面介绍(点击菜单栏中的HOME进入)51Testing软件测试网/X ]X0E8aU Np
51Testing软件测试网"Tn2J y`
注：QUICK SEARCH是一个非常有用的框框：51Testing软件测试网"DVLr~
1) 输入issue Key可以迅速打开这个issue，比如输入PR-10,则可以转入到PR-10的明细页面51Testing软件测试网0@L+K#X YF5U
2) 当你已经工作在某个Project时，你只要在快速搜索框中输入issue Key的序号，即可完成1)中的功能，即输入10然后按回车既有PR-10的效果51Testing软件测试网A"I#E l'B
3) 输入非issue Key或非数字的字符等同于Filter中在Text Search中输入了特定的字符进行搜索
-_I2S py7D oS c0
9B'Z+Y7T7e'O*S:`7p02. BROWSE PROJECT界面
?8Z} ]l;v,H0
7p$z2k[yb03. FIND ISSUES界面51Testing软件测试网 S$n&?;x4}d(L/E
VG
51Testing软件测试网!]3e,t}J*^F g
4. Issue Detail界面51Testing软件测试网.i6~ m!W"V2M
通过点击issue Key进入，或者其他链接进入51Testing软件测试网Q&HOv[P$Sa m
51Testing软件测试网mgd7K_ frl\
5. ADMINISTRATION界面介绍51Testing软件测试网~4apF i"J3j5v;?I#t/{]
最多菜单链接的一个界面，在后面章节中会有针对大多配置对应链接的说明。
%{SP%fX`p051Testing软件测试网lFA%f1v
4.2 修改个人信息51Testing软件测试网,n/g N4PoCgh
JIRA中的个人信息包括：密码、姓名、Email、Filter、preference、Dashboard、Column Navigator等。51Testing软件测试网IB2o1XB;o
通过JIRA右上部的Profile链接进入设置，进入后的界面如下图所示：
(YFt,r"l+R,c)k051Testing软件测试网3eOH#zn ^#c"o
d8U.X+G:g6W0其中Preferences可定制的选项包括浏览时每页最大issues数目，语言选项，Email格式。如果系统默认的语言是英文，你想把自己的界面改成中文，则可以通过这个地方将Locale改为中文即可
_ v2\#D ] ar04.3 定制Filter51Testing软件测试网Z8D[8R+}h
Filter可以理解为过滤器、定制查询，即将一组查询条件保存起来。通过菜单栏中的FIND ISSUES进入51Testing软件测试网.WdI LdK/Vf~0[
我们以建立“最近一周解决或者关闭的问题”为例来建立一个filter:51Testing软件测试网p n |WEB/}
1. 在Project中选择目标项目，选择项目之后会得到一个如下的提示51Testing软件测试网3^ ^ V K5gD
-E2b3b Y^1L!m0改变了所选的Project，其对应的versions, components, custom fields都是可能不一致的，所以需要点击Click here这个链接来更新这些信息51Testing软件测试网#|7b"L!g%{J&g K1U0W
2. 在Issue Attributes中的Status选择Resolved和Closed(选择第二个值按住Ctrl再点击)
Y5_5K e2U!E03. 在Dates and Times中的updated: From中填上-1w (-1w表示一周以来，类似的符号有d天，h小时，m分钟，2h 30m表示2小时30分，注意两个时间之间有个空格)51Testing软件测试网c3IF g F
4. 点击View即可查询出满足以上条件的Issues，我们希望按照Update time来倒序排列这些issues，点击Updated那列的标题即可倒序排列，再点击一次会变成顺序排列，想按照其他字段来排序也是类似的操作。51Testing软件测试网gO1v!q"l~ai6`
5. 如果确认查询出的issues已经是所想要的，剩下一步就是将这些条件保存为一个filter，点击Save it as a filter，如下图所示
f/[V
W3u8i4~051Testing软件测试网j7~6e_#IO.^~
填上filter名字，点击Save之后可以通过下图中的Summary看到刚才填写的条件概况51Testing软件测试网x z#I-JY/[s7h`;g)nE
p#|F{{06. 通过Share链接还可以将这个Filter共享给其他人或者其他用户组
3]5N P2md04.4 定制Portal(Dashboard)
+nu%Bt/Y)_e&b0JIRA将它的首页定义为Portal，定制Portal即定制自己的JIRA首页。通过Manage Portal进入定制界面，如下图所示的链接：（通过个人信息中的Dashboard Config链接也可以进入）51Testing软件测试网o] n {,`t0?,S
51Testing软件测试网 y4\a3{&M0] ` Z
进入的配置界面如下图所示：51Testing软件测试网9Y/l X0d FQ
xg
e M ]
^p e@0其中Full configure可以修改当前的配置，Add New Portal Page可以增加一个portal 页面，我们通过Add New Portal Page来举例，Name中输入My Page, Start From选择Dashboard，然后点击Add按钮，之后可以得到如下图所示的效果：51Testing软件测试网@@9VHD0V
z
8y.NK#RB zD
r
E0点击其中的Full configure可以进行My Page的配置，如下图所示：51Testing软件测试网_3b#c-D2o8U;_P3f9B)]5C
51Testing软件测试网&aW[N6E#@
定制的界面分为左右两边，点击Add按钮增加内容，Edit、Copy、Delete、上下左右箭头按钮顾名思义。51Testing软件测试网 ^MtL.M rCT"`
我们点击Add按钮，准备在My Page上增加一个Project statistics，如下图来操作：
6N8v{ @ Q j g7g%B}0
R0A \)B8jo8~q0Project Statistics还有下一个屏幕来提供选项，如下图所示：51Testing软件测试网f[ R&H%tmt7f
J:sg/VT0我们选择需要添加的项目，统计类型我们关注的是状态，选择Status，第三个选项是已经解决的问题是不是要统计出来，之后点击Save，则将Project Statistics这个portlet加入到了left column，我们要让它显示在右边，选中它点击向右箭头按钮即可。51Testing软件测试网9tvIB6cBj)wMo
然后回到首页，我们可以看到如下的效果：51Testing软件测试网m(P4s1U'|
51Testing软件测试网o0gn:?5{?m
Portlet有很多选项，我认为最有用的应该是Show Saved Filter，你可以首先定制好自己的Filter，然后把它加入到首页中，这样自己关注的issues就可以一目了然的看到了。51Testing软件测试网){x h&n(\%|&f
注：
7};aa ]|Z0JIRA管理员通过同样的方法来设置Default Dashboard，操作入口是：ADMINISTRATION-Default Dashboard
@.W}#g5q J04.5 定制Navigator Columns
YWf
F2f1F0点击某个Filter进行issue查询，查询列表中的显示字段可以进行定制，可供的选项有：增加字段、减少字段、编排字段先后顺序。JIRA默认的字段包括： T,Key,Summary,Assignee,Reporter,Pr,Status,Res,Created,Updated,Due ，其中T是issue type, Pr是Priority， Due是Due date。默认的排序是按照Key倒序排列。51Testing软件测试网-a#}cf.hw5B
通过列表上方的Configure链接来进行定制，如下图：51Testing软件测试网#Y$t
l3ts
进入后的界面如下图：51Testing软件测试网&k\ IPzK9T5^)l
51Testing软件测试网-c4w2B7L,@#o"kj
注：
c e+XkS!s1d e0JIRA管理员通过同样的方法来设置Navigator Columns，操作入口是：ADMINISTRATION-Navigator Columns51Testing软件测试网K!L&i5Jb*g6w5l
51Testing软件测试网l-c.t X$Z6`&~
4.6 导出、打印Issues51Testing软件测试网*h
n-r~+A }8b
JIRA在列表和明细界面提供了导出Word、导出Excel、打印页面的功能
l U7^ R^;H+ba01. 列表操作
A/^U l x(E X051Testing软件测试网1U|9d^j fRI
在查询列表页面中如上图提供了一系列的操作，其中
.Q*M;Lf P5i b0Printable链接提供一个便于打印的简洁HTML页面，如下图
l$Mq%Z Jk Lc051Testing软件测试网A$Tn Mb%]&~ Cu8e
Full Content链接提供了一个便于打印的所有issues明细的HTML页面，如下图51Testing软件测试网D&s%f
c)h C$e*N
Z%l
T5x1u,o0Word链接可以将所有issues明细导出成word文档
d4iO1S4e#hrY0Excel后面的两个链接：All fields导出所有字段为Excel，Current Fields导出当前字段为Excel51Testing软件测试网)oM Z5H(@JI
2. Issue明细操作
b H v(]*b ?$b"] xn0操作链接在Issue Detail中，功能与明细中的Word和Printable链接是一样的，如下图：
L!n;~f?E ~%K7].[051Testing软件测试网*g`nF*PI
~ d-H3yv o'Z04.7 制作报表51Testing软件测试网AY sr zaz.r
报表制作通过BROWSE PROJECT界面中的Report下的Single Level Group By Report链接进入，如下图：
(D"Y Z V*r\o:k0
i:o5r8r+RS0K(t0进入制作报表界面后，可以选择不同的Filter和不同的统计类型进行报表显示，如下图：51Testing软件测试网
Bm9H0{UwG
n!@uu&G0制作完的报表如下图所示：
8[ {i9z3SOnj#m{051Testing软件测试网2t7m6_1_2_
T u"im
5 让你的JIRA更专业(For Administrator)
jv[9h1Uh9P05.1 常用配置51Testing软件测试网M9a0~.q ^ tl i
5.1.1 Users, Groups & Roles
"BY|m mA0用户和用户组已经在Quick Start中描述过。Project Role Browser中可以定制项目角色，JIRA提供的三种用户角色略显不够，一般的项目包括project managers, team leaders, developers, testers，不妨按照这个思路来添加项目角色。项目角色添加好之后可以通过Permission Scheme来对角色分配不同的权限51Testing软件测试网 CG1m/x(p/v s#I5u
5.1.2 Global Settings
#M?&i Qj2v D0 General Configuration51Testing软件测试网 O.zLj/M E2n+@
这个配置界面有很多项目可以配置，每个项目JIRA都有说明，需要解释的有：
!K Qq-^O01. Base URL，这个选项很有必要设置正确，JIRA会对描述、comments中的Issue KEY自动加上链接，如果Base URL不正确，所有的链接都将是错误的51Testing软件测试网x])Z/I"p
2. Indexing language，这个选项默认是English,在Character encoding是UTF-8的情况下，indexing language是English也没有影响，即使你在创建issue时使用了中文，也能建立索引51Testing软件测试网L"Z8r+w N
3. Default language，安装好JIRA后第一次进入JIRA选择语言后可以通过这个地方来修改，正如之前说的，最好选择成英文。51Testing软件测试网1]do4sh,]
{p
4. Options里面的选项没有特别要求使用默认设置即可
7j2Y8pKz#o9C'DX0 Global Permissions
!}$e eY'as0这里的权限和项目中的权限是不同的，项目中的权限指的是创建issue、编辑issue等等，这里的权限是一些管理权限、创建filter的权限等与项目无关的权限
%wlHV9p0 Look and Feel51Testing软件测试网2L pw4TN.d8~
这个地方可以打造你的JIRA的外观，包括配色、Logo、日期格式51Testing软件测试网%l6] `q G m*EG l
Mail Servers
Er%S1?(O X&e E.?0配置邮件服务器，可以配置SMTP或者JNDI
1Co R Ig(\r%Ap4{05.1.3 Issue Settings
oz ~s$h/H1n:N+j0可以在ADMINISTRATION-Issue Settings中进行以下项目的配置：51Testing软件测试网 e {m(p sg6A"ss~-_)l
Issue Types51Testing软件测试网$?9o;o xi H C~h7As
Priority51Testing软件测试网 n+] }
`1w0dq
Resolutions
] ]#{ _$U0Statuses
,q'aE |\(?e0JIRA提供两种配置：翻译和编辑这些resolution。翻译可以适应多语言环境。编辑可以改变字段属性、排序位置、默认值、增删字段值等。这四个字段的配置都是类似的方法，参见JIRA提供界面应该不存在难度，以下列出配置中需要注意之处
!y
X
f+g o7} r
n0 配置Issue Types
@wS1i;N l5|%C DhV4o0系统自带的Issue Type包括：Bug, Task, Improvement, New Feature, sub-task .如果需要增加自己的问题类型，下面的Issue Types中进行配置。按照界面进行添加、编辑Issue Type，没什么特别。
Qs6]_s&I7g0但如果想删除已经添加好的Issue Type可能会碰到一些麻烦，当该Issue Type下存在issue的时候是不能删除这个Issue Type的。有两种办法来删除这个Issue Type
+YZ h%o5b+}d n
s01. 编辑相应的Issue，将Issue Type改成其他不删除的Issue Type。当Issue被close之后将不能被编辑，所以这种方法存在限制。51Testing软件测试网0?7kB H}i
2. 改变相应Project的Issue Type Scheme，这个scheme必须不包含待删除的Issue Type，在改变scheme的时候可能会报错，如下图所示：
F fD ~1_2N0{P0
1[[Z&G+vA0这是因为操作用户没有权限，应该在Project Permission中增加move issue的权限给操作用户。之后按照向导进行操作即可。
wxUL E0 配置Resolutions51Testing软件测试网j8^ |(?c$\m&X
通过ADMINISTRATION-Issue Settings中的Resolutions进行设置。
)G M_[\N.H0JIRA默认的Resolutions包括：51Testing软件测试网{2B3U i m U"ge
1. Fixed
1K6{
^f7K*F02. Won't Fix
;B J*uM9r{V
e03. Duplicate51Testing软件测试网] ia t XGf?(IHu
4. Incomplete
2j'x L^.}v05. Cannot Reproduce
n'w.U J^H0基本上这五种解决办法已经足够了。
4oo u \*r^,@0注意：
_ R"gV)J S(x ~%Ob0Resolution这个字段被JIRA默认的几个filter做了引用，所以千万不要自定义一个字段也叫Resolution，同时又把系统自带的Resolutions字段屏蔽!这些filter包括open issues, OUTSTANDING, filter中的条件都是Resolution为UNRESOLVED，这个UNRESOLVED的含义是Resolution字段没有设置任何值或者Issue Status为非Resolved和非Closed，所以当一个Issue状态为Resolved，即使它的Resolution为Won’t Fix，它也不会出现在open issues里面，即无法解决也是一种解决办法…51Testing软件测试网'd#?;n
sQ
配置Priority51Testing软件测试网b+A-[,wq
s4kB(f
Priority的颜色、图标都是可以修改的，最常用的Major级别的颜色是绿色，不妨修改为警告色黄色可以引起更多的重视
1TcNJ:| G3veT(_0 配置Statuses51Testing软件测试网W#wc;V I D0rO5T
这个字段是供workflow使用的一个字段，当在做工作流配置时如果觉得状态不够，那在这里添加即可。状态可以关联Icon可以让查看issue时更直观，JIRA提供了17个图标，足够来挑选了。
)tr:MaW05.1.4 Options & Settings51Testing软件测试网m| AH1N].M
1. Send E-mail51Testing软件测试网/^+{:ua"H;E9~
可以通过这个功能给某个用户组或者某个项目的特定项目角色发送Email
w+X,L3fYx,E H:W02. Announcement Banner
it&N+^K a5eHb V9f8C0这个地方可以设置一个横幅在JIRA菜单栏下面，可以写上重要的使用说明、通知等等，支持HTML
)a~9K(s G)G:m
m$V6s I7N05.2 自定义工作流
.]'n
B K|6Lf X"[S/e\0配置工作流之前请先定好Issue有哪些状态，状态的配置见常用配置--Issue Settings部分。
A4T$X~ Lm5r&^0工作流配置从ADMINISTRATION-General Settings-Workflows进入，系统默认有一个叫做jira的工作流，这个工作流是只读的不能修改。但是可以以此为蓝本来建立工作流，通过Operations中Copy链接即复制了一个一样的工作流。点击Operations--steps进入步骤的设置，进入的界面如下图所示：
:@7yV(Z%Ax%T;m0
6X%[ W4e:q.I [ML0从图中看Open step，Linked Status表示执行完这个step后，issue的状态会变成Open，Transitions表示对于Open状态的issue可以执行的操作，Operations是设置时用到的链接。
5UmKHB|!D0下面以几个例子来说明如何配置工作流：
C'D id{w*t01. 我们认为Open状态的issue不能有Resolve Issue这个Transition，所以准备把它删除，点击Delete Transitions，之后在多选框中选择Resolve Issue，删除即可。51Testing软件测试网ZgQ"@5q Y G$^
2. 对于Open状态的issues，Start Progress这个操作我们想控制它的权限，只有开发人员才能执行这个操作。通过点击Start Progress这个链接进入设置，我们看到在Conditions这个Tab中已经存在一个条件，含义是“只有assignee才能执行这个操作”，这个condition是合理的，保留。
;c
f:x L{;@051Testing软件测试网o(@ Z riu
g
我们通过点击Add链接来增加另外一个condition，之后会得到一个列表来选择condition的类型，开发人员才能执行同Project role比较接近，选择User is in Project Role。其实选择User is in group 然后配置一个开发人员组也是可以达到同样的效果。51Testing软件测试网.hV5Np3\
51Testing软件测试网2W~8`7A'?a
在下一屏中选择Developers这个Project Role，添加完我们可以看到如下图所示的Conditions51Testing软件测试网,uO?3?4pI7L7l
51Testing软件测试网9l(? s/{6i)t1@ J6?
JIRA默认将增加的condition用AND来连接，如果需要也可以将条件用OR来连接。
/n C F u7E \ k;oU?0熟悉以上操作后，通过Add New Step，调整每个step关联的status就可以实现复杂的自定义工作流。
U;u T?.G E?)w0工作流定义好之后，还需要定义workflow scheme，这个工作流才能被项目引用。通过ADMINISTRATION-Schemes-Workflow Schemes进入配置界面，先增加一个scheme，然后在Operations中的Workflows链接中关联workflow。JIRA在workflow之外再包装一层scheme的意义在于可以针对不同的issue type使用不同的工作流，如下图。51Testing软件测试网%Qq|+{
H5N0u-f
l
b$P8e2?2Qk0uz0为了简洁起见，我们一般选择All unassigned Issue Types对应一个工作流。51Testing软件测试网 sT8~6FpYq{
定义好workflow scheme之后才能被特定的Project所使用，通过ADMINISTRATION—Projects，选择需要配置的Project进行配置，如下图：51Testing软件测试网]
\7CQ1zs
51Testing软件测试网%L$XNw oD(\ BN
在Workflow Scheme中点击Select进行scheme的选择。在Associate的时候会得到一个警告：51Testing软件测试网 P_(fXi6q
51Testing软件测试网 }&]"H-};a7g(J:}#v
针对已经存在issues的project，修改工作流可能会引起状态等信息的丢失，所以最好先做好JIRA数据的备份以免发生意外。（我修改过1000个issues的project的工作流，JIRA可以很好的处理，不用因为有警告而太紧张，不过事先备份是必须的操作）
U g7V!h0i;\+Q
B0另外Project配置界面有很多scheme可配置，方法是类似的，后面不再详细描述。可以配置的scheme包括：51Testing软件测试网 E.B2y+V#k)tk
Issue Type Scheme51Testing软件测试网9Ti5m7^9AS._5y6w
z
Notification Scheme
d
Bx2T4^ qf%j @0Permission Scheme51Testing软件测试网'RwjO$ryJ
Issue Security Scheme51Testing软件测试网 xq/|0IYQ#G v0ch
Field Configuration Scheme51Testing软件测试网{Z:?k u&oxh R
Issue Type Screen Scheme51Testing软件测试网$T @!P
u"i C
Workflow Scheme
S\$~
U X ED}`6L05.3 自定义权限51Testing软件测试网 t9P!|
}P'~!Z
JIRA中的权限包括两部分：Global Permission和Project Permission，前者已经描述，配置也相对简单。本节描述的是后者。
.g&R,D!uj0通过ADMINISTRATION—Schemes—Permission Schemes进入配置。系统定义了一个Default Permission Scheme，并且这个scheme中的权限是可以直接进行修改的，点击Operations—permissions进行修改。JIRA将权限分细项列表在配置界面中，通过Operations中Add链接或者页面上方的Grant Permission进行权限增加，通过Delete链接删除赋予给特定对象的权限。
'J w I O6F1E05.4自定义字段51Testing软件测试网:v4Ulu ]%Q[x
通过ADMINISTRATION—Issue Fields—Custom Fields进行配置，点击Add Custom Field进行字段添加，再下一步是选择字段的类型，常见的字符型、数字型、日期型、下拉框、双重下拉框、多选框、单选按钮等等JIRA都支持。51Testing软件测试网 b n?Lh6VE!~Rk%I
我们选择Text Field (< 255 characters)做个测试，之后天上字段名称、字段描述。Search Template表示该字段使用的搜索类型，如果选择None，这个字段将不会出现在Find Issues里面的查询条件中，即对该字段将不能进行查询。后面还有两个选项：issue types，projects，目的是让这个自定义的字段出现在特定的issue type和特定的项目中。点击Finish之后会得到如下屏幕：
!SYB#@#qSB E,z ~._0
#w _ _J;d{4ms0这个设置屏幕是将添加好的自定义字段加入到特定的界面中，选择需要显示该字段的界面点击update即可完成设置。设置完得到如下界面：
;E1F'\v5T2e;n i K051Testing软件测试网/Z z/cx/lN ze
Configure链接可以进行issue types, projects设置，Edit可以进行字段名称和search template修改，Screens可以对字段出现的界面进行配置。51Testing软件测试网 h6p H8Gr?
注意：
fk6e(] Ty u01. 定义好的字段是不能修改字段类型的!
"j I2|-G/f nY02. Text Field类型存在一个Bug，如果对该字段填值都是数字，比如输入300，之后通过Filter来搜索issue将会失败，但是如果输入L300, 然后通过L300来搜索是可以搜索到相应issue。51Testing软件测试网m%dI:R#nP'?v
5.5 自定义界面(Screen)
ok E+B0Cd3js"o0通过ADMINISTRATION—Issue Fields—Screens进行配置，系统自带有三个Screen，通过Operations中的Configure可以进入配置界面，在这个界面中可以进行字段的增删、字段顺序的排列。51Testing软件测试网 M^C6c lc9P8I
}1zX#s
5.6 自定义事件通知51Testing软件测试网&t,m,gw1_
通过ADMINISTRATION—Schemes—Notification Schemes进行配置，系统默认的通知策略是当任意事件发生时都会通知Reporter、Assignee和Watchers。
/uCX H f9m8a b05.7 和代码库(SVN,CVS)关联51Testing软件测试网@H FC L5^"b C7I
在测试过程中tester提交了一个bug，developer解决了这个bug，同时提交了几个java类，如果你想看到针对这个bug项目里面的代码做了哪些修改，jira-subversion plugin就发挥作用了。安装好subversion plugin之后，只需要developer在做svn commit的时候在comments里面写上jiraid，在jira的subversion tab里面就会显示这个comments和这次提交的文件。51Testing软件测试网;F&I` `9d5r)Tz n^
!YrJ/Am&k;w@R1A0注：51Testing软件测试网'_;j#[
X!Qv
目前最新的atlassian-jira-subversion-plugin-0.10.3 不支持svn 1.5，不过通过升级svnkit到1.1.8以上版本就能解决这个问题51Testing软件测试网9[/g#C)J:WU
5.8 和Fisheye关联
hm*U P0vI Cb$?0而jirafisheye plugin则是将fisheye的功能集成到jira中，同时也是随jiraid来显示版本的变更记录：
Y0qta M\:V0
$~q
[ j h%O,P n U x0Fisheye plugin配置时，记得在fisheye管理界面中把Remote API设置成ON，要不然plugin连不上fisheye的！51Testing软件测试网 b#C
dz6m;T(jd
5.9 Sub-tasks51Testing软件测试网j5c8M N}l.Ed
通过Global Settings—Sub-tasks来开通这个功能
8G \#N uk}05.10 Time tracking51Testing软件测试网C5U _ b u3q
通过Global Settings—Sub-tasks来开通这个功能，其中对一周几天，一天几个小时需要先定义好。
)g d A*b"K O/l)`2n0
P[2}#@%V*n
P i0JIRA的网站也有一个描述：Project Management Tool，用JIRA实现项目管理最重要的是开通Time tracking功能。
o%m1{UU
]q^CL0Activate Time tracking功能之后在创建issue时多了一个字段：51Testing软件测试网*R _$Y+C
Xq X?3M
51Testing软件测试网
^ z3uvaf
这个字段的含义是预估完成这个任务所需要的时间。
y:N0rLg Oe v0同时在处理issue时，多了一个操作：Worklog，如下图所示
4_@8bl n8@0y0
[2p3iH2Q0点击其中的Log work done进行工作日志的记录：51Testing软件测试网 B2d6U"\'Jl^
51Testing软件测试网A z[z'E.n J0H
记录之后在issue detail界面的work log Tab可以看到记录：
sj o%~BC0
Gc@(R^x2i0oI%a4w0开通Time Tracking之后，JIRA还提供了一个Time Tracking Report
qX)x&[ Z ?G:|0
0s K1zO9[m
e-T6^[1y?0报表如下图所示：
O(jF/Q'u2\T_l_W R0
as)k
M f0JIRA完全以时间来确定工作的进度，这种算法还得好好适应一下。51Testing软件测试网5R7f#Q,~!hm*?,~hf
5.11 备份、导入导出
i2H _rM o C0备份通过Import & Export-- Backup Data to XML来操作，导出路径写服务器上的绝对路径，Backup As Zip这个复选框选上则会将XML文件压缩成一个zip包。
0MWj&_zy(B H.F0导入则通过Restore Data from XML来操作，导入的文件可以是XML，也可以是zip。51Testing软件测试网na Od m-G(O'k$US
JIRA的导入导出都是基于XML格式，与数据库平台无关，这也十分方便系统迁移。
_i u0|"Y!Q M;b8d0同时JIRA还提供了定时的备份机制，通过ADMINISTRATION—System—Services可以看到这个后台的服务：
'j(~+@ m6b6G:m!O051Testing软件测试网T)IE}gPL
JIRA默认会在每12个小时进行系统备份一次，其数据安全还是很有保障的。
^:|4Mz @&vK#`05.12 系统优化
MdE L
Ex p
{ ]+c01. NT 服务修改JVM内存大小
]ekqX E0修改%JIRA_HOME%/bin/service.bat文件中的：
I)y4o+M|(o1R0"%EXECUTABLE%" //US//%SERVICE_NAME% ++JvmOptions "-Djava.io.tmpdir=%CATALINA_BASE%\temp" --JvmMs 256 --JvmMx 512 --Startup auto
Xo,AU s _4D0其中-JvmMs是最小内存数，-JvmMx是最大内存数，一般最小256，最大512足够了。修改完后执行
}7L;P9`.Kp?h{0service.bat remove 将原有的NT 服务删除(如果JIRA服务处于启动状态先停止服务)
p)uwI-QN v b+v0service.bat install 安装新的NT服务
!f cZ D f Cv5d`0启动新的服务即生效了
B a A o? I02. 非NT服务修改JVM内存大小
Q8Yv G4X9Bp/I0修改%JIRA_HOME%/bin下面的setenv.bat文件，修改JAVA_OPTS这个环境变量51Testing软件测试网-@ M'sR xm ty
set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m -Datlassian.standalone=JIRA-Dorg.apache.jasper.runtime.BodyContentImpl.LIMIT_BUFFER=true
OMEoVBa h-X rR0其中-Xms256m表示最小内存，-Xmx512m表示最大内存51Testing软件测试网 b0xu^ }S
3. 让JVM进行garbage collection51Testing软件测试网4i'l-CE!y
如果在使用JIRA时感到打开页面明显变慢，可能的原因是JVM内存吃紧，可以考虑进行手动garbage collection，操作如下
4P.S BF6~#d|0进入Administration-System Info，在Java VM Memory Statistics这栏可以看到如下图所示信息：51Testing软件测试网fJ$m C/W!h3b2a Q
E
51Testing软件测试网1}O;y!V r iW&x2N }u
如果Memory Graph中显示20% Free，甚至更低，点击右边的Force garbage collection后你会得到更到free的内存，一般来说之后打开页面会变快一些。51Testing软件测试网)na0DA%Yr'Y"e
6JIRA需要改进的地方
+X.@(v2^0{ I1R01. 上传附件时可以填一个comment，但是这个comment和普通的comment是没有任何区别的，它并不会和你上传的这个附件进行关联。当你想对这个附件加一些描述的时候，你只能在comment里面指明附件名称，这样才能手工关联附件和comment。
]
j8A]y%az02. Redmine的Calendar是一个非常不错的设计，将每一天的工作可以一目了然的区分开来，虽然在JIRA中也可以通过filter来实现，但还是不够直观，redmine的calendar样子见图：
Z'b'ITWC g V6u0
2h ~m9p V*P{(J0当然这个calendar结合到JIRA中可以好好改善改善，比如加上My Calendar只显示自己的活动，特定Group的Calendar，特定Project的Calendar等等。51Testing软件测试网 |H7n X-s
3. 关于comments在Redmine中有一个reply的功能，这个功能也是个不错的设计，JIRA中的comments是没有关联的，只能通过自己通过其中的含义来关联，不过一般来说这也足够了。
y)lY?M"v(LT,V(F04. 在work log中可以加上一个如TodoList中% complete字段，当问题的% complete达到100%时才算完成，而不是时间达到estimate的时间才算完成，其实JIRA的time tracking计算任务的进度算法真是太没道理了，需要大大的改进。
rfAsXJ7O^0源文档 ：http://www.mangbar.com/document/8a80809d1c1345f0011c54ce39231df951Testing软件测试网/G u T n op+Z K/ux ES
相关阅读:
- Linux下Jira+Mysql 安装 (NODDY820, 2007-7-18)
- What's JIRA? (积雨云, 2007-7-24)
- 以前写的一份BUG提交规范 (hjjlearning, 2008-6-06)
- 缺陷管理工具JIRA从入门到精通 (hjjlearning, 2008-7-01)
- 缺陷管理工具之一——JIRA入门使用手册 (hjjlearning, 2008-7-01)
- JIRA中文演示站点 (ydog, 2008-7-02)
- JIRA 用户使用指南 (cci_cci, 2008-8-05)
- BUG管理平台－JIRA平台的部署 (fishy, 2008-9-09)
- \从CSV文件导入JIRA (雪儿, 2008-9-16)
TAG: JIRA
标题搜索
日历
|
|||||||||
| 日 | 一 | 二 | 三 | 四 | 五 | 六 | |||
| 1 | 2 | 3 | 4 | 5 | 6 | ||||
| 7 | 8 | 9 | 10 | 11 | 12 | 13 | |||
| 14 | 15 | 16 | 17 | 18 | 19 | 20 | |||
| 21 | 22 | 23 | 24 | 25 | 26 | 27 | |||
| 28 | 29 | 30 | |||||||
我的存档
数据统计
- 访问量: 93530
- 日志数: 51
- 文件数: 2
- 建立时间: 2008-10-09
- 更新时间: 2019-03-06
