Versions Compared

Version Old Version 1 New Version Current
Changes made by

Lango: Language and translation manager

Lango: Language and translation manager

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Automatically translated by Lango

DifficultyMoeilijkheidsgraad: expert

Content

Inhoud

Table of Contents
minLevel1
maxLevel1

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.

Expand
titleExternal Data Sources for beginners - an analogy

Since you’re on this page: looks like the sensors, that are in scope of sending data to the Workplace platform, are sending data to a platform or database that is not connected to Workplace. Working your way down this page, we’ll make sure that there is a connection set up between the platforms, that the data is send is a format that Workplace can work with and knows how to identify.

Setting up External Data Sources and sending data from an external database to the Workplace platform can be compared to “A car arrives at a gate. The car is known to the gate keeper, and the person in the car has a badge, because he told his contact person up front that he was coming.”

Image Removed

  1. We want the external platform to send data to Workplace, which is why we use webhook with HTTP method “post”. This means the data gets pushed by the other system, and Workplace will not have to pull it from somewhere.

  2. By creating an External Data Source in the tenant, you create a door or gate towards the Workplace platform: the Webhook URL. You’ll also receive the code to open the gate: the Authorization Token. Providing this information to the owners of the database, they are now able to reach the door.

  3. But they need to present us the data in a way that we can consume! So they need to adhere to some rules:

    1. the data they send us must be meaningful: Workplace needs to be able to do something with that data (for example present them on a live floor plan or in a dashboard). So the External Data Source needs to provide the data in any of the 10+ supported data types.

    2. it’s not enough that they would just throw some data at us. In order to correctly interpret that data, it needs to adhere to a specific (payload) format. In this way, we know which part of the information to interpret as the device ID, which part as the value we need to store in the Workplace database etc.

  4. For Spacewell to know where we need to store the data in our database, the sensor needs to be known on our end, and linked to a location. This is why the device needs to be registered in Studio. To register the device in Workplace Platform, you need:

    1. Device Type, which actually contains a preset of data types (per chosen DeviceType, a default set of channels is enabled).

    2. Device ID, which needs to be unique.

      1. In order to make this ID unique across all tenants, the device ID format includes the tenant ID

      2. In order to make this ID unique within the tenant, the device ID format includes the External Data Source ID

    3. Location information. If a sensor is not linked to a location, data is not stored in the Spacewell database.

Image Removed

  • the fact that the car is arriving at the gate without Spacewell needing to do anything is the webhook

  • the supported data type was the instruction to present at a specific gate

  • the brand and model of the car is the payload, the vehicle that is used to present the data

  • the data is in the trunk of the car

  • the sensor ID is the badge used for identification

  • the device type is the gate number

  • the gate is open thanks to the authorization token

Spacewell consultants that want to learn more about how Spacewell treats data that comes in, can check out

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.

Expand
titleExterne gegevensbronnen voor beginners - een analogie

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

Image Added

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

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

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

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

Image Added

  • 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 /wiki/spaces/WM/pages/492237

The sensor vendor needs to comply with the De sensorverkoper moet voldoen aan de Spacewell webhook, supported data types & ondersteunde gegevenstypen en payload.

Info

Within Binnen 1 vendor ID , sensor IDs need to be unique and prepended with the vendor ID.
Combining device IDs from multiple third parties in 1 External Data Source, raises the potential risk of conflicts.

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.

The

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:

  1. In de externe database (klant of derde partij): Gegevenslading configureren

  2. De verbinding tussen Externe gegevensbron en Workplace configureren

  3. Ga naar de database en vul URL en token in, zorg ervoor dat je de verbinding test

  4. Apparaten configureren op het Workplace platform

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

Supported data types & payload

For all data types, it makes sense to verify if data will be send regularly or not; see

Ondersteunde gegevenstypen en payload

Voor alle gegevenstypen is het zinvol om te controleren of gegevens regelmatig worden verzonden of niet; zie https://spacewell.atlassian.net/wiki/spaces/KB/pages/5242896/External+Data+Sources#FAQ

Space occupancy related data typesDatatypes met betrekking tot ruimtebezetting:

Expand
titlePIR*: space occupancyruimtebezetting
Code Block
languagejson
{
"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
}
Pulse: for door counters sending pulse values
Expand
titleHeadcountAantal personen*: for measuring number of peoplevoor het meten van het aantal personen
title
Code Block
languagejson
{
“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
}
Expand

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

Expand
titlePuls: voor deurtellers die pulswaarden verzenden
Code Block
languagejson
{
“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
}
Expand
titleCount: for door counters sending accumulated valuesTeller: voor deurtellers die geaccumuleerde waarden verzenden
Code Block
languagejson
{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "countcounter", // 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
}
Expand
titleFootfall-Voetval in pulsepuls*
Code Block
languagejson
{
“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
}
Expand
titleFootfall-out pulseVoetuitval puls*
Code Block
languagejson
{
“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
}
Expand
titleParkingParkeren*
Code Block
languagejson
{
“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 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 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 Zie voor een mogelijke oplossing voor gegevenslacunes in de dashboards (gegevens kopiëren in tijdslots) https://spacewell.atlassian.net/wiki/spaces/KB/pages/5242896/External+Data+Sources#FAQ

Comfort related data typesComfortgerelateerde gegevenstypen:

Expand
titleTemperatureTemperatuur
Code Block
languagejson
{
“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
}
Expand
titleHumidityVochtigheid
Code Block
languagejson
{
“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 typesAan binnenluchtkwaliteit gerelateerde gegevenstypen:

Expand
titleCO2
Code Block
languagejson
{
“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
}
Expand
titleTVOC (Total volatile organic compoundsTotaal vluchtige organische stoffen)
Code Block
{
“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
}
Expand
titleRadon
Code Block
languagejson
{
“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

Go to

Info

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 https://studio.cobundu.com/

  • Login with your credentials

  • Select Settings > External Data Sources in the Inloggen met je gegevens

  • Selecteer Integraties > Externe gegevensbronnen in de 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

Note

In Source ID field, only use alphanumeric values. The Source ID will later be used as a component of the device IDs.

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

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

    • Make sure to enable your setup

    1. Selecteer "Nieuw toevoegen".

    2. Huurder-ID wordt ingevuld op basis van de omgeving waarop je bent ingelogd

    3. Vul Source ID in met een unieke naam, verwijzend naar uw externe gegevensbron

    Note

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

    1. (Optioneel) Vul een beschrijving in, waarin staat wat voor soort gegevens via de externe gegevensbron komen

    2. Kopieer de URL van de webhook + het autorisatietoken om de webhook aan te maken in de externe gegevensbron naar Spacewell Workplace.

    3. Zorg ervoor dat uw installatie is ingeschakeld in Workplace

    Info

    It’s possible to refresh the Authorization Token Het is mogelijk om het autorisatietoken te vernieuwen in Studio. Remember that this new token now also needs to be updated in the 3rd party platform.

    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.

    Configure the sensors in Workplace

    Prerequisites for this step:

    have the confirmation that the test was successful (endpoint returns 200 status codewith an empty body)

  • 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

    • Image Removed

    1. Go to your environment (https://studio.cobundu.com ) and log in

    2. Select the location, and manually add a sensor via "Add New Device"

    3. Select the (most relevant) Device Type "Generic …” (eg for PIR: "Generic PIR") from the drop-down list. As per the chosen DeviceType, a default set of channels is enabled

      1. If a device is able to gather data on a channel, that is not part of the DeviceTypes' default set of channels : it’s possible to manually add these in Advanced*

    4. 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>|<device_id>

    Expand
    titleExample device ID

    for example

    • if you want to configure a sensor with ID “123” (unique_device_id that will be mentioned in the payload; in case of 3rd party vendor will need to be provided by the 3rd party)

    • in an environment with tenant ID “spacewell”

    • where an External Data Source with source ID “testgeneric” has been set up

    the Spacewell Device ID will be

    “spacewell-testgeneric|123"

    1. Give a meaningful name (eg customer_floor number_area) in Device Name.

    2. Location will be filled in based on your pre-selection in the location tree

    For more information on how to add multiple new devices to Studio, check out Configure devices (add, remove, import/export).

    Info

    Within 1 vendor ID, sensor IDs need to be unique and prepended with the vendor ID.
    Combining device IDs from multiple third parties in 1 External Data Source, raises the potential risk of conflicts.

    * If a device is able to gather data on a channel, that is not part of the DeviceTypes' default set of channels : it’s possible to manually add these in Advanced

    Image Removed

    1. Select the relevant Sensor Type from the drop-down

    2. Fill in the “channel” value as mentioned in the https://spacewell.atlassian.net/wiki/spaces/KB/pages/5242896/External+Data+Sources#Supported-data-types-%26-payload

    Expand
    titleConcrete example to set up a device for which there is no Generic DeviceType available

    In this example, we’re setting up a sensor that will provide data on footfall (sending data each time a person crosses a (virtual) line in one or in the other direction).

    1. Select the DeviceType that most closely describes the device (in this example we could use “Generic Pulse”

    2. Fill in Device ID, a meaningful name, location etc as mentioned above

    3. Open the “Advanced” section

    4. Delete any sensor types that are selected by default but are not relevant for your sensor

    5. Select “Add new sensor” and add as many new sensor types as relevant for your sensor, in this case:

      1. Sensor type “Footfall (in)”

      2. Sensor type “Footfall (out)”

    6. Fill in the Channel with the information “type” value as mentioned in the https://spacewell.atlassian.net/wiki/spaces/KB/pages/5242896/External+Data+Sources#Supported-data-types-%26-payload

    Image Removed

    Image Removed

    FAQ

    Expand
    titleWhat if the sensor does not regularly send data? Is it possible to copy data in timeslots?

    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.

    Info

    Consequently, Workplace will only visualize or report if a sensor is NOT transmitting data after the configured time has expired (in previous example: after 7 days).

    Reach out to your Account Manager to set this up.

    Expand
    titleIs it possible to connect multiple external data sources through the same endpoint in Workplace?

    It's possible to re-use the external data source information (Authentication token + URL).

    So if devices have the same behavior, but are linked to different external data sources, it’s possible to only set up 1 endpoint in Studio, and have the 2 external data source send data to that same Workplace endpoint.

    Info

    Within 1 vendor ID, sensor IDs need to be unique and prepended with the vendor ID.
    Combining device IDs from multiple third parties in 1 External Data Source, raises the potential risk of conflicts.

    Troubleshooting

    Expand
    titleNot getting a 200 status code (indicating succesful connection)?

    Make sure the following configuration is in place:

    • the connection details used in the external data source are the ones provided by Spacewell

    • verify the authorization code has not been updated / changed in Workplace

    • adhere to the required supported data types & payload

    Expand
    titleSuccessfull connection message, but sensor is not loading any data

    Make sure the following configuration is in place:

  • sensor ID created in Workplace adheres to the described logic, and contains:

    • environment tenant ID

    • External Data Source ID

    • unique_device_id that is mentioned in the payload (in case of 3rd party vendor will need to be provided by the 3rd party)

    • sensor data is send according to the required

    Vergeet niet dat dit nieuwe token nu ook moet worden bijgewerkt in het platform van de 3e partij.

    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.

    Image Added

    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

    Expand
    titleWat als de sensor niet regelmatig gegevens verstuurt? Is het mogelijk om gegevens in timeslots te kopiëren?

    Afhankelijk van het soort sensor kan het zijn dat ze niet regelmatig hartslagen of gegevens verzenden. Als ze gegevens verzenden en dan alleen een bericht sturen als de waarde verandert, kan het zijn dat je met stukjes en beetjes gegevens zit (bijvoorbeeld 1 tijdslot van 15 minuten met gegevens over de temperatuur, en de rest van de dag niets), wat verwarring kan veroorzaken als je de dashboards probeert te lezen.

    Om dit te omzeilen kunt u ervoor kiezen om Spacewell de gegevens te laten kopiëren, per generiek eindpunt / apparaattype niveau voor elke gewenste hoeveelheid tijd.

    Bijvoorbeeld voor het sensortype "Generieke PIR" kunnen we een "kopie in verdere tijdslots" instellen en deze waarde zou geldig zijn voor alle Generieke PIR-sensorwaarden die bij ons binnenkomen voor je huurder. Natuurlijk worden de gegevens alleen gekopieerd totdat er weer nieuwe gegevens binnenkomen. Zodat als een waarde op maandag om 9 uur 's ochtends binnenkomt en de configuratie zegt "7 dagen kopiëren", en op woensdag om 8 uur 's ochtends komt er een nieuwe waarde binnen, dan wordt vanaf woensdag om 8 uur 's ochtends de nieuwe waarde 7 dagen meegenomen, of totdat er een nieuwe waarde binnenkomt.

    Info

    Bijgevolg zal Workplace alleen visualiseren of rapporteren als een sensor GEEN gegevens verstuurt nadat de geconfigureerde tijd is verstreken (in het vorige voorbeeld: na 7 dagen).

    Neem contact op met je Account Manager om dit op te zetten.

    Expand
    titleIs het mogelijk om meerdere externe gegevensbronnen aan te sluiten via hetzelfde eindpunt in Workplace?

    Het is mogelijk om de externe gegevensbroninformatie opnieuw te gebruiken (verificatietoken + URL).

    Zodat als apparaten hetzelfde gedrag hebben, maar gekoppeld zijn aan verschillende externe gegevensbronnen, het mogelijk is om slechts 1 eindpunt in Studio in te stellen en de 2 externe gegevensbronnen gegevens naar datzelfde eindpunt in Workplace te laten sturen.

    Info

    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.

    Expand
    titleIs het mogelijk om gegevens te verzenden met een tijdstempel die afwijkt van de datum van vandaag?

    Technisch gezien kan Workplace gegevens accepteren met tijdstempels van 5 jaar in het verleden en 1 jaar in de toekomst. Maar deze gegevens worden natuurlijk niet meegenomen in berekeningen of live gegevensweergaven. Alleen tijdstippen van de vorige dag worden berekend. Zodat, zelfs als we de gegevens opslaan, ze nergens zichtbaar zijn.

    De beste manier is dus om gegevens te verzenden met een (bijna) realtime tijdstempel.

    Expand
    titleIs het mogelijk om een Externe gegevensbron te verwijderen?

    In Workplace is het mogelijk om een Externe gegevensbron uit te schakelen, maar je kunt deze niet verwijderen. Verwijdering zou gevolgen hebben voor apparaten die een koppeling hebben met deze Externe gegevensbron.

    Problemen oplossen

    Expand
    titleKrijg je geen 200 statuscode (wat aangeeft dat de verbinding is gelukt)?

    Zorg ervoor dat de volgende configuratie aanwezig is:

    • de verbindingsgegevens die worden gebruikt in de externe gegevensbron zijn de gegevens die worden geleverd door Spacewell

    • controleer of de autorisatiecode niet is bijgewerkt / gewijzigd in Workplace

    • voldoen aan de vereiste ondersteunde gegevenstypen en payload

    Expand
    titleVerbindingsbericht succesvol, maar sensor laadt geen gegevens

    Zorg ervoor dat de volgende configuratie aanwezig is:

    • sensor ID die in Workplace is gemaakt, voldoet aan de beschreven logica en bevat:

      • ID omgeving huurder

      • Externe gegevensbron-ID

      • unique_device_id die wordt vermeld in de payload (in het geval van een externe leverancier moet deze worden verstrekt door de externe partij)

    • sensorgegevens worden verzonden volgens de vereiste https://spacewell.atlassian.net/wiki/spaces/KB/pages/5242896/External+Data+Sources#Supported-data-types-%26-payload

    • relevant sensor data channels are enabled for the device on the Spacewell relevante sensorgegevenskanalen zijn ingeschakeld voor het apparaat op het Spacewell-platform

    See “Legacy Generic End-Point Set-up” chapter below
    Expand
    titleSeeing "Created by Spacewell" and not able to refresh the token or enable/disable the external data source?
    Ik zie "Aangemaakt door Spacewell" en kan het token niet vernieuwen of de externe gegevensbron in- of uitschakelen?

    Zie het hoofdstuk "Generieke eindpuntinstelling voor oudere versies" hieronder.

    Expand
    titleNot able to refresh the token or enable/disable the external data source?

    For security reasons: If a user logs in with a multi-tenant account, they are not able to make any changes to any external data sources.

    Legacy Generic End-Point Set-up

    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:

    1.  The old / legacy Generic Endpoints will be shown in Studio with the label '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.

    To Enable / Disable or Refresh authorization token, reach out to your Account Manager.

    Image Removed

    Search

    Kunt u het token niet vernieuwen of de externe gegevensbron in-/uitschakelen?

    Om veiligheidsredenen: Als een gebruiker zich aanmeldt met een account voor meerdere huurders, kan hij geen wijzigingen aanbrengen in externe gegevensbronnen.

    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:

    1. De oude / legacy Generic Endpoints worden in Studio getoond met het label 'Gemaakt door Spacewell'.

    2. De gebruiker kan geen acties ondernemen (Vernieuw Autorisatie token, Inschakelen / Uitschakelen worden allemaal grijs weergegeven)

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

    Image Added

    Zoek op

    Live Search