Documento para registrar etapas da conversão da integração TOP x Protheus Stored para TOP x Protheus EAI 2.0

Versão RM Minima 12.1.18.154

1- Habilitar Menu de Conversão Stored EAI 1.0

2 - Habilitar Menu Mensagem Unica

2 - Rodar Script de Liberação de Integração TOP x Protheus EAI 1.0

         RM.Script.Executor.

2 - Desativar a Integração Stored Procedure. RM.Exe → Integrações → Aba Ferramentas → Parâmetros → TOP x Protheus 

É interessante que seja informado um IP interno no caso de Cloud. Também tem que ser liberado a conexão do RM com este IP e Porta pelo Protheus estar em uma rede diferente. Isto gera o Erro.

3 - Executar o Configurador de Integração Mensagem Unica

4 - Ativar a Integração e Informar a URL do Web Service Protheus.

3 - Realizar a Configuração de Adapters - Protheus - SigaCFG → Schedule → Adapter .

      Realizar o cadastro conforme orientações na pagina TOP x Protheus - EAI 2.0. já pode ser realizado a configuração conforme o EAI 2.0 apesar de até o momento estar ainda no EAI 1.0

      Cadastrar o Adapter's:

ATENÇÃO: A partir da versão 12.1.0.17 do Protheus, é necessário alterar os adpaters de ITEM para rotina MATA010M e FORNECEDORES para  a rotina MATA020M.

3 - Cadastrar o parâmetros:

sigacfg→parametros

MV_EAIURL2 - Exemplo: http://187.94.62.198:8023/EAIService/IConWSEAIService

O Servidor do Protheus pode ser necessario configuração de liberação ao Servidor RM.

MV_EAIPASS - Senha RM - Exemplo totvs

MV_EAIUSER - Usuário RM - Exemplo mestre

3 - Atualizar Menu SIGACFG

2 - Executar o processo de conversão de integração Stored para Mensagem Unica

Preencher a Filial no Contexto.

Executar o Conversor -  (Foi necessario executar Entidade a Entidade pois conforme print abaixo o processo foi interrompido, mas isto ocorreu automaticamente com a perda da sessão do Go Global)

5 - Acompanhar Execução

5.1 → Aba Ambiente → Gerenciamento de Jobs

5.2 - Log de Conversão

Conferir e realizar os cadastros  que faltam ou estão divergentes como Agendamento no SCHEDULE, Parâmetros e Fases do Projeto: Como Fazer: Configuração do Protheus para a Integração TOTVS Obras e Projetos x Backoffice Protheus

POSSIVEL ERROS:

Se existir um jobserver parado pode ocorrer o erro abaixo:

Solução: Remover Servidores Inválidos no CookPit na aba Ambiente.

TESTES REALIZADOS EM HOMOLOGAÇÃO E RECOMENDADOS EM EAI 1.0 APÓS CONVERSÃO STORED:

• Realizar alteração de Projetos já existentes e verificar se a alteração é enviada para o Protheus via mensagem única conferindo as mensagens da fila e seu de-para.
• Realizar inclusão de novos projetos e verificar se é enviado para o Protheus, criado de-para. Dentro do projeto, criar planilha de atividades, com obra, etapa e tarefa e verificar se foram enviadas para o Protheus e criado de-para.
• Realizar alterações nos cadastros já existentes no Protheus, como: Cliente, Fornecedor, Unidades de Medida, Locais de Estoque, Condições de Pagamento, Natureza Financeira, Centros de Custos, Produtos e Bancos, todas as alterações devem disparar mensagem para o RM realizando as devidas alterações.
• Logar em um projeto e enviar um movimento qualquer para o Protheus e verificar se o mesmo foi integrado com sucesso. (Solicitação de Compras, Armazém e Pedido de Compra).

DIFICULDADES ENCONTRADAS:

• Se o Goglobal cair a sessão o Conversor é interrompido e também pode ocorrer falha no serviço do Protheus ao converter todas as entidades de uma só vez. (Uma dica é rodar entidade a entidade para cada empresa, assim o processo é agilizado e não derruba o serviço do Protheus).
• A conversão executa com sucesso mesmo que tenha ocorrido erro em todas as mensagens.
• O usuário fica com a tela travada e não consegue acompanhar a fila durante a execução. ( Mudar para não travar a tela seria uma melhoria simples que facilitaria bem, inclusive para que o usuário possa disparar mais de uma tread por entidade)
• O Log do Conversor estoura o limite de 1000 registros facil e não é possivel aumentar o limite deste dataserver la na pagina de Globais.
• Não temos como fazer um simples teste de conexão da URL no RM após ativar o EAI 1.0. Tive que importar a formula visual de Projeto para este teste. E se testa-se eu não teria perdido tempo tentando executar o conversor. ( Seria bem simples criar um teste conexão igual ao já existente em Stored )
• Ter que preencher uma filial no Contexto para executar o Conversor.
• Não tem conversão de movimentação, o que vai acontecer se o usuário tentar cancelar um pedido que não tem de-para pois foi integrado em Stored? O mesmo para medições.
• Ao fazer a conversão de stored para mensagem única, o cadastro de Clientes/Fornecedores apresentam erro de legado, pois não é preenchido a informação correta de Chave Primária RM o seu valor: CODCOLIGADA|CODCFO. Fazendo com que dê erro de PK ao tentar enviar uma alteração do Protheus pro RM. Este ítem foi aberto issue para ser tratado no Conversor Stored. http://jiraproducao.totvs.com.br/browse/TOPEXECONTROL01-2291

DIFICULDADES A SEREM ANALISADAS:

• Em stored era possível enviar projetos com Descrição maior que 50 caracteres. Ao converter, os projetos que tem mais que 50 caracteres não são sincronizados, pois o Protheus informa que é maior que o limite do seu campo. Por isso deve se adequar as descrições dos projetos nesses casos.
• Aberto issue para o Conversor Stored Procedure para Mensagem Unica EAI 1.0 para que seja corrigido os problemas de Conversão de De-Para de Cliente/Fornecedor e de Natureza Financeira. http://jiraproducao.totvs.com.br/browse/TOPEXECONTROL01-2291

CONVERTENDO E CONFIGURANDO EAI 2.0

1. Habilitar via script o Conversor para o EAI 2.0

INSERT INTO HCPARAMETROS (CODCOLIGADA,NOMECOLUNA,VALORSTR,VALORINT,VALOR)
VALUES (0,'LIBERACONVERSOREAI2','1',1,1)

        2. Após rodar o script, será habilitado o conversor no menu "Integração > Mensagem única:"

3. Após abrir o Conversor, avançar as próximas duas telas:

4. Ao chegar na tela abaixo, configurar as informações do Source Aplication e Avançar:

Deve clicar em "Atualizar Source Aplication manualmente" e informar:

Sistema Integrado: PROTHEUS (Exemplo)
Source Aplication: Eviroment do Protheus (K9OZIH_HOM) Por exemplo.

Após o preenchimento das informações, clicar em "Avançar" e posteriormente em "Executar":

Neste momento, inicia-se a conversão de EAI 1.0 para EAI 2.0:

Ao final, será exibido a mensagem de Sucesso:

5. Após o término, será exibido uma mensagem para que seja executado uma carga de dados para os movimentos de compra para o Protheus, essa carga pode ser executada a qualquer momento, não necessáriamente neste momento:

Após término da carga, será demonstrada a seguinte mensagem:

Após o término, deverá ser reinicializado o HOST e consequentemente o RM.

Configurações do EAI 2.0

Ao entrar no módulo Integração, será disponibilizado o menu EAI 2.0:

Para habilitar as opções do EAI 2.0, deverá acessar as devidas permissões abaixo: