Moeilijkheidsgraad: expert
Inhoud
Leerdoelen
Na het lezen van dit artikel kun je:
- Ondersteunde gegevenstypen herkennen
- Webhook en token voor externe bronnen configureren
Bestaande gebouwen kunnen al sensoren hebben. Het generieke webhookendpoint integreert, verwerkt en bewaart veel externe sensorgegevenstypen.
Na koppeling eigen typen voor eenvoudiger beheer:
- Duidelijke namen voor herkenning bij onderzoek/vervanging
- Eigen drempels voor meldingen en proactief onderhoud
Vereisten
Leverancier voldoet aan webhook, typen en payload; zie Externe gegevensbronnen
Opmerking
Sensor-ID uniek en voorafgegaan door vendor-ID.
Meerdere leveranciers onder één bron geven conflictrisico.
Apparaattypen configureren
Openen
- Ga naar https://studio.cobundu.com/
- Log in
- Integrations > Device Types in Studio 2.0
- Add New
Algemeen
- Device Type Name
- Device Type ID: unieke identifier, ook bulkimport
Altijd prefix Generic|
Opmerking
Alleen kleine letters, cijfers en - in ID volgens bron
Info
Na opslaan ID niet wijzigbaar
- External Data Source
Specifieke bron voor één-op-éénkoppeling, eenvoudiger registratie; zie hieronder
- Any bij meerdere bronnen, complexere registratie
Info
Na opslaan bronkoppeling niet wijzigbaar
- Status aan voor selectie bij apparaatconfiguratie
- Device Image: standaard, generiek of eigen afbeelding op Device Label
Sensorstatus
Laatste meetwaarde/heartbeat, eigen frequentie per type. Zie Sensorstatus bewaken
Numerieke statusgrenzen:
- To Check
- Offline
moet hoger dan To Check
Kanalen
Kies uit ondersteunde typende kanalen die de apparaten zullen sturen:
- CO₂
- Counter
- Footfall Pulse (in)
- Footfall Pulse (out)
- Headcount
- Humidity
- Presence*
- Pulse
- Radon
- Temperature
- VOC
* Aanwezigheid
Verschil in bevestigen van leegstand:
- No: aanwezigheid bevestigd, maar afwezigheid niet direct na vrijgave, dus niet betrouwbaar als leegstandbevestiging
- Yes: bezetting én directe afwezigheid bevestigd
Opmerking
Niet sensornauwkeurigheid of communicatiebetrouwbaarheid, maar geldigheid van bezetstatus na enige tijd zonder detectie.
Bij onzekerheid over wanneer weer vrij, pictogramverval instellen via https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357488730/Live+floorplan+settings#Occupancy-settings.
Apparaten configureren
Vereisten
- Geslaagde bronverbinding bevestigd; zie https://onespacewell.atlassian.net/wiki/spaces/KB/pages/4357488644/External+Data+Sources#Test-your-setup
- Gebruikt gegevenstype bekend
- Lijst van verzendende IDs
Volgens vaste/Any-bron andere registratie:
1. Vaste externe bron
Eén-op-één vereenvoudigt Studio-registratie:
- Ga naar omgeving (https://studio.cobundu.com ) en log in
- Locatie en handmatig Add New Device
- Kies relevant Device Type met standaardkanalen
- Vul Device ID uit payload in*
- Geef herkenbare naam zoals klant_verdieping_ruimte.
- Location volgens eerdere boomselectie
Info
* Tenant-/bronprefix automatisch toegevoegd, zichtbaar in export.
Meerdere apparaten: Apparaten configureren: toevoegen, verwijderen, importeren en exporteren.
Info
Import vereist tenant en bron volgens formaat<tenant_id>-<source_id>, zie hieronder.
Opmerking
Binnen vendor-ID uniek en geprefixt.
Meerdere leveranciers geven conflictrisico.
2. Any externe bron
Bij verschillende bronnen is registratie complexer:
- Ga naar omgeving (https://studio.cobundu.com ) en log in
- Locatie en handmatig Add New Device
- Kies relevant Device Type met standaardkanalen
- Vul Device IDmet tenant-/bron-ID uit Settings > External Data Sources volgens <tenant_id>-<source_id>|<device_id>
- Geef herkenbare naam zoals klant_verdieping_ruimte.
- Location volgens boomselectie
Meerdere apparaten: Apparaten configureren: toevoegen, verwijderen, importeren en exporteren.
Opmerking
Uniek en geprefixt binnen vendor-ID.
Meerdere leveranciers geven conflictrisico.