Real Time Automation, Inc.
51
1-800-249-1612
Special Note for XML Strings
There is an additional consideration when posting data points with the STRING data type. “Unsafe” XML
characters, such as “<” and “&” that might appear in STRING d
ata should be converted to their
respective XML entity-references. In general, your application (ex. scripting language or library), will
either handle this automatically or provide easy-to-use mechanisms to accomplish this for you. When
the gateway parses the XML data written to it, it will convert these entity-references back to their ASCII
equivalent characters before writing the STRING data to the other protocol. The reverse is also true
when reading STRING data from the other protocol.
Minimum JSON Input
At minimum, a valid JSON post must include the root array, one Device Object, which must include the
DeviceName
name/value pair member to identify the device followed by at least one writeable
name/value pair member.
The following example represents a minimal JSON POST. This POST will write a value 100 to the point
named “Temperature” which belongs to the device named “Breaker”:
<Devices>
<Device>
<DeviceName>Breaker</DeviceName>
<Temperature>100</Temperature>
</Device>
<Device>
<DeviceName>Drive</DeviceName>
<Temperature_Cutoff>32</Temperature_Cutoff>
<Torque>15.2</Torque>
</Device>
</Devices>
[
{
"DeviceName": "Breaker",
"Temperature": 100
}
]
