Torre de Control está diseñada para monitorear viajes o procesos con un "itinerario" o "secuencia de etapas repetitiva"; A dicho itinerario, en torre de control lo denominamos "Trip Definition".
Atributos obligatorios para configurar un "Trip definition"
name: El nombre descriptivo del itinerario, por ejemplo "Abstecimiento". Con este nombre se podrá seleccionar el Trip definition, en caso de tener más de uno configurado, ya que para puedes generar tantos Trips Definitions como procesos necesites monitorear en "Torre de Control".
ttlFinishedTrips: "time to live" de los viajes o procesos finalizados; Define el tiempo durante el cual se mostrará un viaje finalizado en la pantalla Kanban de torre de control. Se expresa en horas, en el formato "PT24H"
delayedYellow: Es el tiempo dentro del cual, una demora en el viaje o proceso no se considera como una alerta. Una demora dentro de este límite se muestra en amarillo en la tarjeta del viaje. Se expresa en minutos, en el formato "PT30M".
delayedRed: Es el tiempo de tolerancia máximo para considerar una demora en el viaje o proceso como una Alerta. Superado este límite resaltará la tarjeta en rojo y generará una alerta. Se expresa en minutos, con el formato "PT1H"
Parte de la configuración de Trip definition, es definir sus "etapas", a las que denominamos "Checkpoints" y los "pasos" a completar dentro de cada "etapa", a los que denominamos "Steps"
Atributos obligatorios de un Checkpoint
type: Nombre del conjunto de pasos (Steps) de una Etapa (Checkpoint); actúa como un template que representa un conjunto de pasos en particular.
Luego deben definirse, para cada paso de la Etapa, los siguientes atributos mínimos:
name: Es el nombre del paso (Step), por ejemplo: "Ingreso a zona de carga".
type: Es el tipo de Trigger que dá por iniciado un paso (Step). Los tipos disponibles son:
- "In_area": Evento generado cuando se detecta una posición GPS dentro de una zona.
- "Out_area": Evento generado cuando se detecta una posición GPS fuera de una zona.
- "customer_arrival": Evento generado cuando se detecta una posición GPS dentro de la geocerca de un Punto de interés.
- "customer_departure": Evento generado cuando se detecta una posición GPS fuera de la geocerca de un Punto de interés.
- "Webhook": Puede utilizarse un dato para activar un Step.
- "app": Acción ejecutada desde la app QuadMinds para el conductor.
zoneType: Se utiliza para los triggers de tipo "In_area", "Out_area", "customer_arrival" y "customer_departure". El valor del zonetype es un texto definido por el usuario.
normalDuration: Es la Duración Programada para completar un Step. Se expresa en minutos, en el formato "PT10M".
icon: Es el ícono que representa visualmente a la etapa del viaje o proceso en la pantalla Kanban, es decir el ícono que acompaña a cada state definition. Consultar disponibilidad de íconos en la etapa de implementación.
id del Trip definition
Al completar el POST de un Trip definition, se obtendrá un id que será requerido para cargar Viajes o Procesos en Torre de control.