Histórico da Página
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.0Versão RM Minima 12.1.18.154
1- Habilitar Menu de Conversão Stored EAI 1.0
...
2 - Habilitar Menu Mensagem Unica
2 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.
2 4 - Desativar a Integração Stored Procedure. RM.Exe → Integrações → Aba Ferramentas → Parâmetros → TOP x Protheus 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.
3 5 - Executar o Configurador de Integração Mensagem Unica
4 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:
Sim | PMSA200B | InternalID | Sim | Não | Síncrono | Todas | EAI | 1.000 |
Sim | INTXATU01 | InternalIdLoad | Não | Sim | Sincrono | Todas | EAI | 1.000 |
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
View file | ||||
---|---|---|---|---|
|
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.