com.atlassian.jira.charts

Interface ChartFactory

All Known Implementing Classes:

DefaultChartFactory

public interface ChartFactory

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.

Since:

v4.0

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ChartFactory.ChartContext Provides context for rendering a chart that is needed by all chart types.
static class	ChartFactory.PeriodName Defines the period for which data in the charts will be grouped.
static class	ChartFactory.VersionLabel Defines what version labels to show in a chart that supports this feature.

Field Summary

Fields

Modifier and Type	Field and Description
static int	FRAGMENT_IMAGE_HEIGHT
static int	FRAGMENT_IMAGE_WIDTH
static int	PORTLET_IMAGE_HEIGHT
static int	PORTLET_IMAGE_WIDTH
static int	REPORT_IMAGE_HEIGHT
static int	REPORT_IMAGE_WIDTH

Method Summary

Modifier and Type	Method and Description
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.

Field Detail

FRAGMENT_IMAGE_HEIGHT

static final int FRAGMENT_IMAGE_HEIGHT

See Also:

Constant Field Values

FRAGMENT_IMAGE_WIDTH

static final int FRAGMENT_IMAGE_WIDTH

See Also:

Constant Field Values

PORTLET_IMAGE_HEIGHT

static final int PORTLET_IMAGE_HEIGHT

See Also:

Constant Field Values

PORTLET_IMAGE_WIDTH

static final int PORTLET_IMAGE_WIDTH

See Also:

Constant Field Values

REPORT_IMAGE_HEIGHT

static final int REPORT_IMAGE_HEIGHT

See Also:

Constant Field Values

REPORT_IMAGE_WIDTH

static final int REPORT_IMAGE_WIDTH

See Also:

Constant Field Values

Method Detail

generateCreatedVsResolvedChart

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.

generateDateRangeTimeChart

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.

generatePieChart

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.

generateAverageAgeChart

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.

generateRecentlyCreated

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.

generateTimeSinceChart

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.