Skip to main content
Version: 2.2.3

insertVariableReading

This method allows adding:

  • Readings of asset variables.

To insert each of these items, it is necessary to follow the standard documented below.

Java class
RequestInsertVariableReadingRequestType.java
ReturnInsertVariableReadingResponseType.java

Request:

ID #RequiredDescription
idobjectXAsset ID #.
idvariableXVariable ID #.
vlreadvalueXIf it is a subjective variable:
Name of the option of the list of values of the variable.

If it is an objective variable:
Reading value.
Use point as decimal separator and do not used thousands separator, for example “16000.000”.
dtreaddateVariable reading date, in the format mm/dd/YYYY.
If empty, it will consider the date and time of the import service.
qthrreadVariable reading time, in the format hh:mm (00:00 - 23:59). If empty, it will consider the date and time of the import service.
info
  • X¹ - Required if the reading date is filled out.

Request structure:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:maintenance">
<soapenv:Header/>
<soapenv:Body>
<urn:insertVariableReading>
<!--You may enter the following 5 items in any order-->
<urn:idobject>?</urn:idobject>
<urn:idvariable>?</urn:idvariable>
<urn:vlreadvalue>?</urn:vlreadvalue>
<urn:dtreaddate>?</urn:dtreaddate>
<urn:qthrread>?</urn:qthrread>
</urn:insertVariableReading>
</soapenv:Body>
</soapenv:Envelope>

Return:

ID #Description
returnSUCCESS: 1.
FAILURE: Message detailing the error.