快速開始：完成第一個 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__ 時指令碼不會錯誤訊息；
操作全過程使用測試環境；
文件、指令碼和截圖不包含真實認證資料。