signals
Signals (time-series channels), signal groups, latest values and measurement names.
Create or update a signal
Creates a new signal when the payload has no id, otherwise updates the existing signal with that id. Returns the resulting signal. Saving a signal as transient removes it from every signal group it is a member of (see getSignalGroupsOfSignal) - a group reads stored time series only, and a transient signal stores none.
Get latest values for multiple signals
Returns the latest available value for each requested signal.
Compute one value per signal over a time range
Computes the requested aggregation for every requested signal over the resolved range - the
Get a signal by id
Returns the signal identified by the given signal id.
Get where a signal is still used
Lists the dashboard panels that show the signal, the forms that write into it, the workflow configurations - virtual signals included - that read it through an input, the signal groups it is a member of and the alarm rules bound to it by hand, for the warning before the signal is deleted (HET-2038). Reads the data source references of every panel and the wiring of every workflow of the tenant, so it may take a few seconds. Objects the caller may not read are listed with `readable: false` and nothing that opens them - a server that does not do so yet counts them in `unreadable`.
Set how the values of a signal's MQTT metric are compressed
Sets the compression the mqtt-client applies to the metric of the signal (HET-2188). The compression belongs to the metric, so it applies to every signal reading the metric. Takes effect with the mqtt-client's next reconciliation (30 s); stored values stay as they are. Needs the write right on every live signal reading the metric, not only on this one; `403` without naming the others, which the caller may not be allowed to read. `400` when the metric is not MQTT or the compression is not one the platform offers (interval, deadband).
List the signal groups of a signal
Returns the signal groups the given signal is a member of - those the caller may read with name and node, the others as a number only. Saving a signal as transient removes it from every one of them, and this is what a client lists before it does so.
Get a signal group by id
Returns the signal group identified by the given signal group id.
Create or update a signal group
Creates a new signal group when the payload has no id, otherwise updates the existing group with that id. Returns the resulting signal group.
Search distinct measurement names
Returns the distinct measurement names that start with the given search string. Returns an empty list when the search string is shorter than three characters.