Using the Classic Agile Gadget

The Classic Agile Gadget allows you to view summaries of GreenHopper information from your projects directly on your JIRA dashboard. You can monitor the progress of versions, view charts and access common GreenHopper pages via the Classic Agile gadget.

 

 

Note that this page only applies if you are using the Classic Boards (which are no longer being actively developed; read more).

On this page:

Related pages:

•  Customising the JIRA Dashboard
• The big list of Atlassian gadgets

Screenshot: The GreenHopper Classic Agile Gadget

Adding the GreenHopper Classic Agile gadget to your JIRA dashboard

To add the GreenHopper Classic Agile Gadget to your JIRA dashboard,

1. Log into JIRA or navigate to your dashboard, if you are already logged in.
2. Click the Add Gadget link in the top right. The Gadget Directory screen will display.
3. Find the GreenHopper Agile Gadget in the list of gadgets and click Add it now.
4. Click the Finished button in the bottom right.
5. The GreenHopper Agile Gadget gadget will display on your dashboard. Enter the following setup details for your gadget:
   
   • Project or Saved Filter — the JIRA project or issue filter for which you want to display GreenHopper data.
     If you see the message "This filter contains too many issues", please ensure that you are not limiting your GreenHopper resources.
   • Display chart values — whether or not you want data points for the charts to be displayed in the gadget.
   • Display chart legend — whether or not you want the chart legend to be displayed in the gadget.
   • Refresh Interval — how often the data in the gadget will refresh.
6. Click the Save button. The GreenHopper Agile Gadget will display on your dashboard showing the cross-project burndown chart for the project versions specified in your issue filter.
7. The GreenHopper Classic Agile Gadget will refresh and display data for all unscheduled issues in your project. To display the desired GreenHopper data in your Agile gadget, configure the following:
   
   • Select a version from the version () dropdown. Defaults to 'Unscheduled'. Note, only unreleased versions can be selected.
   • Select a context from the context () dropdown. Defaults to 'Default'.
   • You can switch between the different types of charts by clicking the tabs above the charts (i.e. Hours, Issues, etc).
   • You can click the Info tab to view the same statistics as shown on the Planning/Chart Board.
     Due to a bug in the Agile gadget (GHS-3377), the 'Time Estimate' and 'Time Remaining' values on the 'Info' tab do not reflect the values of statistics shown on the Planning/Chart Board when viewing a project's version.
8. You can also access the main JIRA/GreenHopper views for your issues, via the icons in the top right:
   
   • Click the icon for the Issue Navigator view.
   • Click the icon for the Planning Board view.
   • Click the icon for the Task Board view.
   • Click the icon for the Chart Board view.

Tip: You can add the GreenHopper Classic Agile Gadget to your dashboard multiple times, if you wish to track multiple projects/versions.

 Note: The Agile gadget will automatically append 'AND NOT fixVersion is EMPTY' to the search filter to make sure there are no unscheduled issues in the gadget's statistics.

Configuring the GreenHopper Classic Agile Gadget to display Cross-Project Burndown Charts

You can configure the GreenHopper Classic Agile Gadget to display a burndown chart encompassing multiple projects. This is done by setting up a filter to retrieve data for the appropriate project versions and configuring the GreenHopper Agile Gadget to use the filter. The GreenHopper Agile Gadget will then display a burndown chart to represent the burndown progress across all project versions specified in the filter.

To configure the GreenHopper Classic Agile Gadget to display cross-project burndown charts,

1. Log into JIRA, if you are not logged in already.
2. Click the Issues link in the header. The Issue Navigator will display.
3. Click the New tab next to the Filter label in the left column.

4. Create your cross-project query as desired. You can do this by using either simple searching or advanced searching (JQL). For example, a cross-project query in advanced searching might look something like this,

   (project = JRA AND fixVersion = "4.0") OR (project = GHS AND fixVersion = "4.0")

5. Save your search as a filter by clicking the 'Save it as a filter' link under the Operations section in the left column.
6. Navigate to the JIRA dashboard to which you want to add the GreenHopper Agile Gadget.
7. Click the Add Gadget link in the top right. The Gadget Directory screen will display.
8. Find the GreenHopper Agile Gadget in the list of gadgets and click Add it now.
9. Click the Finished button in the bottom right.
10. The GreenHopper Classic Agile Gadget will display on your dashboard. Enter the following setup details for your gadget:
    
    • Project or Saved Filter — enter the name of the filter you just created.
    • Display chart values — whether or not you want data points for the charts to be displayed in the gadget.
    • Display chart legend — whether or not you want the chart legend to be displayed in the gadget.
    • Refresh Interval — how often the data in the gadget will refresh.
11. Click the Save button. The Classic Agile Gadget will display on your dashboard showing the cross-project burndown chart for the project versions specified in your issue filter.

Screenshot: The GreenHopper Classic Agile Gadget (multiple project version burndown)

The 'Burnup' and 'Velocity' tabs will only be displayed if all the issues selected by your chosen filter, use the Scrum template.

Known Issues

• Please see GHS-7683 - Getting issue details... STATUS  — there is an issue with this gadget if the issues are moved to a different workflow.