| Name | Release Status |
|---|---|
| Version | 2.4.3 |
| Product Versions | 3.13 |
| Author(s) | Henri Yandell/SourceLabs, Inc. |
| License | Apache License, 2.0 |
| Download/Bugs etc | JIRA Outlet |
This project uses the excellent famfamfam.com Silk icons.
Description/Features
A plugin providing three portlets - a release status portlet, a latest releases portlet and a releases project panel.
1. The first is a portlet for the JIRA dashboard that provides a status for a particular version. Its expected use case is for highlighting the next release of the major product(s) via a feature-list of:
- Handy stats on the activity in the last week
- Useful stats for due-date management
- Information on how close the project is to release
- Release health - will your last week's velocity see you hitting your release date
- Useful links to the release notes and the version workload
- Current user, all users or adaptive toggle - adaptive means that between 50% and 95% it's current user, otherwise it's all users
2. The second portlet lets you show the last N releases. Its expected to be of use to large JIRAs with many releases.
3. The third is a project panel that makes it easy to see the release history of a project. Its expected to be of use to projects that have had with many releases.
Release History
Version 2.4.3 was released on 4th of November 2008. There was one bugfix:
- JOUT-3 - Velocity Error with isVersionOverDue in Releases project tab
Version 2.4.2 was released on 30th of January 2008. There was one bugfix:
- RSP-71 - Nothing shows when a project has only 1 version
Version 2.4.1 was released on 28th of September 2007. There were two bugfixes, the second of which was an improvement over its fix in 2.4:
- RSP-68 - Fails to run under 3.11
- RSP-63 - No Version Descritpion Text Causes $version.description is not a valid reference Exception
Version 2.4 was released on 4th of August 2007. There were four improvements and three bugfixes:
- RSP-56 - Show a tick or a cross if at 100% or if the release date has been missed
- RSP-57 - Need way to click on progress bar when it's small
- RSP-58 - 'smart' default for currentuser/all
- RSP-60 - Random project Release Status
- RSP-61 - Right arrow is not vertically aligned to top when there's no emoticon
- RSP-62 - Velocity Error with isVersionOverDue in Jira 3.10
- RSP-63 - No Version Description Text Causes $version.description is not a valid reference Exception
Version 2.3.1 was released on 28th of July 2007. There were two bugfixes:
- RSP-55 - Release Status Portlet generates exceptions under Jira 3.10
- RSP-7 - Releases project tab links to unresolved issues, not all issues
Version 2.3 was released on 19th of April 2007. There were four bugfixes:
- Latest Releases portlet was not showing more than one release for the same day
- Release Status portlet links were not changing under current user mode
- The Release Status portlet now ignores archived versions that are not released when deciding on a default version for a project
- The direct link for the Release Status portlet was failing with an NPE when the portlet was showing just the one version
Version 2.2 was released on 13th of April 2007. It provided various bugfixes and small feature enhancements, including:
- The Release Status portlet allows a project to be specified to show the status of all releases in that JIRA project
- Tooltips are now escaped in case descriptions contain HTML
- The Latest Releases portlet allows Future Releases and/or Overdue Releases to be shown
- User's permissions to see projects is better heeded by both the Release Status portlet and the Latest Releases portlet
- The Release Status portlet shows the total number of issues in a project
- The number of issues In Progress is shown
- Anonymous viewing is better
Version 2.1 was released on 27th of March 2007. Its main focus was a beefed up release status portlet with:
- Now supports more than one version, allowing you to create version chains
- The new top bar containing:
o project name
o current-user/all-users toggle
o links to the release notes and the version workload report
Version 2.0 was released on 17th of March 2007. It added the latest releases portlet and the releases project panel.
Version 1.0 was released on 16th of March 2007. It just contained the release status portlet.
Installing & Using
Install the plugin by downloading the plugin jar, place it in your $JIRA/WEB-INF/lib/ and giving your JIRA a restart.
Once it's installed you can add the to your dashboard by selecting the Release Status portlet and the Latest Releases portlet. The Releases project tab is automatically added to your browse project pages. Please follow the instructions from Atlassian for configuring your personal dashboard or the default dashboard.
Previously Asked Questions
- What's happiness? (or... The secret to happiness)
- Obviously you're all wondering what makes happiness. How does one tell the health of a project. What secret bit of wizardry and hours of cpu-intensive magic is this portlet doing???
- Fortunately, here at CBA Industries we decided to take the simple approach to happiness. It's simply: "If the project continues to maintain the velocity of the last 7 days, will it hit its release date?". Nothing fancy, nothing special and something to be taken with a LOT of salt. Amongst its limitations it includes non-work days as if they were normal days and it treats all issues the same regardless of estimate.
- How do I see the open issues?
- Most of the items in the release portlet are clickable. To see the current open issues, click on the green part of the progress bar. To see the closed issues, click on the red part. To see all the issues in a version, click on the version name.
- How do I configure a list of versions?
- Versions are added via a comma-separated list of ids on the portlet configuration page. Version ids can be found by mousing over a version link pretty much anywhere in JIRA (it will be called fixFor or version in the URL). You will see the link in the status bar at the bottom of your browser (you may need to turn on the Status bar).
Comments (62)
Mar 27, 2007
Bob Swift says:
Release status portlet is very nice! Thank-you. Updated to 2.1 to get the chai...Release status portlet is very nice! Thank-you. Updated to 2.1 to get the chain of releases. I added a few versions ids (blank/line separated) to the configuration, but, still only get the default with no arrows.
Apr 05, 2007
Henri Yandell says:
It's a comma separated list rather than one per line; with hindsight that seems ...It's a comma separated list rather than one per line; with hindsight that seems a daft decision
For the moment I've updated the description to specify:
"Comma separated list of versions to provide statuses for. If a version is specified above, it will be the default version. "
I'll also add it to the "Previously Asked Questions" section on the webpage when I make a new release (soon, though nothing major in it).
Thanks for highlighting that I wasn't explaining that at all Bob!
Apr 05, 2007
Bob Swift says:
Thanks - that is easy enough! Should have tried that since I use that technique...Thanks - that is easy enough! Should have tried that since I use that technique all the time too! Can't verify now since I am back on 2.0 level.
Mar 27, 2007
Bob Swift says:
Getting a NPE when I try to use 2.1 with Confluence jiraportlet macro. Works ok...Getting a NPE when I try to use 2.1 with Confluence jiraportlet macro. Works ok with 2.0 . This is what is in the jira log:
Apr 05, 2007
Henri Yandell says:
I'll put this on the to-investigate list. I had a play with the jiraportlet macr...I'll put this on the to-investigate list. I had a play with the jiraportlet macro and the various portlets, but it's not a part of my usual testing process (which is to hit things with Firefox and IE7 and be happy its 2007
).
May 08, 2007
Bob Swift says:
Any update on this issue? Still a problem.Any update on this issue? Still a problem.
Jul 04, 2007
Henri Yandell says:
Recorded as: https://jira.sourcelabs.org/jira/browse/RSP-50Recorded as: https://jira.sourcelabs.org/jira/browse/RSP-50
Jul 31, 2007
Henri Yandell says:
Looking at this Bob, I can't reproduce it. I'm in quite a dated version of Confl...Looking at this Bob, I can't reproduce it. I'm in quite a dated version of Confluence - 2.1.1. Which version of Confluence are you on where you get the NPE? What's your input?
Are you including the os_username, os_password parameters?
I do notice that it stretches off to fill the page, and that the javascript stuff is completely broken as per other comments.
Mar 27, 2007
Bob Swift says:
For use in Confluence, it would be nice to have the portlet be compact. Now it ...For use in Confluence, it would be nice to have the portlet be compact. Now it spreads itself over the entire page width and does not look very good. A good example is the single project portlet.
Apr 03, 2007
Vincent Eggen says:
Very cool plugin. It's very promising. Having tried them a little bit, here is ...Very cool plugin. It's very promising.
Having tried them a little bit, here is my first feedback:
Apr 05, 2007
Henri Yandell says:
Thanks for the list Vincent. What kind of things would you want in a Future R...Thanks for the list Vincent.
The way I use the release-status portlet at work is to chain together both past and future releases, with the current release being the central one. I'm planning to make that easier to configure for projects who want all versions within that project to be in the chain, with the next planned release-date being the one to focus on.
Apr 05, 2007
Vincent Eggen says:
Thanks for your answer. Regarding the Future Releases portlet, it can be as sim...Thanks for your answer.
Regarding the Future Releases portlet, it can be as simple as the Latest Release one, but simply reporting the list of next releases from the current date. If we can also select a list of projects in the scope of the portlet, it's even better.
I think your guess is rigth for the project description issue: the "embedded" html created by our PM is breaking the mouseover. A simple
breaks the view.
For the sub-task issue, it's definitelly related to a usage pattern: we do feature driven development using Jira. And we do our estimates right at the parent issue level. Sub-tasks are only used for intra-team cooperation purpose.
I guess we are not alone working that way in the Jira community
Apr 13, 2007
Henri Yandell says:
See the 2.2 release Vincent. Future releases is now supported, and the embedded...See the 2.2 release Vincent.
Future releases is now supported, and the embedded HTML issue should be taken care of.
Apr 19, 2007
Vincent Eggen says:
Installed and quickly tried them: great job! I've briefly demoed them to some ...Installed and quickly tried them: great job!
I've briefly demoed them to some selected users and their feedback is very positive. You're filling an unexpected gap here.
I did only a few tests but I noticed some strange behaviours about the release table portlet, depending on the kind a config are passed to it. I'll dig in deeper and come back to you with a more precise feedback.
The release status is very promising and despite the basic approach regarding the velocity calculation, it's already one of the most expected new feature by our PMs. From my perspective, the capacity to remove by configuration the subtasks from the portlet's scope is the next great improvement.
I've also noticed a regression in the release status portlet: the portlet url (the one in the top left of the portlet in the dashboard configure mode) doesn't work. I don't know for other Jira/Confuence users, but here, most of our people are using this url to make anonymous access to some specific portlets in order to share them. The portlet url is often embedded in shared wiki pages or documents. It was working with the previous version. Did the anonymous access changed something about this ?
In any case, many thanks for your velocity and your capacity to integrate people feedback in your efforts. I'll keep you in touch with my tests results.
Apr 19, 2007
Henri Yandell says:
I can replicate the regression - it only seems to be a problem for the portlet w...I can replicate the regression - it only seems to be a problem for the portlet when there is only the one version set; which is a relief as the next/previous arrows use that same url
I'm getting a NPE in the logs, so it shouldn't be a tricky one to fix. I'll also get working on the TreeMap bug too. Thanks for finding both of those.
The subtask feature worries me speedwise; currently I use the getSearchCount (or whatever the method name is) feature of the API. Basically getting the values from the indexes. To ignore subtasks I think I'll have to walk all the issues and that could suck mightily for speed. Still - it's on the drawing board, as I'd like to have the opposite of ignore subtask parents. Just a chunk of code. Same kind of thing is needed for my current feature attempt, to allow an unversioned version.
Hopefully I'll have a bugfix release out soon.
Apr 19, 2007
Vincent Eggen says:
Ok, I found an issue with the Release table: when multiple jira projects have re...Ok, I found an issue with the Release table: when multiple jira projects have releases with a similar release date, the release table only shows one of these releases.
I guess it's due to the use of the release date as the key of the TreeMap collection of versions
Apr 19, 2007
Henri Yandell says:
This should be fixed in today's 2.3 release, as should the portlet url giving a ...This should be fixed in today's 2.3 release, as should the portlet url giving a white screen and a couple of other bugs.
Apr 04, 2007
Adam Bugaj says:
Hellp me What i shoul put in field Version ID: the name of Reales or...Hellp me What i shoul put in field Version ID: the name of Reales or whta?
Apr 05, 2007
Henri Yandell says:
The Version ID. I've tended to rely on typed in IDs rather than trying to have a...The Version ID. I've tended to rely on typed in IDs rather than trying to have a drop-down of all versions in the JIRA install. The easiest way to find one is to goto an issue in that version and mouse over the Fix Version or Affects Version link.
If it's Fix Version, then you'll see 'fixFor=10010' or somesuch in the URL. 10010 is your ID. If it's Affects Version then you'll see 'version=10010'.
Hope that helps.
Apr 16, 2007
hernan guelman says:
I know the answer will be no... but: will this work with JIRA version 3.6.2-#15...I know the answer will be no... but:
will this work with JIRA version 3.6.2-#156 ?
Apr 16, 2007
Henri Yandell says:
I think there's a good chance it will. I put 3.7.3 simply because that and 3.8 ...I think there's a good chance it will.
I put 3.7.3 simply because that and 3.8 are the JIRA versions that I develop/test on.
My plugins won't tend to work before 3.5 (I think) because I use the downloadable resources feature for various images, but 3.6+ is probably good. If you get the chance to try, I suspect other readers of this page would love to know.
Apr 18, 2007
hernan guelman says:
Well, I tried. I don't think my news are good. When I try to add the portlet, I ...Well, I tried. I don't think my news are good. When I try to add the portlet, I get the not so happy face below. The good news, removing the portlet makes everything ok again... The Releases tab works...
System Error
Cause:
java.lang.NoSuchMethodError: com.atlassian.jira.project.ProjectManager.getProjectObj(Ljava/lang/Long;)Lcom/atlassian/jira/project/Project;
Stack Trace: [hide]java.lang.NoSuchMethodError: com.atlassian.jira.project.ProjectManager.getProjectObj(Ljava/lang/Long;)Lcom/atlassian/jira/project/Project;
at com.sourcelabs.jira.plugin.portlet.releases.ReleaseStatusPortlet.getVelocityParams(ReleaseStatusPortlet.java:146)
at com.atlassian.jira.portal.PortletImpl.getViewHtml(PortletImpl.java:64)
at org.apache.jsp.secure.views.dashboard_jsp._jspService(org.apache.jsp.secure.views.dashboard_jsp:1133)
...Build Information:
Uptime: N/A
Edition: Standard
Version: 3.6.2
Build Number: 156
Atlassian Partner: null
Server Information:
Application Server: Apache Tomcat/5.5.9
Servlet Version: 2.4
at org.apache.jasper.runtime.HttpJspBase.service(HttpJspBase.java:97)
Apr 17, 2007
ian says:
Great plugin - thanks Henri. Would it be possible to have the option to display...Great plugin - thanks Henri.
Would it be possible to have the option to display the Release Status Plug-in information within the Release Table?
This would given a great overview of release activity past, future & overdue
Apr 18, 2007
Henri Yandell says:
Quite tricky I think Ian, if I'm understanding what you're suggesting. ie) some ...Quite tricky I think Ian, if I'm understanding what you're suggesting. ie) some kind of hidden div in the release table that you click on and it shows the release status.
It would be nice to provide a way for multiple release status's to live in one space - ie) Maybe a Projects drop down that lets you choose a project to do an auto-configure on. That would be a nice thing for JIRAs with lots of projects on-going.
Maybe with a random default project.
Apr 24, 2007
ian says:
I was thinking that the option would be in the Portlet Settings, e.g. Version De...I was thinking that the option would be in the Portlet Settings,
e.g. Version Detail: Summary or Detail
When Summary is selected, the table renders as it does now.
When Detail is selected, the table row which contains the version info (i.e. name, project, date) is replaced with the section from the status portlet (see image)
Jul 04, 2007
Henri Yandell says:
Recorded as: https://jira.sourcelabs.org/jira/browse/RSP-52 Though this seems q...Recorded as: https://jira.sourcelabs.org/jira/browse/RSP-52
Though this seems quite tricky to do without lots of duplication.
May 29, 2007
Juha Sadeharju says:
When using this plugin via jiraportlet in Confluence 2.5 and clicking an arrow t...When using this plugin via jiraportlet in Confluence 2.5 and clicking an arrow to display next version, it tries to execute javascript from the JIRA url, i.e. http://jira.server.com/jira/secure/javascript:getPortlet(..) resulting in an 404 error.
Looking at HTML is says a href="http://jira.server.com/jira/secure/javascript:getPortlet(...)"
I suppose correct URL would be a href="javascript:getPortlet(....)"
Jul 04, 2007
Henri Yandell says:
Recorded as: https://jira.sourcelabs.org/jira/browse/RSP-51Recorded as: https://jira.sourcelabs.org/jira/browse/RSP-51
Jul 12, 2007
Mark Derricutt says:
I noticed after upgrading to JIRA 3.10 that the portlet throws exceptions and ma...I noticed after upgrading to JIRA 3.10 that the portlet throws exceptions and makes a right mess of JIRA
I don't have the stacktrace handy off hand but will comment again in the morning with it. Is there a 3.10 compatible build on the cards shortly?
Jul 12, 2007
Henri Yandell says:
I've nothing planned, but as I need to upgrade various JIRA's I admin to 3.10, I...I've nothing planned, but as I need to upgrade various JIRA's I admin to 3.10, I'm going to need to look at this asap.
Could you raise it in the issue tracker?
https://jira.sourcelabs.org/jira/secure/Dashboard.jspa
Jul 27, 2007
Vincent Eggen says:
Exception confirmed on Jira V3.10. Affecting version 2.3 of the portlets. I had ...Exception confirmed on Jira V3.10. Affecting version 2.3 of the portlets.
I had to disable the Release Status and the Release Table portlets.
The Releases Project Tab works fine.
Any fixing date known already ?
Vince
Jul 29, 2007
Henri Yandell says:
The newly released 2.3.1 should fix this (and another small bug that happened to...The newly released 2.3.1 should fix this (and another small bug that happened to be in SVN).
Jul 29, 2007
Vincent Eggen says:
Great. I wasn't expected that much reactivity. Many thanks. VinceGreat. I wasn't expected that much reactivity.
Many thanks.
Vince
Jul 30, 2007
Vincent Eggen says:
Correction confirmed on 3.10. Many thanks. BTW, I also noticed a set of error m...Correction confirmed on 3.10. Many thanks.
BTW, I also noticed a set of error messages coming from the release table portlet:
2007-07-30 09:08:44,687 http-8080-Processor22 ERROR [velocity] Left side ($versionManager.isVersionOverDue($version)) of '==' operation has null value. If a reference, it may not be in the context. Operation not possible. templates/releases portlet/latestreleases.vm [line 4, column 59]Doesn't look blocking.
Any idea ?
Vince
Aug 02, 2007
J. Russell Noseworthy says:
I get an exception from Jira 3.10 when I use any version other than an integer w...I get an exception from Jira 3.10 when I use any version other than an integer with the 2.3.1 version of the Release Status portlet. E.g., our releases are named things like "1.0.55" or "dingo". Releases like that raise exceptions like this:
java.lang.NumberFormatException: For input string: "1.0.55"
at java.lang.NumberFormatException.forInputString(NumberFormatException.java:48)
at java.lang.Long.parseLong(Long.java:412)
at java.lang.Long.valueOf(Long.java:518)
at com.sourcelabs.jira.plugin.portlet.releases.ReleaseStatusPortlet.getVelocityParams(ReleaseStatusPortlet.java:183)
at com.atlassian.jira.portal.PortletImpl.getViewHtml(PortletImpl.java:68)
at com.atlassian.jira.web.portlet.bean.PortletRenderer.getNormalHtml(PortletRenderer.java:83)
at com.atlassian.jira.web.portlet.bean.PortletRenderer.renderPortlet(PortletRenderer.java:61)
The only thing I could get to not raise an exception was simple integers. Am I doing something wrong or is this in fact a bug?
Also, the Release Tables portlet gives these errors in the log when I use it:
2007-08-02 17:41:18,648 TP-Processor29 ERROR [velocity] Left side ($versionManager.isVersionOverDue($version)) of '==' operation has null value. If a reference, it may not be in the context. Operation not possible. templates/releasesportlet/latestreleases.vm [line 4, column 59]