Der Asset-Baum zeigt, was worin enthalten ist. Relationen sagen mehr: welcher Controller eine Pumpe steuert, welche Pumpe einen Tank speist, welche Kamera eine Tür überwacht. Eine Relation verbindet zwei Enden, jeweils ein Asset oder ein Gerät, mit einem Typ und einer Richtung.
Relationstypen
| Typ | Lesart | Beispiel |
|---|---|---|
| Contains | von einem Asset zu einem Gerät | Room 1 contains Sensor 4. Das ist die Platzierung des Geräts. |
| Manages | A manages B | Ein Controller steuert eine Pumpe |
| Feeds | A feeds B | Pump 2 feeds Tank 1; eine USV versorgt einen Standort |
| Monitors | A monitors B | Eine Kamera überwacht eine Tür |
| Eigene | wie du sie definierst | BACKS_UP, SERVES, METERS |
Eigene Typen haben 1 bis 32 Zeichen: zuerst ein Buchstabe, danach Buchstaben, Ziffern und _. Sie werden in Großbuchstaben gespeichert.
Regeln:
- Eine Relation gilt in eine Richtung: von einem Ende zum anderen. „Pump 2 feeds Tank 1“ ist nicht dasselbe wie „Tank 1 feeds Pump 2“.
- Die beiden Enden müssen verschieden sein: „A relation needs two different ends.“
- Dieselbe Relation (gleiche Enden, gleicher Typ) gibt es nur einmal: „This relation already exists.“
- Contains gilt nur von einem Asset zu einem Gerät und ist die Platzierung des Geräts: eine pro Gerät. Setze sie mit der Platzierung, nicht als Relation. Siehe Placing devices.
- Ein Asset innerhalb eines anderen Assets ist nie eine Relation: Verschiebe stattdessen das Asset („An asset inside another asset is set by moving it, not by a CONTAINS relation.“).
- Eine Relation kann bis zu 20 Schlüssel (4 KiB) zusätzlicher Informationen tragen, zum Beispiel eine Rohrgröße.
Relationen ansehen
Öffne ein Asset unter Sites & Assets. Der Abschnitt Relations im Drawer listet die Relationen zu und von dem Asset auf:
| Spalte | Zeigt |
|---|---|
| Relation | Den Typ |
| From | Das erste Ende, Asset oder Device, mit seinem Namen |
| To | Das andere Ende |
Mit Search relations findest du eine Relation, mit Remove relation löschst du sie (du brauchst Manage relations and device placement). „No relations.“ bedeutet, dass es keine gibt.
Relationen anlegen
Relationen außer Platzierungen werden über die API angelegt:
POST /tenant/<tenantId>/api/iot/relations
{ "fromType": "DEVICE", "fromId": "<pump id>", "toType": "DEVICE", "toId": "<tank id>", "type": "FEEDS" }Enden sind ASSET oder DEVICE. Auflisten mit GET /api/iot/relations?entityType=DEVICE&entityId=<id> (beide Richtungen), löschen mit DELETE /api/iot/relations/<relationId>. Siehe Sites and assets API. Manche fertigen Lösungen legen ihre Relationen bei der Installation an, zum Beispiel eine USV, die einen entfernten Standort versorgt.
Ein gelöschtes Asset beendet seine Relationen. Ein Gerät ist anders: Ein Gerät, das platziert ist oder eine Relation hat, kann nicht gelöscht werden („The device is still in use by 1 asset placement or relation (iot_asset).“). Entferne zuerst seine Platzierung und Relationen.
Relationen in Boards verwenden
Ein Dashboard-Parameter kann seine Entitäten Related to another parameter or entity wählen, zum Beispiel „die Geräte, die ein Controller steuert“ oder „alle Geräte unter diesem Standort“ über Contains. Du wählst den Relationstyp, die Richtung und wie viele Ebenen verfolgt werden (1 bis 10). Siehe Data sources and parameters.
Die Vorlage Sites nutzt das, um im Auswahlfeld Device die Geräte eines Standorts anzubieten: Sie folgt Contains vom Standort abwärts, bis zu 10 Ebenen.
Relationen in Flows verwenden
Der Block Related data fügt einer Nachricht Daten verbundener Assets und Geräte hinzu:
| Einstellung | Bedeutung |
|---|---|
| Richtung | from das Gerät der Nachricht (was es steuert, seine Untergeordneten) oder to es (seine Übergeordneten, wer es steuert) |
| Relationstypen | Standard Contains; ein beliebiger Typ, oder keiner für alle |
| Tiefe | 1 bis 8 Ebenen |
| Entitätsart, Arten, Profile | nur Assets, nur Geräte, Assets bestimmter Arten, Geräte bestimmter Profile |
| Daten | Attribute, letzte Werte (Geräte) oder Felder (Name, Art, Code, …) |
In Flows zählt der Asset-Baum als Contains-Relationen von jedem Elternteil zu seinen Kindern, und eine Platzierung ist Contains vom Asset zum Gerät. So findet to, Contains, 3 Ebenen, nur letzte Ebene, Art SITE den Standort eines Geräts drei Ebenen darüber. Siehe IoT data blocks.
Beispiele
| Ziel | Relationen |
|---|---|
| Die Pumpen eines Tanks auf der Seite des Tanks anzeigen | Pumpe Feeds Tank; ein Parameter „related to the tank, direction to, type Feeds“ |
| Den Tarif des Standorts zu jedem Zählerstand hinzufügen | Zähler unter dem Standort platziert; Standort-Attribut tariff; Related data zum Standort |
| Wissen, welche Kamera einen Türsensor überwacht | Kamera Monitors Türsensor |
| Ein Controller mit seinen Sensoren | Controller Manages jeden Sensor |