Tag Archives: SAP PO SOAP API Tutorial

  • 0

Cómo conectar SAP PO que se ejecuta sobre NetWeaver 7.50 con el adaptador XML de OpenText

Category:Programación,SAP,SAP PI/PO Tags : 

Introducción

En el panorama digital actual, las empresas dependen en gran medida de la integración fluida entre plataformas para mantener la agilidad, optimizar las operaciones e impulsar las iniciativas de transformación digital. SAP Process Orchestration (SAP PO) es un software de integración integral que permite la sincronización de procesos y datos entre numerosas aplicaciones SAP y de terceros. Una de las posibilidades de integración consiste en conectar SAP PO con la API SOAP de OpenText para facilitar una gestión documental eficiente.

OpenText es una empresa líder en gestión de información empresarial, reconocida por sus sólidas soluciones, incluyendo su API SOAP, que proporciona funcionalidades para la gestión documental. La integración de SAP PO con la API SOAP de OpenText permite a las organizaciones lograr una conexión optimizada entre sus procesos de negocio y sus sistemas de gestión documental, mejorando así el acceso a información y documentos esenciales.

Antes de emprender este proceso de integración, es fundamental abordar varias consideraciones clave, como los mecanismos de autenticación, la asignación de formatos de mensajes y el manejo de errores. Dado que SOAP (Simple Object Access Protocol) se basa en protocolos de mensajería XML, dominar estos elementos es crucial para una integración segura y exitosa. Este artículo le guiará a través de los pasos esenciales para establecer una conexión segura con la API SOAP de OpenText y le brindará información sobre cómo autenticar usuarios y administrar documentos de manera eficaz.

Meta

El objetivo de este artículo es guiar a las empresas en la conexión de un sistema heredado a OpenText mediante SAP PO y en la generación de un único punto de acceso que encapsule múltiples solicitudes a los diferentes servicios que ofrece OpenText. De esta forma, las organizaciones pueden optimizar sus procesos de gestión documental, reducir la complejidad y mejorar la eficiencia de sus operaciones.

El primer paso para lograr la integración de ambos sistemas será establecer una conexión segura y confiable entre SAP PO y la API SOAP de OpenText, lo que requiere mecanismos de autenticación robustos.

En este caso, profundizaremos en la autenticación básica. Comprender esta metodología es fundamental para proteger sus datos y garantizar que solo accedan las personas autorizadas.

iFlow_AuthenticateUser.png

Una vez autenticado, el núcleo de la integración reside en el uso de las funcionalidades de gestión documental que ofrece la API SOAP de OpenText. Esta sección ofrece una guía paso a paso sobre cómo configurar SAP PO para interactuar con las funcionalidades de gestión documental de OpenText.

Para simplificar, la arquitectura básica se estructurará de esta manera.

iFlow_DocumentManagement.png

Se presenta una única interfaz al sistema heredado, que luego se divide dentro de SAP PI para interactuar con múltiples interfaces en función de una etiqueta personalizada denominada método.

iFlow_InterfaceSplit.png

Paso 1 .

Generar un único tipo de dato con una estructura común para los servicios que se consolidarán en uno solo.

Se utilizará el siguiente tipo de datos como solicitud.

Captura de pantalla 2024-09-26 183556 - Editado.png

Y este tipo de datos se utilizará para la respuesta.

DT_OpenText_Response.png

El proceso de transformación implica el uso de varias transformaciones de mapeo gráfico y XSLT para lograr el objetivo de obtener un único punto de entrada para todos los servicios expuestos, con los mapeos gráficos que permiten incluir transformaciones y validaciones para detectar el tipo de datos recibidos. 

Paso 2 

Defina las asignaciones gráficas de mensajes para la solicitud y la respuesta, una para cada interfaz de servicio entrante definida.

Captura de pantalla 2024-09-26 183908 - Editado.png
Captura de pantalla 2024-09-26 183950 - Editado.png

Paso 3

En la representación gráfica de la respuesta, agregue funciones Java personalizadas para identificar y establecer el tipo de datos de los valores que se devuelven; las funciones personalizadas deben estar integradas dentro de la representación gráfica y llamarse como funciones personalizadas.

Esta función personalizada recibe 5 parámetros de entrada que son devueltos por el método `get node` de OpenText, evalúa el tipo de datos del valor y devuelve un único texto con la descripción del tipo. El objetivo es reducir la complejidad de la lógica en el sistema heredado.

Captura de pantalla 2024-09-26 184244 - Editado.png

Aquí está el código Java de la función personalizada.

Captura de pantalla 2024-09-26 184029 - Editado.png

Además, se desarrolló otra función personalizada para validar el tipo de datos de cualquier valor devuelto en la etiqueta Valores.

Captura de pantalla 2024-09-26 184305 - Editado.png
Captura de pantalla 2024-09-26 184215 - Editado.png

Paso 4

Construye las transformaciones XSLT para adaptar la estructura a los servicios de OpenText; esto agregará los espacios de nombres correspondientes, eliminará las etiquetas innecesarias y generará los padres cuando sea necesario.

Captura de pantalla 2024-09-26 183722 - Editado.png
Captura de pantalla 2024-09-26 183747 - Editado.png
Captura de pantalla 2024-09-26 183807.png

Paso 5.

Construya el mapeo de operaciones que se encargará de llamar secuencialmente al mapeo de mensajes gráficos y a las transformaciones XSLT, este mapeo de operaciones tendrá un paso para la solicitud y otro para la respuesta considerando el proceso definido como síncrono.

El lado de la solicitud primero llamará al mapeo gráfico y luego utilizará la transformación XSLT.

Captura de pantalla 2024-09-26 184651 - Editado.png

El lado de respuesta llamará a la transformación XSLT que adaptará la estructura, luego agregará el espacio de nombres y finalmente utilizará el mapeo gráfico donde se encuentran las funciones Java personalizadas.

Captura de pantalla 2024-09-26 184711 - Editado.png

Una vez completados todos los pasos y creado e implementado el iFlow, el servicio podrá probarse mediante SOAP UI.

Conclusión

Este enfoque permite generar un único punto final para consumir algunos métodos específicos de la implementación de OpenText, lo que permite obtener una estructura homogénea en la respuesta, pero requerirá cierto trabajo si se implementan nuevos métodos. Además, la arquitectura podría considerarse  ligeramente acoplada, ya que también podría requerirse mantenimiento, aunque no con frecuencia.

La arquitectura actual podría enfrentar varios desafíos para ser migrada a SAP Integration Suite que se ejecuta sobre BTP.



Archivos

Categorías