Bug Burn Down Chart Widget |

Home » Support » Dashboard Widgets » Bug Burn Down Chart Widget

Purpose

This widget was constructed to provide a Scrum like “burndown” chart for an individual bug. The following is a very simple chart showing an initial estimate and then several 1 hour entries against the bug.

Screenshots

You have the option of using a dropdown (see above) listing the bug id’s on file or a text input file (see below). Although you can restrict the portlet to a single product, it is still possible that the number of bugs on file is greater than a dropdown might easily handle. A property file allows you to change from a dropdown list of bug id’s to a text input box.

The dropdown can be replaced with a text input box for products with a larger number of bugs.

Installation

Note: This version will only work with Bugs Dashboard v3.2.2 and up due to the use of the “params” parameter. Furthermore, it will only work with Bugzilla 3.0 or above. This is because of the use of the fielddefs.id column. If you would like to use this with an earlier version, you will need to update the SQL statements.

To use the Bug Burndown Widget, do the following:

Copy both the BurnDown.class and BurnDownChart.class files at com/wmpnj/bugz/portlets into the deployed web application directory; i.e. /webapps/bugs/WEB-INF/classes/com/wmpnj/bugz/portlets. This may require that you also copy the directory “portlets” if this is the first portlet you are deploying.
Copy the burndown_en_US.properties file to the deployed web application classes directory; i.e. /webapps/bugs/WEB-INF/classes. The default input mechanism is a dropdown list. If you wish to use a text input box, edit the properties file so that the “input” property is “text”.
Update the dwr.xml file in the deployed web application WEB-INF directory; i.e. /webapps/bugs/WEB-INF. Edit the file with a text editor and add the following after the last </create> statement:
```
<create creator="new" javascript="BurnDown">
  <param name="class" value="com.wmpnj.bugz.portlets.BurnDown" />
</create> 
```
Update the web.xml file in the deployed web application WEB-INF directory; i.e. /webapps/bugs/WEB-INF. Edit the file with a text editor and add the following after the last <servlet> (you will find this just above the first <servlet-mapping> entry):
```
<servlet>
  <servlet-name>BurnDownChart</servlet-name>
  <servlet-class>com.wmpnj.bugz.portlets.BurnDownChart</servlet-class>
</servlet> 
```
Still within the web.xml file, move to the bottom of thesection and add the following (right above the session-config property):
```
<servlet-mapping>
  <servlet-name>BurnDownChart</servlet-name>
  <url-pattern>/burndownchart</url-pattern>
</servlet-mapping> 
```
Update the appropriate portlets.properties file in the deployed web application classes directory; i.e. /webapps/bugs/WEB-INF/classes for the portal you wish to use this class on:
- Update the first line by incrementing the count of portlets by 1
- Add the following in the position that you want the portlet to appear within your desired column. For example, if you want the BurnDown to appear at the top of the right-most column in a three column portal, you must insert this ahead of any other portlet whose column is “2″. After adding the following block, you MUST then renumber the portlets appropriately, beginning with 0, i.e. “portlet0″, “portlet1″.
```
portlet0.title=Bug Burndown Chart
portlet0.column=0
portlet0.package=com.wmpnj.bugz.portlets.BurnDown
portlet0.className=BurnDown
portlet0.method=getText
portlet0.stylesheet=
portlet0.javascript=
portlet0.desc=A burndown chart for the work performed on a particular bug.
portlet0.call=
portlet0.restrictTo=
portlet0.params=DWRUtil.getValue("burndown") 
```

You may change the title and column, but do NOT change the package, className, or method!

Download

BugBurnDown.zip