Pré-Requisitos para iniciar o processo de Conversão:

• Atualização da versão Protheus para 12.1.0.17
• Versão RM Minima 12.1.18.154
• Configuração do Serviço REST - Protheus
• Configurar e testar webservices RM e Protheus.
• Solicitar para Equipe TOTVS o Script de Liberação de Integração Mensagem Única 
• Rodar Script de Liberação de Integração TOP x Protheus EAI 1.0 - RM.Script.Executor.
• Ajuste nos compartilhamentos das Tabelas após a conversão para Mensagem Única 1.0: Produtos, Unidade de Medida, Moeda e Cliente/Fornecedor.
  
  

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

1- Habilitar Menu de Conversão Stored EAI 1.0

2 - Habilitar Menu Mensagem Unica

3 - Rodar Script de Liberação de Integração TOP x Protheus EAI 1.0 que foi solicitado para equipe Totvs BH.

         RM.Script.Executor.

4 - Desativar a Integração Stored Procedure. RM.Exe → Integrações → Aba Ferramentas → Parâmetros → TOP x Protheus (Ativa Integração) Deve ficar desmarcado.

É 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.

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

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

7 - 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:

8 - Cadastrar os 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

9 - Atualizar Menu SIGACFG

sigacfg.xnu

Conferir e realizar os cadastros  que faltam como de-para ou estão divergentes como Agendamento no SCHEDULE, Parâmetros e Fases do Projeto: 1 - CONFIGURAÇÃO

Percorra todas as abas do documento de Configuração e execute todas as instruções.

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

Preencher a Filial no Contexto.

Executar o Conversor -  (Foi necessário 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)

11 - Acompanhar Execução

11.1 → Aba Ambiente → Gerenciamento de Jobs

11.2 - Log de Conversão

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, Grupos de Produtos, 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

Importante: Desabilitar as fórmulas visuais do EAI 1.0 de Projeto, Obra, Etapa, Tarefa, caso estas tiverem sido importadas para o EAI 1.0.

• Habilitar via script o Conversor para o EAI 2.0

IMPORTANTE:  Deve-se solicitar na TOTVS o Script de Liberação do Conversor EAI 2.0.

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

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

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:

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:

• Informando os Parâmetros para serviço REST

No menu de Integração > Parâmetros de Integraçã, deve-se informar os parâmetros abaixo para utilizar o serviço REST do Protheus:

• Processos de Apropriação e Eliminação de Resíduos no EAI 2.0

Após a conversão realizada para o EAI 2.0, os processos de apropriação e eliminação de resíduos tem sua funcionalidade migrada para o novo EAI.

Para configuração dos dois processos, favor acompanhar nos documentos abaixo:

Apropriação 2.0: http://tdn.totvs.com/display/INT/3+-+PROCESSOS#t--1400348179

Eliminação de Resíduos: http://tdn.totvs.com/display/INT/3+-+PROCESSOS#t–1505097505

ATENÇÃO: Para essas duas funcionalidades deve-se aplicar todos os patchs de apropriação e eliminação de residuos no Protheus.

Testes realizados no EAI 2.0 pós conversão:

• Cadastro de Projeto, obra, etapa e tarefa (alteração e exclusão) 
• Liberação de Contrato
• Solicitação de Compra e Solicitação de Armazém
• Cadastros no Protheus de: Cliente, Fornecedor, Produto, Centro de Custo, Condição de Pagamento, Local de Estoque, Unidade de Medida, Natureza e Banco.

Problemas Encontrados:

1. Liberação de periodos de contratos.
Erro1: [21/02/2018 17:44:30] - Não foi possível concluir o processo devido ao seguinte erro: Movimento ?499?! - Série P04: Condição de Pagamento não permitida para o tipo de movimento.

Solução: Condições de pagamentos utilizadas podem estar inativas. Deve ativar a condição de pagamento ou utilizar uma ativa.

2. Erro no cadastro de Condições de Pagamento.

Solução: Ajustar compartilhamento.

3. Liberação de periodos, Geração de Pedido extra e de Material:

INTEGDEF RETURN ERROR --> [array out of bounds ( 3 of 1 ) ] - [|THREAD ERROR ([62164], JOB_WS_0101, THIS)   21/02/2018 17:54:22|array out of bounds ( 3 of 1 )  on V3002(MATI120.PRW) 14/09/2017 14:29:11 line : 1229||[TOTVS build: 7.00.131227A-20171123 NG]|Called from V3002(MATI120.PRW) 14/09/2017 14:29:11 line : 1229|Called from MATI120(MATI120.PRW) 14/09/2017 14:29:11 line : 61|Called from INTEGDEF(MATA120.PRX) 31/10/2017 11:31:09 line : 12468|Called from FWUMESSAGE(PROTHEUSFUNCTIONMVC.PRX) 05/10/2017 18:39:41 line : 5626|Called from FWEXECEAI(FWEAIUTIL.PRW) 05/10/2017 18:39:40 line : 533|Called from FWEAI:SAVE(FWEAI.PRW) 05/10/2017 18:39:40 line : 1261|Called from EAISERVICE:RECEIVEMESSAGE(EAISERVICE.PRW) 05/10/2017 18:39:40 line : 135|Called from WSEXECUTE(XMLWSVCS.PRW) 05/10/2017 18:39:40 line : 2001|Called from __WSCONNECT(XMLWSVCS.PRW) 05/10/2017 18:39:40 line : 1104|Called from STATICCALL(XMLWSVCS.PRW) 05/10/2017 18:39:40 line : 1104|]

Solução: Aplicar novo RPO 12.1.0.17 do Protheus que corrige tal problema.

4. Ajustar compartilhamento que está incorreto da tabela de Produtos (SB1).

Solução: Acessar SIGACFG → Bases de Dados → Tabela SB1, alterar nível de compartilhamento para Filial, Unidade → Compartilhado.

5. Ajustar compartilhamento da tabela de Moedas Contábeis.

Solução: Acessar SIGACFG → Bases de Dados → Tabela SYF, alterar nível de compartilhamento para Filial, Unidade → Compartilhado.

6. Ajusar tabela de classificação de País (Fiscal -> Paises -> Classificação) - Incluir o código no parâmetro de integração CODCLASSIFICPAIS.

7. Ajustar de-para de moeda (R$).

Solução: Alterar e gravar o registro do lado do Protheus.