データモデルとグループ

Edge-EMS Builder はデータポイントを 4 種類に分け、dataKey で収集、計算、制御ロジック、共有を結び付けます。業務スクリプトでデバイスレジスターを直接操作する必要はありません。

4 種類のデータ

種類	データソース	主な用途
生データ（Collection）	CommBridge の収集値と通信状態	電圧、温度、デバイス状態。書き込み可能なポイントは制御にも使用可能
集約データ（Aggregation）	Lua 式、または保存された動作値	電力合計、状態判定、動作変数
時間帯別データ（Customization）	有効期間を持つ手動設定または制御設定	電気料金、運転モード、計画曲線
共有データ（Share）	他の EMS Builder ノード	ノード間の計算と制御

共有ポイントは、送信元デバイスコードと dataKey の両方で指定します。生データや共有データへの書き込み可否は、最終的に対象デバイスの書き込み対応と権限によって決まります。すべての収集ポイントを制御ポイントとして扱うことはできません。

ポイントには名前、エイリアス、単位があり、共有時にこれらの属性も同期します。生データポイントには CommBridge の読み取り係数を同期できます。係数未設定のポイントや状態ポイントでは空値が返ることがあります。

収集データへの書き込み時の係数の逆変換は CommBridge が行うため、Edge-EMS Builder スクリプトや呼び出し元で再度換算する必要はありません。読み取り値と送信する目標値には、確認済みの工学単位を使用してください。

例えば毎日繰り返す電気料金では、08:00～12:00 の料金と、スケジュール全体の適用日付範囲を設定できます。スケジュール全体を置き換える前に、既存の時間帯と重複を確認してください。

集約ポイントは式による計算にも、useLatestValue による動作値の保存・読み取りにも使用できます。動作変数の作成時に初期値を設定でき、UDE から生成する場合は初期値テンプレートも使用できます。

式の中では欠損データを文字列 __Null__ で表します。数値計算には tonumber を使用し、欠損時の処理を明示して、データなしをゼロとして扱わないようにしてください。関数と例は式エンジンを参照してください。

4 種類のポイントは、すべて親子グループへ追加できます。子グループやグループ内ポイントの順序、基本情報を変更でき、削除時には子グループの処理方法を選択できます。グループ単位のデータ照会や購読により、デバイス、区域、用途に応じた画面を構成しやすくなります。

同種デバイスの設定が多数繰り返される場合は、UDE テンプレートでグループとマッピングを自動生成できます。