Inhaltsverzeichnis
<texit info> author=Alexander Krause title=Clever2Link - Dataobjecs/Templates backgroundtext=Clever2Link recurse=on </texit>
Templates/Vorlagen
Die Template Funktion wird hauptsächlich durch das Ordner-Link Objekt realisiert. Der Grundlegende Ablauf sieht wie folgt aus:
- Erstellen einer Objektstruktur mit
- Ordnern/Unterordnern
- Datenpunkten
- mit dynamischen Eigenschaften (siehe Unten)
- Erstellen eines Links, außerhalb der Struktur
- target Eigenschaft ist die Objekt-Nummer vom Template-Objekt der Objektstruktur (ab Version 1.22.0 dataobjects kann auch auf Objekte mit der Eigenschaft „is“ verwiesen werden)
- Link auflösen
Beispiel: Objektstruktur einer Clever2Link Funktzentrale
- Template-Objekt der Objektstruktur ist der Ordner `WHZ`
- `room[?]` ist Template für `room[0]` bis `room[9]`
dynamische Eigenschaften
Mitunter werden Templates auch innerhalb des gleichen Gerätes benutzt, dies bedeutet, dass die Eigenschaft address unterhalb jedes Links angepasst werden muß.
Beispiel
Aufgabe
- ein iLON hat 30 Datenpunkte mit folgenden Adressen
- Raumname: NVL_name_200 .. NVL_name_210
- Sollwert: NVL_setpoint_200 .. NVL_setpoint_210
- Istwert: NVL_temperature_200 .. NVL_temperature_210
- die Datenpunkte sollen nach Raum gruppiert werden, das Template sähe wie folgt aus
- Raum
- Name
- Sollwert
- Istwert
- es werden nun 10 Links erstellt, welche alle auf das selbe Template verweisen
Problem
- Anpassung der Adresse für jeden Datenpunkt nötig
Lösung
- Benutzen von dynamische Eigenschaften
- jeder Link besitzt zu der Eigenschaft address eine 2te, welche den Raumindex angibt
- z.B. rid für Raum-ID
- rid wird nun für jeden der 10 Links festgelegt, der Name spielt keine Rolle
- 1. Link: name=raum[0],rid=0
- 2. Link: name=raum[1],rid=1
- 3. Link: name=raum[2],rid=2
- dynamische Eigenschaften in dem Template benutzen
- name=Name, address=NVL_name_{200+$rid}
- name=Sollwert, address=NVL_setpoint_{200+$rid}
- name=Istwert, address=NVL_temperature_{200+$rid}
- beim Auflösen wird nun der Teil `{200+$rid}` durch 200, 201 usw. ersetzt
Syntax dynamischer Addressen
- Eigenschaften übergeordneter Objekte sind Variablen
- Eigenschaft eines untergeordneten Objektes hat mehr Priorität und überschreibt Folge-Eigenschaften
Beispiel
- Vater: Alter=30
- Sohn: Alter=10 → $Alter==10
- Tochter: → $Alter==10
- Onkel: → $Alter==10
- Tante: Alter=40 → $Alter==40
| Regulärer Ausdruck | Bedeutung | Beispiel |
|---|---|---|
| [\w_] | Konstante | 123 abc_123 |
| \$([\w_]+) | Variable | $rid $Alter |
| [\+\-\.\/\%] | Operator + Addieren - Subtrahieren . String-Addieren / Division % Modulo | |
| \|(%[\w]+) | Formatierung | |%02d |
Beispiele dynamischer Eigenschaften
- NVL_temperature_{200+$rid}
- NVL_temperature_200
- NVL_temperature_201
- NVL_temperature_{$rid}
- NVL_temperature_0
- NVL_temperature_1
- NVL_temperature_20
- NVL_oRmTemp{$rid|%02d}_{200+$wid}
- NVL_oRmTemp00_200
- NVL_oRmTemp11_210
- NVL_oRmTemp99_201
Auflösen
- Objekte, welche im Template vorhanden sind, aber nicht im Link werden neu erzeugt
- Objekte, welche nicht im Template sind werden gelöscht
- Objekte mit gleichen Namen bleiben erhalten (Objet-Id bleibt gleich)
- neue Eigenschaften werden bei vorhandenen Objekten im Link hinzugefügt
- alte Eigenschaften werden gelöscht, außer sie beginnen und enden mit einem _
- Beispiel: _nid_