Ações de Regras

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.

Ações da Regra

Controlar Viagem

Tipo: CONTROL_TRIP

Esta ação realiza modificações na viagem associada ao equipamento ou veículo que originou o alerta.

Controlar Viagem

Campos:

  • Tipo: Determina a modificação a ser realizada na viagem. Conforme:
    • Iniciar Viagem: Para os casos onde existe uma viagem atrelada ao processamento embora a viagem não tenha sido iniciada. No momento essa situação é incomum (depende de projetos específicos) e não significa que o Plamoon buscará a próxima viagem disponível para o equipamento/veículo.
    • Concluir Viagem: Conclui a viagem ativa associada ao processamento. Concluir uma viagem significa finalizar todas as rotas e alterar a situação da viagem para Concluída. Os vínculos de equipamentos/veículos são mantidos.
    • Finalizar Viagem: Finaliza a viagem ativa associada ao processamento. Finalizar uma viagem significa finalizar todas as rotas e alterar a situação da viagem para Finalizada. Os vínculos de equipamentos/veículos não são mantidos.
    • Finalizar Viagem (Manter Configuração): Finaliza a viagem ativa associada ao processamento. Finalizar uma viagem significa finalizar todas as rotas e alterar a situação da viagem para Finalizada. Os vínculos de equipamentos/veículos são mantidos.
    • Iniciar Próxima Rota: Finaliza a rota atual da viagem ativa associada ao processamento e inicia a rota subsequente caso exista.
    • Finalizar Rota Atual: Finaliza a rota atual da viagem ativa associada ao processamento.
    • Adicionar Rota: Adiciona a rota especificada ao fim das rotas já existentes na viagem ativa associada ao processamento. Caso a rota atualmente ativa seja a última rota da viagem, a rota adicionada será iniciada.
  • Rota: Especifica uma rota para o tipo acima.

Consulte a documentação das viagens para mais detalhes. Esta ação reflete o mesmo comportamento da interface do usuário no Plamoon, incluindo a lógica para manter ou não os vínculos de equipamentos/veículos.

Gerar Relatório

Tipo: GEN_REPORT

Esta ação gera um relatório automáticamente. O relatório é adicionado a fila de geração de relatórios da mesma forma como com um usuário.

Gerar Relatório

Atualmente os seguintes relatórios estão disponíveis:

  • Detalhes de Viagem (TRIP_DETAILS) O relatório será referente a viagem marcada nas condições da regra;

O link para download do relatório pode ser referenciado usando a tag de substituição [REPORT_URL] e utilizado em ações subsequentes.

Gerar segredo

Tipo: GEN_SECRET

Esta ação gera um Segredo aleatório utilizando digitos numéricos (0-9).

Gerar Segredo

Campos:

  • Dígitos: Quantidade de dígitos.
  • Enviar comando: Agenda o envio de um comando Definir Senha de Destravamento.
  • Índice: Para equipamentos que permitem mais de um segredo em memória.
  • Atualizar segredo no perfil: Atualiza o segredo no perfil se o comando for entregue com sucesso.

Durante o envio do comando alguns equipamentos poderão reformatar o segredo para manter a quantidade de dígitos aceitos. Consulte os detalhes de implementação de cada equipamento.

Gerar senha remota

Tipo: GEN_PASSWORD

Esta ação gera uma senha aleatória utilizando os caracteres 0123456789AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRrSsTtUuVvWwXxYyZz.

Gerar Senha

Campos:

  • Dígitos: Quantidade de dígitos. Entre 6 e 32.
  • Enviar comando: Agenda o envio de um comando Definir Senha Remota.

Sempre atualiza a senha no perfil do equipamento se o comando for entregue com sucesso.

Durante o envio do comando alguns equipamentos poderão reformatar o segredo para manter a quantidade de dígitos aceitos. Caso seja reformatado, o valor enviado ao equipamento é que será atualizado no perfil. Consulte os detalhes de implementação de cada equipamento.

Requisição HTTP

Tipo: HTTP_REQUEST

Esta ação realiza uma requisição HTTP que pode ser utilizada para realizar integrações simples.

Requisição HTTP

Campos:

  • Tipo: Método Http
  • URL: Endereço Http. Podem ser incluídos parâmetros e tags de substituição .
  • Content-Type (POST): Configura o cabeçalho HTTP.
  • Conteúdo (POST): Formato raw utf-8

A requisição é colocada em uma fila sequencial específica para ações deste tipo. Pode levar alguns segundos para a realização da requisição.

Enviar comando

Tipo: SEND_COMMAND

Esta ação agenda o envio de um comando para o equipamento.

Enviar comando

Campos:

  • Cancelar comandos anteriores: Cancela comandos com a situação Aguardando que foram agendados para o mesmo equipamento, com mesmo tipo e criados pela mesma regra.

Demais campos conforme Envio de Comandos;

Enviar mensagem

Tipo: SEND_MESSAGE

Esta ação agenda o envio mensagens através de uma conta cadastrada na plataforma.

Enviar Mensagem

Campos:

  • Conta: Uma conta cadastrada no sistema que seja compatível com envio de mensagens.
  • Agendamento: Agenda o envio para o horário especificado (no mesmo dia).
  • Enviar para Usuários: Adiciona usuários dos grupos relacionados.
  • Enviar para Contato da Localidade: Adiciona contatos das localidades marcadas nas condições da regra.
  • Enviar para Cliente: Envia para o contato do cliente do veículo (requer revisão para utilizar outras fontes para o Cliente).
  • Para: Lista de destinatários separado por “; ou ,”. Depende do tipo da conta sendo utilizada, pode ser um email ou número de telefone.
  • Assunto: Para contas com a capacidade de definir um assunto.
  • Mensagem: Corpo da mensagem.

Para campos de assunto e mensagem podem ser utilizadas as tags de substituição .

Atribuir situação ao equipamento

Tipo: SET_EQUIPMENT_STATUS

Esta ação modifica a situação do equipamento.

Situação do Equipamento

Atribuir grupos ao veículo

Tipo: SET_GROUPS

Esta ação modifica os grupos de forma que apenas os grupos especificados conterão o veículo.

Não haverá modificação caso não exista veículo associado ao alerta.

Atribuir Grupos

Atribuir estacionamento

Tipo: SET_PARK

Esta ação atribui a localidade especificada no campo Estacionamento no perfil do veículo.

Atribuir estacionamento

Atribuir tags

Tipo: SET_TAGS

Esta ação modifica os tags do equipamento, veículo e viagem.

São respeitadas as configuraçãos do Tag indicando se o mesmo é aplicável a Equipamentos, Veículos ou Viagens.

Atribuir Tags

Atribuir situação ao veículo

Tipo: SET_VEHICLE_STATUS

Esta ação modifica a situação do equipamento.

Atribuir Situação

Desvincular Equipamento

Tipo: UNLINK

Esta ação desvincula o equipamento do veículo caso esteja vinculado e não exista viagem associada.

Adicionar grupos ao equipamento

Tipo: ADD_GROUPS_EQUIPMENT

Esta ação modifica os grupos especificados adicionando o equipamento ao grupo caso não exista o relacionamento.

Remover grupos do equipamento

Tipo: REMOVE_GROUPS_EQUIPMENT

Esta ação modifica os grupos especificados removendo o equipamento do grupo caso exista o relacionamento.

Adicionar grupos ao veículo

Tipo: ADD_GROUPS_VEHICLE

Esta ação modifica os grupos especificados adicionando o veículo ao grupo caso não exista o relacionamento.

Não haverá modificação caso não exista veículo associado ao alerta.

Remover grupos do veículo

Tipo: REMOVE_GROUPS_VEHICLE

Esta ação modifica os grupos especificados removendo o veículo do grupo caso exista o relacionamento.

Não haverá modificação caso não exista veículo associado ao alerta.