Histórico da Página

Tempo aproximado para leitura: 00 min

01. 

03. SOLUÇÃO

04. DEMAIS INFORMAÇÕES

05. ASSUNTOS RELACIONADOS

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

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.

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.

Image Added

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.

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.

Image Added

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.

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. GEAIMENSAGEM

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. GEAIJOBMENSAGEM

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. GEAIROTAMENSAGEM

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.04. 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. GEAIROTALOGMENSAGEM 

Tabela responsável por armazenar os logs de execução.

06. Configurações do EAI

06.01. Descrição

A rotina de configuração está disponível na arvore de menus do EAI 2.0.

Image Added

06.02. Parâ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.
    
• 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
  • DT_EAI2_Engine
• Documento técnico da criação do Conversor para EAI 2.0
  
  • DT_ConversorEAI1_EAI2