Skip to main content

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.

User Permissions

Sensor Templates are available to Construction Admins and higher (Global Admin, Organization Admin). The tab is not shown to lower roles.

Template management

Creating, editing, and deleting templates is handled on the backend. The portal only allows selecting and applying existing templates.

Accessing Templates

There are two entry points:

  • Measurement Point edit modal → Sensors tab → Communicating Sensors — apply a template directly while configuring a specific MP.
  • Charts view → Manage Templates tab — accessible to admins; full template management for the current MP (same sensor cards, template selection, and Configure button as the Sensors tab).

Communicating Sensors list

Opening Communicating Sensors triggers three parallel API requests:

  • Active sensors detected in the last 24 hours
  • All available templates
  • Existing template assignments for this Measurement Point

Results are displayed as a grid of Sensor Cards — one card per detected sensor/channel combination. Each card shows a dropdown for selecting a template compatible with that sensor type.

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:

ColorSectionWhat it shows
RedTo removeLegacy 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.
BlueTimed changesParams that already exist and will gain a new version tied to the selected effective date. Version history is shown inline.
YellowOverlappingParams that exist without a date and would be overwritten by the template. Values are editable before saving.
GreenNewParams 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.

Review before saving

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:

ParameterControlNotes
hideData, filterData, autoRemovePeaks, newView, enableTempCompensation, showBeforeCompensated, negativeRawValue, displayNewtons, digitView, deformationView, frequencyView, pascalView, viewTension, viewSensor10, viewEvent1, calculateSettlement, event, SHT, onlyTemp, dewpoint, deltaT, useApiCalculationToggle switchStored as the string "true" or "false"
tempSourceDropdownOptions: disabled, device, sensor, or a channel number for a specific Environment measurement

Other numeric parameters use a standard text input.