Filters

Introduction

Filters are used to determine which data is shown on a dashboard. The following options are available to add filtering to a dashboard or dashboard item.

Dashboard Item Filters

Filters created by a developer that filters the data from the table before it is provided to the dashboard item. Each dashboard item has its own filter which you can set in the Filter field in the General panel of the Chart tab. You can enter an expression that returns a Boolean value. For example, if you want to display only events from a specific country in a dashboard item (country="Japan").

Note:

The syntax of the expression should be similar to a per record expression. See Record expressions.

Dashboard item filters are not visible or editable by end users.

Filter Controls

These are created by the developer and placed on the dashboard. Filter controls can be set up to filter multiple dashboard items. End users can change the values that are filtered but cannot add or remove these filters.

End-user Filters

Attributes that are marked by developers to be used as end-user filters. End users can freely add or remove these filters on dashboards. These filters always affect all dashboard items that are based on tables the filter can be propagated to.

Default active filters on a chart

When you create a new chart, any existing filters on the dashboard will be active for this new chart as well.

In this case, the available filters on the Filters panel will be applied in the following way:

• The same filters from an existing chart that is created on the same table as the new chart will be applied.
• If there is no existing chart based on the table for the new chart, any defined filters for the first chart will be applied.
• If this is the first chart on the dashboard, all existing filters are activated for the new chart.