Sensor Templates
Sensor Templates are saved sets of Measurement Point parameters tied to a specific sensor type. Applying a template copies its parameters onto a Measurement Point in one step, replacing the need to configure offset, sensitivity, display options, and other values manually each time.
Typical use-case: A system administrator prepares a template called "Accelerometer Standard" for the LIS2DH12 sensor. When configuring a new Measurement Point with that sensor, you select the template and all parameters are applied automatically — no manual input needed.
Sensor Templates are available to Construction Admins and higher (Organization Admin, Global Admin). Lower roles see neither the Manage Templates tab nor the template controls under a chart.
Applying or removing a template writes to the Measurement Point, so it needs the same role as editing the point.
Creating, editing, and deleting templates is handled on the backend. The portal only allows selecting and applying existing templates.
Accessing Templates
There are three entry points, all of which end up in the same Apply Template dialog:
- Measurement Point edit modal → Sensors tab → Communicating Sensors — apply a template while configuring a specific Measurement Point.
- Charts view → Manage Templates tab — full template management for the current Measurement Point (the same sensor cards, template selection and Configure button as the Sensors tab).
- Charts view → under an individual chart — the fastest route when you are already looking at the data. See Templates from the chart.
Templates from the chart
Under each chart channel there is a Show Parameters toggle. What it opens depends on your role:
| Role | What the toggle offers |
|---|---|
| Below Construction Admin | Nothing — the toggle is not shown |
| Construction Admin, Organization Admin | The Template section only |
| Global Admin | A switch between Template and Parameters, one open at a time |
In the Template section:
- Template for this channel lists only templates matching that channel's sensor type. With none matching, it says "No templates available for this sensor."
- Select template, then Apply — this opens the same Apply Template dialog described below, so you still see the full preview before anything is written.
- When a template is already applied, the panel shows Applied template with a Configure button. Configure reopens the Apply Template dialog for the template already in place, which is how you adjust the values it wrote without reapplying it from scratch. The template can also be removed from here.
The chart and the Manage Templates tab show the same sensors and the same templates. Use whichever is closer to what you are doing — the chart when you are reading data, the tab when you are setting a point up.
Communicating Sensors list
Opening Communicating Sensors gathers three things:
- the sensors configured on the Measurement Point
- all available templates
- existing template assignments for this Measurement Point
Results are displayed as a grid of Sensor Cards — one card per sensor/channel combination. Each card shows a dropdown for selecting a template compatible with that sensor type.
The list is built from the sensors configured on the point, not from recent traffic, so it is not limited to a time window. A sensor that has been silent for days still appears and can still be given a template.
Sensors are narrowed to the devices currently assigned to the point, which keeps sensors from a previously assigned device out of the list. If that device lookup fails, the full inventory is shown rather than an incomplete one.
Click Configure on a card to open the Apply Template Modal.
Apply Template Modal
Template selection
The dropdown lists only templates compatible with the sensor type on the selected channel. Templates for a different sensor type are not shown.
Effective date (optional)
You can set a date from which the new parameters become valid. This uses validFromEpoch — the same versioning mechanism as standard parameters.
Existing timestamps are shown below the date picker — click any of them to instantly set it as the effective date.
Preview
Before saving, the modal shows a preview of all changes grouped into four sections:
| Color | Section | What it shows |
|---|---|---|
| Red | To remove | Legacy params with no assigned sensor type, and params from a previously assigned template that are absent from the new one. Each has a Keep toggle. |
| Blue | Timed changes | Params that already exist and will gain a new version tied to the selected effective date. Version history is shown inline. |
| Yellow | Overlapping | Params that exist without a date and would be overwritten by the template. Values are editable before saving. |
| Green | New | Params from the template that don't yet exist on the MP. |
Keep toggle (red section)
Params marked for removal can be kept by enabling their Keep switch. Keeping a legacy param (one with no assigned sensor type) also converts it to the current format by assigning it the sensor type, while preserving its value.
Saving
Confirming the modal writes the merged parameter set back to the Measurement Point.
The save writes the entire parameter list as a single PUT request. The resulting array is a merge of existing and new parameters according to the rules shown in the preview — review it carefully, particularly the red (removal) section, before confirming.
Per-sensor isolation
A single channel can carry multiple sensors of different types. Each sensor's parameters are tracked independently — applying a template for one sensor type does not affect parameters belonging to a different sensor type on the same channel.
Special parameter rendering
Some parameters have dedicated controls instead of a plain text input:
| Parameter | Control | Notes |
|---|---|---|
hideData, filterData, autoRemovePeaks, newView, enableTempCompensation, showBeforeCompensated, negativeRawValue, displayNewtons, digitView, deformationView, frequencyView, pascalView, viewTension, viewSensor10, viewEvent1, calculateSettlement, event, SHT, onlyTemp, dewpoint, deltaT, useApiCalculation | Toggle switch | Stored as the string "true" or "false" |
tempSource | Dropdown | Options: disabled, device, sensor, or a channel number for a specific Environment measurement |
Other numeric parameters use a standard text input.