Ir al contenido principal

Conexión a S/4HANA Cloud Public Edition mediante OData V4

SAP S/4HANA Cloud Public Edition no admite la importación del dab RFC Add-On para este método de conexión. En su lugar, configure el acceso a través de las aplicaciones de comunicación en el launchpad SAP Fiori. Esto requiere un usuario de comunicación, un sistema de comunicación que represente el entorno Nexus, y una disposición de comunicación para el escenario de comunicación requerido.

Una vez completada la configuración en SAP, configure el endpoint OData V4 proporcionado por el tenant objetivo en dab Nexus como una conexión OData Communication. Nexus no proporciona un catálogo de servicios para seleccionar automáticamente fuentes en este escenario de Public Cloud.

Requisitos previos​

Verificar el SAP System​

Confirme el producto, edición, release y tenant objetivo utilizando Identificar SAP System. No determine el modelo operativo solo a partir del hostname o el launchpad Fiori.

SAP ECC, S/4HANA local, Private Cloud y Public Edition emplean diferentes modelos de conexión y administración. Marque los valores desconocidos como no confirmados y verifíquelos con el administrador de SAP.

Verificar el entorno Nexus​

  • Consulte la versión instalada en Configuración → Licencia y soporte. Confirme que OData Communication está disponible.
  • Asegúrese de que pueda alcanzar el host de la API de SAP por HTTPS en el puerto TCP 443 y valide su certificado TLS.

Habilite el catálogo de servicios​

El escenario de comunicación SAP_COM_0181 es obligatorio porque habilita el acceso al catálogo de servicios de SAP que utiliza Nexus.

Cree y mantenga una disposición de comunicación para:

SAP_COM_0181

Asigne el sistema de comunicación y el usuario de comunicación destinados a la integración Nexus.

Importante

SAP_COM_0181 es un requisito absoluto para la conexión OData V4 de Nexus porque habilita el catálogo de servicios. No reemplaza el escenario de comunicación requerido por la fuente de datos. Por ejemplo, una fuente CDI_CDS requiere además SAP_COM_0531 y la disposición de comunicación correspondiente.

Descripción general del proceso​

  1. Seleccionar la fuente y el escenario de comunicación.
  2. Para CDI_CDS, configurar la lista de autorización CDS (allowlist) y el grupo de autorización.
  3. Crear el usuario de comunicación y el sistema de comunicación.
  4. Crear la disposición de comunicación.
  5. Determinar la ruta del conjunto de entidades (entity-set).
  6. Crear, probar y registrar la conexión Nexus.
  7. Crear un paquete para la fuente añadida en Package Studio y ejecutar una extracción de prueba.

1. Seleccionar la fuente y el escenario de comunicación​

Obtenga un registro de referencia conocido con su clave completa y los valores de campo esperados. Utilícelo para validar tanto la conexión como la extracción.

FuenteVerificaciónEscenario de comunicación
CDI_CDSLocalice la fuente en View Browser. Verifique sus campos, claves, compatibilidad con extracción y capacidad delta para la versión objetivo.SAP_COM_0531
Business APIBusque una API OData V4 publicada para Public Edition en SAP Business Accelerator Hub. Compruebe las entidades requeridas, los campos y la versión de la API.Scenario ID especificado en la documentación de la API
Danger

Un servicio usado por una aplicación Fiori no se publica automáticamente para integración externa.

Para Business API:

  • No aplica la lista de autorización CDI.
  • SAP_COM_0531 no es automáticamente el escenario correcto.
  • SAP_COM_0532 no sustituye el acceso CDI OData descrito aquí.
  • Se requiere la disposición de comunicación específica de la fuente, aparte de la disposición del catálogo de servicios para SAP_COM_0181.

Vistas CDS personalizadas de Key User​

En la aplicación Custom CDS Views, confirme que la vista utiliza el escenario Data Extraction, supera su verificación y está publicada. Esta vía para key users es distinta de las vistas CDS Z* creadas por desarrolladores; no asuma que se pueden agregar anotaciones de extracción ABAP arbitrarias en objetos personalizados en Public Edition. SAP documenta extracción total sin delta para este tipo de fuente key user en SAP KBA 2884410 en SAP for Me. Esta restricción no aplica automáticamente a los extractores estándar de SAP.

Para comprobaciones interedición—incluyendo acceso al catálogo de servicios, descubrimiento de proveedor CDI, metadatos y resolución de problemas Package Studio—consulte Solución de problemas SAP OData V4 CDS Views que faltan en Package Studio.

2. Configurar la lista de autorización CDS (allowlist) y el grupo de autorización​

Realice esta sección solo para CDI_CDS. Para una Business API, continúe en 3. Crear el usuario de comunicación.

Si no puede acceder a la actividad de configuración, el responsable de la configuración Cloud de SAP debe finalizar esta preparación.

2.1 Abrir la actividad de configuración​

Busque Definir listas de autorización para extracción de vistas CDS mediante una de estas rutas.

Gestionar su solución​

  1. Abra Gestionar su solución → Configurar su solución.
  2. Aplique estos filtros:
    • Área de la aplicación: Application Platform and Infrastructure
    • Subárea de la aplicación: Data Extraction
  3. Abra el resultado correspondiente.
  4. Seleccione Configurar para el paso de configuración.

SAP Central Business Configuration​

Busque el nombre de la actividad en:

Configuration Activities
→ General Settings
→ Further Settings

Dependiendo de la interfaz, la actividad puede aparecer directamente bajo Configuración.

2.2 Crear el grupo de autorización y la lista de autorización​

  1. Seleccione Nuevas entradas.
  2. Ingrese un ID de grupo de autorización único.
  3. Ingrese una descripción significativa.
  4. Seleccione Explicit allow list como tipo.
  5. Añada las fuentes CDS requeridas a la lista del grupo.
  6. Guarde la configuración.
  7. Seleccione el transporte de Customizing correspondiente.
  8. Registre el ID del grupo de autorización para la disposición de comunicación específica de la fuente.
  9. Si el tenant objetivo es distinto, confirme que el grupo y sus entradas también están disponibles allí.

2.3 Actividad de lista de autorización no disponible​

Si falta la actividad, solicite al responsable de la configuración que verifique si el elemento de alcance Data Protection and Privacy (5LE) está activo. SAP KBA 3781796 en SAP for Me describe la falta de activación de este elemento como causa. Tras la activación, busque de nuevo la actividad.

3. Crear el usuario de comunicación​

  1. Abra Maintain Communication Users.
  2. Cree un usuario de comunicación dedicado para Nexus, o abra el usuario existente designado para esta integración.
  3. Configure el método de autenticación requerido por el servicio.

Usuario y contraseña​

  • Defina la contraseña para el usuario de comunicación.
  • Transfiera la contraseña sólo a través del proceso aprobado de gestión de secretos.
  • Guárdela luego en la conexión de Nexus.

Certificado de cliente​

  • Asigne el certificado público de cliente al usuario de comunicación.
  • Nexus también requerirá la clave privada asociada.
  • Entregue a Nexus un archivo .p12 que contenga el certificado de cliente y la clave privada.
  • Guarde y transfiera la contraseña del archivo por separado del archivo de certificado.
  1. Guarde el usuario.
  2. Registre su identidad para el sistema de comunicación.
nota

El usuario de comunicación no es la cuenta personal utilizada para acceder al launchpad Fiori. Su usuario Fiori configura la integración, mientras que Nexus llama al servicio usando el usuario de comunicación o su certificado. Un inicio de sesión exitoso en Fiori no valida, por tanto, la autenticación de Nexus.

4. Crear el sistema de comunicación para Nexus​

  1. Abra Communication Systems.
  2. Cree un sistema para el entorno Nexus relevante.
  3. Asigne un ID de sistema único y un nombre significativo, por ejemplo: DAB_NEXUS_PROD.
  4. En Host Name, ingrese el nombre del host de la instalación Nexus o Managed App correspondiente.
  5. Ingrese solo el hostname, sin esquema ni camino URL.
  6. En Usuarios para comunicación entrante, añada el usuario de comunicación creado en 3. Crear el usuario de comunicación.
  7. Seleccione su método de autenticación.
  8. Guarde el sistema de comunicación y verifique la asignación del usuario.

En este contexto, entrante (inbound) significa que Nexus envía solicitudes a SAP.

Danger

El sistema de comunicación representa Nexus como socio de comunicación. Su Host Name no es el host de la API de SAP usado como Nexus Base URL. Obtenga la URL de SAP API desde los servicios entrantes de la disposición de comunicación.

Utilice sistemas de comunicación separados si DEV, QA y PROD emplean entornos Nexus o identidades técnicas distintas.

5. Crear las disposiciones de comunicación​

Pueden requerirse al menos dos disposiciones de comunicación. Cree las siguientes disposiciones:

  1. Una disposición para el catálogo de servicios para SAP_COM_0181.
  2. Una disposición específica para SAP_COM_0531 o el escenario de comunicación documentado para la Business API seleccionada.

5.1 Crear la disposición para el catálogo de servicios​

  1. Abra Communication Arrangements.
  2. Seleccione Nuevo.
  3. Seleccione el escenario de comunicación:
    SAP_COM_0181
  4. Ingrese un nombre significativo para la disposición.
  5. Seleccione el sistema de comunicación Nexus creado en 4. Crear el sistema de comunicación para Nexus.
  6. En Comunicación entrante, verifique:
    • el usuario de comunicación asignado,
    • el método de autenticación configurado.
  7. Guarde la disposición.
  8. Abra Servicios entrantes y confirme el acceso ofrecido al catálogo de servicios.
Importante

La disposición SAP_COM_0181 habilita el catálogo de servicios. No autoriza acceso a las entidades de la fuente de datos seleccionada.

5.2 Crear la disposición específica de la fuente​

  1. Abra Communication Arrangements.
  2. Seleccione Nuevo.
  3. Seleccione el escenario identificado en 1. Seleccionar la fuente y escenario de comunicación:
    • para CDI: SAP_COM_0531,
    • para Business API: el ID de escenario de comunicación documentado.
  4. Ingrese un nombre para la disposición.
  5. Seleccione el sistema de comunicación Nexus creado en 4. Crear el sistema de comunicación para Nexus.
  6. En Comunicación entrante, verifique:
    • el usuario de comunicación asignado,
    • el método de autenticación configurado.
  7. Para CDI, ingrese el ID de grupo de autorización creado en 2.2 Crear el grupo de autorización y lista de autorización bajo Propiedades adicionales → Authorization Group ID.
  8. Guarde la disposición.
  9. Acceda a Servicios entrantes.
  10. Copie las URLs mostradas para el tenant objetivo.

Errores comunes de configuración​

Se debe mantener el grupo de autorización​

Verifique que:

  • el ID del grupo de autorización fue ingresado exactamente,
  • el grupo existe en el tenant objetivo,
  • las fuentes CDS requeridas están incluidas en su lista de autorización.

SAP KBA 3118974 en SAP for Me describe este error.

El catálogo de servicios no está disponible​

Verifique que:

  • existe una disposición de comunicación para SAP_COM_0181,
  • el sistema de comunicación correcto está asignado,
  • el usuario de comunicación requerido está asignado,
  • el método de autenticación configurado coincide con la conexión Nexus.

No use la disposición específica de la fuente como sustituto de SAP_COM_0181.

El servicio requerido no se ofrece​

Compare:

  • el escenario de comunicación seleccionado,
  • la versión de la API,
  • la versión de SAP Cloud,
  • la documentación específica de la versión de SAP.

No sustituya un escenario no relacionado solo porque contenga un servicio de nombre similar.

6. Determinar la ruta específica del conjunto de entidades​

6.1 CDI_CDS​

Consultar el directorio de proveedores​

Utilice el usuario de comunicación para llamar al directorio de proveedores CDI a través del endpoint CDI de la disposición. SAP documenta este patrón:

https://<SAP-API-Host>/sap/opu/odata4/sap/cdi/default/sap/cdi/0001/Providers
  1. Busque el nombre técnico del extractor identificado en 1. Seleccionar la fuente y el escenario de comunicación. Para una vista CDS clásica, puede ser el nombre de la vista SQL generada más su sufijo de categoría; por ejemplo, CMMPURORDHIST$F es un extractor de hechos/transacciones. Para una CDS view entity, utilice el nombre de la entidad CDS.
  2. El nombre del extractor no es la URL del proveedor CDI. No construya una URL a partir de él; copie la URL del proveedor retornada por SAP. Consulte la Guía de resolución de problemas CDI_CDS para ejemplos de nombres y detalles.
  3. Siga cada página @odata.nextLink retornada.
  4. Copie la URL del proveedor ofrecida por el tenant objetivo.
  5. No construya una ruta CDI_CDS solo a partir del nombre de la vista.

Verificar el servicio y los metadatos​

Llame a:

  • el documento de servicio en la raíz del servicio, incluyendo el / final,
  • el documento de metadatos en service root + /$metadata.

Verifique:

  • el entity set Facts,
  • los campos requeridos,
  • la clave completa,
  • los tipos de campo, monedas y unidades.

Un proveedor ofrecido por el tenant objetivo puede, por ejemplo, devolver estas rutas:

Service root: /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/c_billingdocitembasicdex_1/0001/
Metadata: /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/c_billingdocitembasicdex_1/0001/$metadata
Entity set: /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/c_billingdocitembasicdex_1/0001/Facts

Sustituya este ejemplo por la URL del proveedor retornada por el tenant objetivo. Providers es usado para el descubrimiento de fuentes. La URL del proveedor retornada por el tenant objetivo debe agregarse en la configuración Nexus durante la instalación.

Si el proveedor está ausente, o aparece en SAP pero no en Package Studio, consulte la Guía de resolución de problemas CDI_CDS.

6.2 Business API​

  1. Copie la raíz del servicio desde Inbound Services en la disposición de comunicación correspondiente.
  2. Llame al documento de servicio.
  3. Llame a /$metadata.
  4. Identifique el conjunto de entidades requerido, los campos y la clave completa.
  5. Utilice el nombre publicado del conjunto de entidades con la capitalización documentada.
nota

Facts no es un sufijo genérico para Business APIs. Utilice el nombre del conjunto de entidades que declara la metadata de la API específica.