OpenBOS

Die OpenBOS-App ermöglicht die Integration und Synchronisation zwischen Eliona und dem ABB Ability™ Buildings (OpenBOS).

Überblick

Dieses Handbuch bietet Anweisungen zur Konfiguration, Installation und Nutzung der OpenBOS-App, um Ressourcen zu verwalten und Daten zwischen Eliona und OpenBOS Edge zu synchronisieren.

Installation

Installieren Sie die OpenBOS-App über den Eliona App Store.

Konfiguration

Die OpenBOS-App muss über die Einstellungsoberfläche von Eliona konfiguriert werden. Im Folgenden finden Sie die Schritte zur Konfiguration der App.

Registrierung der App in OpenBOS

Um Eliona mit Ihrem OpenBOS Edge zu verbinden, muss das Edge so konfiguriert werden, dass API-Verbindungen erlaubt sind. Wenden Sie sich für weitere Informationen an den ABB-Support. Sie müssen die öffentliche API-URL von Eliona angeben: https://{ihr-eliona-domain.io}/apps-public/open-bos.

Eliona benötigt die Gateway-ID, die Client-ID und das Client-Secret für die Authentifizierung.

Konfiguration der OpenBOS-App

Konfigurationen können in Eliona unter Einstellungen > Apps > OpenBOS vorgenommen werden, was die Generic Frontend der App öffnet. Hier können Sie den entsprechenden Endpunkt mit der POST-Methode verwenden. Jede Konfiguration erfordert folgende Daten:

Attribut	Beschreibung
gwid	Die ID des Gateway-Geräts, das in den API-Anfragen verwendet wird.
clientID	Die Client-ID für die OAuth 2.0-Authentifizierung.
clientSecret	Das Client-Secret für die OAuth 2.0-Authentifizierung.
appPublicAPIURL	URL der öffentlichen API dieser App. Wird automatisch aus der Anfrage abgeleitet. Beispiel: "https://{ihr-eliona-instance.io}/apps-public/open-bos".
enable	Flag zum Aktivieren oder Deaktivieren des Abrufs von dieser API. Standard: true.
refreshInterval	Intervall in Sekunden für das Abrufen von Daten von der API. Standard: 60.
requestTimeout	Zeitüberschreitung für API-Abfragen in Sekunden. Standard: 120.
active	Wird von der App auf true gesetzt, wenn sie läuft, und auf false, wenn sie gestoppt wird. Nur lesbar.
projectIDs	Liste von Eliona-Projekt-IDs für die Datenerfassung. Für jede Projekt-ID werden alle Smart Devices automatisch als Assets in Eliona erstellt, mit Zuordnungen, die in der KentixONE-App gespeichert werden. Beispiel: ["42", "99"].

Beispiel für eine vollständige Konfigurations-JSON:

{
  "gwid": "1234acbd-3faa-ab32-ab32-21c3876ba",
  "clientID": "4321dcba-3faa-ab32-ab32-21c3876ba",
  "clientSecret": "your-client-secret",
  "appPublicAPIURL": "https://{ihr-eliona-instance.io}/apps-public/open-bos",
  "enable": true,
  "refreshInterval": 60,
  "requestTimeout": 120,
  "projectIDs": [
    "42",
    "99"
  ]
}

Einige Felder haben Standardwerte, sodass die minimale Konfigurations-JSON vereinfacht werden kann:

{
  "gwid": "1234acbd-3faa-ab32-ab32-21c3876ba",
  "clientID": "4321dcba-3faa-ab32-ab32-21c3876ba",
  "clientSecret": "your-client-secret",
  "projectIDs": [
    "42"
  ]
}

Kontinuierliche Asset-Erstellung

Nach der Konfiguration beginnt die App mit der kontinuierlichen Asset-Erstellung (Continuous Asset Creation, CAC). Entdeckte Ressourcen werden automatisch als Assets in Eliona erstellt, und der Benutzer, der die App konfiguriert hat, wird über das Benachrichtigungssystem von Eliona informiert.

Asset-Filterung

Falls nicht alle Assets von OpenBOS nach Eliona importiert werden sollen, kann ein Asset-Filter erstellt werden, der nur passende Assets einschließt. Die App kann Assets nach ID, Name und Template-ID (sowohl für Assets als auch für Räume) filtern.

Wenn nur wenige Assets ausgeschlossen werden sollen, können alle Assets in Eliona erstellt und die unerwünschten anschließend archiviert werden. Die App erstellt diese dann nicht erneut.

Asset-Typen

Asset-Typen werden automatisch aus OpenBOS-Assetvorlagen erstellt und synchronisiert.

Eliona	OpenBOS
Asset-Typ	Asset-Vorlage
Attribut - Input	Datenpunkt mit Richtung "Feedback"
Attribut - Output	Datenpunkt mit Richtung "Command" oder "CommandAndFeedback"
Attribut - Info	Eigenschaft
Grenzwerte	Min/Max
Einheit	Einheit
Wertzuordnung	Enums

Komplexe Datentypen von OpenBOS werden in separate Attribute in Eliona aufgeteilt.

Verwaiste Datenpunkte

Falls ein Asset aus OpenBOS gelöscht wird, aber noch ein Alarm mit diesem Datenpunkt verknüpft ist, bleibt dieser Datenpunkt in der Ontologie von OpenBOS erhalten. Eliona respektiert dieses Verhalten und weist diese Datenpunkte einem Root-Asset zu.

Alarme

Alarme, die in OpenBOS ausgelöst werden, werden mit Eliona synchronisiert. Diese werden in Eliona als Alarmregeln vom Typ "Extern" erstellt und durch Updates von OpenBOS verwaltet. Wird ein Alarm in OpenBOS ausgelöst, wird er auch in Eliona ausgelöst – ebenso verschwindet er, wenn er in OpenBOS nicht mehr aktiv ist.

Falls ein Alarm bestätigt werden muss, kann dies in Eliona erfolgen. Diese Bestätigung wird mit OpenBOS synchronisiert.