Actions

You can configure actions on a dashboard to provide an interactive experience to users. Actions allow you to give your dashboard more context and focus by performing events like filtering, adjusting a map, and more.

Actions can be initiated by one of the three supported events: URL parameter change, map extent change, and selection change. The dashboard and many of its elements can support different events while there are some elements that do not support any events. The following table lists the event sources and the events that are supported from that source for both the desktop and mobile view.

Event sourceURL parameter change Map extent change Selection change

Dashboard

Desktop view supportedMobile view supported

Map

Desktop view supportedMobile view supported

Operational layer from a map

Desktop view supportedMobile view supported

List

Desktop view supportedMobile view supported

Serial chart

Desktop view supported

Pie chart

Desktop view supported

Table

Desktop view supportedMobile view supported

Category selector

Desktop view supportedMobile view supported

Number selector

Desktop view supportedMobile view supported

Date selector

Desktop view supportedMobile view supported

  • Desktop view supported Supported in desktop view
  • Mobile view supported Supported in mobile view
Tip:

The following are tips for adding actions to your dashboard:

  • Always assign dashboard elements a unique and meaningful name on the General tab. This is helpful when configuring actions.
  • Finish adding elements and make visual refinements to a dashboard before configuring actions.

Using actions

The action source describes where the event initiates while the action target is where the event occurs. The following types of actions are supported:

  • Filter—Reduces the number of features available to the target element or operational layer when it's rendering
  • Set extent—Sets the extent of a target map element
  • Flash location—Flashes a geographic location on a target map element
  • Show pop-up—Displays an information window on a target map element
  • Pan—Causes a target map element to pan to and remain centered on a specified location
  • Follow feature—Causes a target map element to pan to and remain centered on a specific feature
    Note:

    The follow feature action is only available on the dashboard's desktop view.

  • Zoom—Causes a target map element to zoom to a specified location

Some filter actions can be configured to require a selection before rendering an element. You can enable the Render only when filtered option when configuring a filter action to add focus and context to a target element. When enabled, the target element doesn't render the target visualization until a selection is made on the source. The message displayed on an element that requires a selection can be configured in the target element's general settings.

The following table summarizes which elements can be the source of actions and which can be targets in either the desktop or mobile view. Some dashboard elements, such as a map legend and rich text, can be neither the source nor the target of an action and are not listed here.

Dashboard element Action source Action target

Dashboard

Desktop view supportedMobile view supported

Map

Desktop view supportedMobile view supported

Desktop view supportedMobile view supported

Map's operational layer

Desktop view supportedMobile view supported

Desktop view supportedMobile view supported

Serial chart

Desktop view supported

Desktop view supportedMobile view supported

Pie chart

Desktop view supported

Desktop view supportedMobile view supported

Indicator

Desktop view supportedMobile view supported

Gauge

Desktop view supportedMobile view supported

List

Desktop view supportedMobile view supported

Desktop view supportedMobile view supported

Details

Desktop view supportedMobile view supported

Embedded content

Desktop view supportedMobile view supported

Table

Desktop view supportedMobile view supported

Desktop view supportedMobile view supported

Category selector

Desktop view supportedMobile view supported

Desktop view supportedMobile view supported

Number selector

Desktop view supportedMobile view supported

Desktop view supportedMobile view supported

Date selector

Desktop view supportedMobile view supported

  • Desktop view supported Supported in desktop view
  • Mobile view supported Supported in mobile view

Note:

The Show pop-up action is only available on an element when it's configured to show features and its data source represents an operational layer from a map already added to the dashboard. For more information, see Configure actions on dashboard elements and Configure actions on URL parameters.

Considerations for using actions

Actions have a source and a target. An action's source can be the dashboard or one of its elements. An action's target is always one of the dashboard's elements. If the source and target are based on different data sources, the relationship between these sources must be established. This can be either an attribute relationship or a spatial relationship. In an attribute relationship, a field or value from the source element is used to match field values of the target element. In a spatial relationship, the following occurs:

  • If an element is configured with Categories from features, feature geometries from the source element are used to intersect geometries of the target element.
  • If an element is configured with Categories from grouped values, an envelope around features in a category from the source element is used to intersect geometries of the target element.
Note:

If the source and target are based on the same data source, you don't need to take any steps to establish their relationship.

Considerations for follow feature

The follow feature action is only available on an element when it's configured to show features, and its data source represents an operational layer from a map already added to the dashboard. Additionally, the data source must be point geometries and have a refresh interval set. When enabling the follow feature action, the target can only be the map that the element's data source is from.

When follow feature is triggered, tools appear in the upper corner of the target map element. These allow the end user to control various aspects of the follow action (for example, pause and resume, show info window, and cancel). When a feature is being followed on a map, manually panning or zooming the map pauses the follow action. It must be restarted using the tools on the map.