Histórico da Página

É uma tela que possui a funcionalidade de fazer a configuração dos fluxos automáticos do sistema, trazendo assim mais agilidade e praticidade ao dia a dia do cliente. Ela é dividido em 3 partes; Atualização automática do status do monitorável, Criação de ocorrências de atraso e Criação de ocorrências de velocidade.

Nesta documentação iremos compartilhar e detalhar cada um dos fluxos.

01. Atualização automática do monitorável Âncora
AutomaticMonitoring
AutomaticMonitoring

Quando geramos uma ocorrência ele passará por um fluxo consumer que verificará se a causa da ocorrência gerada é igual à alguma causa configurada, se sim, ele atualiza o status do monitorável para “Cancelado” ou “Finalizado’.

Nesses campos são configurados:

Campo	O que faz
Checkbox	Indica se esse fluxo automático está ativo ou inativo.
Causa da ocorrência	Indica qual a causa da ocorrência, para ocorrer “Cancelamento” ou “Finalização” do monitorável

OBS1. Ele primeiro passará pelo fluxo de “Cancela” depois “Finaliza”.

02. Ocorrência automática de atraso
Âncora
DelayOccurrenceConfigurations
DelayOccurrenceConfigurations

Quando mandamos um sinal para o “tracking”, ele irá passar por um fluxo de consumir que irá verificar se o sinal está atrasado. Ele vai pegar a próxima transição não realizada e calcular a distância dela com base na latitude e longitude do sinal, depois vai usar a velocidade média (seja a velocidade passada pelo sinal ou configurado do banco) e com isso irá calcular o impacto que irá ter na transição, se o impacto for maior que o tempo "Tempo mínimo para estimativa de atraso (min)" vai ser gerada uma ocorrência de atraso.

Obs. Olhe no tópico “Como criar sinal no postman” para criar o sinal

Nesses campos são configurados:

Campo	O que faz
Checkbox	Indica se esse fluxo automático está ativo ou inativo.
Nome da categoria da causa de ocorrência	Indica qual a categoria da ocorrência quando for criada a nova ocorrência.
Nome da causa de ocorrência	Indica qual a causa da ocorrência quando for criada a nova ocorrência.
Comentário da ocorrência	Indica qual será o comentário que será colocado quando for criada a nova ocorrência.
Tipo de velocidade média para calcular o atraso	Indica qual velocidade média ele quer usar para calcular o atraso.
Velocidade média para estimativa de atraso (km/h)	Indica a velocidade média para calcular se o sinal está atrasado ou não.
Tempo mínimo para estimativa de atraso (min)	Indica o tempo mínimo para criar atraso.
Porcentagem para validação de sinal recebido	Indica a porcentagem em relação ao tempo da viagem para validar se o sinal é valido para gerar a ocorrência.

Obs1. "Tipo de velocidade média para calcular o atraso", podendo ser

Configuração pelo usuário
Sinal recebido do veículo

Obs2. "Porcentagem para validação de sinal recebido", porcentagem aplicada ao tempo de duração da viagem para verificar se o sinal recebido é válido.

A duração da viagem é calculada conforme o intervalo do horário estimado da primeira e ultima transição.

Exemplo:

sinal1 = 09:00:00; sinal2 = 09:30:00; tempo da viagem = 100; porcentagem para validação de sinal recebido = 1%
calculo= sinal2 -sinal1 > tempo da viagem * porcentagem para validação de sinal recebido
calculo = 09:30:00 - 09:00:00 > 100 * 0,01
calculo = 30 > 1
quer dizer que o sinal é valido

Obs3. "Tipo de velocidade média para calcular o atraso", se o for selecionada a opção "Sinal recebido do veículo" o campo "Velocidade média para estimativa de atraso (km/h)" ficara desabilitado

Obs4. O impacto na transição só é valido se ele for pelo menos 1 ou maior.

Obs5. Exemplo de como calcular o atraso. Vamos supor o seguinte cenário:

Horário estimado da transição: 04/01/2024-15:00
Horário que o sinal foi mandando: 02/01/2024-20:00
Tempo entre da latitude e longitude do sinal até o da transição: 48 horas.
Então ela vai pegar o horário do sinal e somar com o tempo calculado, assim tendo o resultado: 02/01/2024-20:00 + 48 horas = 04/01/2024-20:00
Ele verifica a diferença entre esse novo tempo calculado e o horário estimado da transição: 04/01/2024-20:00 - 04/01/2024-15:00 = 05:00
Se a diferença for maior que 1, ele vai criar a ocorrência. No nosso exemplo vai criar, pois a diferença é 5 horas.

03. Ocorrência automática de velocidade
Âncora
VelocityOccurrenceConfigurations
VelocityOccurrenceConfigurations

Quando mandamos um sinal para o “tracking”, ele irá passar por um fluxo de consumir que irá verificar se a velocidade recebida pelo sinal está no intervalo configurado (Velocidade mínima < x < Velocidade máxima), se não estiver ele irá criar uma nova ocorrência com base nos parâmetros configurados.

Obs. Olhe no tópico “Como criar sinal no postman” para criar o sinal

Nesses campos são configurados:

Campo	O que faz
Checkbox	Indica se esse fluxo automático está ativo ou inativo.
Nome da categoria da causa de ocorrência	Indica qual a categoria da ocorrência quando for criada a nova ocorrência.
Nome da causa de ocorrência	Indica qual a causa da ocorrência quando for criada a nova ocorrência.
Comentário da ocorrência	Indica qual será o comentário que será colocado quando for criada a nova ocorrência.
Tempo de espera antes de criar nova ocorrência (min)	Indica o tempo em minutos antes de criar uma nova ocorrência.
Velocidade mínima (km/h)	Indica a velocidade mínima da configuração.
Velocidade máxima (km/h)	Indica a velocidade máxima da configuração.

Obs1. Sobre o "Tempo de espera antes de criar nova ocorrência (min)", ele é usado para ver se o intervalo em que foi mandado o sinal é valido.

Exemplo: Vamos supor que foi configurado o tempo de espera de "60m". O primeiro sinal foi mandando às 14:00 e foi gerada ocorrência, então o próximo sinal valido para gerar a ocorrência é às 15:00.

Obs2. Importante seguir o exemplo do comentário, para não perder as informações quando a ocorrência for gerada. Veja o exemplo.

Velocidade esperada entre %.2f km/h e %.2f km/h, mas foi de %.2f km/h
Velocidade esperada entre 30km/h e 100km/h, mas foi de 150km/h

Obs3. Se não colocar os %.2f, irá ocorrer a perda de informações/precisão de dados ao criar o comentário

Obs4. Velocidade mínima e a Velocidade máxima, também podem ser configuradas no início da execução do monitorável, "Configuração de Velocidade"

Nesse caso a configuração ao iniciar a execução vai se sobrepor a que está na tela, para aquele monitorável em específico.

04. Ocorrência automática de temperatura
Âncora
TemperatureRangeOccurrenceConfigurations
TemperatureRangeOccurrenceConfigurations

Quando mandamos um sinal para o “tracking”, ele irá passar por um fluxo de consumir que irá comparar a temperatura recebida com as faixas de temperatura correspondente ao provedor do sinal, existem 3 casos de comparação:

Se a faixa for "Faixa Superior (Vermelha)", será verificado se a temperatura do sinal é maior que a configurada
Se a faixa for "Faixa Inferior (Vermelha)", será verificado se a temperatura do sinal é menor que a configurada
Caso contrário será verificado se a temperatura do sinal é maior que a mínima do intervalo e menor que o máximo do intervalo (mínimo intervalo < temperatura do sinal < máximo do intervalo)

O No primeiro cenário com se a comparação for valida, ele irá criar uma nova ocorrência com base nos parâmetros configurados.

Obs. Olhe no tópico “Como criar sinal no postman” para criar o sinal

Nesses campos são configurados:

Campo	O que faz
Checkbox	Indica se esse fluxo automático está ativo ou inativo.
Comentário da ocorrência	Indica qual será o comentário que será colocado quando for criada a nova ocorrência.

Obs1. Usar a tela "Sensores" para conectar o tipo de provedor com a Configuração de Temperatura.

Obs2. Importante seguir o exemplo do comentário, para não perder as informações quando a ocorrência for gerada. Veja o exemplo.

Criado automaticamente pelo intervalo Min: %d Max: %d Temperatura: %d
Criado automaticamente pelo intervalo Min: 100 Max: 100 Temperatura: 150

Obs3. Só será criar criado a nova ocorrência se a faixa correspondente configurado a de temperatura correspondente possuir o campo "Causa de ocorrência automática" configurado na tela "Configuração de faixas de temperatura"

Obs4. A "Tolerância para criação de ocorrência" na tela "Configuração de faixas de temperatura", se refere ao tempo mínimo de criação de nova ocorrência daquela faixa em específico.

05. Como criar sinal no postman
Âncora
HowToCreateSinalPostman
HowToCreateSinalPostman

Payload de envio (via Postman):

URL: http://localhost:8080/cockpit-gateway/tracking/signal

Obs: o localhost:8080 é URL do gateway, se sua porta do gateway for diferente por favor altere.

Header: user.Token

Pegue ele pelo seu navegador

Body: segue o exemplo abaixo:

Bloco de código

language	js

{
    "deviceId" : "+5511111111111",
    "providerId": "autotrac",
    "monitorableIds": [103451],
    "latitude": "-23.4744780",
    "longitude": "-46.5365305",
    "positionDescription": null,
    "velocity": 150,
    "signalTime": "2023-12-08T12:00:00.000Z",
    "sensorData": [
        {
            "id": 1,
            "configurationIdentifier": "1",
            "sensorType": "br.com.neolog.tracking.model.api.SensorDataType.TEMPERATURE",
            "temperature": "19",
            "containerDoorOpen": false,
            "providerId": "autotrac"
        }
    ]
}

Parametro	O que é
deviceId	número do dispositivo que está no monitorável
providerId	tipo de dispositivo no monitorável
monitorableIds	uma lista de id do monitorável
positionDescription	no nosso caso pode ser null
velocity	A velocidade que o sinal captou
signalTime	Data e hora do sinal
sensorData	Dados do sensor

Obs1. SignalTime.

Para um sinal ser considerado, o mesmo deve ser maior do que o horário de início, como utilizamos o gmt+3, enviar um sinal com uma hora adicionada. Sinais com o mesmo horário, ou antes, do início da execução são desconsiderados
O horário do sinal passado não pode ser anterior a 24 horas da hora atual. Exemplo data atual: "2023-12-07T12:00:00.000Z"
- sinal valido "2023-12-06T12:00:00.000Z"
- sinal invalido "2023-12-06T10:00:00.000Z"

Obs2.

Atente-se ao providerId ser o mesmo dentro do objeto sensorData.

Árvore de páginas

Versões comparadas

Versão antiga 50

Nova versão 51

Chave

01. Atualização automática do monitorável Âncora
AutomaticMonitoring
AutomaticMonitoring

02. Ocorrência automática de atraso
Âncora
DelayOccurrenceConfigurations
DelayOccurrenceConfigurations

03. Ocorrência automática de velocidade
Âncora
VelocityOccurrenceConfigurations
VelocityOccurrenceConfigurations

04. Ocorrência automática de temperatura
Âncora
TemperatureRangeOccurrenceConfigurations
TemperatureRangeOccurrenceConfigurations

05. Como criar sinal no postman
Âncora
HowToCreateSinalPostman
HowToCreateSinalPostman

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 50

Nova versão 51

Chave

01. Atualização automática do monitorável ÂncoraAutomaticMonitoringAutomaticMonitoring

02. Ocorrência automática de atraso ÂncoraDelayOccurrenceConfigurationsDelayOccurrenceConfigurations

03. Ocorrência automática de velocidade ÂncoraVelocityOccurrenceConfigurationsVelocityOccurrenceConfigurations

04. Ocorrência automática de temperatura ÂncoraTemperatureRangeOccurrenceConfigurationsTemperatureRangeOccurrenceConfigurations

05. Como criar sinal no postman ÂncoraHowToCreateSinalPostmanHowToCreateSinalPostman

01. Atualização automática do monitorável Âncora
AutomaticMonitoring
AutomaticMonitoring

02. Ocorrência automática de atraso
Âncora
DelayOccurrenceConfigurations
DelayOccurrenceConfigurations

03. Ocorrência automática de velocidade
Âncora
VelocityOccurrenceConfigurations
VelocityOccurrenceConfigurations

04. Ocorrência automática de temperatura
Âncora
TemperatureRangeOccurrenceConfigurations
TemperatureRangeOccurrenceConfigurations

05. Como criar sinal no postman
Âncora
HowToCreateSinalPostman
HowToCreateSinalPostman