DifficultySchwierigkeitsgrad: expertExperte

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.

Expand
title 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." Image Added 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. 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. 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: 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. 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. 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: Gerätetypdie eine Voreinstellung von Datentypen enthält (je nach gewähltem DeviceType ist ein Standardsatz von Kanälen aktiviert). Geräte-IDdie eindeutig sein muss. Um diese ID für alle Mieter eindeutig zu machen, enthält das Format der Geräte-ID die Mieter-ID Um diese ID innerhalb des Mandanten eindeutig zu machen, enthält das Format der Geräte-ID die ID der externen Datenquelle Informationen zum Standort. Wenn ein Sensor nicht mit einem Standort verknüpft ist, werden die Daten nicht in der Spacewell-Datenbank gespeichert. Image Added 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 /wiki/spaces/WM/pages/492237

The sensor vendor needs to comply with the Spacewell webhook, supported data types & payloadDer Sensorhersteller muss den Spacewell Webhook, die unterstützten Datentypen und die Nutzdaten einhalten.

How to set up this connection?

Steps described on this page:

1. In the external (customer or 3rd party) database: Configure data payload

2. Configure the connection between External Data Source and Workplace

3. Go to database and fill in URL and token, make sure to test the connection

4. Configure devices on Workplace platform

5. Devices send data to Workplace platform

Configure Data Payload

Webhooks

Webhooks provide a fast and secure way to reliably stream sensor data through from other systems.
The sensor provider is expected to post updates to the Spacewell endpoint.
The webhook endpoint expects a single HTTP request which represent a distinct message from the sensor.

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_vendor>anbieter>/data>

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

• Verwendete HTTP method used-Methode: POST

• HTTP headers-Header:

  • AuthorizationAutorisierung: Bearer <token> Überbringer <Token>

  • ContentInhalt-TypeTyp: applicationanwendung/json

Supported data types & payload

Unterstützte Datentypen & Nutzdaten

Bei allen Datentypen ist es sinnvoll, zu überprüfen, ob die Daten regelmäßig gesendet werden oder nicht; siehe https://spacewell.atlassian.net/wiki/spaces/KB/pages/5242896/External+Data+Sources#FAQ

Space occupancy related data types:Raumbelegungsbezogene Datentypen:

{
"device": "<unique_device_id>", // string: unique id of the device
"type": "pir", // string: pir for occupancy
"timestamp": "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
"value": "1" // string: 0 or 1, 0 = not occupied, 1 = occupied
}

{
“device”: "<unique_device_id>", // string: unique id of the device or count area
“type”: "headcount", // string: headcount for measuring number of people
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "10" // string: value is unsigned integer
}

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "pulse", // string: pulse for door counters sending pulse values
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "1" // string: count of pulses expressed as unsigned integer
}

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "counter", // string: count for door counters sending accumulated values 
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "10" // string: value is unsigned integer
}

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "footfall-in-pulse", // string: footfall in pulse sensor
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "5" // string: count of in pulses expressed as unsigned integer
}

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "footfall-out-pulse", // string: footfall out pulse sensor
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "3" // string: count of out pulses expressed as unsigned integer
}

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "pir", // string: pir for occupancy
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "1" // string: 0 or 1, 0 = not occupied, 1 = occupied
}

* Depending on the reliability of the sensor, space occupancy data may only contain data confirming “movement” (presence, headcount, footfall in one or the other direction etc), not the absence of movement… To tackle this in the Workplace platform, a decay feature has been introduced, which allows to visualize occupancy/headcount on the live (end user facing) floor plans for longer than what the data really tells us.For an example on how Decay works, see 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 https://spacewell.atlassian.net/wiki/spaces/KB/pages/491737/Motion+sensor#How-is-Motion-sensor-data-reflected-in-Workplace-Live-Views%3F

For a potential solution for data gaps in the dashboards (copy data in time slots), see Eine mögliche Lösung für Datenlücken in den Dashboards (Kopieren von Daten in Zeitfenstern) finden Sie unter https://spacewell.atlassian.net/wiki/spaces/KB/pages/5242896/External+Data+Sources#FAQ

Comfort related data typesKomfortbezogene Datentypen:

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "temperature", // string: temperature sensor
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "25.5" // string: value in Celsius expressed as double with dot as decimal separator
}

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "humidity", // string: humidity sensor
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "75.5" // string: value in percentage 0-100
                     // expressed as double with dot as decimal separator
}

Indoor Air Quality related data typesInnenraumluftqualitätsbezogene Datentypen:

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "co2", // string: co2 for carbon dioxide sensor
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "555.5" // string: measured value of CO2 in the air (parts per million)
                       // expressed as double with dot as decimal separator
}

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "voc", // string: voc for volatile organic compounds
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "1.0" // string: measured value of VOC in the air (parts per billion)
                   // expressed as double with dot as decimal separator
}

{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "radon", // string: radon sensor
“timestamp”: "2020-09-22T14:27:36Z", // string: ISO 8601 date and time
“value”: "19.0" // string: radon level measured is Becquerels per cubic meter, Bq/m3
                     // expressed as double with dot as decimal separator

}

Configure the connection between External Data Source and Workplace

How to access

Konfigurieren Sie die Verbindung zwischen externer Datenquelle und Workplace

Wie man Zugang erhält

• Gehen Sie zu https://studio.cobundu.com/

• Login with your credentials

• Select Integrations > External Data Sources in the Anmeldung mit Ihren Anmeldedaten

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

1. Select “Add New”

2. Tenant ID will be filled in based on the environment that you logged in to

3. Fill in Source ID with a unique name, referring to your external data source

4. (Optional) Fill in a description, detailing what kind of data will come through the external data source

5. Copy the provided webhook URL + Authorization token to create the webhook in the external data source towards Spacewell Workplace

6. Make sure to enable your setup in Workplace

Image Removed

Test your setup

Once the webhook is created in the 3rd party database with above provided URL and token, make sure to test the connection.

This step is to be performed by the party that wants to send data to Spacewell Workplace.

Verify in a tool like Postman if your setup works:

• In case request is not successful, the endpoint returns 4xx-5xx status codes depending on the occurred issue.

• In case of successful request, the endpoint returns 200 status code with an empty body.

Image Removed

Check below chapter “Troubleshooting” in case of doubts.

Next steps

• -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

Image Added

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.

Image Added

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

Make sure the following configuration is in place:

Troubleshooting

Fehlersuche

Legacy Generic End-Point

In the past, some external data sources were connected to Spacewell through a slightly different format. Because of that, there is a limitation only for the legacy / old generic endpoints:

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'

2. User will not be take actions (Refresh Authorization token, Enable / Disable will all be greyed out)

3. User can only View, and Copy URL / Authorization token.

1. 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.

Search

Suche