表达式 (Expressions) 指南

ProcessMind 的表达式功能支持在仪表板中生成丰富文本和动态内容。通过使用表达式，您可以根据数据实时调整可视化，提高信息展示的灵活性和互动性。随着用户操作或数据刷新，内容可自动变化，帮助您的仪表板始终保持高相关性和分析价值。本文将介绍表达式的常见用法和示例，帮助您高效使用表达式。

初步使用时，您可以在文本中引用指标和属性实现动态内容，数据变化时内容自动更新。

我希望展示当前可见的 case 数与总数对比，表达式如下：

视图中的 case 数: ${metric} / 总 case 数: ${total}

其中 ${metric} 表示当前指标值，${total} 表示 case 总数。

我希望展示总数减去当前 case 数：

未包含的 case 数量: ${total - metric}

其中 ${metric} 表示当前指标值，${total} 表示 case 总数。

我希望展示当前视图 case 占总数的百分比：

视图中的 case 百分比: ${formatPercentage(metric)}

其中 ${metric} 为当前 case 指标值。

ProcessMind 支持多种函数，可在表达式内用于计算、格式化及动态查找。结合指标与属性，能实现更强大的动态文本输出。

函数	描述	示例
`round(value, decimals?)`	对数值四舍五入，可指定小数位数。	`${round(metric, 2)}` → `123.46`
`power(base, exponent)`	数值的 n 次方（与 `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 的 value 次方。	`${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))}

此表达式将比值四舍五入后转化为百分比。

通过灵活组合指标、属性、运算符和函数，您的仪表板不仅展示数字，更能讲述业务故事。表达式让动态文本和自动计算洞察成为可能，用户筛选或探索数据时，内容即时更新。

无论是展示百分比、突出 KPI 还是优化可读性，表达式都可帮助您使仪表板更具信息量、可操作性和视觉吸引力，无需自定义开发。

利用这些工具，轻松引导用户发现洞察、把握趋势，使数据更易理解。只需稍加创意，您的仪表板就能成为互动式叙事，助力智能决策。