表达式指南

表达式（Expressions）

ProcessMind 表达式可让您在仪表盘中生成丰富文本和动态内容。通过表达式，您的仪表盘更具交互性，内容能根据 data 自动更新。此指南提供实际案例和标准写法，帮助您高效使用表达式。

您可用表达式在文本中直接引用指标和属性。这样内容会随 data 更变自动更新，实现动态展现。

显示当前活跃案例数对比总数用法：

视图中的案例数：${metric} / 总案例数：${total}

其中 ${metric} 为当前指标值，${total} 为总案例数。

显示未包含案例数量（总数减当前数）：

未包含的案例数：${total - metric}

同样，${metric} 为当前数据，${total} 表示所有案例总数。

显示视图中的案例占总体百分比：

视图案例占比：${formatPercentage(metric)}

${metric} 需设为案例相关指标。

ProcessMind 在表达式中支持多种函数，适用于计算、格式化及动态查值。可将其与您的指标（metrics）和属性组合，输出更强大且灵活的内容。

函数	说明	示例
`round(value, decimals?)`	数值四舍五入到最近整数，或指定小数位数。	`${round(metric, 2)}` → `123.46`
`power(base, exponent)`	幂指数运算（同 `pow`）。	`${power(2, 3)}` → `8`
`pow(base, exponent)`	`power` 函数别名。	`${pow(metric, 2)}`
`sqrt(value)`	返回平方根。	`${sqrt(metric)}`
`abs(value)`	取绝对值（去除负号）。	`${abs(metric)}`
`ceil(value)`	数值向上取整。	`${ceil(3.2)}` → `4`
`floor(value)`	数值向下取整。	`${floor(3.8)}` → `3`
`exp(value)`	返回自然数 e 的指定次幂。	`${exp(1)}` → `2.718...`
`log(value)`	返回自然对数（以 e 为底）。	`${log(metric)}`
`mod(dividend, divisor)`	返回整除的余数。	`${mod(10, 3)}` → `1`
`formatDate(date, format?)`	日期格式化。支持自定义格式。	`${formatDate(created_at, "YYYY-MM-DD")}`
`formatDuration(ms)`	毫秒时长转人类可读格式。	`${formatDuration(metric)}` → `3d 4h 5m`
`formatPercentage(value)`	小数转百分比。	`${formatPercentage(metric)}` → `75%`
`getVariable(name)`	获取用户自定义变量值。	`${getVariable("Case Id")}`

提示： 可以嵌套函数或结合算术运算。例如：

${formatPercentage(round(metric / total, 2))}

该表达式计算比率，保留两位小数并输出为百分比。

结合指标、属性、运算符和函数，您可以让仪表盘不仅展示数字，更能讲述业务故事。表达式支持动态文本和计算洞察，用户筛选或分析 data 时自动刷新。

无论是展示百分比、重点突出 KPI，还是格式化数值，表达式都能让仪表盘更加信息丰富、可操作且有吸引力，无需写代码。

使用这些工具，帮助用户获得有意义的洞察，发现趋势，让数据更易理解。只要善用创意，您的仪表盘能成为支持决策的智能交互平台。