Configuring the context bar

简介

TemplateOne 中的大多数仪表板顶部都有一个上下文栏，用于显示上下文信息和 KPI。 您可以在上下文栏中配置元素。 TemplateOne 最多支持 6 个元素，这些元素可以在 HTML 面板中进行配置。 另请参阅 HTML 面板。

您可以配置 6 个以上的元素。 但是，这可能会影响上下文信息的可读性。

要将上下文栏添加到新仪表板，您可以从现有仪表板复制 表达式 中的代码并更改配置。

Configuring the context bar

配置包括设置元素数量和单个元素。

Setting the number of elements

请按照以下步骤更改上下文栏中的元素数量。

步骤	操作
1	单击“ 常规 ” 面板的“表达式” 字段中的表达式以编辑表达式。
2	将Number_of_KPIs变量中的整数设置为要在上下文栏中显示的元素数。

请参见下图。

var Number_of_KPIs            := 3;

注意： 如果输入的数字大于配置的元素数量，则元素将不显示任何内容，但会占用上下文栏中的空间。

Configuring the individual elements

单个元素的配置包括设置许多变量。

元素	描述
KPI_n_title	要在上下文栏中显示的元素或 KPI 的名称。
KPI_n_present	计算得出的要在选定期间显示的实际指标。
KPI_n_comparison	显示在实际指标旁边的比较指标。 通常，这是一个包含所选时间段以外数据的指标。
KPI_n_higher_is_better	该值用于确定是否应将 KPI 的提高视为改进。 这会影响颜色或比较 KPI：绿色 - 较好，红色 - 较差。
KPI_n_action	使元素可单击的操作。 默认情况下，不使用操作，但可以使用用于配置此操作的选项。

请参见下图。

示例

// 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 添加到上下文栏中。

Extra period

如果您在仪表板上创建另一个条形图或复制一个现有条形图，请确保启用“ 额外期间 ”。

请按照以下步骤添加额外的句点。

步骤	操作
1	在开发者环境中打开 TemplateOne 。
2	转到要为其配置上下文栏的仪表板。
3	单击上下文栏。
4	转到“HTML 面板”选项卡。
5	在“ 常规 ” 面板的“额外期间” 字段中单击none ，然后选择额外期间。

请参见下图。

Ading additional elements

如果要为上下文栏配置 6 个以上的元素，则必须复制元素集并针对每个新元素进行调整。 您还必须复制和调整每个新元素的代码，并将其添加到表达式末尾的 KPI 列表中。 请参见下图。

注意： 对于“ 详细信息 - 案例概述 ” 仪表板，上下文栏的构造略有不同，但基于为KPI_n标题和KPI_n_present定义的基础结构。 此处也未使用“ 额外句 点”，因此已将其从模板中删除。