Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Deck of Cards
effectDuration0.5
idIntegração Mensagem única
effectTypefade
Card
defaulttrue
effectDuration0.5
idTestes de Integrações via XML
labelConceito Mensagem única

Conceito:


Durante o processo de consolidação de marcas, iniciado pela TOTVS, várias empresas diferentes foram adquiridas e com elas vários produtos passaram a compor o portfólio de ofertas disponível aos clientes. Esta expansão de ofertas permitiu que clientes de uma marca, antes limitados pelas opções com aquela “etiqueta”, pudesse agora compor o seu ambiente de TI utilizando produtos de origens diferentes (Ex.: BackOffice Protheus + TOTVS Obras e Projetos).

Com o objetivo de padronizar a integrações com os produtos TOTVS, foi definida uma nova diretriz para os projetos de integração: todos os produtos TOTVS devem se comunicar com uma mensagem XML única, evitando desta forma o processo de transformação de mensagens. Neste cenário, teríamos o seguinte quadro: 

  


Neste cenário, qualquer produto TOTVS trabalhará com o mesmo XML para uma mesma entidade, ou seja, supondo que tenhamos um XML correspondente à mensagem de CLIENTES, ela poderá ser enviada para qualquer um dos produtos que suporte o recebimento desta entidade.

Uma vez que os vários produtos TOTVS terão um “idioma” comum (o XML Único), as integrações entre estes produtos não exigirão mais que as mensagens sejam transformadas de um formato para outro. Com isto, será possível conectar diretamente dois produtos, sem a necessidade do TOTVS ESB, como no diagrama abaixo:



Card
effectDuration0.5
idIntegração via Mensagem única
labelPrincipais tabelas

Tabelas:


XXFDe/Para no banco de dados 
XX3Transações EAI
XX4Adapters EAI
Card
defaulttrue
idIntegração Via Mensagem única
labelAdapters

Adapters: 


O cadastro de Adapters são rotinas responsáveis por realizar o processamento das mensagens enviadas e recebidas, possibilitando a inclusão, alteração e exclusão do Adapter no Protheus.

Abaixo segue link completo com as lista dos Adapters utilizado na integração  EAI  (Enterprise Application Integration)

Link: http://tdn.totvs.com/download/attachments/254607629/Mensagens_Protheus.xlsx?api=v2


Caminho para cadastrar os Adapters: Configurador Protheus - Schedule - Adapter E.a.i (CFGA020)


Modelos de mensagens Síncronas e Assíncronas 

 As integrações via Mensageria propõem dois modelos de envio e recebimento de mensagens. O modelo Síncrono e o Assíncrono.


Síncronas:  No modelo de mensagens Síncronas a mensagem é enviada e o sistema que enviou aguarda o processamento da mensagem pelo receptor.
Assíncronas:   Já no modelo Assíncrono a mensagem é enviada e o sistema que a enviou não aguarda o seu processamento. Posteriormente a mensagem será processada no receptor.


Observações:  O modelo de mensagem que será utilizado na integração deve ser avaliado com muito cuidado. Apesar do modelo síncrono parecer o mais adequado para uma integração, isto não é de todo verdade. Em um modelo síncrono deve ser levado em consideração o tempo de processamento: O processamento do sistema que envia, a velocidade do trânsito de dados da rede e o tempo de processamento e resposta do receptor. Isto pode acarretar um tempo de resposta ao usuário muito maior do que o normal, o que pode transformar a integração de solução ao problema. Já o modelo assíncrono, por não aguardar o retorno do processamento do receptor torna o processo mais rápido, porém, neste modelo de mensagem deve-se levar em consideração que o dado será gravado no sistema que envia a mensagem e que o processamento no receptor ocorrerá posteriormente. Desta maneira, em algumas situações os dados irão existir no sistema de envio, mas enquanto não forem processados no receptor eles não existirão lá.

Card
defaulttrue
effectDuration0.5
idIntegração Via Mensagem única
labelDe / Para de empresas

De/Para de Empresas/Filiais : 

O Cadastro de De/Para de empresa irá definir quais empresas e filiais serão integradas.

Nota
titleImportante:

Deve ser informado a referencia a outra marca. 

O cadastro está localizado: Configurador/Ambiente/Schedule/Emp. Fil. Msg. única


No XML para identificar qual a empresa e qual a filias, avalie as seguintes Tags <CompanyId>e <BranchId>.

<CompanyId>= Empresa

<BranchId> = Filial

<CompanyId>15</CompanyId>
<BranchId>1</BranchId>


Card
defaulttrue
effectDuration0.5
idIntegração Mensagem única
labelDe/Para XXF

De/Para XXF: 

A XXF é a tabela que ira guardar os códigos da mensagem para os casos onde os códigos são diferentes nas marcas, por exemplo um cliente pode ser o 00001/01 no Protheus e no RM C0100001. Para que consigamos efetuar a integração é necessário efetuar o De/Para do cadastro. 



O cadastro está localizado: configurador/Ambiente/DE/PARA Msg. única


Card
defaulttrue
idIntegração Mensagem única
labelSoap UI

Ferramenta Soap: 

É uma ferramenta de mercado onde conseguimos realizar testes de Web Service. Utilizamos o Soap para integrar o XML gerado por um ERP(RM/Logix) e enviar para o Protheus.

Link para baixar o Soap: https://www.soapui.org/downloads/latest-release/


Integração WS protheus X Soap Ui:

No Ini do Appserver, busque o caminho do WS.

WEBSERVICELOCATION=http://localhost:92/ws

Acesse o WS via browser

Busque o EAISERVICE , e clique sobre.

Clique sobre a descrição do serviço;


Copie o endereço do .


Abra o Soap UI - Clique em File - New SOAP Project




Cole o endereço do WSDL no campo Initial WSDL, clique em OK.

Pronto o Soap está integrado com o Web Service do Protheus. 

 


Cole o XML entre as seguintes Tags:


<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tot="http://www.totvs.com/">
<soapenv:Header/>
<soapenv:Body>
<tot:RECEIVEMESSAGE>
<tot:INMSG>
<![CDATA[

Cole aqui o XML

]]>

</tot:INMSG>
</tot:RECEIVEMESSAGE>
</soapenv:Body>
</soapenv:Envelope>


Nota
titleImportante:
  • A seguinte Tag tem que ser acrescentada:

<![CDATA[

]]>


  • Não esqueça de salvar o Novo Projeto, caso feche o sistema perde inclusive a integração.





Card
idIntegração Mensagem única
labelParâmetros

Parâmetros: 

  • MV_EAIMETH (não deve ser alterado)
  • MV_EAIUSER
  • MV_EAIPASS
  • MV_EAIURL2 (Endereço do WS para comunicação) - Podemos informar a Rota da integração neste parâmetro ou através da rotina CFGA020.  Saiba mais:  Roteamento EAI Protheus (CFGA020 - SIGACFG)
  • MV_EAIWS(Não Precisa ser alterado). 
Card
idIntegração Mensagem única
labelFontes de Integração

Fontes de Integração:

Todos os fontes de integração contém a letra " I", exemplos:

Cadastro de cliente MATI030

No TFS os fontes do módulo Faturamento estão localizados na pasta Materiais - Mensagem única:




Card
idIntegração Mensagem única
labelComo extrair XML do Protheus

Extraindo o XML do Protheus:


Acesse o ambiente SIGACFG, Menu: Ambiente - Schedule - opção EAI


Image Added

Na integração do Software com o Protheus, são criados os arquivos de transações:

Selecione o arquivo que integrou e para extrair clique na lupa Image Added , ira apresentar as opções Image Added escolha qual XML deseja extrair.

Visualizar mensagem Origem: XML que o Software envia para o Protheus.

Visualizar mensagem de Resposta: XML que o Protheus envia para o Software.



Nota
titleImportante:

Através da tag <Product> consegue visualizar o Software que esta recebendo ou enviando. Exemplo:

XML de envio (original): <Product version="12.1.18.0" name="RM"/>

XML de resposta:<Product version="12" name="PROTHEUS"/>




Card
idIntegração Mensagem única
labelOutras Documentações

Documentações para apoio:




Card
idIntegração Mensagem única
labelExemplos de XML

Exemplo de XML para testes: