Versions Compared

Version Old Version 1 New Version 2
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.

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

Leerdoelen

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

  • Identificeer welke gegevenstypen worden ondersteund door Spacewell Workplace

  • Configureer webhook & autorisatietoken om uw externe gegevensbronnen te verbinden met Workplace

Go to your environment

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
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 Nu je 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 Workplace weet hoe het de gegevens moet 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 zal niet moeten 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 Webhook URL. 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! Dus moeten ze zich aan een aantal regels 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). Dus de externe gegevensbron moet de gegevens 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, moet je:

    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 het 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 voorstelt.

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 occupancy
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
}
Expand
titleHeadcount*: for measuring number of people
Code Block
languagejson
{
“device”: "<unique_device_id>", // string: unique id of the device
“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
titlePulse: for door counters sending pulse values
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 values
Code Block
languagejson
{
“device”: "<unique_device_id>", // string: unique id of the device
“type”: "count", // 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-in pulse*
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 pulse*
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
titleParking*
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/hoofdaantallen op de live (naar de 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 types-gerelateerde gegevenstypen:

Expand
titleTemperature
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
titleHumidity
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 compounds)
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

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 Instellingen > 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 meegeleverde webhook URL + autorisatietoken om de webhook aan te maken in de externe gegevensbron naar Spacewell Workplace

    3. Zorg ervoor dat je je instellingen inschakelt 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

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

    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.

    De sensoren configureren in Workplace

    Vereisten voor deze stap:

    • de bevestiging hebben dat de test succesvol was (endpoint retourneert 200 statuscodemet een leeg lichaam)

    • de bevestiging hebben welk gegevenstype wordt gebruikt om de gegevens over te brengen

    • de lijst met apparaat-ID's hebben die gegevens van de externe gegevensbron naar het Workplace-platform sturen

    Image Added

    1. Ga naar je omgeving (https://studio.cobundu.com ) and en 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 Selecteer de locatie en voeg handmatig een sensor toe via "Nieuw apparaat toevoegen".

    4. Selecteer de (meest relevante) Type apparaat "Generic ..." (bijv. voor 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*

      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>|<deviceuit de vervolgkeuzelijst. Afhankelijk van het gekozen DeviceType wordt een standaardset kanalen ingeschakeld

      1. Als een apparaat gegevens kan verzamelen op een kanaal dat geen deel uitmaakt van de standaard set kanalen van de DeviceTypes: het is mogelijk om deze handmatig toe te voegen in Gevorderd*

    5. Vul de Apparaat-IDGebruik de ID van de huurder en de bron-ID die beschikbaar zijn in Instellingen > Externe gegevensbronnen. Houd u aan het formaat <huurder_id>-<bron_id>|<apparaat_id>

    Expand
    titleExample device ID

    for example

    if you want to configure a sensor with ID “123”

    bijvoorbeeld

    • als u een sensor wilt configureren met 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

    • die zal worden vermeld in de nuttige lading; in het geval van een externe leverancier moet deze door de externe partij worden geleverd)

    • in een omgeving met huurder-ID "spacewell".

    • waar een Externe gegevensbron met bron-ID "testgeneric" is ingesteld

    wordt de Spacewell-apparaat-ID

    "spacewell-testgeneric|123"

    1. Give a meaningful name (eg Geef een betekenisvolle naam (bijv. 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

    1. De locatie wordt ingevuld op basis van uw voorselectie in de locatiestructuur

    Ga voor meer informatie over het toevoegen van meerdere nieuwe apparaten aan Studio naar Configure devices (add, remove, import/export).

    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.

    * 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

  • Select the relevant Sensor Type from the drop-down

    • Fill in the “channel” value as mentioned in 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.

    * Als een apparaat gegevens kan verzamelen op een kanaal dat geen deel uitmaakt van de standaard set kanalen van de DeviceTypes: het is mogelijk om deze handmatig toe te voegen in Geavanceerd

    Image Added

    1. Selecteer het relevante sensortype in het vervolgkeuzemenu

    2. Vul de waarde "kanaal" in zoals vermeld in de 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).

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

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

  • Open the “Advanced” section

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

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

    • Fill in the Channel with the information “type” value as mentioned in the

    dit voorbeeld stellen we een sensor in die gegevens levert over het aantal voetstappen (die gegevens verstuurt telkens wanneer een persoon een (virtuele) lijn in de ene of in de andere richting oversteekt).

    1. Selecteer het DeviceType dat het apparaat het beste beschrijft (in dit voorbeeld kunnen we "Generic Pulse" gebruiken).

    2. Vul Apparaat-ID, een betekenisvolle naam, locatie enz. in zoals hierboven vermeld

    3. Open het gedeelte "Geavanceerd

    4. Verwijder alle sensortypes die standaard zijn geselecteerd maar niet relevant zijn voor uw sensor.

    5. Selecteer "Nieuwe sensor toevoegen" en voeg zoveel nieuwe sensortypes toe als relevant zijn voor je sensor, in dit geval:

      1. Sensortype "Aantal voetstappen (in)".

      2. Sensortype "Voetval (uit)".

    6. Vul het Kanaal in met de informatie "type" waarde zoals vermeld in de https://spacewell.atlassian.net/wiki/spaces/KB/pages/5242896/External+Data+Sources#Supported-data-types-%26-payload

    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 upAfhankelijk 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. Dus 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 accountmanager om dit op te zetten.

    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 Het is mogelijk om de externe gegevensbroninformatie opnieuw te gebruiken (verificatietoken + 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

    Dus als apparaten hetzelfde gedrag hebben, maar gekoppeld zijn aan verschillende externe gegevensbronnen, is het mogelijk om slechts 1 eindpunt in Studio in te stellen en de 2 externe gegevensbronnen gegevens naar datzelfde Workplace-eindpunt 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.

    Problemen oplossen

    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 &

    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
    titleSuccessfull connection message, but sensor is not loading any data

    Make sure the following configuration is in placeZorg ervoor dat de volgende configuratie aanwezig is:

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

    • environment tenant ID

      • External Data Source

      is gemaakt, voldoet aan de beschreven logica en bevat:

      • ID omgeving huurder

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

      • 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

    Expand
    titleSeeing "Created by Spacewell" and not able to refresh the token or enable/disable the external data source?

    See “Legacy Generic End-Point Set-up” chapter belowZie 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

    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 werden sommige externe gegevensbronnen via een iets ander formaat aan Spacewell gekoppeld. 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