======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.** {{:wiki:imagen_2021-07-18_145242.png?300|}} * **Ingresar al menú principal y buscar la categoría “Reglas/Alertas”** {{:wiki:reglas_alertaas.png?600|}} * Dentro de este menú damos clic sobre Reglas. * **en este apartado vamos a crear una nueva regla asignando un “identificador de regla”** {{:wiki:editor_reglas.png?600|}} * Una vez creado, presionamos sobre “Editar” para poder modificar los parámetros. {{:wiki:reglas_identificador.png?600|}} * 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: {{:wiki:seleccion_funcion.png?600|}} * //En la misma resaltar algunos criterios que serán los más utilizados, los mismos que pasamos a detallar// {{:wiki:2022-12-16_11-42.png?700|}} ===== Disparador de la acción===== {{:wiki:true_selector.png?600|}} * //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 ==== {{:wiki:contenido_alerta.png?600|}} * //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** {{:wiki:imagen_2021-07-15_101852.png?600|}} ---- OJO PARA PODER AGREGAR 2 o mas correos se separa con coma(,) {{:wiki:correos.png?600|}} ==== 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==== {{:wiki:ficheros_seleccions.png?600|}} * 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. {{:wiki:2022-12-16_11-43.png?700|}} * **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//