Jedes Asset hat eine Art (was es ist), einen Code (ein kurzer eindeutiger Name, der in Pfaden verwendet wird) und kann Attribute (eigene Schlüssel-Wert-Daten) enthalten. Diese Seite erklärt die Regeln für jedes davon und wo sie eine Rolle spielen.
Arten
Die Liste Art im Asset-Formular bietet:
| Art | Typische Verwendung |
|---|---|
| Site | Ein Werk, eine Station, ein Depot: ein oberster Ort mit einem Standort |
| Building | Ein Gebäude einer Site |
| Floor | Ein Stockwerk eines Gebäudes |
| Room | Ein Raum, ein Kühlraum, ein Anlagenraum |
| Area | Eine Zone einer Etage oder eines Hofs |
| Line | Eine Produktions- oder Prozesslinie |
| Machine | Eine Maschine oder ein Anlagenteil |
| Other | Alles Übrige |
Sie können auch eine eigene Art verwenden: Wählen Sie Andere Art und geben Sie einen Namen der Art ein, zum Beispiel PUMP_STATION, TANK oder KITCHEN. Ein Artname hat 1 bis 24 Zeichen: zuerst ein Buchstabe, danach Buchstaben, Ziffern und _. Er wird in Großbuchstaben gespeichert. Plant, Region, Zone und Depot werden ebenfalls mit einem übersetzten Namen angezeigt.
Ein neues oberstes Asset beginnt als Site; ein neues untergeordnetes Asset beginnt als Building. Ändern Sie die Art vor dem Speichern.
Wo die Art eine Rolle spielt
| Ort | Wirkung |
|---|---|
| Sites & Assets | Das Art-Kennzeichen und der Filter Art |
| Vorlage Board Sites | „Sites“ sind Assets der Art Site; Die Sites eines Typs grenzt sie weiter ein |
| Drill-down-Tabellen (Status unter einem Asset) | Nur Knoten dieser Arten und Nur Knoten mit einem Knoten dieser Arten darunter filtern nach Art, zum Beispiel ROOM,FLOOR |
| 3D-Statusfärbung | Objekte werden anhand des Codes von Assets der Arten Room und Area eingefärbt |
| Flows (Zugehörige Daten) | Die Einstellung kinds behält nur Assets der aufgeführten Arten, zum Beispiel die SITE drei Ebenen darüber |
| Fertige Lösungen | Einige verwenden eigene Arten, zum Beispiel Zonen der Art ZONE in der Personenortung |
Arten begrenzen den Baum nicht: Jede Art kann unter jeder anderen stehen.
Codes
Der Code benennt ein Asset in seinem Pfad. Regeln:
| Regel | Details |
|---|---|
| Zeichen | Buchstaben, Ziffern, ., _, -; das erste ist ein Buchstabe oder eine Ziffer; niemals / |
| Länge | 1 bis 32 |
| Groß-/Kleinschreibung | Wird in Großbuchstaben gespeichert: bld-a wird zu BLD-A |
| Eindeutig | Innerhalb der Assets Ihrer Organisation: „Ein anderes Asset verwendet diesen Code bereits.“ |
| Leer | Wird aus dem Namen gebildet: Akzente entfernt, Großbuchstaben, andere Zeichen durch - ersetzt, höchstens 24 Zeichen, plus -2, -3, … falls belegt. „Compressor room“ wird zu COMPRESSOR-ROOM. |
Hinweis des Formulars: „Buchstaben, Ziffern, . _ – (höchstens 32). Leer lassen, um ihn aus dem Namen abzuleiten; eine spätere Änderung schreibt die unten stehenden Pfade neu.“
Pfade
Der Pfad eines Assets sind die Codes von oben nach unten, verbunden durch /:
/IST/BLD-A/GF/COMPRESSOR-ROOMDer Pfad wird in der Übersicht des Seitenfensters angezeigt und dient dazu, alles unter einem Asset zu finden. Das Ändern eines Codes schreibt in demselben Schritt die Pfade aller darunterliegenden Assets neu. Ein Pfad darf höchstens 1.024 Zeichen lang sein.
Beständige Codes wählen
- Verwenden Sie kurze, stabile Codes: eine Standortnummer, einen Gebäudebuchstaben, eine Raumnummer (
IST,BLD-A,R101). - In 3D-Szenen werden Räume und Bereiche anhand des Codes Szenenobjekten zugeordnet. Wenn Sie einen Code umbenennen, benennen Sie auch den Objektschlüssel um.
- Geben Sie Codes in beliebiger Schreibweise ein: Sie werden in Großbuchstaben gespeichert, daher sind
r101undR101derselbe Code.
Attribute
Attribute sind eigene Schlüssel-Wert-Daten eines Assets: eine Fläche, eine Kostenstelle, eine Vertragsnummer, eine Adresse eines Grundrissbildes. Der Abschnitt Attribute des Seitenfensters zeigt sie nur lesend an. Sie schreiben sie über die API:
PATCH /tenant/<tenantId>/api/iot/assets/<assetId>
{ "attributes": { "area_m2": 42, "cost_centre": "CC-4410", "contract": { "number": "M-77", "until": "2027-06-30" } } }Ein PATCH mit attributes ersetzt das gesamte Attributobjekt: Senden Sie jeden Schlüssel, den Sie behalten möchten. Siehe Sites- und Assets-API.
| Regel | Wert |
|---|---|
| Schlüssel | zuerst ein Buchstabe, danach Buchstaben, Ziffern, ., _, -; bis zu 64 Zeichen |
| Anzahl der Schlüssel | höchstens 100 |
| Größe | insgesamt höchstens 16 KiB JSON |
| Werte | Zahlen, Text, Wahrheitswerte, Objekte, Listen |
Wo Attribute verwendet werden
- Boards: Die Abfrage Ein Asset (Name, Art, Anzahl, Attribute) zeigt sie, zum Beispiel im Kopfbereich einer Site.
- Flows: Der Block Zugehörige Daten liest die Attribute eines Assets, zum Beispiel den Tarif der Site, in der ein Zähler steht. Siehe IoT-Datenblöcke.
- Fertige Lösungen: zum Beispiel das Grundrissbild einer Sensorregion oder das Beacon einer Personenortungszone.
Assets speichern keine Telemetrie. Live-Werte gehören zu Geräten; ein Asset zeigt die Werte und den Status der Geräte darunter.
Weitere Felder
| Feld | Festgelegt in | Verwendung |
|---|---|---|
| Beschreibung | Formular | Bis zu 1.000 Zeichen, im Seitenfenster angezeigt |
| Zeitzone, Breitengrad, Längengrad | Formular | Siehe Standorte und Zeitzonen |
Adresse (addressJson) | API | Bis zu 12 Textfelder; der Seitenkopf einer Site zeigt sie an, wenn die Site keine Assets darüber hat |
Standard-Dashboard (defaultDashboardId) | API | Die Schaltfläche Dashboard öffnen des Seitenfensters öffnet es |