Alertas

• Configuración y características
• Listado de alertas disponibles
• Reenvío de alertas a terceros
• Herencia de alertas por medio de grupos de Activos, geocercas y lugares

Configuración y características

En este módulo vamos a crear alertas de algún evento o acción de nuestros activos, esto nos permite tener un buen control y seguridad sobre ellos. En esta sección hay más de 60 alertas disponibles, como: velocidad máxima, desconexión de batería, anti-jamming, llegada tarde a un lugar, aceleración o frenado brusco, entre muchas otras.

Crear nueva alerta

En esta opción vamos a crear nuestras alertas, elegiremos el tipo de alerta que vamos a configurar, el nombre de alerta para identificar, el tiempo para repetir alerta (esto quiere decir que después de la primera alerta notificada, cuanto tiempo pasará para que esta vuelva a notificarse, en caso de dejar el valor en “0” eso indicará que la alerta solo se notificará una vez), los días de la semana que trabajara esta alerta, si queremos que la alerta se muestre en pantalla, sea sonora, hablada y si la notificación de la alerta será de algún color en especial, elegimos el sonido y por último elegimos si la alerta será solo para el usuario que la está creando (Sí) o estará disponible para todos los usuarios del mismo cliente (No). 

Color en notificación de alertas

Dentro de la configuración de la alerta podrás elegir el color que tendrá la notificación de la alerta. Esto sirve para poder identificar las alertas de una forma más gráfica. 

IMPORTANTE: Esta configuración solo se podrá visualizar si el cliente tiene activo el parámetro "Notificaciones alertas".

Asignación de activos a una alerta

En las acciones que se encuentran en el listado de las alertas creadas, vamos a poder asignar activos, esto será en el primer icono de auto, y se abrirá una ventana que tendrá el listado de los activos que tenemos asignados en nuestro usuario, seleccionaremos la casilla de los activos y listo.

NOTA: Al quitarle el permiso al usuario de un Activo que esté asignado a una alerta, primero es necesario que el usuario desasigne el Activo de la alerta (desmarcando el check de la imagen anterior), y posterior quitarle el permiso al usuario del Activo. De lo contrario la realción de Activo con la alerta se mantendrá.

Asignación destinatarios de las alertas

En el icono verde, elegiremos los destinatarios de las alertas, esto quiere decir que las alertas que genere el activo, podrán llegar a correos, usuarios y por mensaje de texto aunque no tengan el vehículo asignado directamente.

Configuración avanzada de alertas

En asignar eventos sobre alertas, podremos hacer que la plataforma envía un comando cada vez que la alerta se ejecute, por ejemplo: si la alerta es botón de pánico y nuestro equipo gps cuenta con cámaras de video, podremos enviar un comando que permita generar streaming a la plataforma y así ver que sucede. Los comandos están disponibles según la marca y modelo del dispositivo gps.

NOTA: Esta acción únicamente está disponible al ingresar nivel distribuidor a OnTracking o con el botón "Ingresar a la plataforma" (LOGIN AS) dentro del módulo de usuarios en la plataforma Partners.

Historial de alertas emitidas

El botón Historial permite visualizar todos los registros de las alertas que se han ejecutado, por defecto se mostrarán las alertas emitidas en los últimos 5 días. Si deseas ver un rango de fechas mayor, se podrá filtrar por algún Activo y rango de fechas en especifico.

Para visualizar los registros emitidos de una sola alerta, puedes utilizar el botón Historial por definición de alerta muestra los registros de esta alerta que se han emitido, por defecto se mostrarán las alertas generadas del día actual. Si deseas ver un rango de fechas mayor, se podrá filtrar por algún Activo y rango de fechas en específico:

La información que se muestra en el listado es el nombre del Activo que emitió la alerta, el cliente/usuario propietario, el tipo de alerta, la fecha y hora en la que se generó la alerta, y la descripción. 

El botón Mostrar ubicación, muestra un marcador en el mapa con la ubicación en donde se generó la alerta, y al hacer clic en el marcador muestra la descripción de la alerta:

El botón Mostrar detalle de la alerta muestra la información detallada de la alerta generada.

Notificaciones en pantalla

Las notificaciones de las alertas en pantalla, se mostrarán en la parte inferior derecha de la cartografía, y ahí se visualizan las alertas ejecutadas. 

Para visualizar los detalles de la alerta, solo debemos hacer clic en la caja de información y se mostrará una ventana con la información completa. Una vez que una alerta ha sido abierta, se pondrá en color gris y solo permanecerán en color rojo las notificaciones pendientes por abrir.

Detalle de la alerta

Al abrir el detalle de la alerta, muestra en la primer pestaña; la alerta y la información reportada por el equipo del Activo, en la fecha y hora que se emitió la alerta.

Adicional contamos con 3 botones:

• Ocultar/trazar recorrido: sirve para mostrar u ocultar el recorrido de los 4 reportes anteriores y posteriores a generar la alerta.
• Ocultar marcador / mostrar en el mapa: sirve para mostrar u ocultar el marcador de alerta dentro del mapa.
• Copiar ubicación: copia en el portapapeles las coordenadas de la ubicación donde se generó la alerta.

En la segunda pestaña "Reportes cercanos a la alerta", muestra los 4 reportes anteriores y posteriores al reporte que generó la alerta:

La pestaña "Multimedia" únicamente aparecerá cuando el reporte que generó la alerta contenga video, foto, firma digital o grabación de audio:

La pestaña "Información de OnAlert", únicamente aparecerá cuando el usuario tenga permiso a la plataforma OnAlert y muestra la siguiente información:

• El apartado Alerta podemos visualizar la información de la alerta.
• En Incidentes / Comentarios, tenemos disponible la opción para agregar información referente a la alerta y cambiar de estado de esta.
• Comandos solo aparece cuando el usuario tenga permiso de enviar comandos y permite enviarlos al equipo que generó la alerta.
• Por último en Procedimiento podemos consultar los procedimientos que tenga asignado el cliente o el Activo desde OnPartners.

La pestaña "Formulario contestado" únicamente aparecerá cuando el reporte que generó la alerta contenga formulario:

Listado de alertas disponibles

Reenvío de alertas a terceros

Desde la configuración de alertas podrás reenviar, en tiempo real, las alertas emitidas por la plataforma a otros terceros. Estos terceros pueden ser un sistema propio de la empresa u otra plataforma.

Configuración de reenvío de alertas "Asignar servidor destino"

La opción para configurar el reenvío de alertas se encuentra en el módulo de alertas, en las opciones de arriba a la derecha y se llama "Asignar servidor destino".

Luego de acceder al módulo, debemos definir el servidor destino a dónde queremos que se reenvíen las alertas y además debemos seleccionar que alertas queremos que se envíen al host.
IMPORTANTE: Esta opción de "Asignar servidor destino" solo se encuentra disponible para el distribuidor y para cuando se realiza en login as en un cliente. El cliente final no tendrá acceso a esta opción.

En la opción de "Historial de envíos" podrás revisar un histórico de todos los envíos realizados de cada alerta y el resultado del mismo.

Forma de recibir los datos de las alertas

La plataforma envía cada alerta por medio de una petición HTTP que se realiza al servidor destino.
La información y datos de la alerta, se envían por medio de datos POST dentro de la petición HTTP. 
Las llaves que recibirán dentro de la petición POST serán las siguientes.

idalert
device
date
time
description
latitude
longitude
speed
address
vehicle
patent

Un ejemplo en lenguaje PHP de la forma de recibir estos datos sería el siguiente

<?php
echo 'idAlert ' .	$_POST["idalert"];
echo 'device ' .	$_POST["device"];
echo 'date ' .		$_POST["date"];
echo 'time ' .		$_POST["time"];
echo 'description '.$_POST["description"];
echo 'position ' .	$_POST["latitude"].','.$_POST["longitude"];
echo 'speed ' .		$_POST["speed"];
echo 'address ' .	$_POST["address"];
echo 'vehicle ' .	$_POST["vehicle"];
echo 'patent ' .	$_POST["patent"];
?>

El código anterior es el que debes colocar en tu servidor destino que recibirá las alertas, ejemplo: https://miservidor.com/receive_alerts.php
Con el ejemplo anterior debes poder recibir los datos y ya queda de parte de ustedes definir qué acción realizar con la información recibida, como por ejemplo guardarla en una base de datos.

Ejemplo de como recibir los datos utilizando lenguaje C#

using System;
using System.Collections.Generic;
using System.IO;
using System.Net;
using System.Text;

namespace DumpHttpRequests
{
    internal class Program
    {
        private static void Main(string[] args)
        {
            if (!HttpListener.IsSupported)
            {
                Console.WriteLine("Windows XP SP2 or Server 2003 is required to use the HttpListener class.");
                return;
            }
            // URI prefixes are required,
            var prefixes = new List<string>() { "http://*:8000/" };

            // Create a listener.
            HttpListener listener = new HttpListener();
            // Add the prefixes.
            foreach (string s in prefixes)
            {
                listener.Prefixes.Add(s);
            }
            listener.Start();
            Console.WriteLine("Listening...");
            while (true)
            {
                // Note: The GetContext method blocks while waiting for a request.
                HttpListenerContext context = listener.GetContext();

                HttpListenerRequest request = context.Request;

                string documentContents;
                using (Stream receiveStream = request.InputStream)
                {
                    using (StreamReader readStream = new StreamReader(receiveStream, Encoding.UTF8))
                    {
                        documentContents = readStream.ReadToEnd();
                    }
                }
                Console.WriteLine($"Recived request for {request.Url}");
                Console.WriteLine(documentContents);

                // Obtain a response object.
                HttpListenerResponse response = context.Response;
                // Construct a response.
                string responseString = "Respuesta  a la peticion";
                byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString);
                // Get a response stream and write the response to it.
                response.ContentLength64 = buffer.Length;
                System.IO.Stream output = response.OutputStream;
                output.Write(buffer, 0, buffer.Length);
                // You must close the output stream.
                output.Close();
            }
            listener.Stop();
        }
    }
}

Herencia de alertas por medio de grupos de Activos, geocercas y lugares

Es importante que sepas que puedes utilizar diferentes grupos de Activos, geocercas y lugares para ahorrar tiempo en la administración de las alertas; al asignar Activos, geocercas y lugares.

A continuación detallaremos el uso de estos grupos, para poder asignar las alertas dependiendo a qué grupo pertenece tu Activo o también utilizando los grupos de geocercas y lugares.

¿Cómo utilizar los grupos de Activos en alertas?

Los grupos de Activos son muy importantes en las alertas, esto nos puede ayudar para que cada vez que agregues un Activo a la plataforma, no necesites asignarle ninguna alerta si no que esto funcione de forma automática al utilizar los grupos.

Cabe mencionar que existen 2 tipos de grupos de Activos:
1. Grupo predefinido por sistema "Todos los Activos".
2. Los grupos personalizados que puedes crear desde el módulo "Grupos de Activos".

Entonces si quieres que alguna alerta se asigne automáticamente a los Activos actuales y a los futuros que se agreguen en tu cuenta, solo debes asignar el grupo de Activos llamado "Todos los Activos" a la alerta, de esta manera, todo Activo que exista en tu cuenta, automáticamente pertenece a este grupo por lo que se asignará de forma automática a todas las alertas que tengan asignado el grupo anteriormente mencionado.

En el segundo caso, puedes utilizar grupos de Activos creados por ti mismo, y asignar estos grupos a las alertas. Aquí es importante saber que cada vez que se agregue un Activo a la plataforma, manualmente debes asignar este Activo al grupo para que herede las alertas que este grupo tenga asignadas.

¿Cómo utilizar los grupos de geocercas?

Nuestra plataforma soporta diferentes grupos, y dentro de estos están los grupos de geocercas. Es importante que sepas utilizar los mismos para ahorrar trabajo en la asignación de alertas. 

En este caso, para no asignar manualmente las geocercas a las alertas, tienes 2 opciones:
1. Utilizar el grupo predefinido por sistema "Todas las geocercas", este grupo viene por defecto creado en la plataforma. Entonces si deseas que una alerta tenga todas las geocercas existentes o futuras, debes utilizar el mismo a la hora de asignar geocercas a una alerta. Utilizando este grupo aseguras que las futuras geocercas que se creen, automáticamente se asignen a tu alerta.
2. Utilizar grupos de geocercas personalizados, estos grupos también se pueden asignar a las alertas por lo que en este caso, si asignas un grupo de geocercas a una alerta y luego agregas o quitas geocercas del grupo, automáticamente la alerta actualizará la herencia de las geocercas que pertenezcan al grupo.

IMPORTANTE: En el caso que tenga restricciones de permisos a nivel usuario, al utilizar el grupo "Todas las geocercas" las alertas de ese usuario solo trabajarán con las geocercas que el usuario tenga permisos y pueda ver. No funcionará con geocercas que crearon otros usuarios y tengan la opción de "Solo mi usuario" en Sí.

¿Cómo utilizar los grupos de lugares?

Al igual que las geocercas la plataforma soporta grupos de lugares, donde existen también 2 opciones:
1. Grupo predefinido por sistema "Todos los lugares", este grupo sirve para asignarlo a una alerta y a la hora de crear cualquier lugar dentro de la plataforma, este de forma automática estará asignado a la alerta, sin necesidad que realices ningún cambio sobre la alerta.
El uso de este grupo te puede ayudar mucho ahorrando tiempos en la operación de la plataforma.
2. Grupos de lugares personalizados, estos grupos también se pueden asignar a las alertas por lo que en este caso, si asignas un grupo de lugares a una alerta y luego agregas o quitas lugares del grupo, automáticamente la alerta actualizará la herencia de los lugares que pertenezcan al grupo.

IMPORTANTE: En el caso que tenga restricciones de permisos a nivel usuario, al utilizar el grupo "Todos los lugares" las alertas de ese usuario solo trabajarán con los lugares que el usuario tenga permisos y pueda ver. No funcionará con lugares que crearon otros usuarios y tengan la opción de "Solo mi usuario" en Sí.