Massengeräte-Instanziierung (Excel)

• Tutorial

Tutorial

Dieses Tutorial beschreibt die empfohlene Methode, um eine große Anzahl von Geräten in Immersive zu erstellen und zu warten Verwendung eines Excel. Es präsentiert die Struktur der Datei, die Informationen, die zur Definition der Geräte und ihrer Definition notwendig sind Handles sowie den Importprozess aus dem Backoffice Enhancer.

Erinnerung: Handle oder Variablenprinzip

Ein Griff (oder eine Variable) stellt eine Eigenschaft eines Geräts dar. Es ist die Verbindung zwischen Daten eines Sensors oder statischen Daten und dessen Darstellung in der Schnittstelle.

Um einen Handle zu definieren, ist es unerlässlich, mindestens vier Informationen auszufüllen:

• Sein Name : Der in der Benutzeroberfläche angezeigte Text zur Referenz auf die Variable.
• Sein Typ : zum Beispiel ein Boolean für einen trockenen Kontakt, ein Single für numerische Daten wie einen Temperatursensor oder ein String für einen Zustand.
• Sein Weg : die Verbindungszeichenkette, die verwendet wird, um zu definieren, wie die Variable ihren Wert aus der Anwendung abruft (Beispiel: BuildingSensor://temp/Temperature).
• Seine Kategorie (Standardinformation):
  • Informationen —Ist die Standarddarstellung einer Variablen. Es löst kein bestimmtes Verhalten aus, außer dass sein Wert im dedizierten Informationsblock angezeigt wird.
  • Default : Ausgestellt im speziellen Block der Ausrüstung. Wenn die Variable auf true, 1 oder kb gesetzt ist, wird sie rot angezeigt und das Gerät gilt in der Anwendung als fehlerhaft.
  • Instandhaltung : Ausgestellt im speziellen Block der Ausrüstung. Wenn die Variable auf true, 1 oder kb gesetzt ist, wird sie orange angezeigt und das Gerät gilt in der Anwendung als gewartet.
  • Anbindung : Ausgestellt im speziellen Block der Ausrüstung. Wenn die Variable auf true, 1 oder KB gesetzt wird, wird das Gerät vollständig von der Anwendung getrennt.

Massengeräte-Instanziierung (Excel)

Obwohl es möglich ist, die Ausrüstung direkt aus dem Backoffice (Enhancer) zu erstellen, basiert die am häufigsten verwendete Methode zur Erstellung und Wartung der Geräte auf der Verwendung einer Excel-Datei (Link zur Excel-Vorlage).

Diese Excel-Datei beschreibt die vollständige Liste der Griffe sowie Informationen zu den Geräten, an die sie angeschlossen sind. Nach Abschluss kann es in das Backoffice (Enhancer) importiert werden, um automatisch Geräte, Gerätefamilien und zugehörige Handles zu erstellen.

Jede Zeile im Blatt einer Familie stellt einen Handle dar, und jede Spalte repräsentiert ein Datenstück, das mit diesem Handle verbunden ist. (Die Werte genügten durch ein Asterix * stellen die erforderlichen Daten dar, die für einen Handle deklariert werden müssen, die anderen bleiben optional).

• Umfang * : Der Name des Scopes, zu dem das an diesem Griff befestigte Gerät gehört. (Beispiel: Mein Gebäude)Diese Informationen müssen für alle Handles derselben Ausrüstung gleich sein.
• Familie * : Der Name der Familie der Ausrüstung, zu der der Griff gehört. (Beispiel: Temperatursensor)Diese Informationen müssen für alle Handles derselben Ausrüstung gleich sein.
• Gerätename * : Der Name des Geräts (angezeigt an der Schnittstelle), zu dem der Handle gehört. (Beispiel: Sensorraum)Diese Informationen müssen für alle Handles derselben Ausrüstung gleich sein.
• Ausrüstungsreferenz * :Die EINZIGARTIGE Referenz der Ausrüstung, zu der der Griff gehört. (Beispiel: MyBuilding/Temperature/Room 1). Diese Informationen müssen für alle Handles derselben Ausrüstung gleich sein und dürfen sich niemals ändern. Dies ist die Kennung, die von Immersive verwendet wird, um zu erkennen, wann ein Gerät aktualisiert wird.
• Beschreibung : Eine optionale Beschreibung, die dem Gerät hinzugefügt wird, zu dem der Griff gehört.
• Lage : Eine optionale Position, die dem Gerät hinzugefügt wird, zu dem der Griff gehört.
• Interoperabilitäts-ID : Eine optionale Interoperabilitätskennung
• Eigentum * : Der Name des Griffs (Beispiel: Temperatur)
• Eigenschaftsreferenz : Ein Geschäftscode zur Referenz auf den Handle in Skripten (Beispiel: TEMP)
• Interoperabilitäts-ID : Eine Geschäftskennung, die mit dem in einer anderen Umgebung deklarierten Handle verknüpft ist.
• Pfad / Chemin * : Die Verbindungszeichenkette, die definiert, wie der Handle seinen Wert aus der Anwendung abruft (Beispiel BuildingSensor://temp/Temperature). Weitere Informationen finden Sie im Tutorial, das mit dem Hub verbunden ist. Um einen Wert einer fest codierten Variablen zu setzen, ohne mit dem Hub verbunden zu sein, präfixieren Sie ihn einfach mit "Value://" (Beispiel: Value://35)
• Typ * : Der Typ des Handles (Beispiel Single für eine numerische Variable, String für eine String oder Boolean für eine 2-State-Variable).
• Physikalische Größe : Die physikalische Größe, die von dieser Variablen gemeldet wird. (Beispiel: Temperatur)
• Einheit : Die Maßeinheit. (Beispiel: Celsius)
• Automatischer Status : Die Handle-Kategorie. Weitere Informationen finden Sie im Tutorial zu den Variablenkategorien.
• Optionen : Verschiedene Optionen zur Feinjustierung des Verhaltens dieses Handles in der Schnittstelle. Insbesondere, um die Variable vor den Nutzern zu verbergen.
• Abzeichen / Kritikalität : Ein Name des Abzeichens. Weitere Informationen finden Sie im Tutorial zu den Kritikalitätsabzeichen.
• Priorität : Eine Priorität, eine Variable gegenüber den anderen hervorzuheben.

Beispiel für die Definition von zwei Griffen, die demselben Gerät zugewiesen sind:

Sobald die Datei ausgefüllt wurde, ist es nun notwendig, sie in Immersive zu importieren.

Excel-Import aus dem Backoffice (Enhancer)

In diesem Tutorial schauen wir uns an, wie man eine Bulk-Ausrüstungs-Instanziierungsdatei importiert.

Alle Aktionen in diesem Tutorial werden aus der Kategorie ausgeführt Métier > IOT deines immersiven Backends.

Einmal in der Kategorie IOT, klick Page d’import/export In der BOC Imports um das nächste Fenster zu öffnen.

Sobald Sie auf der Seite Import/Export sind, klicken Sie auf die Uploader un fichier, wähle die Datei aus, die du importieren möchtest, und klicke auf Ouvrir

Nach dem Import zeigt das Importwerkzeug folgende an:

• Bei Erfolg: eine Vorschau in Form einer Hierarchie der Änderungen (Erstellung, Änderung oder Löschung), die er an der Datenbank vornehmen wird.
• Beim Ausfall: der Grund für das Scheitern (z. B. Dateiformat, das nicht beachtet wurde)

Wenn erfolgreich, zeigt das System folgende an:

• Änderungen an den Umfangen (Ergänzung)
• Änderungen an Ausrüstungsfamilien (Erweiterung)
• Ausrüstungsmodifikationen (Ergänzung, Modifikation)
• Modifikationen an den Ausrüstungsgriffen (hinzufügen, ändern, löschen)

Wenn ein Objekt bereits existiert und keine Änderungen erfahren hat, wird es ignoriert.

Beim Import können nur Handles gelöscht werden, da das Importieren einer Datei keinen bestehenden Scope, keine Familie oder Geräte löscht.

Wenn mindestens ein Griff für ein Gerät deklariert wird, werden die vorhandenen Griffe, die mit dem Gerät verbunden sind, durch die neue(n) ersetzt.

Die Ausrüstung wird mit der Eigenschaft "Equipment reference" identifiziert, weshalb es wichtig ist, dass sie sich nicht ändert. Wenn sie sich ändert, gilt die Ausrüstung als neu.

Nachdem du die Aktionen gesteuert hast, die der Import in der Datenbank ausführt, musst du nur noch auf klicken Appliquer les changements um den Import in der Datenbank zu speichern.