DifficultySchwierigkeitsgrad: expertExperte
Inhalt
Table of Contents | ||||
---|---|---|---|---|
|
Learning Objectives
After reading this article, you’ll be able to:
Identify which data types are supported by Spacewell Workplace
Configure webhook & authorization token to connect your external data sources to Workplace
Suppose there are already sensors collecting data in the building and you want to include its data into the Workplace IOT platform. Spacewell provides a generic endpoint (using webhooks) for most of its sensor data types, to integrate, process and store sensor data from 3rd party platforms.
Once that connection is established, it’s possible to create custom device types for a more streamlined and efficient sensor management experience:
Clear and descriptive device type names help distinguish between sensors, allowing for quick & accurate identification when troubleshooting or replacing sensors
Customizable threshold settings for each device type trigger alerts and proactive maintenance actions, ensuring optimal sensor performance
Prerequisites
The sensor vendor needs to comply with the Spacewell webhook, supported data types & payload, see External Data Sources
Note |
---|
Within your Workplace environment, sensor IDs need to be unique and prepended with the vendor ID. |
Configure Device Types on Workplace
How to access
Lernziele
Nach der Lektüre dieses Artikels werden Sie in der Lage sein:
Identifizieren Sie, welche Datentypen von Spacewell Workplace unterstützt werden
Konfigurieren Sie Webhook & Autorisierungstoken, um Ihre externen Datenquellen mit Workplace zu verbinden
Angenommen, es gibt bereits Sensoren, die Daten im Gebäude sammeln, und Sie möchten deren Daten in die Workplace IOT-Plattform integrieren. Spacewell bietet einen generischen Endpunkt (mit Webhooks) für die meisten seiner Sensordatentypen, um Sensordaten von Drittanbieterplattformen zu integrieren, zu verarbeiten und zu speichern.
Sobald diese Verbindung hergestellt ist, ist es möglich, benutzerdefinierte Gerätetypen zu erstellen, um die Sensorverwaltung zu optimieren und effizienter zu gestalten:
Eindeutige und beschreibende Gerätetypbezeichnungen helfen bei der Unterscheidung zwischen den Sensoren und ermöglichen eine schnelle und genaue Identifizierung bei der Fehlersuche oder dem Austausch von Sensoren
Anpassbare Schwellenwerteinstellungen für jeden Gerätetyp lösen Warnmeldungen und proaktive Wartungsmaßnahmen aus und gewährleisten eine optimale Sensorleistung
Voraussetzungen
Der Sensorhersteller muss den Spacewell Webhook, die unterstützten Datentypen und die Nutzdaten einhalten, siehe External Data Sources
Note |
---|
In Ihrer Workplace-Umgebung müssen die Sensor-IDs eindeutig sein und die Hersteller-ID vorangestellt werden. |
Gerätetypen auf dem Workplace konfigurieren
Wie man Zugang erhält
Gehen Sie zu https://studio.cobundu.com/
Login with your credentials
Select Integrations > Device Types in the Anmeldung mit Ihren Anmeldedaten
Wählen Sie Integrationen > Gerätetypen in der Studio 2.0 interface
Select “Add New”
General
Device Type Name
Device Type ID is used as a unique identifier of your device type, for example in batch device import
Custom Device Type IDs always include the prefix “Generic|”
Note |
---|
Device Type ID should only include lowercase alphabetic characters, numeric characters or - symbol |
Info |
---|
After saving, in Edit mode, it’s not possible to update Device Type ID anymore |
External Data Source
select a specific External Data Source if the data for this device type will always be provided from 1 External Data Source. Establishing this 1-on-1-connection is beneficial for device registration in Workplace (see below chapter “Configure devices in Workplace“)
select “Any” if the data for this device type might come from different External Data Sources. In this case, device registration in Workplace is a bit more complex (see below chapter “Configure devices in Workplace“)
Info |
---|
After saving, in Edit mode, it’s not possible to update External Data Source link anymore |
Status: enable to select the Device Type from the Device Type drop down when configuring devices in Workplace
Device Image: keep the default image, select a generic image or upload a picture of your device type. This image will be visible on the device label
Sensor Health
Sensor Health is derived from the last communication from the sensor to the Workplace Platform. The communication can be a sensor value or a heartbeat. Since every type of device has its own heartbeat frequency, the health of the device is evaluated per device type. For more information, see How to monitor Sensor Health
Fill in numeric values that will be used to change the status of devices linked to the device type:
To Check
Offline
value needs to be larger than To Check value
Sensor Details
From the list of supported data types, select which channels are relevant for the device type that you’re creating. In other words: which kind of sensor data will be send to Workplace by devices that are set up according to this device type?
CO₂
Counter
Footfall Pulse (in)
Footfall Pulse (out)
Headcount
Humidity
Presence*
Pulse
Radon
Temperature
VOC
* Presence
When it comes to presence / motion sensors, there is a difference in how some confirm or just don’t confirm the absence of presence :
Select "No" if the device sends presence data to confirm occupancy, and might send data to confirm vacancy, but does not send this vacancy confirmation as soon as the location is available (~ is not reliable in confirming vacancy)
Select "Yes" if the device sends presence data to confirm occupancy, and also sends data to confirm vacancy as soon as the location is available again
Note |
---|
This has nothing to do with sensor accuracy or “the sensor itself being reliable of sending data”. It’s about the reliability of the statement “occupied” after no presence detection for some time. |
-Schnittstelle
Wählen Sie "Neu hinzufügen".
Allgemein
Gerätetyp Name
Die Gerätetyp-ID wird als eindeutiger Bezeichner Ihres Gerätetyps verwendet, z. B. beim Batch-Import von Geräten.
Benutzerdefinierte Gerätetyp-IDs enthalten immer das Präfix "Generic|".
Note |
---|
Die Gerätetyp-ID darf nur Kleinbuchstaben, numerische Zeichen oder das Symbol - enthalten. |
Info |
---|
Nach dem Speichern ist es im Bearbeitungsmodus nicht mehr möglich, die Gerätetyp-ID zu aktualisieren. |
Externe Datenquelle
eine bestimmte Externe Datenquelle auswählen, wenn die Daten für diesen Gerätetyp immer von einer Externen Datenquelle bereitgestellt werden sollen. Das Herstellen dieser 1-on-1-Verbindung ist für die Geräteregistrierung im Workplace von Vorteil (siehe unten Kapitel "Geräte im Workplace konfigurieren")
Wählen Sie "Beliebig", wenn die Daten für diesen Gerätetyp aus verschiedenen externen Datenquellen stammen können. In diesem Fall ist die Geräteregistrierung im Workplace etwas komplexer (siehe unten Kapitel "Geräte im Workplace konfigurieren")
Info |
---|
Nach dem Speichern ist es im Bearbeitungsmodus nicht mehr möglich, den Link zur externen Datenquelle zu aktualisieren. |
Status: ermöglicht die Auswahl des Gerätetyps aus der Dropdown-Liste Gerätetyp bei der Konfiguration von Geräten im Workplace
Gerätebild: Behalten Sie das Standardbild bei, wählen Sie ein allgemeines Bild oder laden Sie ein Bild Ihres Gerätetyps hoch. Dieses Bild wird auf der Seite Geräteetikett
Sensor Gesundheit
Der Sensorzustand ergibt sich aus der letzten Kommunikation des Sensors mit der Workplace Platform. Die Kommunikation kann ein Sensorwert oder ein Heartbeat sein. Da jeder Gerätetyp seine eigene Heartbeat-Frequenz hat, wird der Zustand des Geräts pro Gerätetyp ausgewertet. Für weitere Informationen siehe How to monitor Sensor Health
Geben Sie numerische Werte ein, die verwendet werden, um den Status der mit dem Gerätetyp verbundenen Geräte zu ändern:
Zur Kontrolle
Offline
Wert muss größer sein als der Wert von To Check
Sensor-Details
Von der Liste der unterstützten DatentypenWählen Sie aus, welche Kanäle für den Gerätetyp, den Sie erstellen, relevant sind. Mit anderen Worten: Welche Art von Sensordaten werden von Geräten, die für diesen Gerätetyp eingerichtet sind, an Workplace gesendet?
CO₂
Zähler
Fußgängerimpuls (in)
Fußgängerimpuls (aus)
Personalbestand
Luftfeuchtigkeit
Anwesenheit*
Puls
Radon
Temperatur
VOC
* Anwesenheit
Bei Anwesenheits-/Bewegungsmeldern gibt es einen Unterschied in der Art und Weise, wie einige die Abwesenheit von Anwesenheit bestätigen oder eben nicht bestätigen:
Wählen Sie "Nein", wenn das Gerät Anwesenheitsdaten sendet, um die Belegung zu bestätigen, und möglicherweise Daten sendet, um den Leerstand zu bestätigen, aber diese Leerstandsbestätigung nicht sendet, sobald der Standort verfügbar ist (~ ist nicht zuverlässig in der Bestätigung des Leerstands)
Wählen Sie "Ja", wenn das Gerät Anwesenheitsdaten sendet, um die Belegung zu bestätigen, und auch Daten sendet, um den Leerstand zu bestätigen, sobald der Standort wieder verfügbar ist
Note |
---|
Dies hat nichts mit der Genauigkeit des Sensors oder der Zuverlässigkeit der Datenübertragung durch den Sensor selbst zu tun. Es geht um die Zuverlässigkeit der Aussage "besetzt", nachdem einige Zeit lang keine Anwesenheit festgestellt wurde. |
Wenn ein Sensor die Vakanz nicht zuverlässig bestätigt, d.h. wenn wir nicht 100%ig sicher sind wenn der Standort wieder verfügbar ist, können Sie den Symbolabfall auf dem Live-Grundriss über https://spacewell.atlassian.net/wiki/spaces/KB/pages/491694/Live+floorplan+settings#Occupancy-settings.
Expand | ||||
---|---|---|---|---|
| Example
| |||
Beispiel 1. PIR motion sensor-BewegungsmelderThe Der PIR motion sensor in this example sends data confirming “presence detected” as soon as it’s triggered. In this sense, the sensor is reliable in conveying occupancy confirmations. Yet if the user moves away from the sensor, and objectively the room is vacant, the sensor does not immediately send a status change. So the sensor is unreliable in conveying vacancy confirmations. Upon creation of this Device Type, select “unreliable”. Example 2. Headcount sensor providing occupancy data The headcount sensor in this example sends data every minute:
In this case, even if someone walks into a room to get something and immediately leaves the room, after latest 2 minutes, Workplace is updated with the information that there is no (longer) any occupancy detected in that location. Upon creation of this Device Type, select “reliable”. |
Configure devices in Workplace
Prerequisites
have the confirmation that the connection of the External Data source to Workplace was successful, see-Bewegungssensor in diesem Beispiel sendet Daten, die "Anwesenheit erkannt" bestätigen, sobald er ausgelöst wird. In diesem Sinne ist der Sensor zuverlässig in der Übermittlung von Anwesenheitsbestätigungen. Entfernt sich der Benutzer jedoch vom Sensor, obwohl der Raum objektiv frei ist, sendet der Sensor nicht sofort eine Statusänderung. Der Sensor ist also unzuverlässig bei der Übermittlung von Leerstandsbestätigungen. Wählen Sie bei der Erstellung dieses Gerätetyps "unzuverlässig". Beispiel 2. Personenzählsensor mit Belegungsdaten Der Kopfzählungssensor in diesem Beispiel sendet jede Minute Daten:
In diesem Fall wird Workplace, auch wenn jemand einen Raum betritt, um etwas zu holen, und den Raum sofort wieder verlässt, nach spätestens 2 Minuten mit der Information aktualisiert, dass an diesem Ort keine Belegung (mehr) festgestellt wurde. Wählen Sie bei der Erstellung dieses Gerätetyps "zuverlässig". |
Geräte im Workplace konfigurieren
Voraussetzungen
die Bestätigung haben, daß die Verbindung der externen Datenquelle zum Workplace erfolgreich war, siehe https://spacewell.atlassian.net/wiki/spaces/KB/pages/5242896/External+Data+Sources#Test-your-setup
have the confirmation which data type will be used to convey the data
have the list of device IDs that will send data from the External Data Source to Workplace platform
Depending on the (known) connection between the Device Type and a specific External Data Source, different information is required to configure devices in Workplace:
1. If Device Type is set up to connect to a specific External Data Source
Having set up a 1-on-1-connection between Device Type and External Data Source, is beneficial for device registration in Workplace Studio:
die Bestätigung haben, welcher Datentyp zur Übermittlung der Daten verwendet werden soll
die Liste der Geräte-IDs haben, die Daten von der externen Datenquelle an die Workplace-Plattform senden werden
Abhängig von der (bekannten) Verbindung zwischen dem Gerätetyp und einer bestimmten externen Datenquelle werden unterschiedliche Informationen benötigt, um Geräte im Workplace zu konfigurieren:
1. Wenn der Gerätetyp für die Verbindung mit einer bestimmten externen Datenquelle eingerichtet ist
Die Einrichtung einer 1-on-1-Verbindung zwischen Gerätetyp und externer Datenquelle ist für die Geräteregistrierung in Workplace Studio von Vorteil:
Gehen Sie zu Ihrer Umgebung (https://studio.cobundu.com ) and log in
Select the location, and manually add a sensor via "Add New Device"
Select the relevant Device Type from the drop-down list. As per the chosen DeviceType, a default set of channels is enabled
Fill in the Device ID that is used in the payload to report on this data point*
Give a meaningful name (eg customer_floor number_area) in Device Name.
Location will be filled in based on your pre-selection in the location tree
Info |
---|
* In Workplace, a prefix referring to the tenant ID and external data source ID will be added to the device ID. This will be visible in Devices Export. |
und melden Sie sich an
Wählen Sie den Standort aus, und fügen Sie manuell einen Sensor über "Neues Gerät hinzufügen"
Wählen Sie die entsprechende Gerätetyp aus der Dropdown-Liste. Je nach ausgewähltem Gerätetyp wird ein Standardsatz von Kanälen aktiviert
Füllen Sie das Geräte-ID die in der Nutzlast verwendet wird, um über diesen Datenpunkt zu berichten*
Geben Sie eine sinnvoller Name (z.B. Kundennummer_Etage_Fläche) in Gerätename.
Der Ort wird auf der Grundlage Ihrer Vorauswahl im Ortsbaum ausgefüllt.
Info |
---|
* Im Workplace wird der Geräte-ID ein Präfix hinzugefügt, das sich auf die Mieter-ID und die ID der externen Datenquelle bezieht. Dies wird im Geräteexport sichtbar sein. |
Weitere Informationen darüber, wie Sie mehrere neue Geräte zu Studio hinzufügen können, finden Sie unter Configure devices (add, remove, import, and export).
Info |
---|
Make sure to include tenant and source ID (in format “<tenantVergewissern Sie sich, dass Sie die Mieter- und Quellen-ID (im Format "<Mieter_id>-<source<Quelle_id>”) if you’re creating devices through Device Import feature. For more information, see belowid>"), wenn Sie Geräte über die Funktion Geräteimport erstellen. Weitere Informationen finden Sie weiter unten. |
Note |
---|
Within 1 vendor ID, sensor IDs need to be unique and prepended with the vendor ID. |
2. If Device Type is set up to connect to “Any” External Data Source
Select “Any” if the data for this device type might come from different External Data Sources. In this case, device registration in Workplace is a bit more complex:
Innerhalb einer Anbieter-ID müssen die Sensor-IDs eindeutig sein und die Anbieter-ID vorangestellt werden. |
2. Wenn der Gerätetyp für die Verbindung mit einer "beliebigen" externen Datenquelle eingerichtet ist
Wählen Sie "Beliebig", wenn die Daten für diesen Gerätetyp aus verschiedenen externen Datenquellen stammen könnten. In diesem Fall ist die Geräteregistrierung im Workplace etwas komplexer:
Gehen Sie zu Ihrer Umgebung (https://studio.cobundu.com ) and log in
Select the location, and manually add a sensor via "Add New Device"
Select the relevant Device Type from the drop-down list. As per the chosen DeviceType, a default set of channels is enabled
Fill in the Device ID, using the tenant ID and source ID available in Settings > External Data Sources. Adhere to the format <tenant_id>-<source_id>|<deviceund melden Sie sich an
Wählen Sie den Standort aus, und fügen Sie manuell einen Sensor über "Neues Gerät hinzufügen"
Wählen Sie die entsprechende Gerätetyp aus der Dropdown-Liste. Je nach ausgewähltem Gerätetyp wird ein Standardsatz von Kanälen aktiviert
Füllen Sie das Geräte-IDVerwenden Sie die Mieter-ID und die Quellen-ID, die unter Einstellungen > Externe Datenquellen verfügbar sind. Halten Sie sich an das Format <Mieter_id>-<Quelle_id>|<Geräte_id>
Expand | ||
---|---|---|
| ||
for example
the Spacewell Device ID will be “spacewellzum Beispiel
wird die Spacewell-Geräte-ID "spacewell-testgeneric|123" |
Give a meaningful name (eg customer_floor number_area) in Device Name.
Location will be filled in based on your pre-selection in the location tree
Geben Sie eine sinnvoller Name (z.B. Kundennummer_Etage_Fläche) in Gerätename.
Der Standort wird anhand Ihrer Vorauswahl im Standortbaum ausgefüllt
Weitere Informationen darüber, wie Sie mehrere neue Geräte zu Studio hinzufügen können, finden Sie unter Configure devices (add, remove, import, and export).
Note |
---|
Within 1 vendor ID, sensor IDs need to be unique and prepended with the vendor ID. |
FAQ
Expand | ||
---|---|---|
Expand | ||
| ||
| ||
Depending on the kind of sensor, they might not send heartbeats or data regularly. If they send data and then only send a message upon value change, you might find yourself with bits and pieces of data (eg 1 time slot of 15 minutes with data about temperature, and nothing the rest of the day), which would cause confusion when you try to read the dashboards. To work around this, you can opt to have Spacewell copy the data, per generic endpoint / device type level for any desired amount of time. For example for the sensor type "Generic PIR" we could set a "copy in further time slots" and this value would be valid for all Generic PIR sensor values, which come to us for your tenant. Of course, the data is only copied until new data comes in again. So if a value comes in on Monday at 9am, and the configuration says "copy for 7 days", and on Wednesday at 8am a new value comes in, then from Wednesday at 8am the new value is taken for 7 days, or until a new value comes in.
Reach out to your Account Manager to set this up. |
Expand | ||
---|---|---|
| ||
In Workplace, it’s possible to disable a Device Type, but you can’t delete. Deletion would impact devices that have been created with this device type. |
Troubleshooting
| ||
Je nach Art des Sensors senden sie möglicherweise nicht regelmäßig Herzschläge oder Daten. Wenn sie Daten senden und dann nur bei einer Wertänderung eine Nachricht senden, kann es sein, dass Sie nur Bruchstücke von Daten erhalten (z. B. ein Zeitfenster von 15 Minuten mit Daten über die Temperatur und den Rest des Tages nichts), was zu Verwirrung führen würde, wenn Sie versuchen, die Dashboards zu lesen. Um dies zu umgehen, können Sie Spacewell veranlassen, die Daten pro generischer Endpunkt-/Gerätetyp-Ebene für eine beliebige Zeitspanne zu kopieren. Zum Beispiel könnten wir für den Sensortyp "Generic PIR" ein "copy in further time slots" einstellen und dieser Wert würde für alle Generic PIR Sensorwerte gelten, die bei uns für Ihren Mieter eingehen. Natürlich werden die Daten nur so lange kopiert, bis wieder neue Daten eintreffen. Wenn also ein Wert am Montag um 9 Uhr eingeht und die Konfiguration sagt "Kopie für 7 Tage", und am Mittwoch um 8 Uhr ein neuer Wert eingeht, dann wird der neue Wert ab Mittwoch um 8 Uhr für 7 Tage übernommen, oder bis ein neuer Wert eingeht.
Wenden Sie sich an Ihren Kundenbetreuer, um dies einzurichten. |
Expand | ||
---|---|---|
| ||
Im Workplace können Sie einen Gerätetyp deaktivieren, aber nicht löschen. Die Löschung würde sich auf Geräte auswirken, die mit diesem Gerätetyp erstellt wurden. |
Fehlersuche
Expand | ||
---|---|---|
| ||
Stellen Sie sicher, dass die folgende Konfiguration vorhanden ist:
|
Expand | ||
---|---|---|
| ||
If you’ve created a Device Type but it’s not showing in “Add New Device” drop down, make sure your Device Type status is enabled. |
| |
Wenn Sie einen Gerätetyp erstellt haben, dieser aber nicht in der Dropdown-Liste "Neues Gerät hinzufügen" angezeigt wird, stellen Sie sicher, dass Ihr Gerätetyp-Status aktiviert ist. |
Suche
Live Search |
---|