Argumentos del Reporte - pasar parámetros a tus reportes basados en eventos

Esta guía muestra cómo enviar información adicional a sus reportes de reglas de eventos directamente desde las reglas de eventos utilizando argumentos de reporte.

Cómo usar argumentos de reporte

Cuando generamos el reporte EV1000 estándar, obtendremos la información habitual (Fecha de inicio, Hora de inicio, Duración, Activo, etc). Pero, por ejemplo, no tenemos la información de Velocidad del activo en el momento del evento por defecto.

Para agregar una nueva variable (por ejemplo, Velocidad), siga estos pasos:

1. Abra su asistente de reglas de eventos en Menú Principal > Admin > Reglas de Eventos

2. Cree su regla de evento como prefiera.

3. En el paso 5. Notificaciones seleccione + para agregar un nuevo tipo de notificación.

3. Seleccione Argumento de Reporte como tipo de notificación.

Usando argumentos de reporte, podemos incluir fácilmente diferentes argumentos de reporte como velocidad y muchos otros como:

mceclip0.png

4. Guarde su regla de evento.

Reportes

Después de guardar una regla de evento con los argumentos de reporte, puede ejecutar, por ejemplo, el reporte EV1000. Recuerde seleccionar en los parámetros del reporte a la derecha, la regla de evento que contiene los argumentos de reporte:

mceclip1.png

Nota: si modifica la Regla de Evento, y el reporte se ejecutó previamente con los mismos parámetros exactos, es posible que necesite reprocesar los reportes para ver los cambios aplicados. 

Funciones de Variables

En muchos casos, es útil usar funciones para obtener un resultado más adecuado de una variable. Por ejemplo, puede obtener la velocidad máxima o mínima de un activo durante un evento.

Hay en total 5 funciones que se pueden usar junto con variables:

  • $START: El primer valor de la variable cuando el evento comienza
  • $END: El último valor de la variable cuando el evento aún está activo pero está a punto de terminar
  • $FINAL: El valor final de la variable cuando el evento terminó
  • $MIN: El valor mínimo de la variable mientras el evento está activo
  • $MAX: El valor máximo de la variable mientras el evento está activo

Por defecto, el valor de la variable es el primer valor cuando el evento comienza. Se comporta de la misma manera que la función $START.

Ejemplo

Supongamos como ejemplo, que tiene una regla de evento que monitorea una señal de temperatura por encima de 10 grados. La regla de evento ha procesado los siguientes valores de temperatura: [5, 11, 13, 12, 9]

La salida para las diferentes funciones será:

$FIRST([Temperature]) -> 11
$END([Temperature]) -> 12
$FINAL([Temperature]) -> 9
$MIN([Temperature]) -> 11
$MAX([Temperature]) -> 13

Argumentos de Reporte Localizados para Desarrolladores

Al crear reportes personalizados, tenga en cuenta lo siguiente:

Manejo de Valores Decimales en Reportes Localizados

  • Los argumentos de los reportes están localizados, lo que significa que se adhieren a formatos específicos de la cultura (por ejemplo, la visualización de hora/fecha).
  • Los valores decimales pueden usar comas en lugar de puntos, como 45,3 en lugar de 45.3.
  • Problema: Funciones como SUM/AVG/MIN/MAX requieren valores decimales con puntos (.) y no pueden procesar valores con comas (,), lo que resulta en errores.
  • Solución: Reemplace las comas con puntos usando la siguiente sintaxis en su consulta de reporte:
    SELECT REPLACE(price, ',', '.') AS price, REPLACE(lastprice, ',', '.') AS lastprice FROM products
    

Nota sobre Configuraciones Culturales

  • En estos ejemplos, evitamos usar la cultura invariante ya que los argumentos de los reportes generalmente están localizados.
  • Sin embargo, si es necesario, puede explorar configuraciones de cultura invariante para obtener más información.

Funciones de Reporte para Información Adicional

Varias funciones predefinidas proporcionan información en sus reportes:

  • $MAX, $MIN, $START, $FINAL, y $END.
  • Ejemplo: $MIN([SIGNAL_SPEED]).

Explicación de Funciones

  • $START: El valor que desencadena un evento.
  • $FINAL: Vacío durante un evento en curso, pero muestra el valor final una vez que el evento concluye.
  • $END: El último valor durante un evento en curso, o el valor final cuando el evento termina.

Cómo Usar Funciones

Para incluir estas funciones en sus reportes, siga la convención:

$FUNCTION([VARIABLE])

Por ejemplo, para recuperar la velocidad mínima de una señal, use:

$MIN([SIGNAL_SPEED])