Indicator

An indicator is a card that you can add to a dashboard to show the numeric attributes of individual features or display a summary statistic. Indicators can also be used to compare the calculated value to a reference value. You can configure indicators in many different ways, including adding icons, using conditional formatting, or using advanced formatting.

The following are examples of the many configurations possible with an indicator:

Example indicators

Reference values

Reference values on indicators are optional. When specified, reference values can be used as a predefined goal or threshold for an indicators value. On the Data tab, you can choose a reference type in the Reference section. There are three types of reference values: the indicator's previous value, a fixed value set at design time, or a statistic calculated at run time.

If you set a reference value, you can configure conditional formatting for the indicator. Conditional formatting enables an indicator to display differently based on whether the current value is at, above, or below the reference value. In the following example, a red or green triangle is used to indicate whether completed tasks have increased or decreased, respectively, from the previous day's totals:

Indicator with conditional formatting

Indicator options

On the Indicator tab, you can configure the visualization. The area for the visualization is divided into three areas: top, middle, and bottom. Each area is optional and can display any combination of unique text, the indicator's value, reference value, or a predefined calculation.

Top, middle, and bottom text

You can insert values, reference values, and predefined calculations into the top, middle, or bottom text fields by clicking the Insert button Insert. You can also set the Text color, Outline color and Font weight of Normal or Bold for top, middle or bottom text fields.

The predefined calculations available for an indicator are shown in the following table:

Description Formula

Calculated value

Value

Reference value

Reference

Difference

Value - Reference

Absolute difference

|Value - Reference|

Percentage

100 * Value / Reference

Percent change

100 * (Value - Reference) / Reference

Ratio

Value / Reference

Ratio change

(Value - Reference) / Reference

When specifying top, middle, or bottom text, you can also use HTML codes. If you can't find a desired symbol on your keyboard, you can copy and paste it directly into the text settings, or you can enter the symbol's decimal (dec) or hexadecimal (hex) reference code in these fields. For example, to include an upward pointing triangle (▲) in the indicator, you can insert its dec code of ▲ or its hex code of ▲ into the text field.

Indicator resizing

You can resize an indicator in the following ways:

  • Resize the top, middle and bottom text by dragging the panel gutters within the indicator preview area.
  • Resize the indicator directly in the dashboard layout. Press Shift and click to select one or more indicators, and drag the panel gutters to adjust their size. Press Esc to exit resize mode.

As the indicator is resized, the text displayed in the top, middle, and bottom areas scales to fit the size of the indicator.

Conditional formatting

If the indicator has a reference value configured, you can turn on the Conditional formatting toggle button. When conditional formatting is enabled, two sets of top, middle, and bottom text areas are available. In the first set, you can configure the indicator's display when the value is at or above the reference value. In the second set, you can configure the display when the value is below the reference value.

Icons

Icons can be included on an indicator and are always displayed as part of the middle text, either on the left or right of the text. The icons you can select are scalable vector graphics (SVG) and, as with the text, will resize as the indicator resizes. You can select an icon from the provided SVG icon library or create custom icons

Value formatting

You can configure formatting such as value conversion, unit prefixing, and number formatting for the indicator. If the indicator includes a reference value, you can also configure the percentage and ratio formatting.

Actions

In an interactive dashboard, feature-based indicators can be the source of an action. When such an indicator is a source of actions, it can, for example, trigger a map to pan or zoom, or filter another dashboard element.

You can also use indicators in interactive dashboards as the target of an action. This means that an action performed on another element, such as a selection on a list or a category selector, can control the data displayed on the indicator.