CIRCUTOR PowerStudio Series - Manual (Página 21)

PowerStudio
Manual de Instrucciones 21
3.- APÉNDICES
3.1.- Servicios XML
PowerStudio proporciona una serie de servicios XML para posibilitar, en ciertos aspectos, la
comunicación con otras aplicaciones.
En las peticiones en las que sea necesario expresar una fecha y hora, tanto en la petición del
servicio como en los datos de la respuesta, se representará en UTC (Universal Coordinated Time)
con el formato DDMMAAAAHHMMSS (dos dígitos para el día, dos para el mes, cuatro para el año y
dos para la hora, minutos y segundos. También será posible representar solamente una fecha como
DDMMAAAA asumiendo que la hora será la 00:00:00, o representar una hora como HHMMSS. Por
último en aquellos casos en los que se necesite expresar milisegundos se representarán con tres
dígitos después de los segundos, DDMMAAAAHHMMSSUUU ó HHMMSSUUU.
Las peticiones deben seguir el estándar URI (RFC 2396) de manera que el usuario de estas
peticiones tiene que tener en cuenta este detalle cuando realice este tipo de llamadas (sobre todo en
el caso de que el nombre de algún dispositivo contenga caracteres no ASCII). También se deberá
tener en cuenta que la longitud de la petición no podrá sobrepasar los 4000 caracteres.
3.1.1 /services/user/devices.xml
Devuelve la lista de dispositivos configurados.
<devices>
<id> … </id>
…
</devices>
Donde:
• devices: Campo principal que identificará al XML como respuesta a la petición de
lista de dispositivos.
• id: Nombre de cada uno de los dispositivos.
3.1.2 /services/user/deviceInfo.xml?id=dispositivo?...
Devuelve información sobre dispositivos. Cada una de los dispositivos sobre los que se desea
obtener información deberá incluirse en la petición como:
?id=dispositivo2?id=dispositivo2
<devices>
<device>
<id> … </id>
<description> … </description>
<type> … </type>
<typeDescription> … </typeDescription>
<var> … </var>
…
</device>
…
</devices>
Donde:
• devices: Campo principal que identificará al XML como respuesta a la petición de
información de dispositivos.
• device: Información de cada uno de los dispositivos solicitados:
 id: Nombre del dispositivo.
 description: Descripción del dispositivo