数据模型与分组
Edge-EMS Builder 将点位分为四类,用 dataKey 连接采集、计算、策略与共享,业务脚本无需直接操作设备寄存器。
| 类型 | 来源 | 常见用途 |
|---|---|---|
| 原始数据(Collection) | CommBridge 采集值、通信状态 | 电压、温度、设备状态;可写点位也可用于控制 |
| 聚合数据(Aggregation) | Lua 表达式,或保存的运行值 | 功率合计、状态判断、运行变量 |
| 分时数据(Customization) | 带生效区间的人工或策略配置 | 电价、运行模式、计划曲线 |
| 共享数据(Share) | 其他 EMS Builder 节点 | 跨节点计算及控制 |
共享点位同时使用来源设备编码和 dataKey 寻址。写入原始或共享数据最终要看目标设备的可写性与权限,不能把所有采集点都当作控制点。
点位属性与换算
Section titled “点位属性与换算”点位带有名称、别名与单位,共享时会同步相关属性。原始点位可同步 CommBridge 的读取系数;未配置系数和状态点可返回空值。
采集写入的系数反算由 CommBridge 完成,Edge-EMS Builder 脚本或调用方无需再次换算。读取值和下发目标值应采用已确认的工程单位。
- DAILY_CHANGE:每个值通过完整日期时间区间生效。
- DAILY_REPEAT:每个值使用每日时段,配置层另设整体生效日期范围。
例如每日重复电价可以设置 08:00~12:00 的价格,并指定整份计划适用的日期。更换整份计划前,应检查原有时段与重叠关系。
聚合计算与运行值
Section titled “聚合计算与运行值”聚合点可以按表达式计算,也可以用 useLatestValue 保存并读取运行值。创建运行变量时可设置初值;通过 UDE 生成时,还可使用初始值模板。
公式中的缺失数据是 __Null__ 字符串。数值计算使用 tonumber 并明确缺失处理,避免把无数据当作零。函数与示例见 表达式引擎。
四类点位都可加入父子分组。可设置子分组和组内点位顺序、修改基础信息,并在删除时选择是否处理子分组。按分组查询或订阅数据,便于按设备、区域或用途组织界面。
同类设备大量重复时,可用 UDE 模板 自动生成分组与映射。