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 interfaz gráfica. 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 eventos.
Pasos
- Agregar los Campos Personalizados
- Modificar el Tipo de Usuario
- Crear una nueva Máscara de Acceso de Usuario
- Crear un nuevo rol y asignar la Máscara de Acceso
- Crear tus Reglas de Eventos con el script
- Pruebas
Agregar los Campos Personalizados
Lee aquí cómo habilitar campos personalizados de usuario.
Tenemos que seleccionar la lista de Campos Personalizados y colocar aquí todas las diferentes notificaciones que manejarán nuestras Reglas de Eventos. Debemos recordar lo que hemos escrito en las columnas de Ítem y Valor porque las llamaremos más tarde en nuestros scripts.
También queremos agregar otro Campo Personalizado llamado Límite de Velocidad del tipo Texto
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 Tipos.
Seleccionamos el Tipo de Usuario Dispositivo, y luego agregaremos nuestros nuevos Campos Personalizados creados previamente, bajo Detalles
Si editamos un Activo, podemos ver los dos Campos Personalizados añadidos
Crear tus Reglas de Eventos con el script
Ahora tenemos que crear Reglas de Eventos 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 Eventos diferentes. Una es para correo electrónico, otra para SMS y otra para marcador.
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 coincide 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;
|
Recuerda que los valores que estás usando en la función getCustomFieldValue y los valores de comparación dentro de la cláusula IF deben coincidir con los valores y etiquetas de campo personalizado configurados previamente.
Selecciona Email como el tipo de notificación para esta regla
Cuando hayas configurado tu regla de notificación por email, guárdala.
Caso de notificación por SMS
Crea una nueva regla para casos de SMS.
Los scripts de SMS y Marcador cambian ligeramente. En las siguientes imágenes, destacamos los cambios que necesitas hacer:
Caso de Marcador
Para el caso de notificación por Marcador, creamos una nueva regla de evento e introducimos los cambios que se muestran a continuación.
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.
Seleccionamos nuestras opciones en el mapa como se muestra a continuación
Guarda ahora la regla.
Pruebas
Verifica para tu/s activo/s qué campos personalizados necesitan ser seleccionados, de acuerdo con el tipo de notificación que deseas para cada activo.
1. Edita el activo.
2. Ingresa los valores para Speeding Alert y Speed Limit.
Estos valores definirán qué notificación (regla de evento) se usará y a qué velocidades reaccionarán estas alertas.
Recomendamos usar el simulador de activos para probar el comportamiento de estas nuevas reglas y notificaciones.