Moeilijkheidsgraad: expert

Inhoud

1 Hoe stel ik deze verbinding in?
2 Gegevenslading configureren
3 De verbinding tussen Externe gegevensbron en Workplace configureren
4 Test je opstelling
5 Volgende stappen
6 FAQ
7 Problemen oplossen
8 Generieke eindpuntinstelling

Leerdoelen

Na het lezen van dit artikel zul je in staat zijn om:

Bepalen welke gegevenstypen worden ondersteund door Spacewell Workplace
Configureer webhook & autorisatietoken om uw externe gegevensbronnen met Workplace te verbinden

Stel dat er al sensoren zijn die gegevens verzamelen in het gebouw en u wilt deze gegevens opnemen in het Workplace IOT-platform. Spacewell biedt een generiek eindpunt (met webhooks) voor het grootste deel van zijn soorten sensorgegevensom sensorgegevens van platforms van derden te integreren, verwerken en op te slaan.

Nu u toch op deze pagina bent: het lijkt erop dat de sensoren die gegevens naar het Workplace platform sturen, gegevens naar een platform of database sturen die niet met Workplace is verbonden. Op deze pagina zullen we ervoor zorgen dat er een verbinding is tussen de platforms en dat de gegevens worden verzonden in een formaat waarmee Workplace kan werken en dat het weet hoe het te identificeren.

Het opzetten van externe gegevensbronnen en het verzenden van gegevens van een externe database naar het Workplace platform kan worden vergeleken met "Er komt een auto aan bij een poort. De auto is bekend bij de poortwachter en de persoon in de auto heeft een badge, omdat hij zijn contactpersoon van tevoren heeft verteld dat hij eraan kwam."

We willen dat het externe platform gegevens verzenden naar Workplace, daarom gebruiken we webhook met HTTP-methode "post". Dit betekent dat de gegevens geduwd door het andere systeem, en Workplace hoeft niet te trek het ergens vandaan.
Door een Externe gegevensbron te maken in de tenant, maak je een deur of poort naar het Workplace platform: de URL van de Webhook. U ontvangt ook de code om de poort te openen: het autorisatietoken. Door deze informatie aan de eigenaars van de database te geven, kunnen ze nu de deur bereiken.
Maar ze moeten ons de gegevens presenteren op een manier die we kunnen consumeren! Zodat ze zich aan enkele regels moeten houden:
1. de de gegevens die ze ons sturen moeten betekenisvol zijn: Workplace moet iets met die gegevens kunnen doen (bijvoorbeeld ze presenteren op een live plattegrond of in een dashboard). Zodat de Externe Gegevensbron de gegevens moet leveren in een van de meer dan 10 ondersteunde gegevenstypen.
2. Het is niet genoeg dat ze ons zomaar wat gegevens voor de voeten werpen. Om correct interpreteren die gegevens moeten voldoen aan een specifiek (payload) formaat. Op deze manier weten we welk deel van de informatie we moeten interpreteren als de apparaat-ID, welk deel als de waarde die we moeten opslaan in de Workplace database, enz.
Voor Spacewell om te weten waar we de gegevens moeten opslaan in onze database, moet de sensor bij ons bekend zijn en gekoppeld zijn aan een locatie. Daarom moet het apparaat worden geregistreerd in Studio. Om het apparaat in Workplace Platform te registreren, hebt u het volgende nodig:
1. Type apparaatdie eigenlijk een voorinstelling van gegevenstypes bevat (per gekozen DeviceType wordt een standaardset kanalen ingeschakeld).
2. Apparaat-IDdie uniek moet zijn.
  1. Om deze ID uniek te maken voor alle huurders, bevat de indeling van de apparaat-ID de huurder-ID
  2. Om deze ID uniek te maken binnen de tenant, bevat de indeling van de apparaat-ID de Externe gegevensbron-ID
3. Informatie over de locatie. Als een sensor niet is gekoppeld aan een locatie, worden de gegevens niet opgeslagen in de Spacewell-database.

het feit dat de auto aankomt bij de poort zonder dat Spacewell iets hoeft te doen, is de webhook
het ondersteunde gegevenstype was de instructie om te presenteren bij een specifieke poort
het merk en model van de auto is de payload, het voertuig dat wordt gebruikt om de gegevens te presenteren
de gegevens liggen in de kofferbak van de auto
de sensor-ID is de badge die wordt gebruikt voor identificatie
het apparaattype is het poortnummer
de poort is open dankzij het autorisatietoken

Spacewell consultants die meer willen weten over hoe Spacewell omgaat met gegevens die binnenkomen, kunnen kijken op https://spacewell.atlassian.net/wiki/spaces/WM/pages/492237

De sensorverkoper moet voldoen aan de Spacewell webhook, ondersteunde gegevenstypen en payload.

Binnen 1 vendor ID moeten sensor-ID's uniek zijn en voorafgegaan worden door de vendor ID.
Het combineren van apparaat-ID's van meerdere derde partijen in 1 externe gegevensbron verhoogt het risico op conflicten.

Hoe stel ik deze verbinding in?

Stappen beschreven op deze pagina:

In de externe database (klant of derde partij): Gegevenslading configureren
De verbinding tussen Externe gegevensbron en Workplace configureren
Ga naar de database en vul URL en token in, zorg ervoor dat je de verbinding test
Apparaten configureren op het Workplace platform
Apparaten sturen gegevens naar Workplace platform

Gegevenslading configureren

Webhooks

Webhooks bieden een snelle en veilige manier om betrouwbaar sensorgegevens van andere systemen door te sturen.
Van de sensorprovider wordt verwacht dat hij updates post naar het Spacewell eindpunt.
Het webhook-eindpunt verwacht een enkel HTTP-verzoek dat een afzonderlijk bericht van de sensor vertegenwoordigt.

De webhook URL:
- EU: <https://bohemian.eu1.cloud.cobundu.com/generic/<sensor_verkoper>/data>
- VS: <https://bohemian.us1.cloud.cobundu.com/generic/<sensor_verkoper>/data>
Gebruikte HTTP-methode: POST
HTTP-headers:
- Machtiging: Drager <token>
- Inhoudstype: toepassing/json

Ondersteunde gegevenstypen en payload

Voor alle gegevenstypen is het zinvol om te controleren of gegevens regelmatig worden verzonden of niet; zie External Data Sources | FAQ

Datatypes met betrekking tot ruimtebezetting:

{
"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
}

Als je hoofdopnameapparaat meerdere telgebieden kan volgen, kun je ons de gegevens van de afzonderlijke telgebieden sturen door "<unique_device_id>" te vervangen door "<unique_area_id>".

{
“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
}

* Afhankelijk van de betrouwbaarheid van de sensor kan het zijn dat de ruimtebezettingsgegevens alleen gegevens bevatten over bevestiging "beweging" (aanwezigheid, aantal hoofden, voetstappen in de ene of de andere richting enz. afwezigheid van beweging... Om dit in het Workplace platform aan te pakken, is er een vervalfunctie geïntroduceerd die het mogelijk maakt om de bezetting/headcount op de live (eindgebruiker gerichte) plattegronden langer te visualiseren dan wat de gegevens ons werkelijk vertellen.

Voor een voorbeeld van hoe verval werkt, zie Motion sensor | How is Motion sensor data reflected in Workplace Live Views?

Zie voor een mogelijke oplossing voor gegevenslacunes in de dashboards (gegevens kopiëren in tijdslots) External Data Sources | FAQ

Comfortgerelateerde gegevenstypen:

Aan binnenluchtkwaliteit gerelateerde gegevenstypen:

Het beste is om dit eerst lokaal te testen in een sandbox-omgeving

De verbinding tussen Externe gegevensbron en Workplace configureren

Hoe krijg ik toegang

Ga naar Studio
Inloggen met je gegevens
Selecteer Integraties > Externe gegevensbronnen in de Studio 2.0-interface

Selecteer "Nieuw toevoegen".
Huurder-ID wordt ingevuld op basis van de omgeving waarop je bent ingelogd
Vul Source ID in met een unieke naam, verwijzend naar uw externe gegevensbron

Gebruik in het veld Source ID alleen alfanumerieke waarden. De bron-ID wordt later gebruikt als onderdeel van de apparaat-ID's.

(Optioneel) Vul een beschrijving in, waarin staat wat voor soort gegevens via de externe gegevensbron komen
Kopieer de URL van de webhook + het autorisatietoken om de webhook aan te maken in de externe gegevensbron naar Spacewell Workplace.
Zorg ervoor dat uw installatie is ingeschakeld in Workplace

Test je opstelling

Zodra de webhook is aangemaakt in de database van de 3e partij met de bovenstaande URL en token, moet u de verbinding testen.

Deze stap moet worden uitgevoerd door de partij die gegevens naar Spacewell Workplace wil verzenden.

Controleer met een programma als Postman of je opstelling werkt:

Als het verzoek niet succesvol is, retourneert het eindpunt 4xx-5xx statuscodes afhankelijk van de opgetreden kwestie.
Als het verzoek succesvol is, retourneert het eindpunt 200 statuscode met een leeg lichaam.

Raadpleeg bij twijfel het hoofdstuk "Problemen oplossen" hieronder.

Volgende stappen

Zie voor het maken van aangepaste apparaattypen en het configureren van sensoren van derden in Workplace Custom Device Types

FAQ

Problemen oplossen

Generieke eindpuntinstelling

In het verleden waren sommige externe gegevensbronnen via een iets ander formaat verbonden met Spacewell. Hierdoor is er alleen een beperking voor de legacy / oude generieke eindpunten:

De oude / legacy Generic Endpoints worden in Studio getoond met het label 'Gemaakt door Spacewell'.
De gebruiker kan geen acties ondernemen (Vernieuw Autorisatie token, Inschakelen / Uitschakelen worden allemaal grijs weergegeven)
Gebruiker kan alleen URL/autorisatietoken bekijken en kopiëren.

Neem contact op met je Account Manager om het autorisatietoken in/uit te schakelen of te vernieuwen.

Zoek op

Workplace Knowledge Base (nl.support.spacewell.com)

Externe gegevensbronnen

Analytics