Display a JIRA Chart in a Page
Steps
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. The full parameter list of each Macro is in "jiraPieChart" Macro, "jiraCreatedVsResolvedChart" Macro and "jiraBiDimensionalGridChart" Macro.
- 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.
- Edit the wiki page and insert the jiraPieChart, jiraCreatedVsResolvedChart or jiraBiDimensionalGridChart Macro on a line of its own.
Set the id parameter to the instance id, or the url parameter to the instance URL.
- Set the filterId parameter to the filter id, or the query parameter to the JQL query.
- Set the mandatory parameters of the Macro you chose: type for jiraPieChart, period and daysPreviously for jiraCreatedVsResolvedChart, xAxisField and yAxisField for jiraBiDimensionalGridChart.
- Set the optional parameters limiting or sorting the data, or leave them out to accept the defaults.
- Save the page. The statistics JIRA computed are displayed as the chart you chose.
FAQ
Can a chart be displayed inside a sentence?
No. All three chart Macros always start a new block, unlike the jira and jiraCount Macros.
Do I have to install anything to get the charts rendered?
No. The chart Macros pull in the ChartJS UI they render with, so installing the JIRA Charts Macros extension is enough.
Where do I find the id of a saved JIRA filter?
In JIRA, open the saved filter: its id is the number in the page URL. Write it with or without the filter- prefix, both are accepted.
Which fields can I chart on?
Those JIRA aggregates its own statistics over, listed in each Macro's reference page; they are a fixed set, not the full list of issue fields.
More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
