Charts as the source of actions

Pie charts and serial charts are types of charts that support having selections made on them and can be configured as the source of an action.

Understand charts

A chart is a representation of one or more series of data points, where each series is an array and each data point in the array is a name-value pair.

A serial chart can have more than one series, whereas a pie chart can only have one. A data point is not necessarily a row or feature of data from your data source. For example, the information on a chart can represent rows in your data that have been grouped by a common attribute and to which a summary statistic has been applied. For date-based data, the rows from your data can be grouped or binned to a common unit of time before being displayed on the chart.

Every data point rendered on a chart has a shape: rectangle (bar), circular sector (pie slice), or point (with straight or smoother line segments connecting the points).

On a serial chart, the data represented can have discrete or continuous categories. Discrete categories represent unique values, whereas continuous categories represent a time range.

Chart selection

A chart selection represents one or more data points. Chart selections are only enabled if the chart has an action configured. This means that when a chart's selection changes, one or more targets can be affected, for example, another dashboard element, a selector, a map, or a map's operational layer. A selection is made by click the data point on the chart. Charts support either single and multiple selection.

Tip:

Clicking anywhere that does not represent a data point on a chart clears the selection.

When a chart is showing continuous categories, such as date-based data, each selected data point represents a range of time. The size of the range is determined by the minimum period on the chart's configuration. When showing discrete categories, a serial chart's category axis label can be used to create a selection. This is particularly useful on multiseries charts.

Note:

Some charts have legends displayed. Clicking the legend removes the related data points from the chart. If those points are selected when the legend is clicked, clicking the legend again does not reselect the data points.

The way you configure a chart determines the actions that can be configured. The following table outlines the possible actions for each chart configuration type.

Configuration optionPossible action

Categories from Grouped Values

Filter

Pan

Zoom

Flash

Note:

Pan, zoom, and flash actions are not available for serial charts when parse dates is enabled.

Categories from Features

Filter

Pan

Zoom

Flash

Show pop-up

Categories from Fields

No actions possible

Note:

For charts with categories from grouped values, the pan and zoom actions pan and zoom the map to the extent where all features are visible. The flash action renders a rectangle encompassing all features for that selection that flashes on the map.