Mapeo y Transformación de Datos en SAP Cloud Integration

Resumen

Este webinar, presentado por Deimer Angulo de Logali Group, introduce los conceptos de mapeo y transformación de datos dentro de SAP Cloud Integration, una capacidad clave de SAP Integration Suite. Se explica cómo Integration Suite permite conectar diversos sistemas (SAP y no SAP, on-premise y cloud) y se destaca Cloud Integration para realizar las integraciones. La sesión se enfoca en el Message Mapping para modificar la estructura y contenido de los mensajes entre sistemas con formatos distintos y en las Script Collections (usando Groovy Script o JavaScript) como artefactos reutilizables para implementar lógica de transformación personalizada que va más allá de las herramientas estándar. Se realiza una demostración práctica que incluye la creación de artefactos (Package, Integration Flow, Script Collection, Message Mapping, Value Mapping), el despliegue de los mismos, y la ejecución de un flujo que consume un servicio Norwin (OData), transforma los datos mediante mapeo (concatenación) y Value Mapping (traducción de valores como país a código ISO), y maneja errores usando un script. Finalmente, se promociona el Master en SAP Integration Suite.

Puedes ver la clase gratuita sobre este tema en nuestro canal de YouTube, donde podrás escuchar al docente hablar sobre este tema y las explicaciones que tiene para darte. Ver video aquí.

Índice

1. Introducción y Contexto
2. SAP Integration Suite: Visión General
   2.1. Capabilidades Principales (Cloud Integration, API Management, Open Connectors)
3. Prerrequisitos: Suscripciones y Roles en BTP
4. Mapeo de Mensajes (Message Mapping)
5. Colecciones de Scripts (Script Collections)
   5.1. Lenguajes Soportados (Groovy Script, JavaScript)
   5.2. Flujo de Trabajo y Ventajas (Reutilización)
6. Entorno de Desarrollo y Demostración
   6.1. Entorno de Cloud Integration
   6.2. Entorno de Desarrollo de Scripts (Groovy IDE Externo y Editor Integrado)
   6.3. Creación de Paquete y Artefactos
7. Ejecución de la Demostración Práctica
   7.1. Demostración de Script Collection
   7.1.1. Creación y Carga de Scripts
   7.1.2. Despliegue del Artefacto Script Collection
   7.1.3. Consumo del Script desde un Integration Flow (Referencia Global)
   7.1.4. Tratamiento de Excepciones con Script
   7.2. Demostración de Mapeo y Transformación
   7.2.1. Creación del Artefacto Message Mapping
   7.2.2. Carga de Estructuras (Metadata Norwin OData)
   7.2.3. Uso de Funciones de Mapeo (Concatenación)
   7.2.4. Creación del Artefacto Value Mapping (Ej. País a Código ISO)
   7.2.5. Implementación de Value Mapping dentro de Message Mapping
   7.2.6. Configuración del Integration Flow (HTTPS Sender, OData Receiver)
   7.2.7. Prueba con Postman

Conceptos Clave

• SAP Integration Suite
• SAP Cloud Integration (Capabilidad)
• API Management (Capabilidad)
• Open Connectors (Capabilidad)
• Integration Advisor (Capabilidad)
• SAP Business Technology Platform (BTP)
• Roles de BTP (para Integration Suite y Cloud Integration)
• Mapeo de Mensajes (Message Mapping)
• Colecciones de Scripts (Script Collections)
• Groovy Script
• JavaScript
• Value Mapping
• Artefactos (Package, Integration Flow, Script Collection, Message Mapping, Value Mapping)
• Flujo de Integración (Integration Flow / iFlow)
• Despliegue (Deployment)
• Monitorización (Monitoring)
• Adaptadores (HTTPS, OData, Mail)
• Norwin (Servicio OData de ejemplo)
• Metadata (OData)
• Postman
• Transformación de Datos
• Integración Híbrida (Cloud/On-premise)
• PI/PO (Predecesor)

saphana

1. Introducción y Contexto

Este webinar, presentado por Deimer Angulo de Logali Group, se enfoca en el aprendizaje sobre mapeos y transformaciones de datos utilizando SAP Cloud Integration, una capacidad dentro de SAP Integration Suite.

saphana

2. SAP Integration Suite: Visión General

SAP Integration Suite es la solución de integración de SAP diseñada para conectar diversos sistemas, tanto SAP como no SAP, incluyendo aplicaciones móviles, sistemas on-premise, servicios gubernamentales, redes sociales y socios de negocio. Permite escenarios de integración híbrida (Cloud-OnPremise, OnPremise-Cloud) y se posiciona como la evolución de SAP PI/PO.

2.1. Capabilidades Principales (Cloud Integration, API Management, Open Connectors)

La suite incluye varias capacidades (capabilities):

• Cloud Integration: El núcleo para construir y ejecutar flujos de integración. Es la capabilidad central utilizada en este webinar.
• API Management: Para gestionar el ciclo de vida completo de las APIs (seguridad, políticas, analíticas).
• Open Connectors: Proporciona un catálogo de conectores pre-construidos para facilitar la conexión con aplicaciones de terceros (ej. Google Drive).
• Otras mencionadas brevemente: Integration Advisor.

saphana

3. Prerrequisitos: Suscripciones y Roles en BTP

Para trabajar con Cloud Integration dentro de SAP Integration Suite en SAP BTP, se requieren suscripciones a los servicios correspondientes y la asignación de roles específicos al usuario. Para Integration Suite general, se necesita un rol de configuración básica. Para la capabilidad de Cloud Integration, se necesitan los roles específicos de PI (Administrador, Business Expert, Desarrollador de Integraciones, Lector). Estos roles se verifican y asignan en la sección de Seguridad > Usuarios de la subcuenta de BTP.

saphana

4. Mapeo de Mensajes (Message Mapping)

El Message Mapping es una funcionalidad clave en Cloud Integration que permite modificar la estructura y el contenido de los mensajes durante un proceso de integración. Es esencial cuando los sistemas de origen y destino tienen formatos de datos similares pero con etiquetas o estructuras distintas (ej. “empleado” vs “usuario”). El mapeo se realiza dentro de un Integration Flow (iFlow) o como un artefacto reutilizable, transformando los datos del mensaje de origen al formato requerido por el sistema de destino. El editor de mapeo visual permite conectar campos de la estructura fuente a la estructura destino y utilizar expresiones y funciones (aritméticas, booleanas, de cadena, scripts) para transformaciones complejas.

saphana

5. Colecciones de Scripts (Script Collections)

Las Script Collections son artefactos reutilizables en Cloud Integration que contienen código personalizado para realizar transformaciones o lógica de procesamiento que no se puede lograr fácilmente con los elementos estándar del iFlow.

5.1. Lenguajes Soportados (Groovy Script, JavaScript)

Los lenguajes soportados para escribir estos scripts son Groovy Script y JavaScript.

5.2. Flujo de Trabajo y Ventajas (Reutilización)

El flujo de trabajo típico implica:

1. Crear el artefacto Script Collection.
2. Añadir o cargar los scripts (Groovy o JavaScript).
3. Desplegar (Deploy) el artefacto Script Collection.
4. Implementar o referenciar el script desde uno o más Integration Flows.
5. Monitorizar su ejecución.

La principal ventaja sobre escribir scripts directamente dentro de un iFlow (scripts locales) es la reutilización. Un script en una colección desplegada puede ser consumido por múltiples iFlows, incluso si pertenecen a paquetes de integración diferentes (dentro del mismo tenant), promoviendo la eficiencia y mantenibilidad. Es crucial recordar que, al ser artefactos, las Script Collections deben ser desplegadas independientemente del iFlow que las consume

saphana

6. Entorno de Desarrollo y Demostración

6.1. Entorno de Cloud Integration

Se utiliza la interfaz web de Cloud Integration accesible desde BTP para diseñar, configurar, desplegar y monitorizar los artefactos de integración.

6.2. Entorno de Desarrollo de Scripts (Groovy IDE Externo y Editor Integrado)

Se menciona la posibilidad de usar un IDE externo específico para Groovy que permite probar scripts offline con mensajes de entrada, cabeceras y propiedades simuladas. Sin embargo, Cloud Integration también proporciona un editor integrado dentro del artefacto Script Collection para crear y modificar scripts directamente.

6.3. Creación de Paquete y Artefactos

Se explica la necesidad de crear un Paquete de Integración (Package) como contenedor para los artefactos. Los artefactos son los componentes individuales de la integración, tales como:

• Integration Flow (iFlow)
• Script Collection
• Message Mapping
• Value Mapping
• Otros (OData Service, REST API, etc.)

Se diferencia entre artefactos editables y configurables (ej. paquetes estándar de SAP).

saphana

7. Ejecución de la Demostración Práctica

7.1. Demostración de Script Collection

• 7.1.1. Creación y Carga de Scripts: Se crea un artefacto Script Collection y se cargan/crean scripts (Groovy y JavaScript de ejemplo).
• 7.1.2. Despliegue del Artefacto Script Collection: Se enfatiza la necesidad de desplegar este artefacto para que pueda ser consumido. Se muestra cómo un iFlow falla si intenta consumir un script de una colección no desplegada.
• 7.1.3. Consumo del Script desde un Integration Flow (Referencia Global): Se crea un iFlow en un paquete diferente. Se añade una referencia global a la Script Collection desplegada. Se utiliza un elemento Groovy Script en el iFlow y se configura para ejecutar una función específica del script referenciado (ej. suma, multiplicacion).
• 7.1.4. Tratamiento de Excepciones con Script: Se configura un subproceso de excepción en el iFlow. Se induce un error (XML mal formado). Se demuestra cómo el script en el subproceso de excepción se activa y procesa el error (ej. creando un log o enviando un correo).

7.2. Demostración de Mapeo y Transformación

• 7.2.1. Creación del Artefacto Message Mapping: Se crea un artefacto Message Mapping reutilizable.
• 7.2.2. Carga de Estructuras (Metadata Norwin OData): Se descarga la metadata del servicio público Norwin OData y se carga en el artefacto Message Mapping para definir las estructuras de origen y destino (usando la entidad Orders). Se muestra cómo generar un XSD específico de una entidad desde el adaptador OData.
• 7.2.3. Uso de Funciones de Mapeo (Concatenación): Se mapean campos básicos (Order ID, Customer ID). Se utiliza la función Concatenate para combinar varios campos de dirección de la fuente (dirección, ciudad, código postal) en un solo campo de destino, usando delimitadores.
• 7.2.4. Creación del Artefacto Value Mapping: Se crea un artefacto Value Mapping para definir mapeos específicos de valores (ej. Nombre del país a Código ISO). Se muestra cómo importarlo desde un archivo o crearlo manualmente.
• 7.2.5. Implementación de Value Mapping dentro de Message Mapping: En el Message Mapping, se utiliza la función Value Mapping para conectar el campo Country de la fuente al destino. Se configuran las agencias y los identificadores de origen/destino para usar el Value Mapping previamente creado y desplegado.
• 7.2.6. Configuración del Integration Flow (HTTPS Sender, OData Receiver): Se configura un iFlow que recibe una petición HTTPS, llama al servicio Norwin OData para obtener una orden específica (filtrando por ID pasado en cabecera), aplica el Message Mapping (que incluye el Value Mapping) y devuelve el resultado transformado.

7.2.7. Prueba con Postman: Se utiliza Postman para enviar una petición GET al endpoint HTTPS del iFlow, pasando el ID de la orden en una cabecera y las credenciales de BTP (Service Key). Se verifica que la respuesta contiene los datos mapeados y transformados según lo definido (dirección concatenada, código ISO del país).

Conclusión

SAP Cloud Integration ofrece potentes herramientas para la transformación y el mapeo de datos, esenciales en escenarios de integración complejos. El Message Mapping proporciona una forma visual y funcional de adaptar estructuras de mensajes, mientras que las Script Collections (Groovy/JavaScript) brindan flexibilidad para lógica personalizada y reutilizable. Comprender y aplicar correctamente estos artefactos, junto con el Value Mapping, es fundamental para construir flujos de integración robustos y eficientes dentro de SAP Integration Suite.

Recomendación de Curso

Basado en el contenido del texto, el curso más relevante de Logali Group es el Master en SAP Integration Suite. Ver aquí.

• Justificación: El webinar actúa como una introducción a temas específicos (Message Mapping, Script Collections, Value Mapping) que son parte integral de SAP Cloud Integration. El propio presentador menciona explícitamente que estos temas se tratan en profundidad en el Master en SAP Integration Suite (Clase 6), el cual abarca además otras capacidades de la suite y prepara para la certificación oficial.

Clasificación y Etiquetado

• Clasificación (una sola): SAP BTP
• Etiquetas (hasta cinco): SAP, BTP, Cloud, desarrollo, Interface