Time series widgets have the following optional settings for display, for the date range, and for the axis labels. You can also use these setting to select an elements filter in place of a first-level breakdown element.

Important: This topic is not a guide to creating time series widgets. It is a guide to extra, optional settings that are common across time series widget types. FOR INSTRUCTIONS ON CREATING TIME SERIES WIDGETS, PLEASE SEE THE APPROPRIATE "CREATE" TOPIC:

The available settings depend on the selected visualization. The following example is for a Area Chart visualization.

Additional settings for time series widgets.

Date settings

The date settings are available only if Previous period chart is not selected.

Setting Description
Period Select the date range to display in the widget. Several options are available.
  • Select a specific time range. The default is 3m (3 months).
  • Select max to use scores up to the current date.
  • Select between and then fill in the From and To fields to define a time period.

The Period field is available with only the following visualizations:

  • Line
  • Spline
  • Column
  • Area
  • Step
  • Stacked Column
  • Relative Compare
Show date range selector Display a date range selector on the widget. Users can then change the selected period when viewing the widget on a dashboard.
Note:
  • Selecting a date range on a widget does not update the trend line.
  • If you combine a time series aggregation such as By month SUM with a date range selector, the user may see one more time period than they expect. The instance interprets a period such as 3 m as 0-3 months and may show four months of scores.
  • The date range selector is not supported for indicators based on a business calendar.

Axis settings

SettingDescription
Y-axis title Specify a title to display on the vertical axis of the chart.
Y-axis from Specify the starting point for the range of values for the vertical axis of the chart.
Y-axis to Specify the ending point for the range of values for the vertical axis of the chart.
2nd Y-axis title Specify a secondary title to display on the vertical axis of the chart.
2nd Y-axis from Specify the starting point for a 2nd range of values for the vertical axis of the chart.

The 2nd Y-axis can be used if scores normally move between a limited range, but you have some exceptions that would otherwise distort the chart. For example, scores normally lie from 40 through 60, but there is an exception of 1000.
2nd Y-axis to Specify the ending point for a 2nd range of values for the vertical axis of the chart.

Display settings

SettingDescription
Show target Display the target score, if defined. This field appears only if Previous period chart is not selected.
Show thresholds Display thresholds such as an all time high or an all time low. Thresholds appear only if they have been defined for this indicator.
Show data labels Display the score for each data point, such as each slice of a pie chart.
Show trend Display the trend line. This field appears only if Previous period chart is not selected.
Show confidence bands Display confidence bands in this chart. For information about how the confidence band is calculated, see Widget confidence bands.
Show forecast Display forecast data in the chart based on current trend data. Forecasting must be configured on the indicator.
Show forecast range Display the 95% confidence interval of the forecast. Available only when Select forecast is enabled.
Show comments Display comments added to data points in the chart.

Element settings

Setting Description
Elements filter Specify an element filter in place of the first-level breakdown element. Use an elements filter to personalize which elements appear according to the characteristics of the viewer. For example, you can filter elements of the Assignment Group breakdown to show only the groups to which the viewer belongs. For more information, see Personalized visuals.

Previous Period settings

Previous period settings are available only if Previous period chart is selected.

Note: Thresholds, trend, confidence bands, and forecasts aren't intended to work when Previous period chart is selected.
Setting Description
Range of periods Select the range of periods to compare with the current period,
Number of periods Specify the number of previous periods to display.

Widget confidence bands

The visible points of the trend line are used to calculate the confidence band. If you increase the date range, the bands are recalculated using the trend for the new date range.

First, the confidence bands are calculated using the standard error of the trend. The width of the band depends on the number of points that are included in the calculation and the mean of the scores. If the standard error is low, the trend line is shown to be accurate. As the number of points decreases, or outliers are recorded, the confidence band widens. The confidence of the trend is less certain with fewer data points or with volatile scores.