01. Apresentação

Esta página disponibiliza as documentações referentes ao desenvolvimento de Adapters de integração via Mensagem Padronizada com o protocolo Transactions do EAI RM.

02. Responsabilidades

O padrão Adapter tem por definição a responsabilidade de “Converter a interface de uma classe em outra interface, esperada pelo cliente. O Adapter permite que interfaces incompatíveis trabalhem em conjunto – o que, de outra forma, seria impossível.”[1].

Voltado ao modelo de Mensagem Única TOTVS, os Adapters tem por finalidade fazer a transcrição do modelo de negócio interno para a Mensagem Padronizada TOTVS e fazer a orquestração dos serviços internos, e vice-versa dependendo se é um envio ou recebimento.

Padrões de integração (EAI Patterns)

Os padrões de desenvolvimento de integração listados abaixo são os principais para este contexto. É aconselhável o estudo dos demais padrões, sendo melhor descritos no site Enterprise Integration Patterns, SOA Patterns e outras referências bibliográficas.

• Message Translator
  • Transformação de modelos de dados, mesmo que sem alteração de conteúdo.
  • Ex.: Converter os campos do DataSet para os nomes da Mensagem Padronizada, como a tag "NomeFantasia" para "Name", mantendo o valor original.
• Content Enricher
  
  • Enriquecimento dos dados originais.
  • Ex.: A mensagem padronizada trafega somente o InternalId da ForeignKey, sendo necessário obter a coligada e código referentes a este registro.
  • Ex 2.: Caso no dado original não tenham relacionamentos necessários, como o responsável financeiro de um aluno, o adapter deve ser responsável enriquecer o dado com esta informação.
• Content Filter
  
  • Padrão que descreve a situação contrária ao Content Enricher, sendo responsável por reduzir a quantidade de informações.
  • Ex.: O DataSet original de Movimentos possui inúmeras tabelas e colunas, mas para a mensagem de deleção de Pedidos de Compra somente a chave do registro deve ser trafegado.
• Validações de integração
  • Realizar validações de regras de integração, como parametrizações obrigatórias, campos obrigatórios ou predecessão de mensagens.

03. Referências

• [1] https://brizeno.wordpress.com/category/padroes-de-projeto/adapter/
• Enterprise Integration Patterns
• SOA Patterns
• C# Design Patterns - Adapter

04. Documentações