Consulta los conectores compatibles con Application Integration.

Activador de SAP Gateway

El activador de SAP Gateway es un activador de eventos de conector. El conector de SAP Gateway te permite realizar operaciones de inserción, eliminación, actualización y lectura en datos de SAP Gateway.

Antes de empezar

  • Si tienes previsto crear o configurar una conexión para el activador de SAP Gateway, asegúrate de tener el siguiente rol de gestión de identidades y accesos en el proyecto:
    • Administrador del conector (roles/connectors.admin)

      • Para obtener información sobre cómo conceder roles, consulta el artículo sobre cómo gestionar el acceso.

  • Concede los siguientes roles de gestión de identidades y accesos a la cuenta de servicio que quieras usar para el activador de SAP Gateway:
    • Invocador de integración de aplicaciones (roles/integrations.integrationInvoker)

      • Para obtener información sobre cómo conceder roles a una cuenta de servicio, consulta el artículo sobre cómo gestionar el acceso a cuentas de servicio.

    • Añadir el activador de SAP Gateway

    Para añadir un activador de SAP Gateway a tu integración, sigue estos pasos:

    1. En la Google Cloud consola, ve a la página Integración de aplicaciones.

      Ir a Application Integration

    2. En el menú de navegación, haga clic en Integraciones.

      Aparecerá la página Lista de integraciones, donde se muestran todas las integraciones disponibles en el proyecto de Google Cloud.

    3. Seleccione una integración o haga clic en Crear integración para crear una.

      Si vas a crear una integración:

      1. Escribe un nombre y una descripción en el panel Crear integración.
      2. Selecciona una región para la integración.
      3. Selecciona una cuenta de servicio para la integración. Puede cambiar o actualizar los detalles de la cuenta de servicio de una integración en cualquier momento desde el panel Resumen de la integración de la barra de herramientas de integración.
      4. Haz clic en Crear.

      La integración que acabas de crear se abre en el editor de integraciones.

    4. En la barra de navegación del editor de integraciones, haga clic en Activadores para ver la lista de activadores disponibles.
    5. Haz clic en el elemento Activador de SAP Gateway y colócalo en el editor de integraciones.

      6. Para configurar el activador de SAP Gateway, puedes usar una conexión de SAP Gateway que ya tengas en Integration Connectors o crear una con la opción de creación de conexiones insertada.

    Configurar un activador de SAP Gateway con una conexión existente

    El activador de SAP Gateway es un activador de evento de conector, por lo que solo puedes usar una conexión de SAP Gateway con la suscripción a eventos habilitada para configurar el activador.

    Para obtener información sobre cómo configurar un activador de SAP Gateway con una nueva conexión de SAP Gateway, consulta Configurar un activador de SAP Gateway con una nueva conexión.

    Para configurar un desencadenador de SAP Gateway con una conexión de SAP Gateway, sigue estos pasos:

    1. En el editor de integraciones, haz clic en el elemento Activador de SAP Gateway para abrir el panel de configuración del activador.
    2. Haz clic en Configurar activador.
    3. En la página Editor de activadores de eventos de conector, proporcione los siguientes detalles de configuración:
      1. Región: selecciona la región de tu conexión de SAP Gateway.
      2. Conexión: selecciona la conexión de SAP Gateway que quieras usar.

        Integración de aplicaciones solo muestra las conexiones de SAP Gateway que están activas y tienen habilitada una suscripción a eventos.

      3. Escriba el nombre del campo de tipo de evento. Este campo identifica el tipo de evento asociado a la solicitud de evento entrante. 
        {
    "event_type": "user.created",
    ...
    // other request fields
    ...
    }
      4. Cuenta de servicio: selecciona una cuenta de servicio con los roles de gestión de identidades y accesos necesarios para el activador de SAP Gateway.
    4. Haz clic en Hecho para completar la configuración del activador y cerrar la página.

    Configurar un activador de SAP Gateway con una conexión nueva

    1. En el editor de integraciones, haz clic en el elemento Activador de SAP Gateway para abrir el panel de configuración del activador.
    2. Haz clic en Configurar activador.
    3. Omite el campo Región.
    4. Haz clic en Conexión y selecciona la opción Crear conexión en el menú desplegable.
    5. En la sección Detalles de la conexión, haz lo siguiente:
      1. Conector: seleccione SAP Gateway en la lista desplegable de conectores disponibles.
      2. Versión del conector: seleccione la versión del conector en la lista desplegable de versiones disponibles.
      3. En el campo Connection Name (Nombre de conexión), introduce un nombre para la instancia de conexión.

        Los nombres de las conexiones deben cumplir los siguientes criterios:

        • Los nombres de conexión pueden contener letras, números o guiones.
        • Las letras deben estar en minúsculas.
        • Los nombres de conexión deben empezar por una letra y terminar por una letra o un número.
        • Los nombres de conexión no pueden tener más de 49 caracteres.
        • En el caso de los conectores que admiten la suscripción a eventos, los nombres de conexión no pueden empezar por el prefijo "goog".
      4. Si quiere, puede introducir una Descripción para la instancia de conexión.
      5. Cuenta de servicio: selecciona una cuenta de servicio que tenga los roles necesarios.
      6. Para usar la conexión en las suscripciones a eventos, selecciona Habilitar suscripción a eventos. Si seleccionas esta opción, se mostrarán las siguientes:
        • Habilitar la suscripción a eventos con entidades y acciones: selecciona esta opción para usar la conexión tanto para la suscripción a eventos como para las operaciones del conector (entidades y acciones).
        • Habilitar solo la suscripción a eventos: selecciona esta opción para usar la conexión solo para la suscripción a eventos. Si seleccionas esta opción, haz clic en Siguiente y, a continuación, configura la suscripción a eventos.
      7. Espacio de nombres: especifica el espacio de nombres del servicio del que quieres obtener datos. Es obligatorio si el servicio no se especifica en la URL.
      8. Servicio: especifica el servicio del que quieras obtener datos. Es obligatorio si el servicio no se especifica en la URL.
      9. CustomUrlParams: especifica los parámetros de cadena de consulta personalizados que se incluyen en la solicitud HTTP. Los parámetros deben codificarse como una cadena de consulta con el siguiente formato: field1=value1&field2=value2. Los valores de la cadena de consulta deben estar codificados como URL.
      10. Formato de datos: el formato de datos en el que se recuperarán los datos. Selecciona XML o JSON.
      11. Usar nombres visibles: valor booleano que determina si se deben usar etiquetas de SAP.
      12. Si quieres, configura los ajustes del nodo de conexión:

        • Número mínimo de nodos: introduce el número mínimo de nodos de conexión.
        • Número máximo de nodos: introduce el número máximo de nodos de conexión.

        Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se necesitan más nodos para procesar más transacciones en una conexión y, a la inversa, se necesitan menos nodos para procesar menos transacciones. Para saber cómo influyen los nodos en el precio de tu conector, consulta la sección Precios de los nodos de conexión. Si no introduces ningún valor, de forma predeterminada, el número mínimo de nodos se establece en 2 (para mejorar la disponibilidad) y el máximo en 50.

      13. También puedes hacer clic en + AÑADIR ETIQUETA para añadir una etiqueta a la conexión en forma de par clave-valor.
      14. Haz clic en SIGUIENTE.
    6. En la sección Destinations (Destinos), define la URL de tu entorno de SAP Gateway o la URL completa del servicio OData. Por ejemplo, el formato ${ENVIRONMENT_URL}/sap/opu/odata/${NAMESPACE}/${SERVICE}/ y la URL de ejemplo https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/. Añada las propiedades adicionales que quiera con la propiedad CustomUrlParams.
      1. Tipo de destino: selecciona un Tipo de destino.
        • Para especificar el nombre de host o la dirección IP de destino, selecciona Dirección de host y introduce la dirección en el campo Host 1.
        • Para establecer una conexión privada, selecciona Endpoint attachment (Endpoint adjunto) y elige el adjunto que quieras de la lista Endpoint Attachment (Endpoint adjunto).

        Si quieres establecer una conexión pública con tus sistemas backend con seguridad adicional, puedes configurar direcciones IP de salida estáticas para tus conexiones y, a continuación, configurar las reglas de tu cortafuegos para que solo se permitan las direcciones IP estáticas específicas.

        Para introducir más destinos, haga clic en +AÑADIR DESTINO.

      2. Haz clic en SIGUIENTE.
    7. En la sección Autenticación, introduce los detalles de autenticación.
      1. Seleccione un Tipo de autenticación e introduzca los detalles pertinentes.

        La conexión de SAP Gateway admite los siguientes tipos de autenticación:

        • Nombre de usuario y contraseña
        • Anónimo
        • Flujo de código de autorización de OAuth 2.0
        • SAP BTP (OAuth 2.0: credenciales de cliente)

        2. Para saber cómo configurar estos tipos de autenticación, consulta Configurar la autenticación.

      2. Haz clic en SIGUIENTE.
    8. Revisar: revisa los detalles de la conexión y la autenticación.
    9. Haz clic en Crear.

    Configurar la autenticación

    Introduce los detalles en función de la autenticación que quieras usar.

    • Nombre de usuario y contraseña
      • Nombre de usuario: nombre de usuario del conector.
      • Contraseña: secreto de Secret Manager que contiene la contraseña asociada al conector.
    • Anónimo

      Si quieres usar el inicio de sesión anónimo, selecciona No disponible.

      • Clave de API: la clave de API del usuario autenticado.
    • Flujo del código de autorización de OAuth 2.0
      • ID de cliente: introduce el ID de cliente obtenido en la página de cliente de la API.
      • Permisos: introduce una lista de permisos separados por comas.
      • Secreto de cliente: introduce el secreto de cliente obtenido en la página del cliente de la API.
      • Versión del secreto: introduce la versión del secreto seleccionado en Secreto de cliente.
      • URL de autorización: introduce la URL de autorización generada al crear un cliente de OAuth en tu instancia de SAP Gateway.
      • Habilitar invalidación de autenticación: selecciona esta opción para permitir que la conexión acepte una autenticación diferente de forma dinámica durante el tiempo de ejecución.
    • SAP BTP (OAuth 2.0 - credenciales de cliente)
      • ID de cliente: introduce el ID de cliente obtenido en la página de cliente de la API.
      • Secreto de cliente: introduce el secreto de cliente obtenido en la página del cliente de la API.
      • Versión del secreto: introduce la versión del secreto seleccionado arriba.
      • OAuthAccessTokenURL introduce la URL del token de acceso de OAuth.
      • Nombre de destino: introduce el nombre del destino de SAP BTP.
      • URL de destino: introduzca la URL de destino de SAP BTP.
      • Habilitar anulación de autenticación: selecciona esta opción para permitir que la conexión acepte una autenticación diferente de forma dinámica durante el tiempo de ejecución.

    Configurar la suscripción a eventos

    Si ha habilitado la suscripción a eventos, introduzca los siguientes valores en la sección Event Subscription Details (Detalles de la suscripción a eventos):

    1. Selecciona uno de los siguientes tipos de autenticación para el receptor de eventos.
    2. Escriba el nombre del campo de tipo de evento. Este campo identifica el tipo de evento asociado a la solicitud de evento entrante. 
      {
"event_type": "user.created",
...
// other request fields
...
}
    3. Selecciona Habilitar conectividad privada para establecer una conexión segura entre tu aplicación backend y tu conexión. Si seleccionas esta opción, debes seguir unos pasos de configuración adicionales después de crear la conexión. Para obtener más información, consulta Conectividad privada para la suscripción a eventos.
    4. Introduce la configuración de la cola de mensajes fallidos. Si configura mensajes fallidos, la conexión escribe los eventos no procesados en el tema de Pub/Sub especificado. Introduzca los siguientes detalles:
      1. ID de proyecto de mensajes fallidos: el ID del proyecto de Google Cloud en el que has configurado el tema de mensajes fallidos de Pub/Sub.
      2. Tema de mensajes fallidos: el tema de Pub/Sub en el que quieres escribir los detalles del evento no procesado.

    Configurar la autenticación en SAP

    Configura la autenticación en SAP siguiendo las instrucciones de la guía Información general sobre la autenticación de la edición local o en la nube del SDK de ABAP para Google Cloud.

    Validar el activador

    Para validar el activador, puedes crear un programa ABAP. A continuación, se muestra un programa ABAP de ejemplo que puedes usar como referencia. El campo ls_event_payload cambia en función de tus requisitos:

    *&---------------------------------------------------------------------*
*& Report ZR_TEST_INT_CONNECTOR
*&---------------------------------------------------------------------*
*&
*&---------------------------------------------------------------------*
REPORT zr_test_int_connector.
PARAMETERS: p_auth TYPE char1 RADIOBUTTON GROUP rbg1 USER-COMMAND uc DEFAULT 'X',
 p_apik TYPE char1 RADIOBUTTON GROUP rbg1.
DATA:
 lv_p_projects_id TYPE string,
 lv_p_locations_id TYPE string,
 lv_p_connections_id TYPE string,
 ls_input TYPE /goog/cl_connectors_v1=>ty_103.
TYPES: BEGIN OF event_payload,
 event_type TYPE string,
 event_id TYPE string,
 name TYPE string,
 org_id TYPE string,
 END OF event_payload.
DATA: ls_event_payload TYPE event_payload.
ls_event_payload = VALUE #(
 event_type = 'create-entity'
 event_id = '1'
 name = 'demo-org'
 org_id = 'SAP'
 ).
TRY.
 IF p_Auth = abap_true.
 DATA(lv_client_key) = 'IC_DEMO_GOOGLE_AUTH'.
 lv_p_connections_id = 'conn-event-triggers-from-sap-gateway'.
 ELSE.
 lv_client_key = 'IC_DEMO_GOOGLE_APIK'.
 lv_p_connections_id = 'conn-event-triggers-from-sap-gateway-apik'.
 ENDIF.
* Open HTTP Connection
 DATA(lo_client) = NEW /goog/cl_connectors_v1( iv_key_name = CONV #( lv_client_key ) ).
* Populate relevant parameters
 lv_p_projects_id = lo_client->gv_project_id.
 lv_p_locations_id = 'us-central1'.
 GET REFERENCE OF ls_event_payload INTO ls_input-payload .
* Call API method: connectors.projects.locations.connections.listenEvent
 CALL METHOD lo_client->listen_event_connections
 EXPORTING


iv_p_projects_id = lv_p_projects_id
 iv_p_locations_id = lv_p_locations_id
 iv_p_connections_id = lv_p_connections_id
 is_input = ls_input
 IMPORTING
* es_raw =
 es_output = DATA(ls_output)
 ev_ret_code = DATA(lv_ret_code)
 ev_err_text = DATA(lv_err_text)
 es_err_resp = DATA(ls_err_resp).
 IF lo_client->is_success( lv_ret_code ).
 MESSAGE 'Success' TYPE 'S'.
 ELSE.
 MESSAGE lv_err_text TYPE 'E'.
 ENDIF.
* Close HTTP Connection
 lo_client->close( ).
 CATCH /goog/cx_sdk INTO DATA(lo_exception).
 MESSAGE lo_exception->get_text( ) TYPE 'E'.
ENDTRY.

    Cuotas y límites

    Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.

    Siguientes pasos