Administração da Plataforma
...
Ação Automática via E-mail
Graph Mail

Projeto Service Management

6min

Diretório de imagens e anexos

Definir o valor do parâmetro ID = 479, informando o diretório de anexos, onde serão gravados os arquivos usados no envio e leitura de e-mails; o mesmo, deve estar mapeado nos volumes dos containers docker.

Envio de e-mail

Para utilizar o envio de e-mails usando a integração graph-mail é necessário definir o parâmetro MAIL_AUTHENTICATION_TYPE – ID: 477 com a opção Microsoft Graph Mail, para uma parametrização geral onde será usado o valor default: graphMailQueue, para o nome da fila de envio de e-mails; ou, caso deseje uma configuração por caixa de correio, basta configurar a tela caixa de e-mail, com o nome das filas registradas no wildfly:

Document image


📌IMPORTANTE!

O controle de envio de e-mail foi alterado, portanto, nos scripts rhino, não se deve utilizar as classes antigas ControleEmail e ControleEmailNotificacao para envios e, sim, as classes MensagemEmail ou MensagemEmailNotificacao.

Leitura de e-mail

O sistema irá realizar a leitura de uma caixa de e-mail microsoft, utilizando o método de autenticação OAuth2, e disparando as ações automáticas cadastradas e definidas para cada caixa de correio e pasta. Será utilizado o SDK java disponibilizado pela própria microsoft para tornar mais simples, segura e adequada esta integração. Esta nova implementação não interfere, no processo de leitura e disparo de ações automáticas já existente e que usa um Job-Quartz, para ler as caixas de e-mail usando IMAP e POP3.

O projeto Service Management:

  • Escuta as filas cadastradas na tela de ação automática via e-mail;
  • A cada mensagem recuperada o sistema obtém a ação automática configurada a partir do nome da fila e da pasta; Implementar recurso para evitar múltiplas pesquisas ao banco de dados para uma configuração já recuperada, durante o processamento;
  • Processa a ação recuperada utilizando o conteúdo da mensagem recuperada;

Configuração de leitura

O usuário deve cadastrar as ações automáticas, que devem ser disparadas, a cada leitura de e-mail, realizada na conta da microsoft; para o correto funcionamento, é necessário que o nome da fila e pasta sejam exatamente iguais aos que foram parametrizados pela infraestrutura. Pois, a pesquisa é case sensitve. Durante a execução, se o sistema encontrar uma Configuração de ação automática via e-mail que esteja ativa, possuindo uma fila com o nome, da que foi lida pelo sistema, a pasta cadastrada seja a mesma, o tipo de autenticação for MICROSOT_GRAPH e a data fim estiver vazia, ele irá disparar esta ação passando como parâmetros as informações lidas no e-mail;

É importante destacar que o cenário de pastas para leitura e ações automáticas que devem ser disparadas, deve ser pensado antes de se iniciar a configuração de infraestrutura, tendo em vista que as parametrizações que devem ser feitas são estáticas e não podem ser alteradas com o sistema em funcionamento, pois envolve alterar arquivos standalone.xml, config.properties e System-properties.

Na tela Configuração de ação automática via e-mail ainda é possível configurar o job de leitura via IMAP e POP3, como também a nova forma de integração com o microsoft graph, tal como na imagem a seguir:

Para leitura via graph-mail:

Document image


Para leitura via Job – IMAP ou POP3:

Document image