wangwen 2008-5-27 14:32
【jira日记系列】创建图表报告插件
万万没想到 这篇文章脱了那么久 哎。。。。。力不从心啊 感觉个人的能力和精力不足
该邀请一些人来帮助我了
首先感谢黄fy 洪山 小陶 给与我的帮助
接着感谢债主们没有在这段时间找我
最后这篇文章来自官方文档 但是不代表标准翻译
<>里面的是我个人使用的时候的经验 作为文档的补充添加进来
---------------------------------------------------------------------------------------------
注意
1如果你使用SQL Server 数据库，请使用1.2.10或者更高版本，其中修复了一个会引起search index lock 的问题
如果jira的Issues已经从外部系统得到:
2如果从外部系统(csv)导入问题,图表插件无法计算问题的决议日期,这个可能在以后的版本解决
3 这个插件不支持Sybase ASE
特征和描述
该插件提供JIRA的各种图表和报告
这些图表和报告提供一个直观表示的项目或者在不同上下文下已经保存的过滤器
通常,图表是
扼要复述一个保存的过滤器或者项目
为了X天前到当前的时期(创建!?)
提供的图表类型
Recently Created Issues 最近创建的问题
Created vs Resolved Issues 创建的VS解决的问题
Resolution Time 一个显示已经解决的问题的平均决议时间的柱状图
这是个非常有用的,向您显示随着时间的推移，
是否您的团队是变得更好或更糟的及时解决问题
Average-Age Open Issues - 一个显示问题未被解决的天数平均值的柱状图
这个图表显示了指定时间段（例如每天，每周）问题遗留的时间的平均值
Pie Chart - 显示来自项目或者过滤器由统计类型归纳的问题饼状图
问题可以按它的任一可统计的属性来归纳（例如 状态 优先级 等等）
Average Time in Status - 显示问题在一个状态的平均天数
Average Number of Times in Status - 显示（所有已经解决的）问题拥有某个状态的平均次数
Time to First Response - 显示在一个项目或者过滤器中问题被回应的小时数。
只适用于端口(比如没有收到报告的情况下) \\原文：Portlet only (i.e. not available as a report).
很晦涩 不是很理解
Time Since Chart - For any chosen date field, shows a bar chart with number of issues with the
chosen date field set on that date.
这个实在太难理解了。。。。貌似是汇总某个date field在不同的时间段里的数量
那位高手给个明确翻译
问题浏览器的图表视图
JIRA Charting Plugin 现在能够与你的问题浏览器结合
在搜索结果上点击'Chart'选项时 在问题浏览器试图上弹出一个即时的图表视图
你可以再弹出的图表视图上设置任何图表的配置
此图表插件会弹出一个图表视图，可以用它对任何可用的图表进行设置。
你可以通过一个步骤轻松的搞定你的图表和他的设置：创建一个named filter且保存这个图表到你dashboard上的任意页面.
自定义字段
Resolution Date ：必须进行设置 这个自定义字段除了索引问题的决议日期（为了在制图期间快速查询）
也同样允许你添加到搜索和过滤器中
举例：秀给我一周（前）或者30天（前）所有（完成）决议的问题。这个字段当然可以结合其他的查询字段
First Response Date 必须进行设置 这个自定义字段除了索引非报告者第一次写注释的时间日期（为了在制
图期间快速查询）
也同样允许你添加到搜索和过滤器中
Time in Status - Stores statistics about the amount of time/times an issue has spent/been in its statuses.
This field is used to generate the Average Number of Times Spent In Status and Average Time Spent In
Status Charts
这个。。。。实在太晦涩 我翻译不出来 只知道这个字段是用来处理各种次数和时间的平均值计算的
你必须在Headless Mode下运行java，做到这一点，是通过设置VM的参数 - -Djava.awt.headless=true
<貌似linux和UNIX服务器有关 详见[url=http://think.blogdriver.com/think/233258.html]http://think.blogdriver.com/think/233258.html[/url]
和[url=http://blog.csdn.net/cm4ever/archive/2004/09/22/113145.aspx]http://blog.csdn.net/cm4ever/archive/2004/09/22/113145.aspx[/url] win的服务器好像不用考虑这个问题>
使用和安装
1将插件的JAR复制到JIRA web application的WEB-INF/lib 目录下 然后重新启动 JIRA
注意:1你再做下一步之前必须重新启动 JIRA
2这三个字段必须按照各自的自定义字段类型添加(不要用Date Picker添加他们)
<就是说不要添加Date Picker然后名字叫做Resolution Date等
虽然Resolution Date的searcher 还是Date Pick的 >
2 Administration > Custom 添加一个新的Resolution Date类型的自定义字段,
不要添加他到任何的workflow transition screens(例如 Resolve screen)
但是如果你想要的话你可以让他在默认的("问题导航栏")screen显示
建议: 自定义字段的名字叫 "Resolution Date"
警告: 正确的设置 searcher为 "Date Picker" (好处: 意味着你能按照 date resolved搜索和过滤)
3 Administration > 添加一个新的 Date of First Response类型的自定义字段. 不要添加他到任何的
(transition) screens.
警告: 正确的设置 searcher 为 "Date Picker" (好处: 意味着你能按照 date of the first comment搜索
和过滤!)
<该值将第一次comment的时间认为第一次Response的时间
据本人试验 Administration添加comment 不会更新该值>
4 Administration > 添加一个新的 Time in Status 类型的自定义字段. 不要添加他到任何的
(transition) screens.
警告: 正确的设置 searcher为 "Free Text Searcher" (注: 不要期望它显示在任何的screens,它不是
以人类可读的形式存储的)
5 Administration > Indexing 进行re-index
现在你可以创建需要的图表了
---------------------------------------------------------------------------------------------
插件下载地址：[url=http://confluence.developer.atlassian.com/plugins/servlet/proxy-counter/com.atlassian.jira.ext.charting/29/http://svn.atlassian.com/svn/public/contrib/jira/jira-charting-plugin/jars/jira-charting-plugin-1.3.13.jar]http://confluence.developer.atlassian.com/plugins/servlet/proxy-counter/com.atlassian.jira.ext.charting/29/http://svn.atlassian.com/svn/public/contrib/jira/jira-charting-plugin/jars/jira-charting-plugin-1.3.13.jar[/url]
[[i] 本帖最后由 wangwen 于 2008-5-27 14:37 编辑 [/i]]
scmscmscm 2008-6-11 13:47
图表的PlugIn如果和过滤器（Filter）一起使用，会有更丰富的结果。
比如可以先做一个过滤器：最近3天创建的Issue。
再用图表的功能，让它按模块分类。
于是就得到一个图，显示了最近3天各模块分别创建了多少个Issue。
angieny 2008-6-12 16:15
::em31::
按照楼主的写的设置了插件！
配置这个插件后，JIRA的图表报告丰富了很多呢~~
真的很好用~~支持下
感谢楼主的分享！