Using the Agile Gadget

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 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 Agile Gadget' to your dashboard multiple times, if you wish to track multiple projects/versions.

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 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 that you want to add the GreenHopper Agile Gadget to.
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 Agile Gadget' 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 Agile Gadget will display on your dashboard showing the cross-project burndown chart for the project versions specified in your issue filter.