ROOMZ

Die ROOMZ-App integriert ROOMZ-Sensoren mit der Eliona-Plattform, um Echtzeitdaten zur Raumnutzung bereitzustellen.

Übersicht

Dieses Handbuch enthält Anweisungen zur Installation, Konfiguration und Verwendung der ROOMZ-App zur Datenerfassung von ROOMZ-Sensoren.

Installation

Installieren Sie die ROOMZ-App aus dem Eliona App Store.

Konfiguration

Registrieren Sie die App in ROOMZ und konfigurieren Sie dann die ROOMZ-App über die Eliona-Einstellungen.

Registrierung der App im ROOMZ-Portal

Die ROOMZ-App verwendet eine experimentelle Webhook-API, die noch nicht allgemein verfügbar ist. Kontaktieren Sie den ROOMZ-Support, um das Senden von Daten zu aktivieren und ein Webhook-Geheimnis zu erhalten. Der Webhook-Endpunkt für Ihre Eliona-Instanz lautet: https://{Ihre-eliona-Instanz}/apps-public/roomz/webhook.

Da der Webhook-Endpunkt über das Internet zugänglich sein muss, werden alle eingehenden Daten mithilfe der ROOMZ-Signatur überprüft. Zur Verifizierung muss ROOMZ ein Webhook-Geheimnis und einen öffentlichen Schlüssel zur Überprüfung der Signatur bereitstellen.

Konfiguration der ROOMZ-App

Konfigurieren Sie die App in Eliona, indem Sie zu Apps > ROOMZ > Einstellungen navigieren, wodurch das Generic Frontend der App geöffnet wird. Verwenden Sie die POST-Methode, um die Konfiguration einzurichten. Jede Konfiguration erfordert die folgenden Parameter:

Attribut	Beschreibung
secret	Von ROOMZ bereitgestelltes Webhook-Geheimnis.
enable	Flag zum Aktivieren oder Deaktivieren dieser Konfiguration.
projectIDs	Liste der Eliona-Projekt-IDs für die Datenerfassung.

Beispiel-Konfigurations-JSON:

{
  "secret": "some-webhook-secret",
  "enable": true,
  "projectIDs": [
    "10"
  ]
}

Kontinuierliche Asset-Erstellung

Nach der Konfiguration hört die App auf Datenaktualisierungen von ROOMZ. Jedes Mal, wenn sich der Anwesenheitsstatus ändert (jemand betritt oder verlässt einen Raum), empfängt die App eine Nachricht von ROOMZ und schreibt die Daten in Eliona.

Die App erstellt automatisch alle Assets für die überwachten Räume - Wenn die App zum ersten Mal Daten von einem Sensor empfängt, erstellt sie ein neues Asset unter dem "ROOMZ root"-Asset. Das Asset wird nach der Raum-ID benannt (die einzige Information, die die ROOMZ-API bereitstellt), kann aber vom Benutzer umbenannt und verschoben werden.

Der Benutzer, der die Konfiguration der App erstellt oder zuletzt aktualisiert hat, wird über neu erstellte Assets benachrichtigt.