Wiki V & R GLOBAL SERVICES S.A.C

Esta página es de solo lectura. Puedes ver la fuente pero no puedes cambiarla. Pregunta a tu administrador si crees que esto es incorrecto.
======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//