Real Time Automation, Inc.
41
1-800-249-1612
Example Input Format (POST)
This format is used when an external web client writes XML/JSON data to the gateway through a HTTP
POST operation. The input format is the same as the output format except that the
GroupName
and
dataTimeStamp
may be omitted. If they included, they are ignored.
Important Notes:
•
Only data points configured as Write Data Points may be written to.
•
The value for STRING datatypes must between double quotation marks.
A gateway is configured for a Breaker group and a Drive group as so:
Minimum XML Input
At minimum, the XML POST is the
<Devices>
root element, and at least one
<Device>
child-
element containing the matching
<DeviceName>
tag of the Device to be written to, and finally, at
least one writable
Data Point
tag/value pair.
The following example represents a minimum XML POST. This POST will write a value 100 to the point
named “Temperature” which belongs to the Device named “Breaker”:
Expanded XML Input
The following example is slightly more complicated and writes one
Data Point
to one
Device
and two
Data Points
to a different
Device
. Expanding on this pattern, it is possible to write to every writable data
point of every
Device
configured in the gateway with a single XML write.
<Devices>
<Device>
<DeviceName>Breaker</DeviceName>
<Temperature>100</Temperature>
</Device>
</Devices>