Card |
---|
effectDuration | 0.5 |
---|
id | Integração via Mensagem única |
---|
label | Principais tabelasInformações Gerais |
---|
|
Expandir |
---|
| Tabelas utilizadas na Integração EAI: | XXF- De/Para de Empresas/Filiais Mensagem única (XXD)
- De/Para
| no banco de dados |
XX3 | Transações EAI |
XX4 | Adapters EAI |
Card |
---|
default | true |
---|
id | Integração Via Mensagem única |
---|
label | Adapters |
---|
|
|
default | true |
---|
effectDuration | 0.5 |
---|
id | Integração Via Mensagem única |
---|
label | - de Conteúdos Mensagem Única (XXF)
- Transações E.A.I. (XX3)
- Adapters E.A.I. (XX4)
|
Expandir |
---|
| Parâmetros utilizados na Integração EAI: - 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 E.A.I. Protheus (CFGA020 - SIGACFG)
- MV_EAIWS: Não precisa ser alterado
Dica |
---|
title | Integração RM TOP x Protheus |
---|
| A integração do Top RM com o Protheus envolve o módulo Gestão de Projetos (SIGAPMS), neste módulo não é necessário realizar alguns cadastros de De/Para na tabela XXF e sim configurar alguns parâmetros. Lista dos parâmetros que envolve as integrações deste módulo: Parâmetros da Integração |
| Adapters: | Os Adapters são responsáveis por realizar o processamento das mensagens enviadas e recebidas, possibilitando a inclusão, alteração e exclusão de dados. | Veja integração EAI integração E.A.I (Enterprise Application Integration).
| As integrações via Mensagem Única propõem dois modelos de envio e recebimento de mensagens: | No modelo de mensagens Síncronas a - A mensagem é enviada e o sistema que enviou aguarda o processamento da mensagem pelo receptor
| . Já no modelo Assíncrono a mensagem - A mensagem é enviada e o sistema que a enviou não aguarda o seu processamento. Posteriormente a mensagem será processada no receptor.
Aviso |
---|
| 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 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 |
---|
| | empresas De/Para de : | O Cadastro de De/Para de empresas/filiais irá definir quais empresas e filiais serão integradas entre os dois sistemas. No XML é necessário identificar a Aplicação de Origem, a Empresa e a Filial para cadastrar o De/Para. As tags a serem verificadas são: - SourceApplication = Aplicação de Origem (XXD_REFER)
- CompanyId = Empresa (XXD_COMPA)
- BranchId = Filial (XXD_BRANCH)
|
|
Card |
---|
|
default | true |
---|
effectDuration | 0.5 |
---|
id | Integração Mensagem única |
label | De/Para de Mensagem Única |
---|
|
| (XXF)De/Para de Mensagem Única (XXF): Na maioria das vezes, os códigos dos registros utilizados nos sistemas que se comunicam via Mensagem Única não são os mesmos, a XXF é a tabela que ira guardar os códigos para relacionar os registros, por exemplo um cliente pode possuir o código | no no Protheus, e no RM esse mesmo cliente possui o código C0100001. | Por Por isso o sistema realiza o cadastro de um "De/Para de Mensagem Única". Ao realizar a inclusão de um cadastro, o sistema verifica se já existe um "De/Para de Mensagem Única", caso já exista, o sistema entende que trata-se de uma alteração, caso não exista, trata-se de uma inclusão, então ele cria automaticamente o "De/Para de Mensagem Única" (XXF). Dica |
---|
| Veja o vídeo do processo de cadastro do De/Para de Mensagem Única (XXF): | https://drive.google.com/file/d/1DfiCXyiws-psFp8uZ8Ubt9Hy2RhBJy_W/view?usp=sharing De Para de Mensagem Única O vídeo está no Google Drive do Suporte FAT / SERV / JUR, caso execute no navegador Google Chrome, a qualidade do vídeo pode ficar mais baixa, sendo esse o caso, é possível fazer o Download do arquivo para superior qualidade. |
Caso trate-se de uma inclusão que referencia códigos de outros cadastros, esses códigos necessitam de um "De/Para de Mensagem Única", por exemplo, ao incluir um Pedido de Vendas você precisa referenciar um código de Produto e um código de cliente, mas, nesse momento, você não está incluindo o cliente ou o produto, você está incluindo o Pedido, portanto o cliente e o produto precisam ter um "De/Para de Mensagem Única" (XXF) cadastrado. |
| card |
default | true |
---|
id | Integração Mensagem única |
---|
label | Soap 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:
1° No Ini do Appserver, busque o caminho do WS.
WEBSERVICELOCATION=http://localhost:92/ws
2° Acesse o WS via browser
3° Busque o EAISERVICE , e clique sobre.
4°Clique sobre a descrição do serviço;
Image Removed
5° Copie o endereço do Image Removed.
Image Removed
6° Abra o Soap UI - Clique em File - New SOAP Project
Image Removed
7° Cole o endereço do WSDL no campo Initial WSDL, clique em OK.
Pronto o Soap está integrado com o Web Service do Protheus.
Image Removed
8° 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 |
---|
|
- 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 |
---|
id | Integração Mensagem única |
---|
label | Parâ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).
Principais parâmetros da Integração RM TOP X Protheus:
A integração do Top RM com o Protheus envolve o módulo Gestão de Projetos (SIGAPMS), neste módulo não é necessário realizar alguns cadastros de De/Para na XXF e sim configurar alguns parâmetros.
Segue a baixo a lista dos parâmetros que envolve as integrações deste módulo:
Link: Parâmetros da Integração
Card |
---|
id | Integração Mensagem única |
---|
label | Fontes 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:
Image Removed
Card |
---|
id | Integração Mensagem única |
---|
label | Como extrair XML do Protheus |
---|
|
Acesse o ambiente SIGACFG, Menu: Ambiente - Schedule - opção EAI
Image Removed
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 Removed , ira apresentar as opções Image Removed 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 |
---|
|
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"/>
title | Fontes de Integração |
---|
| Todos os fontes de integração contém a letra "I" no final do nome da rotina, fontes com processamento a parte em JSON possuem a letra "O" ou "Json" no final. Exemplos: - A rotina de Pedidos de Venda tem seu fonte com nome "MATA410";
- Na integração de Pedido de Venda via XML, o fonte que trata a integração chama-se "MATI410";
- Na integração de Pedido de venda via JSON o fonte que trata a integração chama-se "MATI410O"
- A movimentação do Estoque tem seu fonte com nome "MATA240";
- Na integração da Movimentação via XML, o fonte que trata a integração chama-se "MATI241"
- Na integração da Movimentação via JSON o fonte que trata a integração chama-se "MATI241JSON"
|
Expandir |
---|
title | Extrair Xml-Json Envio e Resposta |
---|
| Para realizar os testes e analises de ocorrências envolvendo integração EAI, é necessário validar o Xml/Json de envio e de resposta, para extrair os arquivos para análise, realise os passos abaixo: - Acesse o ambiente SIGACFG: Ambiente > Schedule > Adapter EAI
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 . Será exibido as opções para extrair
- ENVIO: Visualizar mensagem original: Xml/Json com os dados que o sistema tentou integrar;
- RESPOSTA: Visualizar mensagem de resposta: Xml/Json com a resposta da tentativa de integração.
Nota |
---|
title | Identificando o XML: |
---|
| 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 recebimento (resposta): <Product version="12" name="PROTHEUS"/> |
|
Expandir |
---|
| Durante a análise de ocorrências no processo de integração, pode ser necessário gerar o Profile para analise das funções executadas ou do tempo de processamento. Para gerar o Profiler no processo de integração é necessário: - Em seu appserver.ini na chave/bloco que carrega o nome do JOB do WebServices [JOB_WS_XXXX]
- Inclua uma linha: "PROFILE=1" e depois salve o arquivo (Atalho: CTRL + S)
Bloco de código |
---|
| [JOB_WS_9901]
TYPE=WEBEX
ENVIRONMENT=12.1.2310
INSTANCES=1,1
SIGAWEB=WS
INSTANCENAME=ws
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01
PROFILE=1 <-------- Insira essa chave
SECURITY=0 |
Aviso |
---|
| - Para desabilitar a geração do log, basta alterar para "PROFILE=0"
|
Ao integrar/tentar integrar, será gerado um arquivo .txt de log na pasta protheus > protheus_data > wsprofiler: Image Added |
|