Framework - Linha Logix - FRW - Como configurar o Logix para realizar integrações assíncronas via EAI

Tempo aproximado para leitura: 00:02:00 min

Dúvida
Como configurar o Logix para realizar integrações assíncronas via EAI

Ambiente
Framework - Framework (Linha Logix) - Administração Logix - Todas as versões.

Solução
Algumas integrações com o ERP Logix, como as utilizadas no módulo TOTVS GFE, operam utilizando mensagens assíncronas.

Nesse modelo, a comunicação entre sistemas não ocorre de forma imediata (tempo real), permitindo maior flexibilidade e resiliência no processamento das informações.

Exemplos de adapters que utilizam esse tipo de integração:

Invoice
ListOfAccountPayableDocument

No modelo assíncrono, o envio e o processamento das mensagens ocorrem de forma independente.

Fluxo básico de funcionamento: 

• O Sistema A envia uma mensagem
• A mensagem é armazenada em uma fila
• O Sistema B consome essa mensagem quando disponível
• O processamento é realizado
• Opcionalmente, pode haver retorno (resposta)

No LOGIX ao receber uma mensagem assíncrona, o ERP Logix realiza as seguintes etapas:

• A mensagem é registrada na tabela: EAI_APLICATIVO_FILA
• Posteriormente, o sistema realiza:
  -Leitura da fila
  -Processamento da mensagem

Para que o processamento das mensagens ocorra corretamente, é obrigatória a configuração de uma instância dedicada de AppServer.

Essa instância será responsável por consumir e processar as mensagens da fila.

Na configuração do appserver, a instância deve possuir um serviço ativo configurado conforme abaixo:

[ONSTART]
Jobs=4GLJOBEAI1
[4GLJOBEAI1]
Environment=prod
Main=EAIStarter

Descrição dos parâmetros

• ONSTART / Jobs - Define o job que será iniciado automaticamente junto ao AppServer
• 4GLJOBEAI1 - Nome do serviço responsável pelo processamento da fila
• Environment - Ambiente de execução (ex: produção – prod)
• Main - Programa principal responsável por iniciar o processamento das mensagens (EAIStarter)

Importante
A ausência dessa configuração pode impedir o consumo das mensagens
A instância do AppServer deve ser dedicada para garantir performance e estabilidade

Saiba mais
Configurar EAI no logix
DI Integração Logix x GFE