Zum Inhalt springen
JelinaJelina DocumentationTechnische Dokumentation
Zur Website

Dynamische Erweiterung von Geräteeinheiten (UDE)

UDE verwaltet gleichartige Geräte anhand gemeinsamer Vorlagen. Neue Geräte erhalten automatisch Aggregationsdatenpunkte, Gruppen und Freigabekonfigurationen. Nach Vorlagenänderungen können vorhandene Instanzen durch einen „Abgleich“ aktualisiert werden.

Objekt Aufgabe
Geräteeinheitstyp Definiert Namensregeln und Vorlagen für gleichartige Geräte
Geräteeinheitsinstanz Konkrete Einheit auf einem Gerät, beispielsweise METER#1
Aggregationsvorlage Erzeugt berechnete Datenpunkte, Einheiten, Ausdrücke und Anfangswerte
Gruppenvorlage Erzeugt über- und untergeordnete Gruppen, Datenpunktzuordnungen und Sortierung
Freigabevorlage Erzeugt Listen freigegebener Datenpunkte und ordnet Freigabeziele zu

Das System verarbeitet in der Reihenfolge Aggregation → Gruppen → Freigabe. Jeder Schritt kann Ergebnisse des vorherigen verwenden. Gruppenvorlagen unterstützen hierarchische Abfragen und die Angabe einer übergeordneten Gruppe. Einzelne Instanzen können außerdem die übergeordnete Wurzelgruppe überschreiben.

Bei METER#1_power ist METER#1 das Instanzpräfix und power das Datenpunktsuffix. Das Instanzpräfix darf keinen Unterstrich enthalten und sollte innerhalb eines Geräts eindeutig sein. Gleichartige Geräte verwenden dieselben Suffixregeln.

Beim Synchronisieren der CommBridge-Konfiguration oder beim Eingang freigegebener Daten erkennt das System Instanzen, die den Regeln entsprechen. Bereits vorhandene Daten können ebenfalls durchsucht werden, um Geräte nachträglich mit später erstellten Vorlagen zu ergänzen.

Unterscheiden sich Geräte in Namen, Gruppenposition oder Quelle, können {token}-Platzhalter dieselbe Vorlage wiederverwendbar machen:

  • Regelsatz: Fasst Platzhalter zusammen und kann einem Geräteeinheitstyp zugeordnet werden.
  • Zuordnungsregeln: Erzeugen Platzhalterwerte anhand von Gerätecode, Instanzpräfix oder Seriennummer.
  • Geltungsbereich: Gruppen, Quellgeräte, Ausdrücke, Anfangswerte oder Freigabekonfigurationen.
  • Testberechnung und Auswirkungsvorschau: Prüfen das erzeugte Ergebnis vor dem Speichern und zeigen betroffene Bereiche vor dem Deaktivieren oder Löschen einer Regel.

UDE verarbeitet {token} beim Erzeugen der Vorlage; Lua liest mit ${dataKey} Datenpunkte zur Laufzeit des Ausdrucks. Beide Mechanismen haben unterschiedliche Aufgaben. Prüfen Sie nach der Vorlagensimulation daher auch die erzeugten Lua-Ausdrücke.

Der Abgleich ergänzt fehlende Konfigurationen und aktualisiert von Vorlagen verwaltete Felder, Gruppenzuordnungen und Freigabebindungen. Er fügt also nicht ausschließlich neue Objekte hinzu, sondern ändert auch bestehende.

  1. Definieren Sie Typ und Vorlagen und bereiten Sie referenzierte übergeordnete Gruppen sowie Freigabeziele vor.
  2. Führen Sie den Abgleich für eine Testinstanz aus und prüfen Sie das erzeugte Ergebnis.
  3. Führen Sie nach der Bestätigung einen Sammelabgleich für diesen Typ oder alle Typen aus.
  4. Prüfen Sie Materialisierungsstatus und Fehler der Instanzen. Wenn die Schnittstelle „Eingeplant“ meldet, kann die Verarbeitung im Hintergrund noch laufen.

Die aktuelle Version validiert Änderungen beim Speichern oder Löschen von Vorlagen und plant die Verarbeitung betroffener bestehender Instanzen ein. Prüfen Sie vor der Freigabe den Umfang der Auswirkungen. Ist die übergeordnete Gruppe noch nicht bereit, kontrollieren Sie Status und Wiederholungsinformationen, korrigieren Sie die Abhängigkeiten und prüfen Sie anschließend das Ergebnis erneut.

Erzeugte Konfigurationen enthalten Eigentumszuordnungen und Fingerabdrücke, um Vorlagenänderungen und Konflikte mit manuellen Anpassungen zu erkennen. Bleibt der Anfangswert einer Aggregationsvorlage unverändert, setzt ein erneuter Abgleich gültige Laufzeitwerte nicht auf den Standard zurück. Nach dem Löschen einer Vorlage oder Ändern eines Codes dürfen Sie ebenfalls nicht davon ausgehen, dass alle alten Fachobjekte automatisch gelöscht werden. Prüfen Sie Referenzen und Bereinigungsergebnisse.

UDE reduziert wiederholte Konfiguration, wenn weitere Geräte desselben Modells hinzukommen, mehrere Standorte Konfigurationen gemeinsam nutzen oder viele Geräte vorhanden sind. Bei wenigen unveränderlichen Geräten können Datenpunkte auch direkt verwaltet werden.

Verwandte Funktionen: Datenmodell, Gerätefreigaben. Für die Konfiguration durch Agenten stehen Skills für UDE und dynamische Platzhalter bereit. Sie unterstützen Vorlagen und Instanzen sowie Regelsimulation, Auswirkungsanalyse und Freigabe.