Core TSIs : Agile Workplace Management : Agile Workplace Management - Concepts : Connector : Connector options : Planon managed
Planon managed
For a Planon managed connector, the partner sensor system must publish a (Restful) API based on Planon specifications.
The Planon AWM system sends requests to this API in a time interval (polling, default every 60 seconds).
* 
To retrieve data, a Planon managed connector uses polling.
Schematic overview of flow of the agile workplace management setup with the connector in between AWM and the sensoring system. Via a REST API sensor data is delivered to the connector.Schematic overview of flow of the agile workplace management setup with the connector in between AWM and the sensoring system. Via a REST API sensor data is delivered to the connector.
There are two possible requests to the API:
• Synchronization
During synchronization, the whole list with measurement points and related sensors is published to the sensor system. This synchronization is only required if something has changed in the measurement point and/or sensors.
* 
This could be newly added measurement points or sensors, but also changes in the measurement point ID or sensor IDs. The same is true when measurement points or sensors are deleted.
During synchronization, all measurement points that have a valid sensor(s) linked will be published. It does not matter if the sensor is Active or not. Triggering synchronization is a manual process started at the Connector tab. If this event is triggered, the connector is flagged for synchronization.
* 
The actual synchronization will take place at the next polling.
• Measurement update
During a measurement update (polling cycle), a request is sent for all active measurement points. If there is new measurement data, this will be routed to Planon for further processing.
* 
Most of the fields that need to be filled in are related to the identification and authentication of the external API.