Wiki source code of Display a JIRA Chart in a Page
Last modified by Vincent Massol on 2026/08/04 21:49
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | Three Macros display statistics that JIRA itself computes over a set of issues, instead of the issues: the ##jiraPieChart## Macro shows how the issues are distributed over one field, the ##jiraCreatedVsResolvedChart## Macro compares created and resolved issues over time, and the ##jiraBiDimensionalGridChart## Macro crosses two fields in a table. Which issues are covered is decided either by a JQL query or by the id of a filter saved in JIRA. You need the id an administrator gave the JIRA instance, or its URL, as described in [[Configure a JIRA Server>>doc:documentation.extensions.admin.jira.configure-server.WebHome]]. The full parameter list of each Macro is in [["jiraPieChart" Macro>>doc:documentation.extensions.user.jira.display-chart.pie-chart.WebHome]], [["jiraCreatedVsResolvedChart" Macro>>doc:documentation.extensions.user.jira.display-chart.created-vs-resolved.WebHome]] and [["jiraBiDimensionalGridChart" Macro>>doc:documentation.extensions.user.jira.display-chart.bidimensional-grid.WebHome]]. | ||
| 2 | |||
| 3 | 1. Open JIRA and either write down the JQL query selecting the issues, or save the search as a filter and note the filter id shown in its URL. | ||
| 4 | 1. Edit the wiki page and insert the ##jiraPieChart##, ##jiraCreatedVsResolvedChart## or ##jiraBiDimensionalGridChart## Macro on a line of its own. | ||
| 5 | 1. ((({{display reference="documentation.extensions.user.jira.display-issues.set-instance-parameter"/}}))) | ||
| 6 | 1. Set the ##filterId## parameter to the filter id, or the ##query## parameter to the JQL query. | ||
| 7 | 1. Set the mandatory parameters of the Macro you chose: ##type## for ##jiraPieChart##, ##period## and ##daysPreviously## for ##jiraCreatedVsResolvedChart##, ##xAxisField## and ##yAxisField## for ##jiraBiDimensionalGridChart##. | ||
| 8 | 1. Set the optional parameters limiting or sorting the data, or leave them out to accept the defaults. | ||
| 9 | 1. Save the page. The statistics JIRA computed are displayed as the chart you chose.((( | ||
| 10 | {{image reference="jira-chart-result.png" size="large" alt="A saved wiki page displaying a pie chart of the issues of a project, with one slice per issue status"/}} | ||
| 11 | ))) |
