快速开始：完成第一个 EMS Builder 策略闭环

本指南使用测试环境完成“读取采集点位 → 试算聚合表达式 → 创建聚合点位 → 验证结果”的最小闭环。请勿直接在生产设备上执行未经审核的写入。

一、准备条件

Edge-EMS Builder 已安装并正常启动；
CommBridge 已连接至少一个测试设备或模拟器；
已准备 Edge-EMS Builder 管理员测试账号；
已确认 Edge-EMS Builder 地址：
- 局域网直连：http://<设备IP>:8988
- JelinaCloud 代理：https://<设备UUID>.proxy.jelina.wise-iot-cloud.com/api

地址、端口和账号均使用你自己的测试环境信息。不要把真实密码、Token 或设备 UUID 提交到代码仓库。

二、确认 EMS Builder 与 CommBridge 数据

登录 Edge-EMS Builder 管理页面。
打开“采集数据”列表。
确认至少存在两个数值型采集点位，例如：
- voltage_a
- voltage_b
检查点位具有最新值，且通信状态正常。

如果没有采集点位，请先检查：

CommBridge 项目、节点和采集任务是否启用；
Edge-EMS Builder 的 CommBridge WebSocket 地址是否正确；
设备或模拟器是否在线；
Edge-EMS Builder 与 CommBridge 日志中是否存在连接或配置错误。

三、试算聚合表达式

在“聚合数据”页面选择“试算”，输入：

if ${voltage_a} == "__Null__" or ${voltage_b} == "__Null__" then
    return 0
end

local a = tonumber(${voltage_a}) or 0
local b = tonumber(${voltage_b}) or 0
return (a + b) / 2

将示例中的 voltage_a、voltage_b 替换成测试环境中真实存在的 dataKey。

预期结果：

表达式语法校验通过；
返回一个数值；
返回值等于两个采集点位的平均值。

四、创建第一个聚合点位

试算通过后，创建聚合点位：

字段	示例
dataKey	`voltage_avg`
名称	平均电压
数据类型	float
表达式	使用上一步试算通过的 Lua
采集/计算周期	按测试环境要求设置

保存后：

返回聚合数据列表；
确认 voltage_avg 已生成；
改变模拟器中的 voltage_a 或 voltage_b；
确认 voltage_avg 随之更新。

五、使用 API 完成同样的操作

Edge-EMS Builder 对应接口包括：

POST /account/login
GET /collection-data-config/list
POST /aggregation-data-config/calculate
POST /aggregation-data-config/add
GET /aggregation-data-config/list

登录请求示例：

{
  "mail": "<测试账号>",
  "password": "<测试密码>"
}

后续请求使用登录接口返回的 Token。具体请求头、字段和返回结构请参考 Edge-EMS Builder HTTP 接口文档；不要在文档、脚本或截图中保留真实凭据。

六、下一步：创建触发方案

完成聚合点位后，可继续学习：

建议先在测试环境创建“高温告警”或“测试点位变化记录”这类无设备控制风险的触发方案，再进入真实设备写入场景。

七、完成标准

能看到 CommBridge 推送的采集点位；
聚合表达式试算通过；
聚合点位成功创建并刷新；
输入为 __Null__ 时脚本不会报错；
操作全过程使用测试环境；
文档、脚本和截图不包含真实凭据。