Create or update a form
PUT/forms
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.
Creating it decides where the values of the template's time-series elements (numeric and calculation fields with shouldCreateSignal) go: by default into a new signal named after the element under the new form, or - per entry of signalAssignments - into a new signal under another asset or with another name, or into an existing signal (HET-1959). An update reassigns the elements its entries name in the same way and leaves the others as they are (HET-2040). Every signal the form writes into belongs to its signal group.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- default
The updated or created form form
The payload is invalid. For signalAssignments: an entry names an element that fills no time series or one assigned already, lacks what its mode needs or carries the other mode's fields, places a new signal under anything but an asset (or, on update, the form itself), gives two new signals of one place the same name, or fills a node that is no plain signal - or one signal from two elements, counting the ones an update leaves as they are.
Unauthorized — the bearer token is missing, expired or invalid, or carries no role. Errors raised by the security aspects contain an ErrorDto body; requests rejected by the security filter chain may have an empty body.
Forbidden — the authenticated user lacks the required role or access rights.
The form to update, the template, the parent node or a node named by signalAssignments does not exist.
The name of a new signal is taken by a signal already under the parent it names.
the default error response