Tabla de Contenidos
Este material nos enseñara la forma correcta de crear reglas para generar notificaciones en el aplicativo Android y subsecuentemente disparar correos electrónicos (si así se desea)
- Ingresar a la cuenta del cliente/administrador.
- Ingresar al menú principal y buscar la categoría “Reglas/Alertas”
- Dentro de este menú damos clic sobre Reglas.
- en este apartado vamos a crear una nueva regla asignando un “identificador de regla”
- Una vez creado, presionamos sobre “Editar” para poder modificar los parámetros.
- Estos son los primeros elementos a tener en cuenta para la definición de la regla, elementos que se detallaran a continuación.
- E-mail de notificaciones ⇒ aquí definimos la lista de correos electrónicos a ser notificados (separados por comas)
- Activa ⇒ esto indica si la regla será utilizada o no
- Es regla de ejecución programada ⇒ define si la regla será ejecutada por cada “evento” recibido de los gps o si tendrá una ejecución programada (la ejecución programada se utiliza para “revisiones” como podría ser la última transmisión valida)
- Descripción ⇒ texto de apoyo para identificar la regla (no tiene efectos ni es mostrada en notificaciones)
Concepto de reglas para alertas o notificaciones
* Seleccionador de regla (Evaluador) | “usar función/descripción”
- El primer paso para crear y/o gestionar una regla de sistema, es determinar el criterio de evaluación (disparador o evaluador), ya que el mismo se encargara de supervisar cada evento recibido por los equipos GPS y evaluar si requiere de intervención por las reglas activas.
- Podremos apreciar un menú desplegable tal como la imagen de referencia:
* En la misma resaltar algunos criterios que serán los más utilizados, los mismos que pasamos a detallar
Disparador de la acción
- Email ⇒ al marcar esta opción se enviarán correos electrónicos al cumplirse las condiciones a la lista de “e-mail de notificaciones” que se ingreso previamente, de estar vacía no se enviarán correos electrónicos.
- Guardar/alerta
- Cola ⇒ marcar esta opción para poder enviar las notificaciones a los dispositivos Android y al panel de alertas, activa el historial de alertas en la sección de “reporte detallado/Detalle de alerta de vehiculos” y para almacenar el registro de ultima alerta en el sistema (MANAGER SYSTEM).
- Escucha ⇒ dejar sin efecto (se removerá en próximas actualizaciones ya que no tiene función)
Contenido de la alerta/correo electrónico
- Título del correo electrónico ⇒ este campo cumple con la función de dar titulo al correo y a la notificación a generar
- Cuerpo del correo electrónico ⇒ este campo de texto cumple con el contenido del correo electrónico y con el contenido de la alerta a enviar a los dispositivos móviles (solo soporta textos y variables a explicar en los siguientes puntos)
Variables Para Mensaje (Alerta)
#### Leyenda de variables para Alertas (Correos – Reglas)
- ${accountid} ⇒ Identificador de la cuenta
- ${groupid} ⇒ Identificador del grupo/flota
- ${account} ⇒ Descripción de la cuenta
- ${deviceid} ⇒ Identificador de la Unidad (ID)
- ${device} ⇒ Descripción de unidad
- ${licensePlate} ⇒ Placa de vehículo registrada
- ${datetime} ⇒ Imprime la fecha y hora en la que registro el evento (incluye zona horaria de la cuenta)
- ${statuscode} ⇒ Imprime el código de estado (numérico)
- ${status} ⇒ Imprime la descripción del código de estado (evento enviado por el gps)
- ${speed} ⇒ Imprime la velocidad registrada en la alerta (en formato según cuenta)
- ${devSpeedLimit} ⇒ Imprime el límite de velocidad configurado en el vehículo.
- ${direction} ⇒ Imprime la dirección (NORTE, SUR, ESTE, OESTE) en la que se dirige el vehículo.
- ${geopoint} ⇒ Imprime en una sola línea (latitud y longitud)
- ${latitude} ⇒ Imprime la latitud registrada en el evento
- ${longitude} ⇒ Imprime la longitud registrada en el evento
- ${altitude} ⇒ Imprime la altitud registrada en el evento
- ${address} ⇒ Imprime el nombre de la calle, ciudad, país (dirección)
- ${odometer} ⇒ Imprime el kilometraje (odometraje)
- ${distance} ⇒ Imprime la cantidad de distancia recorrida (kilometraje “reseteable”)
- ${geozoneId} ⇒ Identificador de geozonas (zonas o geo cercas)
- ${geozone} ⇒ Descripción de la Geozona (zonas o geo cercas)
- ${batteryLevel} ⇒ Imprime el nivel de batería registrado en el evento
Formatos De Ejemplo Para Mensajes (Alertas)
Formato Para Alertas (Correos) en Reglas – (Aplicación de variables)
Nota: se requiere personalizar los textos, las variables (${variable}) no deben ser modificadas.
Evento Botón De Pánico (Incluye Variables)
- Asunto: Vehículo ${licensePlate}: ${status} - Señal de ayuda requerida
Cuerpo:
- Cuenta : ${account} [${accountid}]
- Dispositivo: ${device} [${deviceid}]
- Placa : ${licensePlate}
- Fecha/Hora: ${datetime}
- Estado : [${statuscode}] ${status}
- Velocidad : ${speed} ${direction}
- Coordenadas: ${geopoint} [${latitude}/${longitude}] * ${alt} (Altitud)
- Dirección : ${address}
- Odómetro : ${odometer}
- Distancia : ${distance}
- El vehículo ${device} [${deviceid}] activo la alerta de pánico (ayuda), contactar al conductor para validar situación.
Google Maps: http://maps.google.com/maps?f=q&q=${latitude},${longitude}&z=14
REFERENCIA
OJO PARA PODER AGREGAR 2 o mas correos se separa con coma(,)
Eventos Ingreso y/o Salida de Geozonas
- Asunto: Vehículo ${licensePlate}: ${status} - Señal de ayuda requerida
Cuerpo:
- Cuenta : ${account} [${accountid}]
- Dispositivo: ${device} [${deviceid}]
- Placa : ${licensePlate}
- Fecha/Hora: ${datetime}
- Estado : [${statuscode}] ${status}
- Velocidad : ${speed} ${direction}
- Coordenadas: ${geopoint} [${latitude}/${longitude}] * ${alt} (Altitud)
- Dirección : ${address}
- Odómetro : ${odometer}
- Distancia : ${distance}
ADAPTAR LOS FORMATOS SEGÚN SU NECESIDAD, NO OLVIDE UTILIZAR LAS VARIABLES ${VARIABLE} SEGÚN FUERA EL CASO (GUIARSE DE LA TABLA PREVIA)
Códigos De Estado Para Evaluador $TRUE
- Los códigos a continuación sirven para el evaluador (selector) $TRUE, el cual únicamente se concentra en la verificación de reglas coincidentes con el código de estado descrito en la parte inferior.
- NOTA: estos códigos deben estar homologados en el capturador GPS y esto depende de las funcionalidades que proporcione el dispositivo GPS.
NOTA: estos códigos son utilizados en las reglas para disparar alertas vía correo electrónico y/o sms
Restricciones: las alertas vía correo electrónico requieren de un servidor SMTP para su funcionamiento, consultar con soporte técnico para mayores detalles