process-mining
2021.10
true
UiPath logo, featuring letters U and I in white
Process Mining
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Sep 2, 2024

Configuring the context bar

Introduction

Most of the dashboards in TemplateOne have a context bar at the top that displays context information and KPI's. You can configure the elements in the context bar. TemplateOne supports up to 6 elements, that can be configured in the HTML panel. See also HTML Panels.

You can configure more than 6 elements. However, this may affect the readability of the context information.

To add a context bar to a new dashboard you can copy the code in the Expression from an existing dashboard and change the configuration.

Configuring the context bar

The configuration consists of setting the number of elements and the individual elements.

Setting the number of elements

Follow these steps to change the number of elements in the context bar.

Step

Action

1

Click on the expression in the Expression field in the General panel to edit the expression.

2

Set the integer in the Number_of_KPIs variable to the number of elements you want to display in the context bar.

See the illustration below.



var Number_of_KPIs            := 3;var Number_of_KPIs            := 3;
Note: If you enter a higher number than the number of elements that you configure, the elements will show nothing but will take up space in the context bar.

Configuring the individual elements

The configuration of the individual elements consists of setting a number of variables.

Element

Description

KPI_n_title

The name of the element or KPI to be displayed on the context bar.

KPI_n_present

The actual metric computed to be shown for the selected period.

KPI_n_comparison

The comparison metric that is shown next to the actual metric. Usually, this is a metric containing data outside of the selected period.

KPI_n_higher_is_better

The value that determines if an increase for the KPI should be considered to be an improvement. This influences the color or the comparison KPI: green - better, red - worse.

KPI_n_action

The action that makes the element clickable. By default, actions are not used, but the option to have this configured is available.

See the illustration below.



Example

// KPI 1
var KPI_1_title             := 'Average throughput time';
var KPI_1_present            := metric(Metric_cases_average_throughput_time, filter(records, activeperiodfilter));
var KPI_1_comparison        := metric(Metric_cases_average_throughput_time, filter(records, not activeperiodfilter));
var KPI_1_higher_is_better    := false;
var KPI_1_action            := Action_analyze_total_case_value;// KPI 1
var KPI_1_title             := 'Average throughput time';
var KPI_1_present            := metric(Metric_cases_average_throughput_time, filter(records, activeperiodfilter));
var KPI_1_comparison        := metric(Metric_cases_average_throughput_time, filter(records, not activeperiodfilter));
var KPI_1_higher_is_better    := false;
var KPI_1_action            := Action_analyze_total_case_value;

Advanced configuration

You can add a context bar to a new dashboard or you can add additional KPIs to the context bar.

Extra period

Make sure that you enable an Extra period if you create another bar on a dashboard or copy one of the existing bars.

Follow these steps to add an extra period.

Step

Action

1

Open TemplateOne in your developer environment.

2

Go to the dashboard for which you want to configure the context bar.

3

Click on the context bar.

4

Go to the HTML panel tab.

5

Click on nonein the Extra period field in the General panel and select the extra period.

See the illustration below.



Ading additional elements

If you want to configure more than 6 elements for the context bar, you must copy the set of elements and adapt these for each new element. You must also copy and adapt the code for each new element and add it to the list of KPI's at the end of the expression. See the illustration below.



Note: For the Details - Case Overview dashboard the construction of the context bar is slightly different but based on the underlying structure defined for KPI_ntitle and KPIn_present. Here, the Extra period is also not used, hence it is removed from the template.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.