Herramientas de usuario

Herramientas del sitio


wiki:creac_reglas

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

wiki/creac_reglas.txt · Última modificación: 2023/12/05 22:04 por aneyra

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki