Reporte Ux — Operaciones con Reportes de Usuario

Permite consultar, ejecutar y generar reportes de usuario previamente configurados con el Comando UC.

¿Para qué sirve?

Caso de uso	Descripción
📤 Envío automático	Generar y enviar reportes customizados por eventos
🔍 Consulta local	Verificar contenido de reportes UC
⚡ Ejecución dinámica	Ejecutar comandos embebidos en el reporte
📊 Telemetría periódica	Enviar datos combinados a intervalos

Comandos

Operación	Sintaxis	Descripción
Consultar	`QUn`	Lee contenido del reporte UCnn
Ejecutar	`SUn`	Ejecuta el reporte como comando local
Generar	`GUn[bb][c]`	Genera y envía reporte al servidor

Diferencia clave:

QUn → Solo muestra el contenido renderizado
SUn → Ejecuta los comandos embebidos en el reporte
GUn → Genera el reporte y lo envía a un destino IP

Parámetros

Parámetro	Descripción	Valores
`n`	Índice de reporte	`0` a `F` (UC00-UC0F)
`bb`	Número de evento asociado (solo para G)	`00`-`FF`, `XX` = sin evento
`c`	Prioridad de envío (solo para G)	`H` = alta, `M` = media, `L` = baja

Operaciones en Detalle

Consultar (Q)

QUn — Consultar Reporte

Lee y muestra el contenido del reporte UC procesado.


>QUn<

Respuesta:


contenido_renderizado

La respuesta a QUn es exactamente el contenido renderizado de la estructura UC, sin ningún prefijo RUn antepuesto: para reportes de usuario, printmsg() copia el texto tal cual (strcpy(str, txt)). No lo confundas con RUn (la respuesta de SUn, que sí lleva ese prefijo seguido de OK/ERR).

Ejecutar (S)

SUn — Ejecutar Reporte

Ejecuta el reporte como si fuera un comando del equipo. Útil para disparar acciones configuradas en el UC.


>SUn<

Comportamiento:

Procesa la estructura UC
Ejecuta los comandos embebidos
Devuelve respuesta local (no envía a servidor)

Ideal para usar en reglas del Motor de Eventos cuando necesitas ejecutar una secuencia de comandos configurada dinámicamente.

Generar (G)

GUn — Generar y Enviar

Genera el reporte y lo envía a un destino IP configurado.


>GUnbbc<

Parámetros adicionales:

bb → Número de evento asociado
c → Tipo de reporte

Resultado: El equipo responde de inmediato con el literal GOK, confirmando que el comando fue aceptado y el reporte quedó encolado. El contenido real del reporte (igual al de QUn, sin prefijo) es lo que efectivamente viaja al destino — no es lo que devuelve como respuesta directa al comando GUn.

Integración con Motor de Eventos

Generar reporte por IGN ON


>SRL60E;TRG=IGN+;ACC={GU0XXH}<

Ejecutar macro por entrada digital


>SRL61E;TRG=IN02+;ACC={SU1}<

Ejecuta el contenido de UC01 cuando se activa IN02.

Generar por velocidad límite


>SRL62E;TRG=VL00+;ACC={GU1XXH}<

Secuencia periódica con timer


>STD05E00005<
>SRL96E;TRG=TD05+;ACC={GU0XXH}<
>SRL97E;TRG=TD05+;ACC={SU1}<

Genera UC00 y ejecuta UC01 cada 5 segundos.

Compatibilidad

💾Firmware v1.12.05

C5Legacy

💾Firmware v1.00.00

SP-IOT

SM-IOT

ZE-IOT

Ver También

Comando UC - Configuración de estructura
Comando G - Generador de reportes
Comando XB - Buffers de texto
Motor de Eventos - Automatización