Handling No Data and Data Errors

This applies to: Managed Dashboards, Managed Reports

At viewing time, if no data is returned for a visualization or if a data error occurs, you'll see a corresponding message displayed by the visualization instead of a blank area. For each data visualization, you can add an interaction when a No Data event or a Data Error event occurs. This allows you to show/hide layers of content or execute some custom script when these events occur.

Note: Data error details can be hidden from end users by enabling the advanced configuration setting Hide Error Stack Traces, with the full details available in the logs.

No Data Indicator

As an example, consider the following dashboard consisting of a chart and a calendar range filter.

In View mode, set the calendar range of the filter to a value for which there is no data (e.g., 2004 to 2004). Instead of showing a blank chart, you see a no data was returned indicator.

Data-Related Events

There are three data-related events that can occur for data visualizations. For each of these events you can add an action to run such as Change Layer or your own script. For example, if No Data occurs for a chart, you may want to hide the chart and associated labels completely.

You can find these in the Properties window of any data visualization in the Actions section:

• Data Change - Occurs when the data visualization's data changes in any way after initially loading. This will always fire before No Data and Data Error.

• No Data - Occurs when the control doesn't receive any data back.

• Data Error - Occurs when the control's data changes, and the data has an error and cannot be shown.

To choose an action to add, click the menu icon to the right.

To quickly add a default action (e.g., script if you are a developer user), click the + button.

For more information about setting up interactions, see Using Interactions.

For more information, see:

• Layers and Groups

• Add a Change Layer Action on Ready Event