How to use Indicators

Highlights

Overview Use the Indicators panel to change the color of values, the background color of table cells, assign display icons, change text style, or replace values with text based on conditional thresholds.

How indicators work Predicate: The IF part of the condition, controls what values are compared. For example, IF X is greater than 50.
Reaction: The THEN part of the condition, controls what value is affected when the condition is met and what action to take when the condition is met. For example, THEN change color to green.

Key Features Use multiple predicates and reactions, compare two sub-components
Use 1 of 4 reaction styles: change color, display icon, change font style, and replace values with text.

Overview

The Indicators panel lets you apply color changes to values, change the background color of cells, and assign icons based on conditional thresholds. The condition is set up by providing a predicate (for example, if X is greater than Y) and a reaction (for example, then change X's color to green).

To set up indicators

Watch this video to learn how to use Indicators with Hidden data.

Every indicator you set up requires a predicate and a reaction. You can add multiple predicates or reactions to a condition to cover a specific threshold, such as values greater than 10 but less than or equal to 20. For example, the Indicators panel of a Gauge component uses two simple conditions. To add a set of conditions, select the Add button.

Predicates

Predicates control what sub-component is compared in the condition and what operators are used in that comparison.
You can compare the component against a static value, or you can select any component in the If menu and compare it to any other component.
Tip: to set an indicator for a text string, use the contains comparator. For example,

If: Current Value contains CompanyName
then: change color

Reactions

Reactions control what value is affected when the predicate evaluates to true. This part of the condition determines if the indicator will change the color the value, change the background color, or use a display icon.

To use multiple predicates/reactions

You can add multiple predicates and/or reactions to any condition you create in the Indicators panel. Add new predicates or conditions using the buttons on the right side of the panel.

Add multiple predicates

By adding multiple predicates to the condition, you can evaluate a specific range of values, or evaluate multiple components. To add and remove predicates from an existing condition, select the + and - buttons.

Add multiple reactions

By adding multiple reactions to the condition, you can return multiple indicators when the predicate is evaluated as true. To add and remove reactions from an existing condition, select the + and - buttons.

Indicators with dates

When you are comparing dates using the Indicators panel, you will need to convert the dates into Unix time format.

Let's use the screenshot below as an example. As you can see, there is a column in the table (Minus 30 Days) indicates whether dates are hitting or not hitting a deadline.

To do that, you'll have to create hidden columns of Unix time values. In our example, there is a Deadline Hidden column and a Minus 30 days Hidden column in Unix time format. We'll have to set up a rule on the Minus 30 days column as follows:

If Minus 30 days Hidden is less than or equal to Deadline Hidden then Minus 30 days change colour to green.

When you are done, set the column as hidden. To do this, go to the Properties panel. At Visibility, check off Hide this column.

Learn more:

Now that you know more about indicators, check out the following tutorial:

Important concepts

These articles provide an overview of important concepts for building Klips: