POST /assets/r1/assets/{assetId}/measuring-elements/{measuringElementId}/measures

Business Logic

This API creates a new Measure for the selected asset. A measure is defined by the mandatory fields:

• measuringDate

• measuringUserId

A measure can be inserted only when its measuring element’s status is set to WORKING (27001).

In order to successfully call this api the user must follow one of the following scenario:

1. If the user sets to true the flag unfeasible then the only data that he can modify are: measuringDate, measuringUserId and notes, the other data set in input will be discarded and the data set to the measure will be the one of the previous measure with eventually the alignment if it is necessary

2. If the measuring element has a catalogGroup then the user can also specify a catalogCode, the catalogCode must exists

3. If the measuring element has a characteristic the scenario will be two:

   1. Characteristic is of type meter: the user can also specify:

      1. deltaValue, allowed only for this kind of characteristic, can’t valorise both value and deltaValue

      2. rotations, it is needed if the counterOverflow reaches the max value, error: PROPERTY_REQUIRED

         1. For FORWARD counters (counting up):

            • When the current value is less than the previousValue

            • Example: Previous reading was 995, new reading is 002 (counter rolled over)

         2. For BACKWARD counters (counting down):

            • When the current value is greater than the previousValue

            • Example: Previous reading was 002, new reading is 995 (counter rolled over)

         This handles counter overflow situations:

         • Forward counter: 999 → 000 (needs rotation count)

         • Backward counter: 000 → 999 (needs rotation count)

         The user needs to specify rotations in these cases because the system can't automatically determine if the counter has completed one full rotation or if it's an error in the reading.

   2. Characteristic is not of type meter:

      1. value

Path parameters

Header Parameters

Default.

Request Body Parameters

Response documentation

Response payload fields

Response error codes

BASE_0001, BASE_0003, BASE_0011, NOT_FOUND, ASSETS_ORCHESTRATOR_011, ASSETS_ORCHESTRATOR_012, ASSETS_ORCHESTRATOR_013, ASSETS_ORCHESTRATOR_014, ASSETS_ORCHESTRATOR_019, ASSETS_ORCHESTRATOR_022