Cómo usar campos personalizados con reglas de eventos

Usando este método, permitirás que los usuarios de tu aplicación seleccionen sus preferencias de notificación para las reglas de eventos de sus activos. Esto es especialmente útil en un entorno restringido con usuarios con roles limitados. Como administrador, ahorrarás tiempo con menos solicitudes de modificación de usuarios.

Los usuarios pueden hacerlo por sí mismos de una manera muy intuitiva simplemente modificando las propiedades del activo y seleccionando los valores en la GUI. En nuestro ejemplo, crearemos un cuadro combinado (Campo Personalizado) que estará disponible en las Propiedades del Activo (Máscara de Acceso del Usuario) donde el usuario puede seleccionar y guardar qué tipo de notificación desea para una alerta de exceso de velocidad para ese activo. El valor del límite de velocidad también es una propiedad que el usuario puede establecer para cada activo y definirá la ejecución de la regla de evento.

Pasos

  1. Agregar los Campos Personalizados
  2. Modificar el Tipo de Usuario
  3. Crear una nueva Máscara de Acceso de Usuario
  4. Crear un nuevo rol y asignar la Máscara de Acceso
  5. Crear tus Reglas de Evento con el script
  6. Pruebas

Agregar los Campos Personalizados

Lee aquí cómo habilitar campos personalizados de usuario.

Screenshot 2024-07-29 at 11.48.53.png

Tenemos que seleccionar la lista de Campos Personalizados y poner aquí todas las diferentes notificaciones que manejarán nuestras Reglas de Evento. Debemos recordar lo que hemos escrito en las columnas Item y Value porque las llamaremos más adelante en nuestros scripts.

Screenshot 2024-07-29 at 11.51.04.png

También queremos agregar otro Campo Personalizado llamado Límite de Velocidad del tipo Texto

Screenshot 2024-07-29 at 11.53.14.png

Modificar el Tipo de Usuario

Ahora que tenemos estos Campos Personalizados configurados, necesitamos agregarlos a las propiedades de nuestros Activos. Para simplificar esta tarea, modificaremos el Tipo de Usuario del Dispositivo en el Editor de Tipo de Usuario.

Screenshot 2024-07-29 at 11.53.39.png

Seleccionamos el Tipo de Usuario Dispositivo, y luego agregaremos nuestros nuevos Campos Personalizados creados previamente, bajo Detalles

Screenshot 2024-07-29 at 11.54.16.png

Screenshot 2024-07-29 at 11.55.38.png

Si editamos un Activo, podemos ver los dos Campos Personalizados añadidos

Screenshot 2024-07-29 at 11.56.17 1.png

Crear tus Reglas de Evento con el script

Ahora tenemos que crear Reglas de Evento para cada notificación diferente que queremos enviar. Como creamos tres opciones diferentes para nuestras notificaciones (Correo Electrónico, SMS, Marcador, Deshabilitado), usaremos tres Reglas de Evento diferentes. Una es para correo electrónico, otra para SMS y otra para marcador.

Screenshot 2024-07-29 at 14.08.20.png

Caso de notificación por correo electrónico

Al crear tu Regla de Evento, en el paso 4. Expresiones, selecciona Expresión de Script.

Lee aquí cómo habilitar expresiones de script.

En este ejemplo, usaremos un código simple de Javascript que comparará el valor del Límite de Velocidad de las propiedades del activo y devolverá true si cumple con la condición.

Un script para la notificación por correo electrónico podría ser así:

var notifType = session.user.getCustomFieldValue ('Speeding Alert'); //from the Asset properties
var limit = session.user.getCustomFieldValue ('Speed Limit'); //from the Asset properties
var speed = fields.get('Speed', null)*3.6; //current Asset speed with mt/s to Km/h conversion
 
if(notifType == 'Email' && speed > limit) return true;
 
// else
 
return false;

Recuerde que los valores que está utilizando en la función getCustomFieldValue y los valores de comparación dentro de la cláusula IF deben coincidir con los valores y las etiquetas de campo personalizado configuradas previamente.

mceclip7.png

Seleccione Correo electrónico como el tipo de notificación para esta regla

mceclip8.png

Cuando haya configurado su regla de notificación por correo electrónico, guárdela.

Caso de notificación por SMS

Cree una nueva regla para casos de SMS.

Los scripts de SMS y Marcador cambian ligeramente. En las siguientes imágenes, destacamos los cambios que necesita realizar:

blog_evCfScr_image_016.png

Caso de Marcador

Para el caso de notificación de Marcador, creamos una nueva regla de evento e introducimos los cambios que se muestran a continuación.

mceclip9.png

No seleccionaremos ninguna notificación en este paso (porque solo queremos un marcador en el mapa, lo hacemos en el paso 6), hacemos clic en Siguiente.

mceclip10.png

Seleccionamos nuestras opciones en el mapa como se muestra a continuación

mceclip11.png

Guarde ahora la regla.

Pruebas

Verifique para su/s activo/s qué campos personalizados necesitan ser seleccionados, de acuerdo con el tipo de notificación que desea para cada activo.

1. Edite el activo.

2. Ingrese los valores para Alerta de Exceso de Velocidad y Límite de Velocidad.

Estos valores definirán qué notificación (regla de evento) se utilizará y a qué velocidades reaccionarán estas alertas.

Screenshot 2024-07-29 at 14.22.42.png

Recomendamos usar el simulador de activos para probar el comportamiento de estas nuevas reglas y notificaciones.