資料模型與分組
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 範本 自動產生分組與映射。