forms

Forms instantiated from a form template under a node.

📄️Create or update a form

Creates a new form under the given parent node from the referenced template (with its signals and a signal group) when the request has no id, otherwise updates the existing form's name, description and - with `signalAssignments` - where its time-series elements write into. Returns the resulting form.

📄️Get a form by id

Returns the form with the given id. Responds 404 if the form does not exist or has been soft-deleted.

📄️Delete a form

Soft-deletes the form and removes its associated signal group. Responds 404 if the form does not exist.

📄️Get the signals the time-series elements of a form write into

Returns, per time-series element of the form's template, the node of the signal its values are written into - the one the form created or an existing one it fills (HET-2040). Every entry is in mode EXISTING. An element whose signal has been deleted since has no entry, like one that never had a signal, and a publish writes nothing for either. Responds 404 if the form does not exist or has been soft-deleted.

📄️List the forms the caller may read, one page at a time

Returns one page of the forms of the tenant whose node the caller holds at least a read right on (directly or inherited), sorted by name, together with the counts of the whole result. Each entry carries its template, its latest input - the one with the latest measurement time - and, if the caller has put the form on their quick access page, its position there. Soft-deleted forms are left out.

📄️Get the caller's quick access forms

Returns the forms on the caller's quick access page, in the order the caller arranged them, in the same shape as the overview. Not paged - the page is arranged by hand and ordered across all of its forms. Forms that were deleted or are no longer readable are left out.

📄️Replace the caller's quick access forms

Replaces the caller's quick access page with the given forms, in the given order. Adding, removing and reordering are all done through this call. Responds 404 if a form does not exist, is soft-deleted or is not readable by the caller, and 400 if a form is listed twice.