Tiempo aproximado de lectura 00:05:00 min
Duda
¿Cómo configurar el ambiente para la utilización de la integración EAI?
Entorno
Cross Segmentos - TOTVS Backoffice (Línea Protheus) - MI - Configurador (SIGACFG) - A partir de la versión 12
Solución
Para solucionar esta duda, realice los siguientes pasos:
1. Inicialmente es necesario configurar el AppServer.ini para recibir y enviar requisiciones vía WebService SOAP, tenemos dos maneras de efectuar ese proceso:
1º) Utilizando el asistente ApWebWizard conforme la documentación del link: ApWebWizard
2º) Colocando directamente los tags dentro del AppServer.ini, sigue ejemplo con tags funcionales:
[http]
enable=1
port=8077
[OnStart]
jobs=JOB_WS_9901
RefreshRate=120
[localhost:8079/ws]
ENABLE=1
PATH=C:\Program Files\TOTVS12\protheus_data\web\ws
ENVIRONMENT=P12.1.24
INSTANCENAME=ws
RESPONSEJOB=JOB_WS_9901
DEFAULTPAGE=wsindex.apw
[JOB_WS_9901]
TYPE=WEBEX
ENVIRONMENT=P12.1.24
INSTANCES=1,10
SIGAWEB=WS
INSTANCENAME=ws
ONSTART=__WSSTART
ONCONNECT=__WSCONNECT
PREPAREIN=99,01
WEBSERVICELOCATION=http://localhost:8079/ws
2. Luego de configurar el AppServer.ini, inicie el servidor de aplicaciones Protheus y vea si el WebService SOAP está activo o no, para verificar use la ruta utilizada en la etiqueta WEBSERVICELOCATION en su navegador, si funcionó, aparecerá como se muestra en la imagen a continuación:
3. Ahora en el módulo configurador (SIGACFG), será necesario parametrizar el sistema para utilizar EAI mediante SOAP:
- MV_EAIURL2 - Parámetro que indica a EAI Protheus a qué dirección de Webservices se enviará el mensaje. Este parámetro se utiliza cuando el adaptador está registrado con el canal de envío (XX4_CHANEL) = EAI;
Ejemplo de relleno:
- MV_EAIUSER – Parámetro para enviar al usuario a acceder a la capa de Webservices en el sistema de destino. Este parámetro se utiliza cuando el adaptador está registrado con el canal de envío (XX4_CHANEL) = EAI. Este parámetro sólo debe configurarse cuando el sistema que recibirá el mensaje de EAI Protheus tiene autenticación de usuario en la capa de Webservices ;
- MV_EAIPASS – Parámetro para enviar la contraseña del usuario para acceder a la capa de Webservices en el sistema de destino. Este parámetro se utiliza cuando el adaptador está registrado con el canal de envío (XX4_CHANEL) = EAI. Este parámetro sólo debe configurarse cuando el sistema que recibirá el mensaje de EAI Protheus tiene autenticación de usuario en la capa de Webservices ;
4. El siguiente paso es configurar las empresas/sucursales de Protheus que interactuarán con otros sistemas TOTVS. En este proceso se utiliza la rutina APCFG050, que se encuentra en la siguiente ruta Entorno > Schedule > Emp. Rama de mensaje único. En esta rutina, vinculamos una empresa/sucursal de Protheus a la empresa/sucursal del otro sistema, como se muestra en la siguiente imagen:
En el ejemplo de la imagen de arriba, informo que la empresa 01 y sucursal 01 de RM se comunicarán con el grupo de empresas 01 y sucursal 0101 de Protheus.
5. Por lo tanto, para que funcione la comunicación a través del canal EAI, es necesario dar de alta los Adapters que se quieren integrar entre los sistemas. La rutina del adaptador es CFGA020 y su ruta en el configurador es Environment > Schedule > Adapter eai. Los adaptadores son los encargados de procesar el mensaje en el sistema. En ella se definen qué rutinas serán procesadas y si Protheus envía o recibe dicho mensaje. También definimos si el mensaje en Protheus funcionará de forma sincrónica (recibiendo retroalimentación inmediata del otro producto) o de forma asincrónica (sin esperar la retroalimentación del otro producto, recibiéndola más tarde). A continuación, se muestra un ejemplo de registro de un ADAPTADOR:
6. Para fines de prueba, si desea validar el mensaje único, pero no dispone de otro producto TOTVS como RM, LOGIX, etc. existen herramientas como SOAP UI o Postman, que reenvía los archivos XML al Protheus Web Service, para que Protheus los reciba y los procese según el adaptador. Aquí está la documentación sobre cómo configurar la interfaz de usuario de SOAP: Cómo configurar la interfaz de usuario de SOAP
0 Comentarios