Regras

O menu Administração/Regras pode ser acessado por usuários com permissão Gerenciar Regras ou Administrador de Instância. Usuários que possuem a permissão Gerenciar Clientes poderão acessar as regras de todos os clientes.

As Regras permitem a geração de alertas de monitoramento a partir dos dados de telemetria. Será gerado um alerta sempre que todas as condições da regra forem verdadeiras.

O Plamoon possui uma fila de processamento dos equipamentos. Esta fila prioriza os equipamentos com maior quantidade de dados pendentes de processamento e que são mais recentes.

A regra é aplicada a todos os dados recebidos que são organizados por data/hora crescente. Os dados recebidos de diferentes fontes seja por comunicação direta ou através de integrações com sistemas terceiros são processados na mesma fila e na mesma ordem.

Podem haver dados históricos desatualizados (também conhecidos como log) que foram posteriormente recebidos pelo Plamoon. Esses dados não alteram o estado do equipamento e veículo vinculado mas são processados da mesma forma, aplicando-se as regras mesmo que já existam dados mais recentes. Nesses casos, as condições adicionadas à regra ajudam a determinar se o dado é atual ou de histórico.

Quando não existem novos dados a serem processados, o Plamoon adiciona à fila de processamento o equipamento num intervalo igual ou superior a 60 segundos (podendo variar conforme a fila).

~~Consulte Equipamentos~~

Veículos sem equipamentos por si só não sofrem o processamento de regras visto que todo dado de telemetria precisa ser originado de um equipamento. O Plamoon determina qual veículo estava ou está vinculado ao equipamento para o dado de telemetria recebido, de forma que as condições e alertas referenciem o veículo correto.

Regra

Opções Gerais

Descrição: Um texto descrevendo a regra, esta descrição será usada para gerar o alerta. Pode-se usar os tags de substituição do Plamoon para informações dinâmicas.
Cor: Cor RGB formato hexadecimal. Esta cor é usada como fundo da linha do alerta na tela do monitoramento.
Dispensar Alerta: Os alertas são dispensados automáticamente não sendo exibidos na tela do monitoramento.
Justificativa de Dispensa Obrigatória: Requer que o usuário digite um texto ao dispensar o alerta.

Validade da Regra

Na aba Tempo encontramos algumas pré-condições para a execução da regra:

Intervalo: Tempo mínimo entre alertas. O alerta não é gerado num intervalo inferior ao tempo definido. Como não ocorre geração de alerta, as ações não são executadas. O menor intervalo para geração de alertas é de 60 segundos.
Data/Hora Ínico/Fim: Define data inicial e final para validade da regra. Não definir um valor inicial implica na validade imediata da regra, não definir um valor final implica validade por tempo indefinido.
Dias da semana: Define a validade da regra para um dia da semana específico. Não marcar um dia desabilita a validade da regra para aquele dia.

É usado o fuso horário definido no perfil do cliente ao qual pertence o equipamento ao invés do fuso horário definido no perfil do equipamento. Esse fuso horário é usado para determinar o horário e dia da semana para as opções acima ao converter a data/hora do dado enviado.

Grupos

As regras podem ser adicionadas a grupos que por sua vez também permitem a adição de equipamentos.

Uma regra será aplicada aos dados provenientes do equipamento que pertence aos grupos comuns à regra.

Caso uma regra seja adicionada em múltiplos grupos dentro dos quais um mesmo equipamento também tenha sido adicionado, esta será executada apenas uma vez para cada dado recebido.

Condições

Internamente a regra possui um resultado final que determina a geração do alerta. As condições são testadas de forma sequencial conforme apresentadas na edição da regra. A medida que as condições vão sendo testadas o resultado final vai sendo modificado seguindo a lógica da condição anterior.

Uma condição é composta de:

Tipo da Condição. Define qual a fonte para o dado a ser comparado.
Comparação. Define = igual, ≥ maior ou igual, ≤ menor ou igual, ≠ diferente. Para dados não numéricos: = igual, ≥ maior ou igual, ≤ menor ou igual, significam igual.
Valor para comparação. Conforme o tipo da condição. Pode ser numérico (indicando uma unidade) ou selecionável.
Lógica. Define a lógica que deverá ser aplicada na condição seguinte. Lógica “E” requer que o resultado seja VERDADEIRO e efetua o teste da condição seguinte modificando o resultado. Lógica “OU” modifica o resultado para verdadeiro se a condição seguinte for verdadeira.

Exemplos de lógica

Resultado	Condição	Lógica
	Verdadeiro	E
Verdadeiro	Falso	E
Falso	…	INTERROMPE

Resultado	Condição	Lógica
	Verdadeiro	E
Verdadeiro	Falso	OU
Falso	Verdadeiro
Verdadeiro	FIM

Resultado	Condição	Lógica
	Verdadeiro	E
Verdadeiro	Falso	OU
Falso	Falso
Falso	FIM

Resultado	Condição	Lógica
	Verdadeiro	E
Verdadeiro	Verdadeiro	E
Verdadeiro	Falso	OU
Falso	Verdadeiro
Verdadeiro	FIM

Resultado	Condição	Lógica
	Falso	OU
Falso	Falso	E
Falso	…	INTERROMPE

Resultado	Condição	Lógica
	Falso	OU
Falso	Verdadeiro	OU
Verdadeiro	Falso	E
Verdadeiro	Verdadeiro
Verdadeiro	FIM

Resultado	Condição	Lógica
	Falso	OU
Falso	Falso	OU
Falso	Verdadeiro	OU
Verdadeiro	Falso	OU
Verdadeiro	FIM

Em geral a origem dos dados para as condições parte sempre priorizando conforme posição/telemetria -> equipamento -> veículo daquele momento -> e assim por diante. No entanto cada condição poderá especificar uma fonte diferente para o dado sendo testado.

As condições são testadas individualmente e não dependem umas das outras.

Condições envolvendo dados componentes de telemetria, sensores ou similares são testadas individualmente para cada dado recebido. Não é necessário que a condição seja verdadeira para todos os sensores. Caso a condição seja verdadeira para um sensor, a condição se tornará verdadeira para a regra toda.

Condições que tratam diferentes parâmetros para um mesmo tipo de sensor não são agrupadas.

O sistema de processamento mantém internamente uma lista com todos os items que testaram verdadeiro para a regra. Quando uma condição testa verdadeiro, é adicionada a fonte do dado a essa lista efetivamente marcando o item. Ao referenciar em ações os dados marcados, somente os dados que testaram verdadeiro serão referenciados.

Por exemplo, no tag de substituição [SENSOR], apenas os sensores marcados serão substituídos no texto final.

Consulte as condições disponíveis.

Exemplos

Veja as seguintes regras e casos:

REGRA 1

Descrição: EVASÃO DE CERCA
Intervalo: 0:05
Datas vazias, Horas vazias, Todos dias da semana
Grupos: OPERAÇÃO X

Condição	Comparação	Valor	Lógica
Posição Atual	= igual	Verdadeiro	E
Posição de GPS Válida	= igual	Verdadeiro	E
Localidade Atual	≠ diferente	Localidade X-1	E
Localidade Atual	≠ diferente	Localidade X-2

Ações:

Envio de Mensagem: VERIFICAR EVASÃO VEÍCULO [PLATE] - [EQUIPMENT]

CASO 1:

Recebe-se uma posição com GPS válido e mais recente, de um equipamento vinculado a um veículo adicionado ao Grupo OPERAÇÃO X, atualmente estacionado na Localidade X-2.

Pré-condições: VÁLIDAS

Condições:

Resultado	Condição	Lógica
	Verdadeiro (Posição Atual = Verdadeiro)	E
Verdadeiro	Verdadeiro (Posição de GPS Válida = Verdadeiro)	E
Verdadeiro	Verdadeiro (Localidade Atual ≠ Localidade X-1)	E
Verdadeiro	Falso (Localidade Atual ≠ Localidade X-2)
Falso	FIM

A regra não é válida, o alerta não é gerado e as ações não são executadas.

CASO 2:

Recebe-se uma posição com GPS válido e mais recente, de um equipamento adicionado ao Grupo OPERAÇÃO X, sem veículo vinculado e fora de qualquer localidade conhecida.

Pré-condições: VÁLIDAS

Condições:

Resultado	Condição	Lógica
	Verdadeiro (Posição Atual = Verdadeiro)	E
Verdadeiro	Verdadeiro (Posição de GPS Válida = Verdadeiro)	E
Verdadeiro	Verdadeiro (Localidade Atual ≠ Localidade X-1)	E
Verdadeiro	Verdadeiro (Localidade Atual ≠ Localidade X-2)
Verdadeiro	FIM

A regra é válida, o alerta EVASÃO DE CERCA é gerado e as ação é executada agendando o envio da mensagem.

REGRA 2

Descrição: CHEGADA NA CERCA
Intervalo: 0:05
Datas vazias, Horas vazias, Todos dias da semana
Grupos: OPERAÇÃO X

Condição	Comparação	Valor	Lógica
Posição Atual	= igual	Verdadeiro	E
Posição de GPS Válida	= igual	Verdadeiro	E
Localidade Atual	= igual	Localidade X-1	OU
Localidade Atual	= igual	Localidade X-2

Ações:

Envio de Mensagem: VEÍCULO CHEGOU NO PÁTIO [PLATE] - [EQUIPMENT] - [POSITION_DATETIME]

CASO 3:

Recebe-se uma posição com GPS inválido e mais recente, de um equipamento adicionado ao Grupo OPERAÇÃO X.

Pré-condições: VÁLIDAS

Condições:

Resultado	Condição	Lógica
	Verdadeiro (Posição Atual = Verdadeiro)	E
Verdadeiro	Falso (Posição de GPS Válida = Verdadeiro)	E
Falso	N/A (Localidade Atual = Localidade X-1)	OU
Falso	N/A (Localidade Atual = Localidade X-2)
Falso	FIM

A regra não é válida, o alerta não é gerado e a ação não é executada.

CASO 4:

Recebe-se uma posição com GPS válido e mais recente, de um equipamento vinculado a um veículo adicionado ao Grupo OPERAÇÃO X, que entrou na Localidade X-2.

Pré-condições: VÁLIDAS

Condições:

Resultado	Condição	Lógica
	Verdadeiro (Posição Atual = Verdadeiro)	E
Verdadeiro	Verdadeiro (Posição de GPS Válida = Verdadeiro)	E
Verdadeiro	Falso (Localidade Atual = Localidade X-1)	OU
Falso	Verdadeiro (Localidade Atual = Localidade X-2)
Verdadeiro	FIM

A regra é válida, o alerta é gerado e a ação é executada.

Ações

Uma regra pode conter uma ou mais ações que são executadas sequencialmente no momento da geração do alerta. Caso uma ação falhe por algum motivo, as subsequentes continuarão a ser executadas.

Similarmente às condições da regra, em geral a origem dos dados para as ações parte sempre priorizando conforme alerta -> posição/telemetria -> equipamento -> veículo -> e assim por diante. No entanto cada ação poderá especificar um comportamento diferente.

Consulte as ações disponíveis.