Schwierigkeitsgrad: Experte

Angenommen, es gibt bereits Sensoren, die Daten im Gebäude sammeln, und Sie möchten deren Daten in die Workplace IOT-Plattform einbinden. Spacewell bietet eine generischer Endpunkt (mit Webhooks) für den größten Teil seiner Sensordatentypenzur Integration, Verarbeitung und Speicherung von Sensordaten aus Plattformen von Drittanbietern.

Externe Datenquellen für Anfänger - eine Analogie

Da Sie sich auf dieser Seite befinden: Es sieht so aus, als ob die Sensoren, die Daten an die Workplace-Plattform senden, Daten an eine Plattform oder Datenbank senden, die nicht mit Workplace verbunden ist. Auf dieser Seite stellen wir sicher, dass eine Verbindung zwischen den Plattformen besteht und dass die Daten in einem Format gesendet werden, mit dem Workplace arbeiten kann und weiß, wie sie zu identifizieren sind.

Das Einrichten von externen Datenquellen und das Senden von Daten aus einer externen Datenbank an die Workplace-Plattform ist vergleichbar mit "Ein Auto kommt an einem Tor an. Das Auto ist dem Pförtner bekannt, und die Person im Auto hat einen Ausweis, weil sie ihrer Kontaktperson im Vorfeld gesagt hat, dass sie kommt."

 

Open

 

1. Wir wollen, dass die externe Plattform Daten senden an Workplace zu senden, weshalb wir einen Webhook mit der HTTP-Methode "post" verwenden. Das bedeutet, die Daten werden geschoben von dem anderen System, und Workplace muss sich nicht ziehen es von irgendwoher.

2. Durch das Anlegen einer externen Datenquelle im Mandanten erstellen Sie eine Tür oder Tor an die Workplace-Plattform: die Webhook-URL. Sie erhalten auch die Code zum Öffnen des Tores: das Autorisierungs-Token. Wenn Sie den Eigentümern der Datenbank diese Informationen zur Verfügung stellen, können sie nun die Tür öffnen.

3. Aber sie müssen uns die Daten in einer Weise präsentieren, die wir konsumieren können! Sie müssen sich also an einige Regeln halten:

   1. die die Daten, die sie uns übermitteln, müssen aussagekräftig sein: Workplace muss in der Lage sein, etwas mit diesen Daten zu tun (z.B. sie auf einem Live-Grundriss oder in einem Dashboard darzustellen). Daher muss die externe Datenquelle die Daten in einem der über 10 unterstützten Datentypen bereitstellen.

   2. Es reicht nicht aus, dass sie uns einfach mit ein paar Daten bewerfen. Um die richtig interpretieren Diese Daten müssen einem bestimmten (Nutzdaten-)Format entsprechen. Auf diese Weise wissen wir, welchen Teil der Informationen wir als Geräte-ID interpretieren müssen, welchen Teil wir als Wert in der Workplace-Datenbank speichern müssen usw.

4. Für Spacewell zu wissen wo wir die Daten speichern müssen In unserer Datenbank muss der Sensor auf unserer Seite bekannt und mit einem Standort verknüpft sein. Aus diesem Grund muss das Gerät in Studio registriert werden. Um das Gerät in Workplace Platform zu registrieren, benötigen Sie:

   1. Gerätetypdie eine Voreinstellung von Datentypen enthält (je nach gewähltem DeviceType ist ein Standardsatz von Kanälen aktiviert).

   2. Geräte-IDdie eindeutig sein muss.

      1. Um diese ID für alle Mieter eindeutig zu machen, enthält das Format der Geräte-ID die Mieter-ID

      2. Um diese ID innerhalb des Mandanten eindeutig zu machen, enthält das Format der Geräte-ID die ID der externen Datenquelle

   3. Informationen zum Standort. Wenn ein Sensor nicht mit einem Standort verknüpft ist, werden die Daten nicht in der Spacewell-Datenbank gespeichert.

 

Open

die Tatsache, dass das Auto am Tor ankommt, ohne dass Spacewell etwas tun muss, ist der Webhook der unterstützte Datentyp war die Anweisung, die an einem bestimmten Tor zu präsentieren ist die Marke und das Modell des Fahrzeugs ist die Nutzlast, das Fahrzeug, mit dem die Daten präsentiert werden die Daten befinden sich im Kofferraum des Fahrzeugs die Sensor-ID ist der zur Identifizierung verwendete Ausweis der Gerätetyp ist die Gatternummer das Tor ist dank des Berechtigungstokens geöffnet

 

Spacewell-Berater, die mehr darüber erfahren möchten, wie Spacewell die eingehenden Daten verarbeitet, können sich hier informieren https://spacewell.atlassian.net/wiki/spaces/WM/pages/492237

Der Sensorhersteller muss den Spacewell Webhook, die unterstützten Datentypen und die Nutzdaten einhalten.

Wie stellt man diese Verbindung her?

Die auf dieser Seite beschriebenen Schritte:

1. In der externen Datenbank (Kunde oder Drittanbieter): Konfigurieren Sie die Daten-Nutzlast

2. Konfigurieren Sie die Verbindung zwischen externer Datenquelle und Workplace

3. Gehen Sie zur Datenbank und geben Sie URL und Token ein, testen Sie die Verbindung

4. Geräte auf der Workplace-Plattform konfigurieren

5. Geräte senden Daten an Workplace-Plattform

Daten-Nutzlast konfigurieren

Webhaken

Webhooks bieten eine schnelle und sichere Möglichkeit, Sensordaten von anderen Systemen zuverlässig zu übertragen.
Es wird erwartet, dass der Sensoranbieter Aktualisierungen an den Spacewell-Endpunkt sendet.
Der Webhook-Endpunkt erwartet eine einzelne HTTP-Anfrage, die eine bestimmte Nachricht vom Sensor darstellt.

• Die Webhook-URL:

  • EU: <https://bohemian.eu1.cloud.cobundu.com/generic/<sensor_anbieter>/data>

  • US: <https://bohemian.us1.cloud.cobundu.com/generic/<sensor_anbieter>/data>

• Verwendete HTTP-Methode: POST

• HTTP-Header:

  • Autorisierung: Überbringer <Token>

  • Inhalt-Typ: anwendung/json

Unterstützte Datentypen & Nutzdaten

Bei allen Datentypen ist es sinnvoll, zu überprüfen, ob die Daten regelmäßig gesendet werden oder nicht; siehe External Data Sources | FAQ

Raumbelegungsbezogene Datentypen:

* Je nach Zuverlässigkeit des Sensors enthalten die Raumbelegungsdaten möglicherweise nur Daten Bestätigung von "Bewegung" (Anwesenheit, Anzahl der Personen, Schritte in die eine oder andere Richtung usw.), nicht die Abwesenheit Um dieses Problem in der Workplace-Plattform zu lösen, wurde eine Verfallsfunktion eingeführt, die es ermöglicht, die Belegung/Personenzahl auf den Live-Grundrissen (mit Blick auf den Endbenutzer) länger zu visualisieren, als es die Daten tatsächlich aussagen.

Ein Beispiel dafür, wie Decay funktioniert, finden Sie unter Motion sensor | How is Motion sensor data reflected in Workplace Live Views?

Eine mögliche Lösung für Datenlücken in den Dashboards (Kopieren von Daten in Zeitfenstern) finden Sie unter External Data Sources | FAQ

Komfortbezogene Datentypen:

Innenraumluftqualitätsbezogene Datentypen:

Konfigurieren Sie die Verbindung zwischen externer Datenquelle und Workplace

Wie man Zugang erhält

• Gehen Sie zu Studio

• Anmeldung mit Ihren Anmeldedaten

• Wählen Sie Integrationen > Externe Datenquellen in der Studio 2.0-Schnittstelle

1. Wählen Sie "Neu hinzufügen".

2. Die Mieter-ID wird auf der Grundlage der Umgebung ausgefüllt, in der Sie sich angemeldet haben.

3. Geben Sie in Source ID einen eindeutigen Namen ein, der sich auf Ihre externe Datenquelle bezieht.

4. (Optional) Geben Sie eine Beschreibung ein, in der Sie angeben, welche Art von Daten über die externe Datenquelle übertragen werden sollen.

5. Kopieren Sie die bereitgestellte Webhook-URL + Autorisierungs-Token, um den Webhook in der externen Datenquelle zu Spacewell Workplace zu erstellen

6. Vergewissern Sie sich, dass Sie Ihre Einrichtung in Workplace aktivieren

Testen Sie Ihre Einrichtung

Sobald der Webhook in der Datenbank des Drittanbieters mit der oben angegebenen URL und dem Token erstellt wurde, stellen Sie sicher, dass Sie die Verbindung testen.

Dieser Schritt muss von der Partei durchgeführt werden, die Daten an Spacewell Workplace senden möchte.

Überprüfen Sie mit einem Tool wie Postman, ob Ihre Einrichtung funktioniert:

• Falls die Anfrage nicht erfolgreich ist, gibt der Endpunkt zurück 4xx-5xx Statuscodes je nach dem aufgetretenen Problem.

• Im Falle einer erfolgreichen Anfrage gibt der Endpunkt zurück 200 status code mit einem leeren Körper.

Im Zweifelsfall lesen Sie bitte das Kapitel "Fehlersuche".

Nächste Schritte

Um benutzerdefinierte Gerätetypen zu erstellen und Ihre Sensoren von Drittanbietern in Workplace zu konfigurieren, siehe Custom Device Types

FAQ

Fehlersuche

Legacy Generic End-Point Einrichtung

In der Vergangenheit wurden einige externe Datenquellen über ein etwas anderes Format mit Spacewell verbunden. Aus diesem Grund gibt es eine Einschränkung nur für die alten / generischen Endpunkte:

1. Die alten/veralteten generischen Endpunkte werden in Studio mit der Bezeichnung 'Created by Spacewell' angezeigt.

2. Der Benutzer kann keine Aktionen ausführen (Autorisierungs-Token aktualisieren, Aktivieren/Deaktivieren werden alle ausgegraut)

3. Der Benutzer kann nur die URL / das Autorisierungs-Token anzeigen und kopieren.

Zum Aktivieren/Deaktivieren oder Aktualisieren des Autorisierungstokens wenden Sie sich bitte an Ihren Account Manager.

Suche