デバイスユニットの動的拡張（UDE）

UDE は共通テンプレートで同種デバイスを管理します。デバイス追加時に集約ポイント、グループ、共有設定を自動生成し、テンプレートの変更後は「差分照合」で既存インスタンスを同期・更新できます。

テンプレートとインスタンス

オブジェクト	役割
デバイスユニットタイプ	同種デバイスの命名規則とテンプレートを定義
デバイスユニットインスタンス	特定のデバイス上の具体的なユニット。例：METER#1
集約テンプレート	計算ポイント、単位、式、初期値を生成
グループテンプレート	親子グループ、ポイントマッピング、並び順を生成
共有テンプレート	共有ポイント一覧を生成し、共有先を関連付け

システムは集約 → グループ → 共有の順に処理し、後の段階から前の段階の結果を参照できます。グループテンプレートはツリー照会と親グループの指定に対応し、個々のインスタンスでルートの親グループを上書きすることもできます。

命名と自動検出

例えば METER#1_power では、METER#1 がインスタンスプレフィックス、power がポイントサフィックスです。プレフィックスにアンダースコアは使用できません。同一デバイス上でプレフィックスを一意にし、同種デバイスには同じサフィックス規則を使用してください。

CommBridge 設定の同期時や共有データの受信時に、規則に合うインスタンスを検出します。既存データを走査して、後からテンプレートを設定したデバイスを補完することもできます。

動的プレースホルダー

デバイスごとに名前、グループ位置、データソースが異なる場合でも、{token} プレースホルダーで同じテンプレートを再利用できます。

• ルールセット：プレースホルダーをまとめ、デバイスユニットタイプへ関連付けます。
• 照合ルール：デバイスコード、インスタンスプレフィックス、シリアル番号に基づいてプレースホルダーの値を生成します。
• 適用範囲：グループ、送信元デバイス、式、初期値、共有設定にそれぞれ適用します。
• 試算と影響プレビュー：保存前に展開結果を確認し、ルールの無効化・削除前に影響範囲を確認します。

UDE の {token} はテンプレート生成時に処理されます。一方、Lua の ${dataKey} は式の実行時にポイントを読み取ります。用途が異なるため、テンプレート試算後にも生成された Lua 式を検証してください。

差分照合による設定更新

差分照合は不足設定を補完し、テンプレートが管理するフィールド、グループマッピング、共有の関連付けを更新します。単に追加だけを行う処理ではありません。

1. タイプとテンプレートを定義し、参照する親グループと共有先を用意します。
2. テストインスタンス 1 つで差分照合を実行し、生成結果を確認します。
3. 確認後、そのタイプまたは全タイプに一括差分照合を実行します。
4. インスタンスの具体化状態とエラーを確認します。API が「スケジュール済み」と返しても、バックグラウンド処理が続いている場合があります。

現行バージョンでは、テンプレートの保存・削除時に変更を検証し、影響する既存インスタンスの処理をスケジュールします。公開前に影響範囲を確認してください。親グループが未準備の場合は状態と再試行情報を確認し、依存関係を修正してから結果を再確認してください。

生成設定は帰属情報とフィンガープリントを持ち、テンプレート変更と手動変更の競合を検出します。集約テンプレートの初期値が変わっていなければ、差分照合を繰り返しても通常の動作値を既定値へリセットしません。テンプレート削除やコード変更後も、古い業務オブジェクトがすべて自動削除されるとは限らないため、参照とクリーンアップ結果を確認してください。

適したシーン

同じモデルの増設、複数拠点での設定再利用、多数のデバイス管理では、UDE が設定の繰り返しを減らします。少数の固定デバイスであれば、ポイントを直接管理することもできます。

関連機能：データモデル、デバイス共有。Agent から設定する場合は、UDE と動的プレースホルダーの Skills で、テンプレート・インスタンス設定と、ルール試算・影響分析・公開をそれぞれ行えます。