Circutor CVM-A1000, Instruction Manual

Page: 367 / 378

ANNEX A: XML SERVICES
PowerStudio provides a range of XML services to enable, in some respects, communication
with other applications.
In requests where it is necessary to express a date and time, both in service request and the
data from the response, these will be represented in UTC (Universal Coordinated Time) with
the format DDMMYYYYHHMMSS (two digits for the day, two for the month, four for the year
and two for the hour, minutes and seconds. It is also possible to represent only a date as
DDMMYYYY assuming that the time is 00:00:00, or represent an hour as HHMMSS. Finally
in cases where milliseconds are required these are represented with three digits after the
seconds, DDMMYYYYHHMMSSUUU or HHMMSSUUU.
The requests must follow the URI standard (RFC 2396), so the user of these requests must
take into account this detail when making such calls (especially in cases where the name of
any device contains non-ASCII characters).It should also be taken into account that the length
of the request may not exceed 4000 characters.
A.1 � - /services/user/devices.xml
/services/user/devices�xml
Returns the list of configured devices.
<devices>
<id> … </id>
…
</devices>
Where:
Table 180: Parameter description (A�1)�
Parameter Description
devices
Main field which will identify the main XML as a response to the
device list request.
id Name of each one of the devices.
A.2.- /services/user/deviceInfo.xml?id=device?...
/services/user/deviceInfo�xml?id=device?���
Returns information on devices. Each of the devices on which information is required must be
included in the request as:
?id=device2?id=device2
<devices>
<device>
<id> … </id>
<description> … </description>
<type> … </type>
367
Instruction Manual
CVM-A1000 - CVM-A1500