Linha RM

Atalhos

Páginas filhas
  • DT_CENTRALIZAR_OS_CODIGOS_DE_INTEGRACAO

Versões comparadas

Versão antiga 6

changes.mady.by.user Erlon Cesar Lima De Freitas

Gravado em

comparado com

Nova versão 7

changes.mady.by.user Erlon Cesar Lima De Freitas

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

aracterísticas do Requisito

Linha de Produto:

RM

Segmento:

Framework

Módulo:

Eai

  

Cadastros Iniciais:

Relacione os cadastros necessários que precisam ser preenchidos antes da utilização desse requisito.

Parâmetro(s):

Informe os parâmetros utilizados.

Ponto de Entrada:

Informe o ponto de entrada relacionado (link).

Chamados Relacionados

Informe o(s) chamado(s) relacionado(s).

Requisito (ISSUE): Informe o requisito relacionado (Issue).

País(es):

Informe o(s) Pais(es).

Banco(s) de Dados:

Informe o(s) Banco(s) de Dados utilizado(s).

Tabelas Utilizadas:

Informe as tabelas utilizadas.

Sistema(s) Operacional(is):

Informe o(s) sistema(s) operacional(is) utilizados.

Descrição

Essa melhoria no EAI foi criada com o intuito de viabilizar a transferência dos códigos fontes das integrações (atualmente localizados na tabela GsourceCode) para projetos a serem localizados nas solutions dos produtos RM.

Com essa mudança, os diversos fontes das integrações passarão a ser controlados pelo TFS, possibilitando com isso ganhos de segurança, histórico, controle de concorrência, etc.

Escopo da funcionalidade


1) - Modelo atual

Atualmente o analista responsável pelo desenvolvimento da integração pode usar diversos "entry Points" disparados durante o processamento da mensagem. 

Isso possibilita diversas formas de customização nas fases de processamento das mensagens.

Códigos C# (.NET) são criados seguindo um modelo padrão, e armazenados em uma tabela de banco chamada GSourceCode.

Através das telas de "cadastro de transformação" e "mapeamento" esses códigos podem ser "vinculados" a esses "entry Points".

Informações

Esse mecanismo continuará existindo pois integrações totalmente customizadas devem ainda utilizar esse modelo.

 

2) - Localização atual dos códigos fontes

Atualmente, os códigos fontes das integrações estão localizados no projeto "RM.Con.ConfiguraIntegracao.TotvsMessage" da solution "Con-EAI" da framework.

Nas pastas "Oracle" e "SQL" (localizadas nesse projeto) foram criados arquivos contendo scripts para inclusão desse códigos na tabela "GSourceCode".

Esses scripts são executados automaticamente durante o processo de configuração da integração.

 

2) - Transferência dos fontes

Todos os scripts que incluem dados na tabela "GSourceCode" devem ser retirados desses arquivos e transferidos para os projetos nas solutions dos produtos.

Em versões futuras, esses arquivos serão removidos dessa solution.

Informações

Atualmente esses códigos fontes estão duplicado em arquivos diferentes (Oracle e sql).

Com a mudança, existirá uma única classe no projeto. Evitando assim, diferenças nesses códigos entre bancos diferentes.

 

3) - Criação dos projetos

As equipes dos produtos deverão criar projetos nas suas solutions contendo classes a serem executadas automaticamente durante o processamento da mensagem.

Passo a passo para criação desses projetos:

a) - No visual Studio, abra a solution correspondente a seu segmento. ex. Financeiro.sln.

b) - Crie um novo projeto na solution do tipo "Class Library";

c) - No arquivo AssemblyInfo.cs, utilize o atributo conforme exemplo: [assembly: AssemblyLayerSide(LayerSideKind.Server)];   

d) - O projeto recém criado deverá seguir o seguinte padrão de nomenclatura:

       RM.{Segmento}.TotvsMessage.Adapter.dll,        onde:  Segmento = Sigla do segmento
               ex:  RM.Fin.TotvsMessage.Adapter.dll.     

Informações

Esse padrão de nomenclatura deve ser seguido corretamente. Caso contrário, a dll não será carregada pelo EAI durante o processamento da mensagem.

 

4) - Criação das classes

Os códigos localizados na tabela GSourceCode deverão ser transferidos para classes localizadas no projeto recém criado. A criação dessas classes deverá seguir um modelo conforme abaixo:

Códigos que estendem as rotinas de processamento (Extensão de códigos):

       a) - Criar uma classe com um nome qualquer (o ideal seria colocar o nome da classe com o mesmo nome da menssage);

               ex: public class CostCenter : ....

       b) -  Herdar da classe "ExtensionBase" e implementar as interfaces "IExtensionDataServer, IExtensionTransformReceive, IExtensionWebServices, IExtensionProcess, IExtensionModule, IExtensionMessage"

          ex: public class CostCenter : ExtensionBase, IExtensionDataServer, IExtensionTransformReceive, IExtensionWebServices, IExtensionProcess, IExtensionModule, IExtensionMessage

        c) - Usar o atributo de classe "AdapterAttr":

          ex: 

               [AdapterAttr(TransactionType.ttMensageriaUnica, "COSTCENTER", "2.000")] 
               public class CostCenter : ExtensionBase, IExtensionDataServer, IExtensionTransformReceive, IExtensionWebServices, IExtensionProcess, IExtensionModule, IExtensionMessage

        d) - Após a criação dessa classe, basta copiar e colar o código fonte (c#) localizado nos scripts, conforme fig abaixo:

Image Added    
b) - Handles customizados:

       - Herdar da classe: ReceiveMessageHandle

       - Utilização do atributo AdapterAttr

      Exemplo:

           [AdapterAttr(TransactionType.ttMensageriaUnica, "FinancingTranding", "1.000")]
            public class FinancingTranding : ReceiveMessageHandle