Histórico da Página
01. Apresentação
Este documento tem por objetivo apresentar as principais entidades do EAI 2.0 da linha RM, juntamente com as tabelas em que são armazenadas, e fazer o paralelo com as entidades equivalentes no EAI 1.0.
01.01. Diagrama
draw.io Diagram border true viewerToolbar true fitWindow false diagramName Diagrama de Entidades simpleViewer false diagramWidth 901 revision 9
02. Aplicativos e Pacotes Instalados
02.01. Descrição
O cadastro de aplicativos é o coração de uma integração, sendo responsável por representar os sistemas integrados e armazenar as informações de conectividade com o mesmo.
Um aplicativo de destino se refere a uma instância de um sistema integrado, como por exemplo um ambiente com o Protheus instalado e de SourceApplication "P12Manutencao".
A partir deste cadastro são feitos todos os relacionamentos que descreverão a integração com os dois sistemas (RM e aplicativo externo), como por exemplo a definição das rotas de integração.
02.02. Equivalência
O cadastro de integrações no EAI 1.0 é migrado para os cadastros de Aplicativos e de Pacotes Instalados durante a conversão. Cada integração no EAI 1.0 é considerado como um pacote de integração, podendo assim ter mais de um pacote para o mesmo aplicativo de destino.
A imagem abaixo representa a forma como as Integrações do EAI 1.0 são migradas para as duas entidades do EAI 2.0. Em resumo, as integrações são agrupadas considerando cada par "Sistema Integrado" e "SourceApplication" como um aplicativo, e cada integração passam a ser consideradas como Pacotes Instalados.
draw.io Diagram | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
03. Transações e Versões
03.01. Descrição
O cadastros de Transações e Versões apresentam quais Mensagens Únicas TOTVS possuem Adapters disponíveis na linha RM para a versão instalada e a configuração destas transações, como os parâmetros se o tipo de entrega será sincrono/assíncrono e se grava log na fila.
Este cadastro é atualizado automaticamente, mas pode ser solicitada o reprocessamento através do processo "Atualizar Transações do Ambiente" que está disponível na visão de Transações.
03.01. Equivalência
A implementação de adapters no EAI 1.0 e no 2.0 são distintas, sendo que no primeiro os fontes do adapter são armazenados em tabelas do banco de dados e no segundo são internos às DLLs do RM.Assim sendo, no EAI 2.0 as tabelas de Transação e Versão armazenam somente a lista de adapters diponíveis, facilitando visualização e configuração.
draw.io Diagram | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
04. Rotas
04.01. Descrição
O cadastro de rotas é responsável por definir quais as transações trafegadas com cada aplicativo integrado, informando também a versão da mensagem e outras informações.
04.01. Equivalência
As rotas são equivalentes ao cadastro de "Mapa de Integração" do EAI 1.0, com a adição de funcionalidades solicitadas como a parametrização do sentido da mensagem (envio/recebimento), se inclui a mensagem original na resposta e outras.
draw.io Diagram | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
05. Fila de Mensagens
05.01. Descrição
O EAI permite o armazenamento das mensagens trafegadas em sua fila de mensagens, sendo este comportamento obrigatório no tráfego assíncrono. Estas tabelas são expostas pelas APIs de monitoramento e podem ser visualizadas a partir do Monitor de Integrações.
05.02. Tabelas envolvidas
05.02.01.
01GEAIMENSAGEM
Tabela responsável por armazenar as mensagens originais.
No recebimento o conteúdo desta tabela será a TotvsMessage recebida e no envio esta tabela armazenará o dado original enviado pela trigger.
05.02.02.
01GEAIJOBMENSAGEM
Tabela de armazenamento dos IDs dos Jobs agendados para processamento de mensagens assíncronas. A partir destes IDs é possível verificar os dados do Job, como data e hora agendamento, status do processamento e outros.
05.02.03.
01GEAIROTAMENSAGEM
Tabela responsável por armazenar as informações da mensagem pra cada rota parametrizada.
Exemplificando o uso desta tabela, caso existam duas rotas para uma transação recebida existirão assim duas "Rota/Mensagem" para uma única Mensagem.
05.02.
0104. GEAIEXECROTAMENS
Esta tabela armazena as informações de execução da "Rota/Mensagem", como o status, mensagem transformada, mensagem de execução, contexto de negócio e outros.
05.02.05.
01GEAIROTALOGMENSAGEM
Tabela responsável por armazenar os logs de execução.
06. Configurações do EAI
06.01. Descrição
A fila de mensagens armazena.rotina de configuração está disponível na arvore de menus do EAI 2.0.
06.
0102.
EquivalênciaAs rotas são equivalentes ao cadastro de "Mapa de Integração" do EAI 1.0, com a adição de funcionalidades solicitadas como a parametrização do sentido da mensagem (envio/recebimento), se inclui a mensagem original na resposta e outrasParâmetros disponíveis
- Usuário de Proxy
- Usuário de rede que será utilizado na comunicação com o EAI de destino.
- Senha do Proxy
- Senha do usuário de rede que será utilizado na comunicação com o EAI de destino.
- Timeout
- Tempo de espera máximo (em segundos) na comunicação com o EAI de destino. Caso o tempo de resposta seja maior que o parametrizado a execução será abortada e será considerado erro de TimeOut.
- Número de tentativas de execução
- Número de tentativas de processamento de uma mensagem assíncrona caso hajam erros de comunicação.
- Intervalo de execução
- Temo de intervalo (em minutos) entre cada tentativa de execução.
- Url do Monitor Interno
- URL do servidor Rest que contém as APIs do monitor de integração.
- Url do WSDL Interno
- URL da definição do WebService do RM para recebimento de Mensagens Padronizadas TOTVS.
- Usa Log
- Informa se deve-se armazenar logs.
- Usa Log de Debug
- Informa se deve-se armazenar logs de informação. Caso desmarcado somente logs de erro serão armazenados.
- Grava anexo de Log
- Informa se deve-se armazenar os dados de objeto ou anexos dos logs.
- Informa se deve-se armazenar os dados de objeto ou anexos dos logs.
- Desabilita customizações
- Caso este parâmetro esteja marcado os pontos de customização dos adapters não serão executados.
05. ASSUNTOS RELACIONADOS
- Documento técnico da criação do EAI 2.0
- Documento técnico da criação do Conversor para EAI 2.0