4 系统配置
该部分主要以某公司对问题跟踪系统的需求作为案例,介绍如何根据实际需求,在JIRA中进行配置。本案例中涉及到缺陷跟踪和需求变更的跟踪管理两部分。
4.1 设置问题类型
问题来源 |
描述 |
缺陷(Default) |
系统本身的错误 |
Improvement |
在系统需求范围内,但是对表现/实现方式进行了改进。 |
Requirement Change |
对系统原先需求进行了变更,包括新增的需求、变更的需求 |
Issue |
平常讨论过程中发现的问题记录 |
Review |
评审中发现的问题记录 |
Noncompliance Report |
QA在审核过程中发现的不符合项记录 |
设置问题类型步骤如下:
1) “管理”-“Issue Settings”-“Issue Type”,进入“View Issue Types”界面
2) 进行问题类型的增加、编辑等操作,并点击“Default”设置默认值。。
4.2 设置工作流方案
1. 设置状态
缺陷处理流程,在JIRA中新增一个工作流设置(不要在原来的工作流上修改),并设置如下。
l 缺陷:
Step Name (id) |
Linked Status |
Transitions (id) |
Conditions |
Post Functions |
Open (1) |
Open |
分配缺陷(2) >>Assigned |
Assignee |
解决=null |
Assigned (2) |
Assingned |
接受本缺陷 (4) >> Accepted |
Resolve Issues |
|
Accepted (3) |
Accepted |
缺陷处理完毕 (5) >> Pending |
Resolve Issues |
|
Pending (4) |
Pending |
验证通过 (701) >> Closed |
Testers |
解决=1(目的是close时,将解决改为Fixed) |
验证不通过缺陷 (3) >> Assigned |
Testers |
解决=null |
||
确认暂不处理本缺陷 (711) >> Sleeped |
Assigners |
|
||
Closed (6) |
Closed |
激活缺陷 (3) >> Assigned |
Testers |
解决=null |
Sleeped (7) |
Sleeped |
激活缺陷 (721) >> Assigned |
Resolve Issues |
解决=null |
其中,“接受本缺陷”,选择“No view for transition” ,“验证通过”,选择“No view for transition”,“确认暂不处理本缺陷”选择“Add comment and assign”。
l 需求变更
Step Name (id) |
Linked Status |
Transitions (id) |
Conditions |
Post Functions |
Open (1) |
Open |
完成需求变更评估 (11) >> Evaluated |
Analyst |
|
Evaluated (2) |
Evaluated |
审核通过 (21) >> Assigned |
CCB |
|
审核不通过 (31) >> Open |
CCB |
|
||
Assigned (3) |
Assigned |
接受本需求变更 (51) >> Accepted |
Resolve Issues |
|
Accepted (4) |
Accepted |
需求变更实施完毕 (61) >> Pending |
Resolve Issues |
|
Pending (5) |
Pending |
验证通过 (71) >> Closed |
Testers |
解决=1(目的是close时,将解决改为Fixed) |
验证不通过 (81) >> Confirmed |
Resolve Issues |
解决=null |
||
Closed (6) |
Closed |
|
Testers |
|
其中,“完成需求变更评估”、“审核通过”、“接受本需求变更”、“验证通过”,选择“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状态对应的缺陷被改变状态。如下图所示:
问题类型 |
选择的工作流 |
Defect |
Defect Track |
Improvement |
Defect Track |
Issue |
Issue Track |
Requirement Change |
Requirement Change Track |
Noncompliance Report |
Noncompliance Report Track |
Review |
Review Track |
4.3 问题属性
1. 严重性
严重性 |
说明 |
Blocker |
灾难——导致系统失效,例如蓝屏或数据发生冲突 |
Critical |
重要——产品不可用,例如导致错误的答案和错误的报告 |
Major (default) |
中等——产品可用,客户说到影响 |
Minor |
轻微——产品可用,没有客户受到影响 |
Trivial |
无足轻重——如果时间允许则修复 |
设置步骤如下:
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. 优先级
优先级分P1-P5五个级别,其中,P1优先级最高,P5最低。
优先级 |
说明 |
P1 |
系统的正常业务流程无法通过,必须马上修改 |
P2 |
系统用户无法正确使用系统;导致用户对系统理解发生偏差;影响客户或公司的形象 |
P3 (default) |
系统用户无法使用部分非重要功能 |
P4 |
不影响系统的正常使用,发布后可以通过打补丁的方式解决问题 |
P5 |
问题对系统影响很小,可以不修改 |
设置步骤如下:
1) 选择“管理”-“Issue Setting”-“Priorities”,进入“View Priorities”界面
2) 对选项值进行编辑,并点击“Default”设置默认值。
3. 缺陷类别
内容 |
说明 |
程序错误 |
1. 由于程序所引起的死机,非法退出 2. 由于程序未做错误控制而引发的缺陷,如直接进入HTTP404/500界面 3. 因错误操作导致的程序中断或退出 4. 程序接口错误 |
功能实现偏差(default) |
1. 功能未达到详细设计说明书中标明的功能 2. 功能超出了详细设计说明书指明的范围 3. 功能未达到详细设计说明书虽未指出但应达到的目标 |
界面不友好 |
1. 功能可用,但是操作界面不友好、难于理解、不易使用、或者最终用户认为界面不好 2. 提示信息内容不友好、不准确 3. 界面不规范 4. 提示窗口文字未采用行业术语 |
数据错误 |
1. 数据被损坏或未传送到目的地 2. 数据通讯错误 |
文档缺陷 |
1. 文档所用的术语不适用于用户 2. 文档不完整 3. 文档未清楚的表达所描述的内容或内容不正确 |
设置步骤如下:
1) 选择“管理”-“Issue Field”-“Custom Fields”,进入“View Custom Fields”界面
2) 点击“Add Custom Field”链接,进入“Create Custom Field”界面
3) 选择“Select List”类型,Scope选择“Issue Type - issues of a specified type ”选项,点击《NEXT》按钮
4) 在“Field Name”域输入“Bug类别”,在“Choose Search Template”项选择“Select List Searcher”,点击《Create》按钮
5) 在“Edit Custom Field Options”页面,增加下拉框选项(如上表所属内容),完成后,点击《Done》按钮
6) 在“View Custom Fields”界面,“Bug类别”行,点击“Edit Defaults”链接,在弹出的页面中,选择该下拉框的默认值
注意:该属性Scope只能选择“Issue Type - issues of a specified type”项。
4. 解决方案
解决方案 |
描述 |
Fixed (default) |
缺陷已正确解决,并经过验证 |
Later |
该问题确实是个缺陷,但是本版本不解决 |
Invalid |
问题的描述不是个缺陷 |
Won't Fix |
该问题确实是个缺陷,但是不打算解决 |
Duplicate |
问题的描述是一个已经存在的缺陷 |
Cannot Reproduce |
按照描述的步骤,不能重现该问题 |
设置步骤如下:
1) 选择“管理”-“Issue Setting”-“Resolutions”,进入“View Resolutions”界面
2) 对选项值进行编辑,并点击“Default”设置默认值。
5. 平台
包括:DEC、HP、Macintosh、PC、SGI、Sun、Other。
设置PC为默认值。设置步骤同上。
6. 操作系统
包括:Windows 95、Windows 98、Windows Me、Windows 2000、Windows NT、Windows XP、Windows Server 2003、Mac System 7.5、Mac System 7.6.1、Mac System 8.0、Mac System 8.5、Mac System 8.6、Mac System 9.x、Mac OS X 10.0、Mac OS X 10.1、Mac OS X 10.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. 申请人
设置为:User Picker
10. 申请时间
设置为:Date Picker
11. 原始需求内容
设置为:Free Text Field
12. 业务分析结论
包括:不采纳该需求变更、接受本需求变更、未达成一致意见,继续进行业务评估。
13. 变更发生的业务背景
设置为:Free Text Field
14. 要求实现的功能
设置为:Free Text Field
15. 技术分析结论
包括:无法实现、可以实现、未达成一致意见,继续进行技术分析
16. 管理分析结论
包括:允许实施、不允许实施、未达成一致意见,继续进行管理分析
4.4 用户组和权限控制
用户组 |
描述 |
权限 |
Administrators |
管理JIRA中的项目、人员、删除缺陷、管理关注者列表 |
Administer Projects Modify Reporter Delete Issues Manage Watcher List |
Assigners |
修改缺陷、分配缺陷 |
Edit Issues Schedule Issues Assign Issues |
Developers |
处理缺陷、填写缺陷原估算工作量、填写缺陷实际处理工作量、管理关注者列表 |
Assignable User Resolve Issues Work On Issues View Version Control View Voters and Watchers Manage Watcher List |
Testers |
修改缺陷、移动缺陷、处理缺陷、管理关注者列表 |
Edit Issues Move Issues Resolve Issues(含Reopen Issues) Close Issues View Version Control View Voters and Watchers Manage Watcher List |
CCB |
变更控制委员会,进行需求变更的审核动作 |
Edit Issues Manage Watcher List |
Analyst |
业务分析,进行需求变更的处理 |
Edit issue Assignable User Schedule Issues close issue Manage Watcher List |
jira-users |
浏览项目(含缺陷)、登记缺陷 |
Browse Projects Create Issues Add Comments Create Attachments |
Anyone |
浏览项目(含缺陷) |
Browse Projects |
1. 设置用户组
设置步骤如下:
1) 选择“管理”-“Users & Groups”-“Group Browser”,进入“Group Browser”界面
2) 新增用户组:Administrators、Assigners、Developers、Testers
2. 设置权限方案
设置步骤如下:
1) 选择“管理”-“Schemes”-“Permission Schemes”,进入“Permission Schemes”界面
2) 新增一个权限方案(不要在默认权限方案上进行修改)
3) 在复制的权限方案上,点击“Permission”链接,进入“Edit Permissions”界面
4) 根据上表的权限分配,进行增、删、改。
注:只有Assigner角色可以分配缺陷。
4.5 设置邮件通知方案
活动 |
通知人员 |
登记缺陷 |
当前缺陷分配人 该缺陷的所有关注者 |
Bug更新/分配/解决/关闭/增加备注/重新打开/删除/移动 |
当前缺陷分配人 缺陷登记人 该缺陷的所有关注者 |
设置步骤如下:
1) 选择“管理”-“Schemes”-“Notification Schemes”,进入“Notification Schemes”界面
2) 复制Default Notification Scheme,并修改为合适的名称(不要在默认权限方案上进行修改)
3) 按照上述的说明,进行设置。
4.6 设置界面设计方案
1. 开启时间跟踪功能
设置步骤如下:
1) 选择“管理”-“Global Settings”-“Time Tracking”,进入“Time Tracking Setting”界面
2) 将“Hours Per Day”设置为8,“Days Per Week”设置为5。
3) 点击《Activate》键,完成开启时间跟踪功能。
2. 开启附件功能
设置步骤如下:
1) 选择“Global Settings”-“Attachments”,点击“Edit Configuration”链接,进入“Attachments Settings”界面,将“Allow Attachments”选项选择“On”,在“Attachment Path”输入框输入附件的保存路径,如f:\JiraTemp\Attachment
2) 选择“Issue Fields”-“Field Layout (System)”,进入“View Issue Fields”界面,选择“附件”项,点击“Show”链接
3. 设置界面设计方案
设置步骤如下:
1) 选择“管理”-“Issue Fields”-“Field Layout Schemes”,进入“View Scheme Issue Fields”界面
2) 执行Edit、Hide、Required等操作。按照下述的说明,进行设置。
l 缺陷:
顺序 |
域 |
是否必填项 |
1 |
概要 |
是 |
2 |
问题类型 |
是 |
3 |
严重性 |
|
4 |
优先级 |
|
5 |
模块 |
|
6 |
缺陷类别 |
|
7 |
影响版本 |
|
8 |
修复版本 |
|
9 |
描述 |
|
10 |
平台 |
|
11 |
操作系统 |
|
12 |
附件 |
|
13 |
分配给 |
是 |
14 |
预期日期 |
|
15 |
时间跟踪 估算一个问题解决的时间期限. 格式是 ' *w *d *h *m ' (表示星期,天,小时,分钟 - * 表示可以是任意数字) 例如: 4d, 5h 30m, 60m and 3w. |
|
16 |
报告人 |
是 |
l 需求变更:
顺序 |
域 |
是否必填项 |
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, 5h 30m, 60m and 3w. |
|
21 |
分配给 |
是 |
22 |
预期日期 |
|
23 |
报告人 |
是 |
4.7 界面
1. 配置整体属性
设置界面的默认语言、Title等信息。
设置步骤如下:
1) 选择“管理”-“Global Settings”-“General Configuration”,进入“Settings”界面
2) 点击“Edit Configuration”链接,在进入的界面按下述设置执行修改。
内容 |
设置 |
Title |
Welcome to XX Issue Tracking System |
Base URL |
http://localhost:8080/jira |
Mode |
private |
Character Encoding |
UTF-8 |
Indexing Language |
English |
Default Language |
中文 (中国) |
Allow unassigned issues |
OFF |
2. 配置外部界面属性
设置公司logo(将logo文件存放在服务器p_w_picpaths目录下)、默认语言、Title。
设置步骤如下:
1) 选择“管理”-“Global Settings”-“Look and Feel”,进入“Logo”界面
2) 点击“Edit Configuration”链接,在进入的界面按下述设置执行修改。
内容 |
设置 |
URL |
http://localhost:8080/jira/p_w_picpaths/aboutus_1.gif |
Logo Width |
170 |
Logo Height |
78 |
Top Bar Colour |
#ffffff |
Top Text Colour |
#000000 |
4.8 其他
1. 修改timeout设置
修改atlassian-jira/WEB-INF/web.xml
<session-config>
<session-timeout>60</session-timeout>
</session-config>
将60(分钟)修改需要的时间。
2. 设置自动备份
设置每天进行一次备份。
设置步骤如下:
1) 选择“管理”-“System”-“Services”,进入“Services”界面
2) 在“Add Service”部分,输入如下信息
内容 |
设置 |
Name |
Backup Service |
Class |
com.atlassian.jira.service.services.export.ExportService |
Delay |
1440(即,24小时) |
3) 点击《Add Service》键,进入“Edit Service:Backup Service”界面,输入如下信息,点击《更新》键,即完成服务设置
内容 |
设置 |
Directory name |
f:\JiraTemp\backup |
Date format |
YYYY-MM-DD-HHmm |
Backup as |
Zip |
Delay |
1440 |