jira手册续

5.4定制Navigator Columns

点击某个Filter进行issue查询，查询列表中的显示字段可以进行定制，可供的选项有：增加字段、减少字段、编排字段先后顺序。JIRA默认的字段包括： T,Key,Summary,Assignee,Reporter,Pr,Status,Res,Created,Updated,Due ，其中T是issue type, Pr是Priority， Due是Due date。默认的排序是按照Key倒序排列。

通过列表上方的Configure链接来进行定制，如下图：

进入后的界面如下图：

 

注：

JIRA管理员通过同样的方法来设置Navigator Columns，操作入口是：ADMINISTRATION-Navigator Columns

 

5.5     Watch和Vote

1.      Watch

Watch是JIRA提供的一个关注Issue的功能，如果你正在Watching某个issue，那么按照JIRA的默认通知策略，这个issue的任何改动都会通过邮件通知你。通过issue明细页面左下方的Operations中Watch it链接来添加关注的issue，如下图

 

如果你想让别人关注这个问题，可以通过issue明细页面左上方的Watchers后面的数字提供的链接进入添加关注人的页面

 

2.      Vote

Vote是JIRA提供的一个投票功能，可以通过issue明细页面左下方的Operations中Vote for it链接来投票，票数越多表示这个issue希望解决的人越多。不过自己汇报的问题是不能自己投票的。

JIRA在BROWSE PROJECT界面中提供了一个Popular Issues来按投票数目多少排序显示这些问题，如下图所示：

 

5.6 Issue Link

Issue link可以让相关的issue关联在一起，并且关联的联系方式是自定义的，最常见的一种联系是重复问题。

Issue linking功能在默认设置下是关闭的，可以让JIRA管理员打开并添加一个Duplicate的联系方式。在有issue link权限的情况下，可以通过issue明细页面的Link链接来建立link，如下图：

 

在Link Issue页面中选择duplicates还是is duplicated by，Issues中填关联的另外一端的issue key，如下图：

 

添加好Link之后在issue明细页面可以看到如下的样子：

 

5.7    导出、打印Issues

JIRA在列表和明细界面提供了导出Word、导出Excel、打印页面的功能

1.      列表操作

 

在查询列表页面中如上图提供了一系列的操作，其中

Printable链接提供一个便于打印的简洁HTML页面，如下图

 

Full Content链接提供了一个便于打印的所有issues明细的HTML页面，如下图

 

Word链接可以将所有issues明细导出成word文档

Excel后面的两个链接：All fields导出所有字段为Excel，Current Fields导出当前字段为Excel

2.      Issue明细操作

操作链接在Issue Detail中，功能与明细中的Word和Printable链接是一样的，如下图：

5.8   制作报表

报表制作通过浏览项目界面中的报告下的单次分组报告链接进入，如下图：

 

进入制作报表界面后，可以选择不同的Filter和不同的统计类型进行报表显示，如下图：

 

制作完的报表如下图所示：

 

6   让你的JIRA更专业(For Administrator)

6.1      常用配置

6.1.1Users, Groups & Roles

用户和用户组已经在Quick Start中描述过。Project Role Browser中可以定制项目角色，JIRA提供的三种用户角色略显不够，一般的项目包括project managers, team leaders, developers, testers，不妨按照这个思路来添加项目角色。项目角色添加好之后可以通过Permission Scheme来对角色分配不同的权限

6.1.2Global Settings

l         General Configuration

这个配置界面有很多项目可以配置，每个项目JIRA都有说明，需要解释的有：

1.      Base URL，这个选项很有必要设置正确，JIRA会对描述、comments中的Issue KEY自动加上链接，如果Base URL不正确，所有的链接都将是错误的

2.      Indexing language，这个选项默认是English,在Character encoding是UTF-8的情况下，indexing language是English也没有影响，即使你在创建issue时使用了中文，也能建立索引

3.      Default language，安装好JIRA后第一次进入JIRA选择语言后可以通过这个地方来修改，正如之前说的，最好选择成英文。

4.      Options里面的选项没有特别要求使用默认设置即可

l         Global Permissions

这里的权限和项目中的权限是不同的，项目中的权限指的是创建issue、编辑issue等等，这里的权限是一些管理权限、创建filter的权限等与项目无关的权限

l         Look and Feel

这个地方可以打造你的JIRA的外观，包括配色、Logo、日期格式

l         Mail Servers

配置邮件服务器，可以配置SMTP或者JNDI

6.1.3Issue Settings

可以在ADMINISTRATION-Issue Settings中进行以下项目的配置：

Issue Types

Priority

Resolutions

Statuses

JIRA提供两种配置：翻译和编辑这些resolution。翻译可以适应多语言环境。编辑可以改变字段属性、排序位置、默认值、增删字段值等。这四个字段的配置都是类似的方法，参见JIRA提供界面应该不存在难度，以下列出配置中需要注意之处

l         配置Issue Types

系统自带的Issue Type包括：Bug, Task, Improvement, New Feature, sub-task .如果需要增加自己的问题类型，下面的Issue Types中进行配置。按照界面进行添加、编辑Issue Type，没什么特别。

但如果想删除已经添加好的Issue Type可能会碰到一些麻烦，当该Issue Type下存在issue的时候是不能删除这个Issue Type的。有两种办法来删除这个Issue Type

1.      编辑相应的Issue，将Issue Type改成其他不删除的Issue Type。当Issue被close之后将不能被编辑，所以这种方法存在限制。

2.      改变相应Project的Issue Type Scheme，这个scheme必须不包含待删除的Issue Type，在改变scheme的时候可能会报错，如下图所示：

 

这是因为操作用户没有权限，应该在Project Permission中增加move issue的权限给操作用户。之后按照向导进行操作即可。

l         配置Resolutions

通过ADMINISTRATION-Issue Settings中的Resolutions进行设置。

JIRA默认的Resolutions包括：

1.        Fixed

2.        Won't Fix

3.        Duplicate

4.        Incomplete

5.        Cannot Reproduce

基本上这五种解决办法已经足够了。

注意：

Resolution这个字段被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里面，即无法解决也是一种解决办法…

l         配置Priority

Priority的颜色、图标都是可以修改的，最常用的Major级别的颜色是绿色，不妨修改为警告色黄色可以引起更多的重视

l         配置Statuses

这个字段是供workflow使用的一个字段，当在做工作流配置时如果觉得状态不够，那在这里添加即可。状态可以关联Icon可以让查看issue时更直观，JIRA提供了17个图标，足够来挑选了。

6.1.4Options & Settings

1.      Send E-mail

可以通过这个功能给某个用户组或者某个项目的特定项目角色发送Email

2.      Announcement Banner

这个地方可以设置一个横幅在JIRA菜单栏下面，可以写上重要的使用说明、通知等等，支持HTML

6.2      自定义工作流

配置工作流之前请先定好Issue有哪些状态，状态的配置见常用配置--Issue Settings部分。

工作流配置从ADMINISTRATION-General Settings-Workflows进入，系统默认有一个叫做jira的工作流，这个工作流是只读的不能修改。但是可以以此为蓝本来建立工作流，通过Operations中Copy链接即复制了一个一样的工作流。点击Operations--steps进入步骤的设置，进入的界面如下图所示：

 

从图中看Open step，Linked Status表示执行完这个step后，issue的状态会变成Open，Transitions表示对于Open状态的issue可以执行的操作，Operations是设置时用到的链接。

下面以几个例子来说明如何配置工作流：

1.      我们认为Open状态的issue不能有Resolve Issue这个Transition，所以准备把它删除，点击Delete Transitions，之后在多选框中选择Resolve Issue，删除即可。

2.      对于Open状态的issues，Start Progress这个操作我们想控制它的权限，只有开发人员才能执行这个操作。通过点击Start Progress这个链接进入设置，我们看到在Conditions这个Tab中已经存在一个条件，含义是“只有assignee才能执行这个操作”，这个condition是合理的，保留。

 

我们通过点击Add链接来增加另外一个condition，之后会得到一个列表来选择condition的类型，开发人员才能执行同Project role比较接近，选择User is in Project Role。其实选择User is in group 然后配置一个开发人员组也是可以达到同样的效果。

 

在下一屏中选择Developers这个Project Role，添加完我们可以看到如下图所示的Conditions

 

JIRA默认将增加的condition用AND来连接，如果需要也可以将条件用OR来连接。

熟悉以上操作后，通过Add New Step，调整每个step关联的status就可以实现复杂的自定义工作流。

工作流定义好之后，还需要定义workflow scheme，这个工作流才能被项目引用。通过ADMINISTRATION-Schemes-Workflow Schemes进入配置界面，先增加一个scheme，然后在Operations中的Workflows链接中关联workflow。JIRA在workflow之外再包装一层scheme的意义在于可以针对不同的issue type使用不同的工作流，如下图。

 

为了简洁起见，我们一般选择All unassigned Issue Types对应一个工作流。

定义好workflow scheme之后才能被特定的Project所使用，通过ADMINISTRATION—Projects，选择需要配置的Project进行配置，如下图：

 

在Workflow Scheme中点击Select进行scheme的选择。在Associate的时候会得到一个警告：

 

针对已经存在issues的project，修改工作流可能会引起状态等信息的丢失，所以最好先做好JIRA数据的备份以免发生意外。（我修改过1000个issues的project的工作流，JIRA可以很好的处理，不用因为有警告而太紧张，不过事先备份是必须的操作）

另外Project配置界面有很多scheme可配置，方法是类似的，后面不再详细描述。可以配置的scheme包括：

Issue Type Scheme

Notification Scheme

Permission Scheme

Issue Security Scheme

Field Configuration Scheme

Issue Type Screen Scheme

Workflow Scheme

6.3      自定义权限

JIRA中的权限包括两部分：Global Permission和Project Permission，前者已经描述，配置也相对简单。本节描述的是后者。

通过ADMINISTRATION—Schemes—Permission Schemes进入配置。系统定义了一个Default Permission Scheme，并且这个scheme中的权限是可以直接进行修改的，点击Operations—permissions进行修改。JIRA将权限分细项列表在配置界面中，通过Operations中Add链接或者页面上方的Grant Permission进行权限增加，通过Delete链接删除赋予给特定对象的权限。

6.4      自定义字段

通过ADMINISTRATION—Issue Fields—Custom Fields进行配置，点击Add Custom Field进行字段添加，再下一步是选择字段的类型，常见的字符型、数字型、日期型、下拉框、双重下拉框、多选框、单选按钮等等JIRA都支持。

我们选择Text Field (< 255 characters)做个测试，之后天上字段名称、字段描述。Search Template表示该字段使用的搜索类型，如果选择None，这个字段将不会出现在Find Issues里面的查询条件中，即对该字段将不能进行查询。后面还有两个选项：issue types，projects，目的是让这个自定义的字段出现在特定的issue type和特定的项目中。点击Finish之后会得到如下屏幕：

 

这个设置屏幕是将添加好的自定义字段加入到特定的界面中，选择需要显示该字段的界面点击update即可完成设置。设置完得到如下界面：

 

Configure链接可以进行issue types, projects设置，Edit可以进行字段名称和search template修改，Screens可以对字段出现的界面进行配置。

注意：

1.      定义好的字段是不能修改字段类型的!

2.      Text Field类型存在一个Bug，如果对该字段填值都是数字，比如输入300，之后通过Filter来搜索issue将会失败，但是如果输入L300, 然后通过L300来搜索是可以搜索到相应issue。

6.5      自定义界面(Screen)

通过ADMINISTRATION—Issue Fields—Screens进行配置，系统自带有三个Screen，通过Operations中的Configure可以进入配置界面，在这个界面中可以进行字段的增删、字段顺序的排列。

6.6      自定义事件通知

通过ADMINISTRATION—Schemes—Notification Schemes进行配置，系统默认的通知策略是当任意事件发生时都会通知Reporter、Assignee和Watchers。

6.7      和代码库(SVN,CVS)关联

6.7.1和SVN的关联

Ø         svn和jira的集成的时候需要下载Subversion+JIRA+plugin的插件儿首先进入下面的页面看详细说明

https://studio.plugins.atlassian.com/wiki/display/SVN/Subversion+JIRA+plugin

Ø         当打开上面的页面后找到”JIRA Compatibility Table“这个对照表

 

根据兼容表来下载兼容的版本插件儿

Ø         这里我用的jira版本是3.13.4版的jira,故需要下载Subversion+JIRA+plugin为atlassian-jira-subversion-plugin-0.10.4.2版的plugin.

Ø         安装说明：

1)        复制jira的web-inf/lib目录下的atlassian-jira-subversion-plugin-*.jar

svnkit-*.jar, trilead-ssh2-*.jar,移除掉任何以前的版本的jar

2)        修改subversion-jira-plugin.properties的配置文件

3)        复制subversion-jira-plugin.properties到jira下的web-inf/classes下

4)        重新启动JIRA

Ø         当安装成功后,访问页面http://localhost:8080/,若测试中提交bug，developer解决了这个bug，同时提交了几个java类，如果你想看到针对这个bug项目里面的代码做了哪些修改，jira-subversion plugin就发挥作用了。安装好subversion plugin之后，只需要developer在做svn commit的时候在comments里面写上jira id，在jira的subversion tab里面就会显示这个comments和这次提交的文件。

 

6.8      和Fisheye集成

Ø         首先进入下面的页面看详细说明

https://studio.plugins.atlassian.com/wiki/display/FISH/FishEye+for+JIRA+Installation+Guide

Ø         当打开上面的页面后找到”JIRA Compatibility Table“这个对照表

 

根据上面的JIRA文件的对照表来下载相兼容的plugin 版本.

Ø         根据jira的版本是3.13.4版本，故需要下载plugin插件儿,2.5.3版本。不同版本的jira-fisheye-plugin插件儿的安装方式都不一样，这里主要针对jira-fisheye-plugin的安装说明：

1)        复制jira-fisheye-plugin-2.0.jar和atlassian-p4package-2007.12.14.jar到jira的webapp下面的web-inf/lib

2)        从web-inf/lib目录中删除以前的类似jira-fisheye-plugin-1.x.jar的jar文件

3)        若你以前安装过JIRA Perforce plugin插件儿，则需要移除掉web-inf下面的类似atlassian-jira-perforce-plugin-x.x.x.jar和

atlassian-p4package-2006.12.5.jar的jar文件

4)        重新启动jira

 

Ø         下载fisheye1.6.5版本，下载完成后进行解压然后进行破解。

Ø         都配置成功后jira fisheye plugin则是将fisheye的功能集成到jira中，同时也是随jira id来显示版本的变更记录：

 

Fisheye plugin配置时，在fisheye管理界面中把Remote API设置成ON，要不然plugin连不上fisheye的！

6.9      Sub-tasks

通过Global Settings—Sub-tasks来开通这个功能