Showing multiple elements separately or aggregated
Summarize
Summary of Showing multiple elements separately or aggregated
When selecting multiple elements on a ServiceNow dashboard, widgets can display values either separately for each element or as a single aggregated value. This behavior is controlled by theShow multiple elements asfield on the widget form, which determines whether the widget shows separate values for each breakdown element or an aggregate value combining all selected elements.
Show less
The availability of separate and aggregate views depends on the widget type and the indicator’s configuration. For example, Score widgets only support the aggregated view, while Time series and List widgets support both views. Some indicators, such as formula indicators, support aggregate views only if explicitly enabled.
Widget Support and Limitations
- Time series widgets: Support both aggregate and separate views.
- List widgets: Support both aggregate and separate views.
- Score widgets: Support only the aggregate view.
- Breakdown widgets: Support only the aggregate view.
- Multiple element selection is not supported on workbench or text Performance Analytics widgets; selected elements are ignored in these cases.
Indicators Supporting Aggregate Views
Indicators that support aggregate views include:
- Automated indicators aggregating data as Count, Sum, Minimum, or Maximum
- Manual indicators
- External indicators without SQL AVG() or COUNT(DISTINCT ...) functions
- Formula indicators with aggregate element views enabled on their records
Important: Indicators aggregating data as Average or Count Distinct do not support the aggregate view. If an indicator widget does not support aggregation but aggregate view is selected, it will not follow dashboard element selections and will show default breakdown settings instead.
Behavior of Aggregate Views
The aggregate view combines multiple elements’ data based on the indicator’s aggregation method:
- Count aggregation: Sum of scores for selected elements
- Sum aggregation: Sum of sums of selected elements
- Max aggregation: Highest value among selected elements for each time point
- Min aggregation: Lowest value among selected elements for each time point
Note that when aggregate view is selected, some features are restricted:
- Targets, thresholds, and comments are unavailable when navigating to the Analytics Hub from an aggregate view widget with multiple breakdown elements selected.
- Breakdown selector and search functionality are disabled in aggregate view.
- Targets and thresholds are not available in Time series widgets.
- Targets and bullet charts are unavailable in List widgets.
Widget Indicators and Breakdown Dashboards
When multiple breakdown elements are selected on a dashboard, widget indicator names and labels show appended breakdown and element names in separate view mode to clarify which values correspond to which elements.
In aggregate view, if an indicator does not support aggregation, breakdown and element names are not appended. Likewise, if the widget does not follow elements or indicators do not support the selected breakdown, names are not appended.
Practical Example
Consider a dashboard with the Incident.Category breakdown and three elements selected: Inquiry/Help, Network, and Software. A Time series widget named Open Incidents shows the Number of Open Incidents indicator (Count aggregation) and follows the selected elements.
- If Show multiple elements as is set to Separate, the widget displays separate columns for each element daily.
- If set to Aggregate, the widget shows a single combined value for all three elements.
When you select multiple elements on a dashboard, widgets that follow these elements can show their values either separately or as an aggregate.
On a widget form, use the Show multiple elements as field to set whether multiple elements are shown separately or as an aggregate. Widgets with the view type Separate show a different value for each breakdown element selected. Widgets with the view type Aggregate show a single value that represents the aggregated value of all selected breakdown elements.
The widget type logically determines whether an aggregated view, a separate view, or both are available. Also, formula indicators support the aggregated view only when the aggregated view is explicitly enabled on the indicator record. For example, a Score widget can only show an aggregated view. Without aggregated views being enabled, a Score widget for a formula indicator cannot be filtered on multiple elements. In this case, the Show multiple element as field displays Not available and is grayed out. For more information, see the section Indicators that support an aggregate of multiple elements.
Widget support of aggregate and separate views
- Time series widgets support aggregate and separate views.
- List widgets support aggregate and separate views.
- Score widgets only support the aggregate view.
- Breakdown widgets only support the aggregate view.
Indicators that support an aggregate of multiple elements
- Automated indicators that aggregate data as a Count, Sum, Minimum, or
Maximum valueNote:The word "aggregate" is used for two different things here: the aggregate view of multiple indicator scores, and the data aggregation that is set on an indicator.
- Manual indicators
- External indicators that do not use
SQL AVG()orSQL COUNT(DISTINCT...)in their SQL statement - Formula indicators that have aggregate element views enabled on their indicator records. For more information, see the entry on the Allow aggregation of multiple breakdown element scores field on the Other tab in Create a formula indicator.
- Indicators that aggregate data as an Average or a Count Distinct do not support the Aggregate view.
- The Show multiple elements as value applies to both the main widget and any indicator widgets. If Aggregate is selected but one of the indicator widgets does not support the Aggregate view, that indicator does not follow the elements on the breakdown dashboard. Instead, the indicator follows any first-level breakdown and element that are set in the widget configuration. The other indicators follow the elements on the breakdown dashboard and show an aggregate of their values.
Results when showing aggregate view
| Automated indicator data aggregation | External indicator SQL statement | In a widget, what an aggregate view of multiple elements shows |
|---|---|---|
| COUNT | SQL COUNT() |
A sum of the scores of the selected elements |
| SUM | SQL SUM() |
A sum of the scores of the selected elements, which themselves are sums |
| MAX | SQL MAX() |
Whichever element had the highest value at each time point |
| MIN | SQL MIN() |
Whichever element had the lowest value at each time point |
- Targets, thresholds, and comments are not available when you navigate to the Analytics Hub from a widget with multiple breakdown elements selected in an aggregate view. The breakdown selector and search functionality are also unavailable.
- Targets and thresholds are not available in time series widgets.
- Targets and bullet charts are not available in list widgets.
Widget indicators and breakdown dashboards
- The widget shows an aggregate view of multiple elements, and the widget indicator does not support this view.
- The widget does not follow elements.
- The widget indicators do not support the selected breakdown elements.
Open incidents with aggregate and separate values for multiple elements
Consider a breakdown dashboard with the Incident.Category breakdown source and the three
elements Inquiry/Help, Network, and Software selected.
The dashboard contains a time series widget called Open Incidents. This widget shows the
Number of Open Incidents indicator, which has the Count aggregate. The widget follows the
elements that are selected on the dashboard. Therefore, the widget can show multiple
elements selected on the dashboard either separately or as an aggregate value. The
Show multiple elements as field is set to
Separate.
On the dashboard, a separate column is shown for each of the three selected elements for
each day.
With the Show multiple elements as field set to
Aggregate, a single, aggregate score is shown for the three
selected elements.