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 | |
|---|---|
| Request | InsertVariableReadingRequestType.java |
| Return | InsertVariableReadingResponseType.java |
Request:
| ID # | Required | Description |
|---|---|---|
| idobject | X | Asset ID #. |
| idvariable | X | Variable ID #. |
| vlreadvalue | X | If 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”. |
| dtreaddate | Variable reading date, in the format mm/dd/YYYY. If empty, it will consider the date and time of the import service. | |
| qthrread | X¹ | Variable 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 |
|---|---|
| return | SUCCESS: 1. FAILURE: Message detailing the error. |