Dúvida
Como configurar o ambiente para a utilização da integração EAI?
Ambiente
Cross Segmento - TOTVS Backoffice (Linha Protheus) - Contabilidade Gerencial - A partir da versão 12
Solução
Para solucionar essa dúvida, realize os seguintes passos:
1. Primeiramente é necessário configurar o AppServer.ini para receber e enviar requisições via WebService SOAP, temos duas maneiras de efetuar esse processo:
1º) Utilizando o assistente ApWebWizard conforme a documentação do link: ApWebWizard
2º) Colocando diretamente as tags dentro do AppServer.ini, segue exemplo com tags funcionais:
[http]
enable=1
port=8077
[OnStart]
jobs=JOB_WS_9901
RefreshRate=120
[localhost:8077/ws]
ENABLE=1
PATH=C:\Program Files\TOTVS12\protheus_data\web\ws
ENVIRONMENT=P12.1.25
INSTANCENAME=ws
RESPONSEJOB=JOB_WS_9901
DEFAULTPAGE=wsindex.apw
[JOB_WS_9901]
TYPE=WEBEX
ENVIRONMENT=P12.1.25
INSTANCES=1,10
SIGAWEB=WS
INSTANCENAME=ws
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01
WEBSERVICELOCATION=http://localhost:8077/ws
2. Após configurar o AppServer.ini, suba o appserver do Protheus e veja se o WebService SOAP está ativo ou não, para verificar utilize o caminho usado na Tag WEBSERVICELOCATION no seu navegador, caso tenha dado certo, aparecerá conforme a imagem abaixo:
3. Agora no módulo do configurador(SIGACFG), será necessário parametrizar o sistema para utilizar o EAI utilizando o SOAP:
- MV_EAIURL2 - Parâmetro que indica ao EAI Protheus para qual endereço de Webservices a mensagem será disparada. Este parâmetro é utilizado quando o adapter está cadastrado com o Canal Envio (XX4_CHANEL) =EAI;
Exemplo de preenchimento:
- MV_EAIUSER – Parâmetro para envio do usuário de acesso a camada de Webservices no sistema destino. Este parâmetro é utilizado quando o adapter está cadastrado com o Canal Envio (XX4_CHANEL) =EAI. Este parâmetro somente deve ser configurado quando o sistema que irá receber a mensagem oriunda do EAI Protheus possuir autenticação de usuários na camada de Webservices;
- MV_EAIPASS – Parâmetro para envio da senha do usuário de acesso a camada de Webservices no sistema destino. Este parâmetro é utilizado quando o adapter está cadastrado com o Canal Envio (XX4_CHANEL) =EAI. Este parâmetro somente deve ser configurado quando o sistema que irá receber a mensagem oriunda do EAI Protheus possuir autenticação de usuários na camada de Webservices;
4. O próximo passo é configurar as empresas/filiais do Protheus que irão interagir com os outros sistemas da TOTVS, nesse processo é usado a rotina APCFG050, que fica no seguinte caminho Ambiente > Schedule > Emp. Filial Mensagem Única. Nessa rotina atrelamos uma empresa/filial do Protheus na empresa/filial do outro sistema, conforme imagem abaixo:
No exemplo da imagem acima, informo que a empresa 1 e filial 1 do RM se comunicará com o grupo de empresas 99 e filial 01 do Protheus.
5. Com isso, para a comunicação via canal EAI funcionar, é necessário cadastrar os Adapters que deseja integrar entre os sistemas, a rotina do adapter é a CFGA020 e seu caminho no configurador é Ambiente > Schedule > Adapter e.a.i. Os adapter são responsáveis pelo processamento da mensagem no sistema, nele você define quais rotinas serão processadas e se o Protheus envia ou recebe essa mensagem. Também definimos se a mensagem no Protheus funcionará de maneira síncrona(Recebe retorno imediato do outro produto) ou assíncrona(Não aguarda o retorno do outro produto, recebendo posteriormente), segue exemplo de um cadastro de ADAPTER:
6. Para efeito de testes, caso queira validar a mensagem única, mas não possui um outro produto da TOTVS como o RM, LOGIX e etc, há uma ferramenta chamada SOAP UI, onde ela encaminha os arquivos XML para o Web Service do Protheus, assim o Protheus recebe o mesmo e o processa conforme o adapter. Segue a documentação de como configurar o SOAP UI: Como configurar o SOAP UI
0 Comentários