Histórico da Página

Informações Gerais

Objetivo

Permitir que o usuário final (cliente da integração) customize um adapter e não a mensagem.

Definição da Regra de Negócio

1) - Modelo atual

Características:

• O EAI comunica diretamente com extensions (códigos fontes c# responsáveis pela manipulação da mensagem);
  
  
• Uma única mensagem pode ser ligada a diferentes extensions no processo de configuração de integrações. Para isso, basta criar um mapeamento entre a integração x mensagem conforme figura 1.
  
  
• Esses fontes (extensions) Extensions são desenvolvidos e mantidos pelas equipes dos produtos (segmentos).
  
  
• Esses fontes Extensions podem ser modificados pelos nos clientes em ambiente de teste e produção, visto que, os mesmos são abertos para alteração.
  
  
• Utilização de É utilizado um editor de código fonte c# para escrita e compilação desses códigos conforme a figura 2. 
  
  
• Esses fontes estão localizados no banco de dados na tabela "GSourceCode" do globais.
  
  
  

Vantagens:

a) - Flexibilidade no processo de customização;

Desvantagens:

a) - Permite a duplicação de fontes para manipulação de uma mesma mensagem;

b) - Modificações realizadas no fonte para uma determinada integração pode não ser replicada para outras integrações;

c)- No recebimento de uma determinada mensagem, se existir mais de uma integração cadastrada, o EAI seleciona a primeira integração e executa o código fonte correspondente a essa integração / mensagem.

d) - Ao executar novamente o configurador em ambiente do cliente, os códigos fontes serão substituídos pela versão atual do fonte presente no configurador;

e) - Dificuldade na detecção e análise de erros desses códigos visto que o Editor c# do EAI não oferece suporte para debugger.

2) - Modelo proposto

Adapters: estrutura utilizada para implementação de regras específicas para manipulação de uma mensagem de integração.

• O EAI comunicará diretamente com os adapters (de responsabilidade das equipes de segmentos);
  
  
• Uma mensagem / versão estará ligada a um único adapter;
  
         Ex: Existirá um único adapter para manipular a mensagem de "BANK" na versão  "2.000" independente da integração. 
  
  
• Regras específicas da mensagem em uma determinada integração deverão ser tratadas diretamente dentro do adapter.
  
  
• Devem ser mantidos pelas equipes dos produtos (segmentos).
  
  
• Não poderão ser modificados pelos clientes;
  
  
• Estarão localizados na mesma estrutura das solutions dos segmentos no TFS;
  
  
• As extensions das integrações atuais devem ser migradas para essas classes de adapter de acordo com o documento localizado em:
   http://tdn.totvs.com/display/LRM/DT_CENTRALIZAR_OS_CODIGOS_DE_INTEGRACAO
  
  

b) - Extensions: estrutura utilizada para implementação das regras customizadas em um determinado cliente

• O Editor de código atual do EAI será utilizado pelos clientes para implementação de customizações nos adapters dos produtos;

• Esses códigos (extensions) devem ser implementados no contexto da integração em questão. 
  Sendo assim, o cadastro de "Mapa de integração" será usado para gravação das regras customizadas a serem implementadas no cliente (customização de integração).
  
  
• Os entryPoints das customizações serão disparados imediatamente após a execução do método (de mesmo nome e interface) do adapter;
  
  
• Esses recurso permitirá que alterações possam ser feitas nos objetos logo após a execução do código do adapter;

Opcional

Protótipo de Tela

Figura1 - Mapeamento mensagem x integração

figura2: Editor de  código fonte do EAI

(Opcional)

Grupo de Perguntas

<Informações utilizadas na linha Protheus>.

Nome: FINSRF2

(Opcional)

Consulta Padrão

<Informações utilizadas na linha Protheus>

Consulta: AMB