public interface

ChartFactory

com.atlassian.jira.charts.ChartFactory
Known Indirect Subclasses

Class Overview

Main entry point for charting in JIRA. This factory can be used to generate the different types of charts that are used in JIRA. It returns a generic Chart object that contains all the information required to render the generated chart. This ensures that we can switch to a different charting framework at some stage in the future.

Summary

Nested Classes
class ChartFactory.ChartContext Provides context for rendering a chart that is needed by all chart types. 
enum ChartFactory.PeriodName Defines the period for which data in the charts will be grouped. 
enum ChartFactory.VersionLabel Defines what version labels to show in a chart that supports this feature. 
Constants
int FRAGMENT_IMAGE_HEIGHT
int FRAGMENT_IMAGE_WIDTH
int PORTLET_IMAGE_HEIGHT
int PORTLET_IMAGE_WIDTH
int REPORT_IMAGE_HEIGHT
int REPORT_IMAGE_WIDTH
Public Methods
Chart generateAverageAgeChart(ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName)
Generates what is essentially a bar chart showing the average time that issues have been open for over time.
Chart generateCreatedVsResolvedChart(ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName, ChartFactory.VersionLabel versionLabels, boolean cumulative, boolean showUnresolvedTrend)
Generates a created vs resolved line graph, showing the difference between created and resolved issues.
Chart generateDateRangeTimeChart(ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName, long yAxisTimePeriod, String labelSuffixKey, String dateFieldId)
Generates a date range chart time, meaning a chart that shows time values for particular date ranges.
Chart generatePieChart(ChartFactory.ChartContext context, String statisticType)
Generates a pie chart for a particular field.
Chart generateRecentlyCreated(ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName)
Generates a stacked bar chart showing the number of created/resolved issues for a certain time period.
Chart generateTimeSinceChart(ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName, boolean cumulative, String dateFieldId)
Generates a chart showing the number of issues since a certain date field.

Constants

public static final int FRAGMENT_IMAGE_HEIGHT

Constant Value: 250 (0x000000fa)

public static final int FRAGMENT_IMAGE_WIDTH

Constant Value: 380 (0x0000017c)

public static final int PORTLET_IMAGE_HEIGHT

Constant Value: 300 (0x0000012c)

public static final int PORTLET_IMAGE_WIDTH

Constant Value: 450 (0x000001c2)

public static final int REPORT_IMAGE_HEIGHT

Constant Value: 500 (0x000001f4)

public static final int REPORT_IMAGE_WIDTH

Constant Value: 800 (0x00000320)

Public Methods

public Chart generateAverageAgeChart (ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName)

Generates what is essentially a bar chart showing the average time that issues have been open for over time.

Parameters
context Basic information needed to generate all charts
days Number of days to go back in time for the chart
periodName Defines if the data will be grouped in days, weeks, months...
Returns
  • A chart object containing all the information required to display the chart.

public Chart generateCreatedVsResolvedChart (ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName, ChartFactory.VersionLabel versionLabels, boolean cumulative, boolean showUnresolvedTrend)

Generates a created vs resolved line graph, showing the difference between created and resolved issues.

Parameters
context Basic information needed to generate all charts
days Number of days to go back in time for the chart
periodName Defines if the data will be grouped in days, weeks, months...
versionLabels Defines what version labels to show in the chart
cumulative Display cumulative totals for the resolved and unresolved issues
showUnresolvedTrend Displays a subgraph showing the trend at which issues are being resolved
Returns
  • A chart object containing all the information required to display the chart.

public Chart generateDateRangeTimeChart (ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName, long yAxisTimePeriod, String labelSuffixKey, String dateFieldId)

Generates a date range chart time, meaning a chart that shows time values for particular date ranges. For example the total resolution time for issues in any given time period.

Parameters
context Basic information needed to generate all charts
days Number of days to go back in time for the chart
periodName Defines if the data will be grouped in days, weeks, months...
yAxisTimePeriod Time period in millis to display on the yAxis. Only supports Hours and Days
labelSuffixKey The i18n suffix key to display for mouse tool tips in the chart
dateFieldId The date field to use as the basis for the times displayed per date range
Returns
  • A chart object containing all the information required to display the chart.

public Chart generatePieChart (ChartFactory.ChartContext context, String statisticType)

Generates a pie chart for a particular field. For example, this may generate a pie chart showing how many issues are in each issue type available. See FilterStatisticsValuesGenerator for possible values for the statisticType. Custom fields are also supported by simply entering the 'customfield_' for the statisticType.

Parameters
context Basic information needed to generate all charts
statisticType The field for which to generate the pie slices.
Returns
  • A chart object containing all the information required to display the chart.

public Chart generateRecentlyCreated (ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName)

Generates a stacked bar chart showing the number of created/resolved issues for a certain time period.

Parameters
context Basic information needed to generate all charts
days Number of days to go back in time for the chart
periodName Defines if the data will be grouped in days, weeks, months...
Returns
  • A chart object containing all the information required to display the chart.

public Chart generateTimeSinceChart (ChartFactory.ChartContext context, int days, ChartFactory.PeriodName periodName, boolean cumulative, String dateFieldId)

Generates a chart showing the number of issues since a certain date field. For example if the 'Created' field is selected, this chart will show the number of issues created for each date in the past (depending on period and days previously selected). Please note that the dateField must be a Field marked by DateField.

Parameters
context Basic information needed to generate all charts
days Number of days to go back in time for the chart
periodName Defines if the data will be grouped in days, weeks, months...
cumulative Display cumulative totals for the number of issues
dateFieldId The date field to use as the basis for the times displayed per date range
Returns
  • A chart object containing all the information required to display the chart.