Using the Agile Classic Gadget

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

 

 

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


 

Screenshot: The Agile Classic Gadget

 


Adding the Agile Classic gadget to your JIRA dashboard

To add the Agile Classic 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 Agile Classic Gadget in the list of gadgets and click Add it now.
  4. Click the Finished button in the bottom right.
  5. The Agile Classic 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 JIRA Agile data.
      (info) If you see the message "This filter contains too many issues", please ensure that you are not limiting your JIRA Agile 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 Agile Classic Gadget will display on your dashboard showing the cross-project burndown chart for the project versions specified in your issue filter.
  7. The Agile Classic Gadget will refresh and display data for all unscheduled issues in your project. To display the desired JIRA Agile 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.
      (info) 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/JIRA Agile views for your issues, via the icons in the top right:

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

(warning) 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 Agile Classic Gadget to display Cross-Project Burndown Charts

You can configure the Agile Classic 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 Agile Classic Gadget to use the filter. The Agile Classic Gadget will then display a burndown chart to represent the burndown progress across all project versions specified in the filter.

To configure the Agile Classic 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 = "6.0") OR (project = GHS AND fixVersion = "6.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 Agile Classic Gadget.
  7. Click the Add Gadget link in the top right. The Gadget Directory screen will display.
  8. Find the Agile Classic Gadget in the list of gadgets and click Add it now.
  9. Click the Finished button in the bottom right.
  10. The Agile Classic 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 Classic Gadget will display on your dashboard showing the cross-project burndown chart for the project versions specified in your issue filter.


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

(warning) 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.

 

Last modified on Jul 1, 2014

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.