Scrum Sprint Widget

Purpose

This widget is for use with Bugs Dashboard v3.0 and above.

Before using this portlet, please read the post on integrating Bugzilla, ScrumWorks Pro, and Bugs Dashboard.

This widget keys on a custom field in Bugzilla which is used to associate a bug with a particular sprint. See our How-to Integrate Bugzilla, ScrumWorks Pro and Bugs Dashboard guide for instructions on how to configure Bugzilla with a custom field and then integrate it with ScrumWorks Pro and Bugs Dashboard.

Screenshots


Although ScrumWorks Pro is not required to use this portlet, we strongly recommend it for Scrum teams.


If there are no bugs on file for a sprint, you will receive a polite message.


If you do not configure Bugzilla with a custom field or the field you specify in your properties cannot be found, you will receive a message informing you of the need to configure Bugzilla first.

Installation

Notes:

NOTES

  1. This version will only work with Bugs Dashboard v3.0 and up due to the use of the parameter to restrict this widget to a specific product if desired.
  2. This assumes that you have integrated Bugzilla and ScrumWorks Pro, although the latter is not necessary if all you want to do is report on a custom field in Bugzilla. Only bugs matching the custom field in the properties file (see step 2(a) below will be listed.

To use the ScrumSprint Portlet, do the following:

  • Copy the ScrumSprint.class file 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’re deploying.
  • Copy the scrumSprint_en_US.properties file (or the file appropriate to your locale) to the deployed web application classes directory; i.e. /webapps/bugs/WEB-INF/classes. Update this file to use the appropriate custom field you have defined in Bugzilla; i.e. customFieldName = YourBugzillaCustomFieldName where, if you added the field “cf_sprintName” to Bugzilla, this would be: customFieldName = cf_sprintName
  • Copy the ScrumSprint.css file to the deployed web application css directory; i.e. /webapps/bugs/css.
  • 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 statement: 
    <create creator="new" javascript="ScrumSprint">
  <param name="class" value="com.wmpnj.bugz.portlets.ScrumSprint" />
</create>
  • Update the portlets.properties file in the deployed web application classes directory; i.e. /webapps/bugs/WEB-INF/classes:
    • 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 Scrum Sprint to appear at the top of the right-most column, 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=Scrum Sprint Identified Issues
portlet0.column=2
portlet0.package=com.wmpnj.bugz.portlets.ScrumSprint
portlet0.className=ScrumSprint
portlet0.method=getText
portlet0.stylesheet=ScrumSprint.css
portlet0.javascript=
portlet0.desc=Lists bugs identified by a custom field as potential issues for use in ScrumWorks Pro.
portlet0.call=
portlet0.restrictTo=

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

Download

ScrumSprint.zip