通过

提示和示例

  • 项目

指标公式

在文本窗体中定义指标公式。 它可以由预定义的运算组成。

单个运算分为两个基本组：

  • 聚合运算：聚合运算的输入是一组值，将为其计算生成的值（例如，平均值、最大值等）。

  • 标量运算：标量运算的输入是一个或多个值，将为其计算生成的值（例如，数字的绝对值、获取税款的一部分等）。

运算可以使用常数，可以使用一元或二元运算符组合（例如，加法、减法等），也可以嵌套。

标量运算还包括获取值的运算，可以直接以属性的形式提供，也可以以派生统计信息（事件持续时间）的形式提供。

某些运算还支持指定计算运算的上下文。 这对于可以聚合值的聚合运算非常重要，例如，仅针对特定活动或所有活动或事件。 另外还支持由指标上下文或父运算上下文生成的隐式上下文。

指标公式可以返回支持的数据类型之一。 本文在公式语法定义旁边定义了特定公式的数据类型。

聚合运算

聚合运算是每个指标的基础。 最常用的聚合运算有：

  • COUNT：返回聚合值的数量 (incl. COUNTIF, COUNTUNIQUE)。
  • SUM：返回聚合值的总和 (incl. SUMIF)。
  • AVG：返回聚合值的平均值。
  • MIN：返回聚合值的最小值。
  • MAX：返回聚合值的最大值。

聚合运算的自愿参数将是运算上下文和用于修改输入值的标量运算。 支持的计算上下文的完整列表在计算上下文中有述。

标量运算

标量运算的目的是获取一个值并将其转换为所需状态。 当前支持的运算可以划分为以下几种类型：

  • 数学：包括获取数字绝对值、舍入等的运算。
  • 日期和时间：包括处理日期的运算，如获取日期的一部分、将日期相加等。
  • 字符串：包括处理字符串数据的运算，如获取子字符串、拆分字符串等。
  • 统计：包括获取案例数量、案例等待时间等不同统计信息的运算。
  • 其他：包括其他运算，例如访问事件、案例、派生的统计信息等的运算。

属性名称

如果将属性名称用作运算参数，有三种方法可以引用它：

  • 直接使用属性名称（例如，Resource）。

  • 使用 GETVALUE("attribute name") 运算（例如，GETVALUE("Resource")）。

  • 直接使用缩短的属性名称（例如，attribute "Resource ID" 可能作为 ResourceID 引用）。

当属性名称不符合命名约定时，使用第二种形式。 属性命名约定定义如下：

  • 属性名称应该以字母字符或下划线开头。

  • 属性名称只能包含以下 Unicode 标准类中的字符：字母字符（Lu、Ll、Lt、Lm、Lo 或 Nl）、组合字符（Mn 或 Mc）、十进制数字字符 (Nd)、连接字符 (Pc) 或带格式字符 (Cf)。

    有关上面提到的 Unicode 字符类的信息，请参阅 Unicode 标准，版本 3.0 中的第 4.5 节。

当属性名称满足命名约定，但也包含空格字符时，可以选择使用第三种形式。 不使用第二种形式 GETVALUE("attribute name")，可以删除空格字符，使用缩短版本 attributename。 两种形式是等效的。

有效属性名称的示例

  • DocumentCategory

  • DocCat

  • DocCat23

无效属性名称的示例

  • Document.Category

  • Document Category

  • 23DocCat

指标公式示例

要计算图中活动的相对持续时间，请执行以下操作：

AVG (DURATION()) / AVG (VIEWCASES, DURATION())