跳到內容
返回官網

資料模型與分組

Edge-EMS Builder 將點位分為四類,用 dataKey 連線擷取、計算、策略與共享,業務指令碼無需直接操作裝置暫存器。

型別 來源 常見用途
原始資料(Collection) CommBridge 擷取值、通訊狀態 電壓、溫度、裝置狀態;可寫點位也可用於控制
聚合資料(Aggregation) Lua 運算式,或儲存的執行值 功率合計、狀態判斷、執行變數
分時資料(Customization) 帶生效區間的人工或策略設定 電價、執行模式、計畫曲線
共享資料(Share) 其他 EMS Builder 節點 跨節點計算及控制

共享點位同時使用來源裝置編碼和 dataKey 定址。寫入原始或共享資料最終要看目標裝置的可寫性與權限,不能把所有擷取點都當作控制點。

點位帶有名稱、別名與單位,共享時會同步相關屬性。原始點位可同步 CommBridge 的讀取係數;未設定係數和狀態點可回傳空值。

擷取寫入的係數反算由 CommBridge 完成,Edge-EMS Builder 指令碼或呼叫方無需再次換算。讀取值和下發目標值應採用已確認的工程單位。

  • DAILY_CHANGE:每個值透過完整日期時間區間生效。
  • DAILY_REPEAT:每個值使用每日時段,設定層另設整體生效日期範圍。

例如每日重複電價可以設定 08:00~12:00 的價格,並指定整份計畫適用的日期。更換整份計畫前,應檢查原有時段與重疊關係。

聚合點可以按運算式計算,也可以用 useLatestValue 儲存並讀取執行值。建立執行變數時可設定初值;透過 UDE 產生時,還可使用初始值範本。

公式中的缺失資料是 __Null__ 字串。數值計算使用 tonumber 並明確缺失處理,避免把無資料當作零。函式與示例見 運算式引擎。

四類點位都可加入父子分組。可設定子分組和組內點位順序、修改基礎資訊,並在刪除時選擇是否處理子分組。按分組查詢或訂閱資料,便於按裝置、區域或用途組織介面。

同類裝置大量重複時,可用 UDE 範本 自動產生分組與映射。

下一步:歷史查詢、觸發方案、裝置共享、前端讀寫。