Measurement point - fields
There are three types of measurement point fields:
• Read only: these are system fields that are filled by the data engine
• Configuration items: these are fields whose values can only edit when the measurement point is Inactive
• Free changeable fields, which do not affect the processing of data.
Field | Description |
|---|---|
General tab | |
Code | Enter an ID for the measurement point. |
Name | Enter a description for the measurement point. |
Measurement point definition | Select a measurement point definition from the list to which the measurement points should belong. |
Measurement point type | Select the type of measurement point. The measurement point types are defined on Configurations & logging > Measurement point types step. You can differentiate between various measurement point types. Working with a predefined set of measurement point types will enable the sensoring system to better interpret measurements.  For some sensoring systems, the measurement point type is mandatory, in which case it should be made mandatory on the layout in Planon. |
Measurement point role | Select your measurement point's role, which is more or less synonymous with the function it is going to play. You can choose from: • Primary A Occupancy is derived from the measurement point readings. When you select this role, the Display availability field on the Configuration tab is set to Yes. Data of all related measurement point roles will be aggregated at this level.• Primary B Occupancy is derived from the reservation data. When you select this role, the Display availability field on the Configuration tab is set to No. Data of all related measurement point roles will be aggregated at this level.• Supplementary Role that enables you to use a different set of sensors (measuring data other than occupancy). By having this role, you can mix sensors of different vendors. When you select this role, the Display availability field on the Configuration tab is set to No. • Secondary Role for providing auxiliary information. When you select this role, the Display availability field on the Configuration tab is set to No. |
Status | Indicate the measurement point status (set manually): Active – the measurement point is operational. Inactive – the measurement point is not operational. |
Comment | Enter notes (optional). The notes that you enter will be visible to the Planon administrator only. |
Occupancy value | Depending on the type of sensors and the API version used, the values in this field can have a different meaning. For more information, see Occupancy measurement. |
Pause reason | Displays the reason why a measurement point's occupancy status is put on Pause. This is a read-only field that can only be set by the Data Engine. Its values can be: • Connector inactive • Update next polling/event • Outside working hours By including the Pause status, the relevant readings can also be viewed. |
Person count | Depending on the type of sensors and the API version used, the values in this field can have a different meaning. For more information, see Occupancy measurement. |
Reading date/time | Displays the latest reading date/time given by the sensoring system. This is the date/time given in the time zone of the sensoring system. |
Normalized date/time | Displays the latest normalized reading date/time of the data engine. The normalized time is the local time calculated by the data engine based on the time zone of measurement point location. If no time zone is provided, the system time of the data engine is used. The occupancy status is calculated based on the normalized date and time. |
Occupancy status | Displays the status of occupancy of the measurement point. For more information refer to, Occupancy statuses. |
Previous occupancy status | Displays the previous occupancy status of the location. |
Occupancy status change date-time | Displays the date/time of the last change in the occupancy status (based on normalized reading date-time). |
Person | Displays the person to which the measurement point is linked. See also Linking persons.  This field can only be filled if supported by the sensoring system. See also Occupancy measurement. |
Reservation | Displays the reservation that is currently valid and was created for the location, if applicable. |
Battery status (voltage) | Displays the battery indication (voltage) received from the connector. The value indicates the status of the sensor's power supply. If multiple sensors are linked to the measurement point, the lowest battery voltage is returned. |
Light intensity (lux) | Displays the luminous intensity or lux (lx) received from the connector. |
Carbon dioxide (ppm) | Displays the carbon dioxide level received from the connector. The measurement point's carbon dioxide level is given in parts per million (ppm). |
Humidity (%) | Displays the humidity percentage received from the connector. |
Noise (dB) | Displays the loudness level received from the connector. The measurement point's loudness level is given in decibel (dB). |
Temperature (degrees) | Displays the temperature received from the connector. The measurement point's temperature is given in degrees Celsius or Fahrenheit, which is determined by the sensoring system. |
Power level (kWh) | Displays the power level value received from the connector. The power level indicates the energy usage in kilowatt (kWh). |
Free field 1/3 for vendor specific readings | Displays any vendor specific values collected from the sensoring system. See also Sensoring system data > free fields. |
Free measurement field 1/10 | Free fields made available for capturing numeric values, e.g. number of particles in a given time frame. This data must be supplied by the sensoring system. Because they are numeric values, they can be summarized and used in analysis. |
Error tab | |
Error code | Displays the error code that is published by the connector when encountering an error situation for the measurement point (not applicable for API). |
Monitor data | Indicate whether you want to enable monitoring logging for the selected measurement point. If you click Yes, the data from the sensoring system is logged in the System feedback field. |
System feedback | It displays an error message if the measurement point is Immeasurable. When monitoring is enabled, this field displays all data exchange (response) collected by the data engine. |
Configuration tab | |
Display availability? | Read-only field that indicates whether the measurement point should be taken into account when displaying availability in Kiosk, Room booking panel and Apps. If set to Yes: • The availability of the related unit will also be determined by the occupancy of the measurement point. • The data is available to Planon Apps, Room booking panel and Kiosk. When multiple measurement points are linked to the same location, only one is considered the primary measurement point (determined by setting this field Yes.) |
Store historical readings | Yes is selected by default. Select No, if you do not want to store historical data on the Details level. A record will not be created in the Measurement point readings list. |
Update during office hours only | Select Yes if you want to update the measurement point linked to a specific location during office hours only. No is selected by default. If you select Yes, the data engine continues to run, but will not record updates outside office hours. |
Store during office hours only | Select Yes if you want to store the measurement point readings during office hours only. No is selected by default. If you select Yes, the data engine continues to run, but will not store updates outside office hours. |
Maximum capacity (No.) | Enter the maximum occupancy capacity of the location to which you are linking the measurement point. This field is used for density calculations. The reservation unit linked to the measurement point also has a maximum capacity value. However, if both these fields are filled, the value defined at Measurement points level takes precedence. |
Time zone | Indicates the time zone of the measurement point. |
Calendar | Select the calendar for the measurement point. The calendar is important for summarization - it determines the time-frame for conducting measurements.You can select a specific calendar to be used, deviating from the location's calendar. If you do not select a specific calendar, the location calendar will be used. Using a separate calendar for measurement points can be important if, for example, you have reservation units with different office hours. When you do, the summarization process will be affected. Note: data that is already summarized will remain based on the previously configured calendar.• By deleting summarized data and subsequently synchronizing again, the summarization will be based on the current calendar. • If you delete summarized data, purge all three levels (hours, days, months). • You can only summarize anew for the period for which you have summarized readings. |
Property / Property zone / Floor / Space / Workspace / Reservation unit / Rentable unit | Select a location to which you want to link the measurement point. You can only select one location per measurement point. |