简单字段计算使用单个数学表达式进行实时计算。 支持基本算术运算(+、-、*、/)及标准函数如sqrt、pow、abs、min、max。 适用于轻量转换与派生值,无需脚本。
在需要快速、声明式计算时使用简单字段计算,例如:
- 归一化与缩放(乘数、偏移、校准系数)
- 派生传感器指标(如露点、热指数、功率 = 电压 × 电流)
- 基于阈值的值(限幅、简单评分、差值)
- 跨实体计算(如合并设备遥测与资产属性)
配置
打开 创建字段计算 对话框并指定:
- 字段计算 title;
- 将应用字段计算的 entity或entity profile;
- 选择 “Simple” 作为字段计算 type。
参数
简单字段计算的arguments可为latest telemetry或attribute。 数据源可为Current entity、另一Device/Asset、Customer、Current tenant或Current owner。
参数类型与配置详见 Arguments。
表达式
在 Expression 区域使用单个数学公式定义计算。
- 按名称直接引用 argument 变量(如temperature、humidity)
- 支持算术运算(+、-、*、/)及标准函数如 abs、sqrt、pow、min、max。
- 产生单个结果值,保存在配置的输出key下
输出
计算结果以 time series 或 attribute 形式存储。
在Output中指定:
- Key — 存储计算值的名称
- Decimals — 可选舍入
[仅适用于Time series]
Use latest timestamp — 使用最新argument时间戳而非服务器时间存储结果。
输出类型与处理策略详见 Output。
示例:露点计算
场景
Smart Device实时发送 temperature 与 humidity 遥测。
目标
计算露点,并将结果以遥测形式存储在同一设备的 dewPoint key下。
字段计算配置
下载“露点计算”字段计算配置 (JSON)。
配置步骤
1. 导入演示设备
导入发布温度和湿度遥测的设备。
- 下载CSV文件:dew-point-calculation-device-data.csv
- 转到“设备”并导入该CSV文件。
CSV包含:
- 名称: Smart Device
- 类型: smart-device
- 时间序列: humidity、temperature
关于CSV的重要说明: humidity 和 temperature 键的列类型必须设置为“时间序列”。
2. 将字段计算应用于设备配置
导入智能设备时,系统会自动创建“smart-device”配置文件并将其分配给该设备。
将字段计算应用于此配置文件,以便它在使用同一配置文件的所有设备上运行。
- 下载字段计算配置文件 (JSON)。
- 转到“字段计算”标签页并导入配置。
此示例中使用的表达式:
1
2
(243.04 * (ln(humidity / 100) + 17.625 * temperature / (243.04 + temperature)) /
(17.625 - (ln(humidity / 100) + 17.625 * temperature / (243.04 + temperature))))
输出设置:
- 输出类型: 时间序列
- 键: dewPoint
转到“字段计算”标签页并导入字段计算配置。
将字段计算应用于“smart-device”配置文件,使其在所有使用该配置文件的设备上运行。
第一个参数设置:
- 实体类型: 当前实体
- 参数类型: 最新遥测
- 时间序列键: humidity
- 参数名称: humidity。
第二个参数设置:
- 实体类型: 当前实体
- 参数类型: 最新遥测
- 时间序列键: temperature
- 参数名称: temperature。
指定的数学表达式计算露点。
输出值以时间序列的形式存储在“dewPoint”键下。
点击“添加”保存字段计算。
结果
露点被计算并作为遥测保存在智能设备上,存储在 dewPoint 键下。