CIRCUTOR PowerStudio Series - Manual (Page 22)

PowerStudio PowerStudio
22 User Manual
3.- APPENDICES
3.1.- 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.
3.1.1 / services / user / devices.xml
Returns the list of configured devices.
<devices>
<id> … </id>
…
</devices>
Where:
• 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.
3.1.2 /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>
<typeDescription>… </ typeDescription>
<var>… </ var>
…
</device>
…
</devices>
Where:
• devices: Main Field which will identify the XML as a response to the device
information request.
• device: Information from each of the devices requested:
 id: Name of the device.
 description: Description of device