CIRCUTOR PowerStudio Series - Manual (Página 24)

PowerStudio PowerStudio
24 Manual de Instrucciones
3.1.5 /services/user/forceVariables.xml?id=dispositivo
Mediante esta petición se podrá enviar al PowerStudio la orden de forzar variables. En la
petición se deberá incluir el nombre del dispositivo que se desea forzar para, en caso necesario,
comprobar la autentificación (ver ¡Error! No se encuentra el origen de la referencia. ¡Error! No se
encuentra el origen de la referencia.). Solamente se forzarán las variables que pertenezcan al
dispositivo indicado en la petición
<forceVariables>
<forceVar>
<forceName> … </forceName>
<forceValue> … </forceValue>
</forceVar>
…
</forceVariables>
Donde:
• forceVariables: Campo principal que identificará al XML como petición de forzar
variables.
• forceVar: Información de cada una de las variables que se desean forzar:
 forceName: Nombre de la variable con formato dispositivo.variable
(Consultar ‘Manual Dispositivos’ apéndice variables). Solamente variables que
puedan ser forzadas como por ejemplo variables de salida digital.
 forceValue: Valor al que se desea forzar la variable.
3.1.6 /services/user/records.xml?begin=…?end=…?var=…?period=900
Devuelve información registrada de una o más variables entre las fechas “begin” y “end”. Cada
una de las variables de las que se desea obtener información deberá incluirse en la petición como:
?var=dispositivo.variable
El formato de ”begin” y ”end” será DDMMAAAA cuando se desee indicar solamente la fecha
(en este caso la hora será la 00:00:00) ó DDMMAAAAHHMMSS cuando se especifique tanto la fecha
como la hora. Tanto ”begin” como ”end” deberá estar expresado en UTC (Universal Coordinated
Time).
Por último se podrá especificar el periodo de agrupación de los datos mediante el parámetro “period”.
Este valor podrá ser :
FILE  No se agruparán los datos, devolviendo los registros tal y como se han guardado en el
histórico.
AUTO  Automático, la agrupación se realizará automáticamente dependiendo de las fechas
”begin” y ”end” especificadas
ALL  Los datos se agruparán en un único valor
> 0  Valor en segundos en los que se agruparán los datos.
Si el parámetro “period”. no aparece en la petición se considerará como valor 0 y no se agruparán los
datos.
<recordGroup>
<period> … </period>
<record>
<dateTime> … </dateTime>
<field> … </field>
<fieldComplex> … </fieldComplex>
<fieldARM> … </fieldARM>
<fieldFO> … </fieldFO>
<fieldEVQ> … </fieldEVQ>
…
</record>
…