The Atlassian Extension Spaces have been migrated to http://plugins.atlassian.com. These pages are now deprecated and will soon be deleted.

Agile Velocity Tracking plugin

Name Agile Velocity Tracking Report Plugin
Version 0.2.4 (12th December 2008)
Product Versions 3.2+ (this report depends on the JFreeChart display servlet which is only enabled in 3.2 and above)
Author(s) [Jon Pither], jon.pither@headrunner.co.uk, [Kieran Shaw], kieran.shaw@blackpepper.co.uk
Homepage Agile Velocity Tracking plugin
Price free!
License n/a
JavaDocs docs
Download JAR agile-velocity-plugin-0.2.4.jar, all versions
Download Source http://svn.atlassian.com/svn/public/contrib/jira/agile-velocity-plugin/trunk/

Description/Features

A report that will generate velocity tracking charts over versions.
Report displaying charts for Velocity Points tracking http://www.agilemanagement.net/Articles/Weblog/AgileEstimating.html. Versions are treated as iterations. The points are gathered from a custom field which must be added (choose which field to generate reports for when running report). Iterations can be of variable length. Forecasting is currently done on 'yesterday's weather.

You might wish to record your stories in Jira before you estimate them and so not take them into account until they are estimated. If you add a custom date picker field ("Estimation Date" perhaps) to your stories then the report lets you use that field for calculating when stories came into play rather than the issue creation date.

Filters can also be used to build the report.

0.2.3 added a new iterations project tab panel that displays a list of all iterations and the points assigned, completed and remaining for each iteration.

0.2.4 fixed iterations project tab where there were issues in an iteration without a "Story Points" custom field broke the tab

Brief Install Instructions

  1. Copy the jar into JIRA's WEB-INF/lib:
    • agile-velocity-plugin-0.x.jar
  2. Restart JIRA
  3. Login as administrator and go to page Administration > Issue Fields > Custom Fields
  4. Add a new field with the name "Story Points" to your screens (Important! Please name the field exactly Story Points! Story points, Points etc. won't work)
  5. You're done!

Screenshots

Screenshots





Labels

agile agile Delete
plugin plugin Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.

Comments (16)

 

  1. Oct 13, 2005

    Jon Pither says:

    Now you can set a start and end iteration, and choose the issue type to report o...

    Now you can set a start and end iteration, and choose the issue type to report on.

  2. Nov 17, 2005

    Thomas Van de Velde says:

    The 0.1.7 link is broken though. Cheers, Thomas

    The 0.1.7 link is broken though.

    Cheers,
    Thomas

    1. Nov 17, 2005

      Jonathan Nolen says:

      Committed the missing jar. The link should work now.

      Committed the missing jar. The link should work now.

  3. Dec 21, 2005

    Kevin James says:

    Does the custom field have to be of a particular type?  I've added a custom...

    Does the custom field have to be of a particular type?  I've added a custom number field called Points.  However, when I go to view the Story Accumulator and choose this custom Points field and some start/end versions, I get exceptions:

    Cause:
    java.lang.NullPointerException

    Stack Trace: [hide]java.lang.NullPointerException
    at com.headrunner.jira.plugin.report.agile.BurndownReport.generateReportHtml(BurndownReport.java:97)
    at com.atlassian.jira.web.action.browser.ConfigureReport.doExecute(ConfigureReport.java:69)
    at webwork.action.ActionSupport.execute(ActionSupport.java:153)
    at com.atlassian.jira.action.JiraActionSupport.execute(JiraActionSupport.java:51)
    at webwork.dispatcher.GenericDispatcher.executeAction(GenericDispatcher.java:132)
    at com.atlassian.jira.web.dispatcher.JiraServletDispatcher.service(JiraServletDispatcher.java:178)
    at javax.servlet.http.HttpServlet.service(HttpServlet.java:802)
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:252)
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:173)
    at com.atlassian.jira.web.filters.AccessLogFilter.doFilter(AccessLogFilter.java:51)
    If I select versions for my start and end which have not had any Points entered then it proceeds to display the charts.  Any ideas?

    1. Dec 22, 2005

      Jon Pither says:

      Kevin, The NPE occurs when you have a version included in the report that has n...

      Kevin,

      The NPE occurs when you have a version included in the report that has no release date. The release date of versions is used by the report to calculate which issues were created in which iteration - this is needed by the burndown report.

      We're looking to update the plugin so it either caters for versions without release dates, or handles the exception more gracefully.

      Thanks,
      Jon.

  4. Oct 04, 2006

    gregor beedie says:

    Hi I've installed the plugin but the Report: Story Accumulator page has no next...

    Hi

    I've installed the plugin but the Report: Story Accumulator page has no next button. It only has a cancel button.

    Is there something more to do to activate the plugin?

     Thanks

     Gregor
     

  5. Feb 02, 2007

    hebeidameng says:

    hi, I am fresh man. I just have one problem, how to use this plugin, such as w...

    hi,

    I am fresh man.

    I just have one problem, how to use this plugin, such as where to get the "Story Accumulator" page

  6. Apr 02, 2007

    Alisa Thomson says:

    What's the trick?  I installed the plugin, added the custom field and popul...

    What's the trick?  I installed the plugin, added the custom field and populated it.  I have my versions as iterations and I have release dates populated on my iterations.  When I use the Story Accumulator, it only shows 0.0.  I have over 1000 points entered.  Thanks in advance.

    1. Jun 07, 2007

      Dave Borgeest says:

      Make sure your 'releases' have been released. These reports don't tell you anyth...

      Make sure your 'releases' have been released. These reports don't tell you anything mid-iteration...

  7. Nov 19, 2007

    Kief Morris says:

    From the screenshot it looks like you can only generate a report for a single is...

    From the screenshot it looks like you can only generate a report for a single issue type? We have different types for feature requests and bugs, but need to track them combined. Is this possible with this plugin?

  8. Dec 20, 2007

    JulioB says:

    This works in Firefox 2, but in IE7 all I get is a blank page when I click on St...

    This works in Firefox 2, but in IE7 all I get is a blank page when I click on Story Accumulator

  9. Dec 21, 2007

    JulioB says:

    I don't get it.  I get charts with negative points for the backlog.  S...

    I don't get it.  I get charts with negative points for the backlog.  Something's screwy

  10. Jun 19, 2008

    Vishal says:

    I am using plugin version 0.2 on Jira 3.12.3 but getting following message: HTT...

    I am using plugin version 0.2 on Jira 3.12.3 but getting following message:

    HTTP Status 404 - Could not execute action [ConfigureReport]:org.jfree.text.TextBlock.setLineAlignment(Lorg/jfree/ui/HorizontalAlignment;)V<p><small><small><pre>java.lang.NoSuchMethodError: org.jfree.text.TextBlock.setLineAlignment(Lorg/jfree/ui/HorizontalAlignment;)V at org.jfree.chart.title.TextTitle.arrangeRR(TextTitle.java:491) at org.jfree.chart.title.TextTitle.arrange(TextTitle.java:450) at org.jfree.chart.JFreeChart.drawTitle(JFreeChart.java:1127) at org.jfree.chart.JFreeChart.draw(JFreeChart.java:1017) at org.jfree.chart.JFreeChart.createBufferedImage(JFreeChart.java:1215) at org.jfree.chart.JFreeChart.createBufferedImage(JFreeChart.java:1195) at org.jfree.chart.ChartUtilities.writeChartAsJPEG(ChartUtilities.java:404) at org.jfree.chart.ChartUtilities.saveChartAsJPEG(ChartUtilities.java:497) at org.jfree.chart.servlet.ServletUtilities.saveChartAsJPEG(ServletUtilities.java:265) at org.jfree.chart.servlet.ServletUtilities.saveChartAsJPEG(ServletUtilities.java:222) at com.headrunner.jira.plugin.report.agile.chart.HRChart.generateAndSaveChart(HRChart.java:35) at com.headrunner.jira.plugin.report.agile.BurndownReport.addCharts(BurndownReport.java:236) at com.headrunner.jira.plugin.report.agile.BurndownReport.generateReportHtml(BurndownReport.java:127) at com.atlassian.jira.web.action.browser.ConfigureReport.doExecute(ConfigureReport.java:109) at webwork.action.ActionSupport.execute(ActionSupport.java:153) at com.atlassian.jira.action.JiraActionSupport.execute(JiraActionSupport.java:54) at webwork.dispatcher.GenericDispatcher.executeAction(GenericDispatcher.java:132) at com.atlassian.jira.web.dispatcher.JiraServletDispatcher.service(JiraServletDispatcher.java:211) at javax.servlet.http.HttpServlet.service(HttpServlet.java:803) at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:269) at

    Note: Release date has been mentioned for the selected version.

    Regards,

  11. Oct 14, 2008

    Kieran Shaw says:

    Hi anyone/everyone, It looks like Jon Pither has disappeared so I've been added...

    Hi anyone/everyone,

    It looks like Jon Pither has disappeared so I've been added as a contributor to this plugin and will do my best to improve it and fix it.

    To start with, I've converted the plugin to use the new Maven 2 build process for Jira plugins which should make working on it easier.

    I've also fixed the bug that was causing negative stories/points in some charts. Basically it was looking for issues created during the iteration dates rather than issues assigned to that iteration.

    It also now supports String and Cascading Select custom field types for your story points field rather than just the Number field. I'll hopefully be adding more improvements soon. Any requests...let me know.

    1. Feb 10, 2009

      Andrew Myers [Atlassian] says:

      Hi Kieran, Are you still maintaining this plugin? The iterations tab hardcod...

      Hi Kieran,

      Are you still maintaining this plugin?

      The iterations tab hardcodes the "Story Points" custom field name in IterationsProjectTabPanel.java.

      If you do not have a custom field named "Story Points" the iterations tab dumps a nasty stack trace:

      An error occurred whilst rendering this message. Please contact the administrators, and inform them of this bug. Details: ------- org.apache.velocity.exception.MethodInvocationException: 
Invocation of method 'getPoints' in class co.uk.blackpepper.jira.plugin.agile.IterationImpl threw exception class java.lang.NullPointerException : null 
at org.apache.velocity.runtime.parser.node.ASTIdentifier.execute(ASTIdentifier.java:193) 
at org.apache.velocity.runtime.parser.node.ASTReference.execute(ASTReference.java:175) ...

      Since you can configure the custom field in the "Story Accumulator" it might be a good idea to allow some kind of configuration for the iterations tab (e.g. a properties file or something).

      -Andrew

  12. Sep 24

    Sandra McLeod says:

    I'm evaluating the beta 4.0 version of JIRA with Greenhopper.   Unfort...

    I'm evaluating the beta 4.0 version of JIRA with Greenhopper.   Unfortunately the velocity plugin doesn't appear to work with this version of JIRA.  I'm getting the following error:

         There was a problem loading the descriptor for module 'Story Creation Report' in plugin 'Agile Reports Plugin'. Error retrieving dependency of class: com.headrunner.jira.plugin.report.agile.BurndownReport.     Missing class: com/atlassian/jira/issue/search/SearchParameter

    Has anyone else been able to find a workaround that will allow the plugin to work with the newest beta version of JIRA?

    Thanks,

       -Sandra