Instala y configura ediciones locales o cualquier edición en la nube del SDK de ABAP para Google Cloud

En este documento, se muestra cómo instalar y configurar las ediciones locales o cualquier edición en la nube del SDK de ABAP para Google Cloud en tu sistema host de SAP en instancias de VM de Compute Engine, de forma local, en otro proveedor de servicios en la nube o en otro entorno fuera de Google Cloud.

Este documento está dirigido a los administradores de SAP, los administradores de Google Cloud y otros profesionales de seguridad de SAP y Google Cloud .

Descripción general

El SDK de ABAP para Google Cloud proporciona bibliotecas cliente para que los desarrolladores usen ABAP y accedan a las APIs de Google Cloud de manera programática. Encapsulando funciones esenciales como componentes reutilizables, estas bibliotecas cliente reducen la cantidad de código que los desarrolladores deben escribir. Si deseas obtener una lista completa de las bibliotecas cliente que proporciona el SDK de ABAP para Google Cloud, consulta el SDK de ABAP para bibliotecas cliente de Google Cloud.

Como desarrollador de ABAP, puedes compilar y, luego, implementar soluciones basadas en el AA y la IA con una amplia gama de Google Cloud servicios, como Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, APIs de Google Workspace y Google Maps Platform.

Para la comunicación entre SAP y las APIs de Google Cloud , el SDK de ABAP para Google Cloud usa el protocolo HTTPS con TLS/SSL.

Soluciones y aceleradores

La edición local o cualquier edición en la nube del SDK de ABAP para Google Cloud ofrece las siguientes soluciones y aceleradores:

  • SDK de Vertex AI para ABAP: Te permite interactuar con la plataforma de Vertex AI de Google Cloud. Si deseas obtener información sobre el SDK de Vertex AI para ABAP, consulta Descripción general del SDK de Vertex AI para ABAP.

  • SDK de IA y AA de BigQuery para ABAP: Te permite usar las capacidades de IA y AA de BigQuery en tus aplicaciones ABAP y agentes de IA basados en ABAP. El SDK ofrece las siguientes capacidades desde tu entorno de ABAP:

    • Usa Gemini para analizar los datos de tu empresa en BigQuery.
    • Genera y administra embeddings para datos empresariales en BigQuery y convierte a BigQuery en tu base de datos vectorial de bajo costo.
    • Realiza búsquedas de vectores en tus datos empresariales en BigQuery para buscar similitudes o para usar RAG en tu modelo.

    Para obtener más información, consulta la descripción general del SDK de BigQuery AI y ML para ABAP.

  • BigQuery Toolkit para SAP: Te permite replicar datos de tus tablas de SAP a BigQuery de forma programática, sin SAP Landscape Transformation Replication Server. Para obtener más información, consulta la Descripción general de BigQuery Toolkit para SAP.

  • Business Eventing Toolkit for SAP: Te permite integrar SAP con Google Cloudy otros sistemas empresariales a través de su arquitectura basada en eventos, lo que requiere una configuración mínima. Para la estandarización de eventos, el kit de herramientas proporciona módulos integrados que te permiten codificar tus eventos de SAP en la especificación de CloudEvents estándar de la industria. Luego, puedes publicar estos eventos estandarizados en destinos prediseñados para servicios deGoogle Cloud , como Pub/Sub, Cloud Run Functions, Firebase Cloud Messaging (FCM) y Integration Connectors. Para obtener más información, consulta Business Eventing Toolkit for SAP.

  • Cloud Storage como repositorio de contenido para SAP: Te permite implementar Cloud Storage como repositorio de contenido para SAP. Cloud Storage puede satisfacer tus necesidades de almacenamiento de datos relacionados con SAP para almacenar varios tipos de archivos, como PDFs e imágenes, y para archivar datos comerciales. Para obtener más información, consulta Implementa Cloud Storage como un repositorio de contenido para SAP.

Antes de comenzar

Antes de instalar el SDK de ABAP para Google Cloud, haz lo siguiente:

  1. Si es la primera vez que usas Google Cloud, crea una cuenta en https://cloud.google.com.

  2. Si aún no tienes un proyecto de Google Cloud , crea uno:

    Ir al selector de proyectos

  3. Asegúrate de tener habilitada la facturación para tu proyecto. Para obtener más información, consulta Verifica el estado de la facturación de tu proyecto.

  4. Asegúrate de que las versiones de software de SAP que usas sean compatibles con el SDK de ABAP para Google Cloud. Para obtener más información, consulta Requisitos de versión de software de SAP.

Requisitos de versiones de software de SAP

Puedes instalar el SDK de ABAP para Google Cloud en cualquier sistema SAP que se ejecute en SAP NetWeaver con SAP_BASIS 702 o posterior. Esto incluye varios sistemas SAP, como los siguientes:

  • SAP ERP 6.0 (ECC)
  • S/4HANA 1909 o posterior
  • SAP Business Warehouse (BW)
  • SAP Landscape Transformation Replication Server (SLT)
  • SAP Customer Activity Repository (CAR)

Complemento de IU de SAP

El SDK de ABAP para Google Cloud usa el complemento de interfaz de usuario (IU) de SAP para serializar datos de ABAP en formato JSON.

Asegúrate de que la clase /UI2/CL_JSON tenga implementadas las correcciones más recientes. El atributo de clase /UI2/CL_JSON version debe ser la versión 12 o una posterior. Para obtener más información, consulta la Nota SAP 2798102 - correcciones /UI2/CL_JSON - PL12.

Para verificar el atributo de clase /UI2/CL_JSON, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción SE24.
  2. Ingresa /UI2/CL_JSON como el nombre de la clase.
  3. Verifica lo siguiente:

    • El atributo de clase /UI2/CL_JSON debe estar disponible en tu sistema SAP.
    • El atributo de clase version debe ser la versión 12 o una posterior.

El complemento de IU de SAP debe ser compatible con tu versión de SAP NetWeaver.

Para verificar la versión del componente de software, haz lo siguiente:

  1. En la GUI de SAP, ve a la barra de menú.
  2. Selecciona Sistema > Estado.

    El estado del sistema SAP muestra las versiones de los componentes de software instalados en tu sistema SAP.

    En la siguiente tabla, se especifican las versiones mínimas requeridas para el componente de software de SAP:

    Componente de software de SAP Versión Paquete de asistencia mínimo
    UI_700 200 SAPK-20016INUI700
    SAP_UI 750 SAPK-75017INSAPUI
    SAP_UI 750 SAPK-75016INSAPUI
    SAP_UI 752 SAPK-75209INSAPUI
    SAP_UI 753 SAPK-75306INSAPUI
    SAP_UI 754 SAPK-75402INSAPUI

Para obtener información sobre la compatibilidad de complementos de IU de SAP, consulta los siguientes vínculos:

Establece una conexión de red a Google Cloud

Si tu carga de trabajo de SAP no se ejecuta en Google Cloud, tú o un administrador de red deben establecer una conexión segura, de ancho de banda alto y latencia baja a Google Cloud.

Puedes acceder a las APIs de Google Cloud a través de la Internet pública. Para obtener más información, consulta Acerca de las APIs de Cloud. Si tus servidores SAP no tienen acceso público a Internet, conéctalos a Google Cloud con uno de los siguientes métodos:

Para configurar una conexión, sigue las instrucciones que proporciona el producto de conectividad de red Google Cloud adecuado. Cada producto tiene un conjunto diferente de instrucciones para diferentes situaciones, por lo que debes revisar la documentación y seguir las instrucciones para tu situación.

Si tu carga de trabajo de SAP se ejecuta en Google Cloud, el SDK de ABAP para Google Cloud usa la red de VPC subyacente.

Instala el SDK de ABAP para Google Cloud

El SDK de ABAP para Google Cloud se proporciona en forma de archivos de transporte. Para instalar el SDK de ABAP para Google Cloud, debes importar los archivos de transporte del SDK a SAP NetWeaver.

Si tienes problemas para importar los archivos de transporte del SDK de ABAP para Google Cloud en tu sistema SAP, como problemas con la revisión del transporte por parte de SAP o la administración de la cola de importación, comunícate con Atención al cliente de Cloud para obtener ayuda. Si deseas obtener más información para comunicarte con el equipo de Atención al cliente, consulta Obtén asistencia para SAP en Google Cloud.

Cuando importes los archivos de transporte a tu sistema SAP, es posible que aparezca el mensaje de error Requests do not match the component version of the target system. Para resolver este problema, vuelve a importar los archivos de transporte. Durante la reimportación, en la pantalla Importar solicitud de transporte, ve a la pestaña Opciones y selecciona la casilla de verificación Ignorar versión de componente no válida.

Si ya tienes instalado el SDK de ABAP para Google Cloud y necesitas actualizarlo a la versión más reciente, consulta Actualiza el SDK de ABAP para Google Cloud.

  1. Descarga el paquete de instalación que contiene los archivos de transporte del portal de descarga.

  2. Copia los archivos de transporte del SDK de ABAP para Google Cloud en los directorios de importación de transporte de SAP Server:

    • Para obtener la funcionalidad principal del SDK de ABAP para Google Cloud, debes copiar los siguientes archivos de transporte:

    • Para autenticarte con credenciales de cliente de OAuth 2.0, copia los siguientes archivos de transporte:

      • /usr/sap/trans/cofiles/K900459.GM1
      • /usr/sap/trans/data/R900459.GM1

        Estos archivos de transporte no proporcionan funcionalidades adicionales, además de la autenticación basada en credenciales de cliente de OAuth 2.0. En la autenticación basada en credenciales de cliente de OAuth 2.0, primero debes importar los archivos de transporte de la funcionalidad principal del SDK de ABAP para Google Cloud y, luego, importar los archivos de transporte de las credenciales de cliente de OAuth 2.0.

        Para usar las credenciales de cliente de OAuth 2.0, tu sistema SAP debe ser compatible con OAuth 2.0. Para obtener información sobre los sistemas SAP que admiten OAuth 2.0, consulta la nota de SAP 3041322 - Cliente de OAuth 2.0 Cliente: Puerto de baja del tipo de credencial de cliente de otorgamiento.

  3. Para importar los archivos de transporte a tu sistema SAP, en la GUI de SAP, usa el código de transacción STMS_IMPORT o STMS.

  4. Asegúrate de que todos los objetos del paquete /GOOG/ABAP_SDK estén activos y sean coherentes:

    1. En la GUI de SAP, ingresa el código de transacción SE80.
    2. En el selector de paquetes, selecciona /GOOG/ABAP_SDK.
    3. En el campo Nombre del objeto, haz clic con el botón derecho en el paquete /GOOG/ABAP_SDK y, luego, selecciona Verificación > Verificación de paquetes > Objetos de paquete (incluidos los subpaquetes).
    4. Haz clic en el ícono Cambiar a vista de lista.

      Vista de lista

      Una marca de verificación verde en la columna Resultado de la verificación del paquete indica que todos los objetos pasaron la verificación del paquete.

Establece la configuración de seguridad de SAP

Sigue estos pasos para conectar de forma segura el SDK de ABAP para Google Cloud a las Google Cloud APIs.

Configura certificados TLS/SSL

Descarga y, luego, importa los certificados de Google requeridos a STRUST.

  1. Para conectarte a los servicios de Google, sigue las recomendaciones de Google Trust Services. Como mínimo, debes descargar todos los certificados de la AC raíz del repositorio de Google Trust Services.

    Para asegurarte de que usas los certificados de CA raíz de confianza más recientes, te recomendamos que actualices el almacén de certificados raíz de tu sistema cada seis meses. Google anuncia los certificados de CA raíz nuevos y quitados en Google Trust Services. Para recibir notificaciones automáticas, suscríbete al feed RSS de Google Trust Services.

    PEM y DER son formatos de certificado de uso frecuente. Puedes descargar los certificados en un formato que sea compatible con el sistema SAP. Si el formato requerido no está disponible, consulta la Nota de SAP 2755238: cómo convertir un certificado al formato adecuado con OpenSSL para convertir los certificados al formato requerido.

  2. En la GUI de SAP, ingresa el código de transacción STRUST.

  3. Cambia al modo de cambio.

  4. Haz doble clic en Cliente SSL del cliente SSL (estándar).

  5. Haz clic en Certificado  > Importar y, luego, importa los certificados que descargaste desde el repositorio de Google Trust Services.

  6. Haz clic en el botón con la marca de verificación verde.

  7. Haz clic en Editar  > Add to certificate list. Asegúrate de que la información del certificado esté visible en el área Certificado en el panel inferior derecho.

  8. Guarda la entrada.

Para obtener más información de SAP sobre la importación de certificados a STRUST, consulta Nota de SAP 3238733: Cómo importar un certificado a una lista de certificados de PSE STRUST en un NetWeaver como ABAP.

Valida puertos HTTP y HTTPS en Internet Communications Manager (ICM)

Para los sistemas SAP alojados en Google Cloud, los metadatos de VM se almacenan en un servidor de metadatos, al que solo se puede acceder a través de un puerto HTTP. Se requiere la activación del puerto HTTP para la autenticación. Por lo tanto, cuando el sistema SAP se aloja en una instancia de VM de Compute Engine, debes validar que un puerto HTTP esté activo para acceder a los metadatos de la VM y habilitar la autenticación. También debes validar que un puerto HTTPS esté activo para las llamadas a la API posteriores.

Si tu sistema SAP está alojado fuera de Google Cloud, no es necesario activar el puerto HTTP.

Para validar los puertos HTTP y HTTPS, haz lo siguiente:

  1. En la GUI de SAP, ingresa el código de transacción SMICM.
  2. En la barra de menú, haz clic en Ir a > Servicios. Una marca de verificación verde en la columna Actv indica que los puertos HTTP y HTTPS están activos.

Para obtener información sobre la configuración de los puertos HTTP y HTTPS, consulta Configuración de HTTP(S) en ICM.

Verifica la salida de red saliente

El servidor de aplicaciones SAP debe conectarse a las APIs a través de HTTPS. Google Cloud

  • Para tu sistema host de SAP, confirma que las reglas de firewall y los proxies permitan la conexión HTTPS de los servidores fuera de las instancias de VM de Compute Engine. Para obtener más información, consulta Crea y, luego, inicia una instancia de VM.
  • Asegúrate de que el acceso para llegar a las APIs de Google Cloudno esté restringido desde la perspectiva de las herramientas de redes.
  • Si usas un servidor proxy para acceder a las APIs de Google Cloud , agrega lo siguiente a la lista de entidades permitidas de tu proxy:

    • *.googleapis.com
    • *.

Administrar autorizaciones

A fin de acceder al SDK de ABAP para transacciones específicas de Google Cloud, debes otorgar a los usuarios acceso al objeto de autorización del SDK. Los archivos de transporte del SDK incluyen el objeto de autorización del SDK ZGOOG_SDK y el grupo de autorización ZSGC.

Para otorgar acceso a las transacciones del SDK, haz lo siguiente:

  1. En la GUI de SAP, ingresa el código de transacción PFCG.
  2. Define un rol para el SDK.
  3. Para el objeto de autorización ZGOOG_SDK, otorga al rol acceso a la autorización Activity 16.

Para limitar el acceso a las tablas de configuración del SDK, haz lo siguiente:

  1. En la GUI de SAP, ingresa el código de transacción PFCG.
  2. Define un rol para restringir el acceso a las tablas de configuración del SDK.
  3. Para restringir el acceso al objeto de autorización S_TABU_DIS, excluye el grupo de autorización ZSGC.

Configura la Google Cloud seguridad

Si tu sistema SAP está alojado en Google Cloud, configura lo siguiente en la instancia de VM del host de Compute Engine:

Configura la autenticación

Para usar las APIs de Google Cloud , debes confirmar tu identidad a través de la autenticación. Para obtener información sobre las opciones de autenticación en Google Cloud y los pasos de configuración, consulta Autenticación.

Después de completar la configuración de la autenticación, puedes comenzar a usar las Guías de inicio rápido para crear programas de muestra.

Configura el SDK de ABAP para Google Cloud

En esta sección, se explican las opciones de configuración del SDK de ABAP para Google Cloud.

Especifica el Google Cloud extremo

El SDK de ABAP para Google Cloud proporciona las siguientes opciones para especificar el extremo de la API cuando se llama a una API de Google Cloud con la clase de biblioteca cliente de la API:

Extremos predeterminados

De forma predeterminada, el método constructor de la clase de biblioteca cliente de la API contiene extremos HTTP para las APIs Google Cloud compatibles. La biblioteca cliente usa estos extremos cuando se llama a un método para realizar una operación en los recursos de la API.

Usa destinos de RFC para extremos

Si necesitas usar alguna de las siguientes funciones, usa los destinos de RFC para establecer una conexión con Google Cloud:

  • Si usas un servidor proxy en tu entorno de SAP y deseas usar el mismo para enviar las solicitudes HTTP a Google Cloud.
  • Si deseas que el SDK acceda a las Google Cloud APIs a través de extremos de Private Service Connect en tu red de VPC.
  • Si deseas usar la compresión HTTP.
  • Si deseas acceder al extremo específico de la región de una API.

Los archivos de transporte del SDK de ABAP para Google Cloud contienen los siguientes destinos de RFC de muestra para los extremos de la API de Google Cloud :

Nombre de destino de RFC de muestra Notas
GOOG_IAMCREDENTIALS Este destino de RFC se orienta a la API de IAM.
GOOG_OAUTH2_TOKEN Este destino de RFC se orienta al extremo de Google Cloud para la autenticación basada en tokens.
GOOG_PUBSUB_V1 Este destino de RFC se orienta a la API de Pub/Sub.
GOOG_TRANSLATION_EU_V3 Este destino de RFC se orienta a la API de Cloud Translation v3.

Para crear un destino de RFC, haz lo siguiente:

  1. En la GUI de SAP, ingresa el código de transacción SM59.

  2. Crea nuevos destinos de RFC a través de la copia de los destinos de RFC de muestra.

  3. Para los destinos de RFC que creaste, asegúrate de que el Tipo de conexión esté configurado de la siguiente manera: G - HTTP connection to external server.

  4. Ve a la pestaña Configuración técnica y, luego, ingresa los siguientes detalles:

    • Host de destino: Ingresa el nombre de host de la API de Google Cloud . Por ejemplo, puedes usar translation.googleapis.com.
    • Prefijo de ruta: ingresa la ruta del recurso. Por ejemplo, puedes usar /language/translate/.
    • Número de servicio: ingresa 443. Este número de puerto se usa para la comunicación segura.

      Si deseas recopilar los detalles específicos de la API de Google Cloud que necesitas para crear un destino de RFC, consulta Recopila detalles para crear un destino de RFC.

  5. Ve al Inicio de sesión y seguridad y asegúrate de que el Certificado SSL se establece el campo con la opción Cliente SSL de CDAULT (estándar).

  6. Opcional: Puedes configurar el proxy, habilitar la compresión HTTP y especificar los extremos de Private Service Connect.

  7. Guarda los cambios.

Si quieres usar destinos RFC para conectarte a las APIs de Google Cloud , debes configurar los destinos RFC en la tabla de asignación de servicios que asignan destinos RFC a una clave de cliente. Para obtener más información sobre la tabla de asignación de servicios, consulta la tabla /GOOG/SERVIC_MAP.

Recopila detalles para crear un destino de RFC

Para obtener los detalles que necesitas para crear un destino de RFC, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABP para Google Cloud > Utilidades > Obtener configuración de RFC para Google Cloud Services.
  3. Especifica el Google Cloud nombre del servicio.
  4. Haz clic en Ejecutar para ver los detalles.
Establece la configuración del proxy

Cuando usas destinos de RFC para conectarte a Google Cloud, puedes enrutar la comunicación desde el SDK a través del servidor proxy que usas en tu entorno de SAP.

Si no deseas usar un servidor proxy o no tienes uno en tu entorno de SAP, puedes omitir este paso.

Para establecer la configuración del servidor proxy, haz lo siguiente:

  1. En la GUI de SAP, ingresa el código de transacción SM59.

  2. Selecciona tu destino de RFC que se oriente a la API requerida.

  3. Ve a la pestaña Configuración técnica y, luego, ingresa valores para los campos en la sección Opciones del proxy HTTP.

Debes establecer la configuración del servidor proxy para cada API a la que planeas acceder mediante el SDK.

Habilita la compresión HTTP

Cuando usas destinos de RFC para conectarte a Google Cloud, puedes habilitar la compresión HTTP.

Recomendamos habilitar la compresión HTTP si el sistema SAP no se ejecuta enGoogle Cloud. Antes de habilitar la compresión HTTP en tu entorno de producción, prueba y compara los beneficios en función de la configuración horizontal, ya que la compresión HTTP puede implicar una sobrecarga de compresión y descompresión. Para obtener más información de SAP, consulta la Nota de SAP 1037677: La compresión HTTP solo comprime ciertos documentos.

Si no deseas habilitar esta función, puedes omitir este paso.

Para habilitar la compresión HTTP, haz lo siguiente:

  1. En la GUI de SAP, ingresa el código de transacción SM59.

  2. Selecciona tu destino de RFC que se oriente a la API requerida.

  3. Ve a la pestaña Opciones especiales.

  4. En el campo Versión de HTTP, selecciona HTTP 1.1.

  5. En el campo Compresión, selecciona un valor adecuado.

Especifica extremos de Private Service Connect

Si deseas que el SDK de ABAP para Google Cloud use extremos de Private Service Connect para permitir el consumo privado de las APIs de Google Cloud y de IAM, debes crear esos extremos en tu proyecto de Google Cloud y especificarlos en los destinos RFC correspondientes.

Si deseas que el SDK siga usando los extremos públicos y predeterminados de la API para conectarse a las APIs de Google Cloud y a IAM, omite este paso.

Si deseas configurar el SDK para usar tus extremos de Private Service Connect, sigue estos pasos:

  1. En la GUI de SAP, ingresa el código de transacción SM59.

  2. Valida que hayas creado nuevos destinos de RFC para las APIs Google Cloud y la IAM requeridas. Si deseas obtener instrucciones para crear estos destinos de RFC, consulta Crea destinos RFC.

  3. Selecciona el destino de RFC que se orienta a la API Google Cloud específica y, luego, completa los siguientes pasos:

    1. Ve a la pestaña Configuración técnica.

    2. En el campo Host de destino, ingresa el nombre del extremo de Private Service Connect que creaste para acceder a la API.

    3. En el campo Número de servicio, asegúrate de que se especifique ese valor 443.

    4. Ve a la pestaña Inicio de sesión y seguridad.

    5. En el campo Certificado SSL, asegúrate de que la opción Cliente SSL de CDAULT (estándar) esté seleccionada.

  4. Selecciona el destino de RFC que se orienta a IAM y, luego, completa los siguientes pasos:

    1. Ve a la pestaña Configuración técnica.

    2. En el campo Host de destino, ingresa el nombre del extremo de Private Service Connect que creaste para acceder a IAM.

    3. En el campo Número de servicio, asegúrate de que se especifique ese valor 443.

    4. Ve a la pestaña Inicio de sesión y seguridad.

    5. En el campo Certificado SSL, asegúrate de que la opción Cliente SSL de CDAULT (estándar) esté seleccionada.

  5. Configura la tabla de asignación de servicios para la API de IAM y otras APIs que planeas consumir mediante el SDK de ABAP para Google Cloud.

    1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

      Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

    2. Haz clic en SDK de ABAP para Google Cloud > Configuración básica > Configurar mapa de servicios.

    3. Haz clic en Entradas nuevas.

    4. Especifica los destinos de RFC para la API de IAM y otras APIs, por ejemplo, Cloud Pub/Sub API v1.

Campo Descripción
Nombre de la clave de Google Cloud Especifica el nombre de la configuración de la clave de cliente.
Nombre del servicio de Google Especifica el servicio Google Cloud para el que asignas un destino de RFC.
Destino de RFC Especifica el nombre del destino RFC.

El SDK usa el destino de RFC especificado en la tabla de asignación de servicios cuando se crea una instancia de clase de biblioteca cliente y el código fuente de ABAP la usa para llamar a una API de Google Cloud .

Registro de aplicaciones

Para escribir los registros de la aplicación, el SDK de ABAP para Google Cloud viene con un framework de registro incorporado. El objeto de registro ZGOOG y el subobjeto ZABAP_SDK se envían con los archivos de transporte del SDK que puedes usar como objetos predeterminados para la configuración de registro. También puedes agregar tus propios objetos de registro y subobjetos personalizados al framework de registro del SDK.

Puedes ver los registros de aplicaciones de SAP estándar mediante la transacción SLG1. Para obtener más información, consulta la página sobre Logging.

Configura el registro usando el objeto y el subobjeto de registro enviados con el SDK

Puedes usar el objeto de registro ZGOOG y el subobjeto ZABAP_SDK que se envían con el SDK como objetos predeterminados para la configuración de registro.

Para configurar el registro, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABP para Google Cloud > Ajustes básicos > Configure Logging Framework.

  3. Haz clic en Entradas nuevas.

  4. Ingresa los valores para los siguientes campos:

    Campo Descripción
    Objeto Ingresa ZGOOG.
    Subobjeto Ingresa ZABAP_SDK.
    Nivel de registro

    Especifica el nivel de registro mínimo. Los valores admitidos son los siguientes:

    • I: Información, advertencias y errores
    • W: Advertencias y errores
    • E: Solo errores

    Te recomendamos establecer el nivel de registro en I para que la mayoría de los mensajes de registro se registren.

    Retención Especifica la cantidad de días que se retendrán los registros.
    Finalizar el Especifica la fecha de finalización hasta la que estará activa esta configuración de registro. La fecha de finalización predeterminada es el 9999/12/31.
    Es predeterminado Para establecer esta configuración de registro como predeterminada, selecciona la casilla de verificación.

Agrega objetos de registro personalizados

También puedes agregar tus propios objetos de registro y subobjetos personalizados al framework de registro del SDK.

Para agregar un objeto y un subobjeto de registro personalizados, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABP para Google Cloud > Ajustes básicos > Configure Logging Framework.

  3. Haz clic en Entradas nuevas.

  4. Ingresa los valores para los siguientes campos:

    Campo Descripción
    Objeto Ingresa un nombre del objeto de registro.
    Subobjeto Ingresa un nombre del subobjeto de registro.
    Nivel de registro

    Especifica el nivel de registro mínimo. Los siguientes son los valores posibles:

    • I: Información, advertencias y errores
    • W: Advertencias y errores
    • E: Solo errores

    Te recomendamos establecer el nivel de registro en I para que la mayoría de los mensajes de registro se registren.

    Retención Especifica la cantidad de días que se retendrán los registros.
    Finalizar el La fecha de finalización hasta la que estará activa esta configuración de registro. La fecha de finalización predeterminada es el 9999/12/31.
    Es predeterminado Especifica si esta es la configuración de registro predeterminada.

Si necesitas configurar cualquier objeto y subobjeto de registro personalizado como configuración de registro predeterminada, borra el campo Es predeterminado para la entrada predeterminada actual y, luego, selecciona Es predeterminado para la entrada nueva que necesites establecer como predeterminada.

Puedes mantener solo una configuración de registro como entrada predeterminada en un momento dado.

También puedes usar tus objetos y subojetos de registro personalizados, incluso sin configurarlos como predeterminados. Para hacerlo, una vez que creas tus objetos y subobjetos de registro personalizados en el framework de registro, debes pasar los objetos y subobjetos de registro cuando creas una instancia de stubs de cliente de la API. Para obtener más información, consulta la página sobre Logging.

Si ya no se requiere una configuración de registro, puedes inhabilitarla.

Para inhabilitar una configuración de registro, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABP para Google Cloud > Ajustes básicos > Configurar Logging Framework.

  3. Configura el campo Finalizar el en una fecha pasada.

Tablas de configuración de claves en el SDK de ABAP para Google Cloud

En esta sección, se detallan las tablas de configuración del SDK de ABAP para Google Cloud.

Tabla /GOOG/CLIENT_KEY

En la configuración relacionada con la autenticación y la conectividad, el SDK de ABAP para Google Cloud usa la tabla /GOOG/CLIENT_KEY. En la tabla /GOOG/CLIENT_KEY, debes configurar claves de cliente mediante los detalles específicos de tu método de autenticación. Para obtener más información sobre los métodos de autenticación y la configuración de claves de cliente relacionadas, consulta Autenticación.

Para ver la tabla /GOOG/CLIENT_KEY, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en el SDK de ABAP para Google Cloud > Configuración básica > Configurar clave de cliente.

En la siguiente tabla, se explican los campos de la tabla de la clave del cliente:

Campo Tipo de datos Longitud Descripción
Nombre de la clave de Google Cloud CHAR 20 El nombre de la configuración de la clave de cliente. Por ejemplo, CLIENT_KEY_API_KEY
Nombre de la cuenta de servicio de Google Cloud CHAR 255 El nombre de la cuenta de servicio, en formato de dirección de correo electrónico.
Permiso de Google Cloud CHAR 255 El permiso de acceso a la API, https://www.googleapis.com/auth/cloud-platform. Este permiso de acceso corresponde a la configuración Permitir acceso total a todas las APIs de Cloud en la VM host.
ID del proyecto CHAR 255 ID del proyecto Google Cloud que contiene tus APIs de destino.
Nombre del comando CHAR 18 Nombre del comando del SO. Por lo general, dejas este campo en blanco.
Clase de autorización CHAR 30 Es la clase de autorización que se usará para la comunicación con Google Cloud.
Almacenamiento en caché de tokens CHAR 1 La marca que determina si los tokens de acceso recuperados de Google Cloud se almacenan en caché. Te recomendamos que habilites el almacenamiento en caché de tokens después de que termines de configurar y probar tu conexión a Google Cloud. Para obtener más información sobre el almacenamiento en caché de tokens, consulta Habilita el almacenamiento en caché de tokens.
Segundos de actualización de los tokens INT4 10 La cantidad de tiempo en segundos antes de que caduque un token de acceso y se deba actualizar. Especificar un valor de 1 a 3599 anula la fecha y hora de vencimiento predeterminada de 3500 segundos. Si especificas 0, el SDK usa el valor predeterminado. El valor predeterminado es 3500.
Parámetro de autorización 1 CHAR 255 Este es un parámetro de autorización adicional que requiere la configuración en situaciones específicas. Por lo general, dejas este campo en blanco.
Parámetro de autorización 2 CHAR 255 Este es un parámetro de autorización adicional que requiere la configuración en situaciones específicas. Por lo general, dejas este campo en blanco.

Tabla /GOOG/SERVIC_MAP

A fin de asignar la configuración de servicio a los destinos de RFC, el SDK de ABAP para Google Cloud usa la tabla /GOOG/SERVIC_MAP.

Según los métodos de autenticación, esta tabla contiene algunas entradas obligatorias y recomendadas.

Para ver la tabla /GOOG/SERVIC_MAP, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABAP para Google Cloud > Configuración básica > Configurar asignación de servicios.

En la siguiente tabla, se explican los campos de la tabla de asignación de servicios:

Campo Tipo de datos Longitud Descripción
Nombre de la clave de Google Cloud CHAR 20 El nombre de la configuración de la clave de cliente.
Nombre del servicio de Google CHAR 255 Nombre del servicio Google Cloud . Para encontrar un servicio, usa la ayuda de búsqueda.
Destino de RFC CHAR 32 El nombre del destino de RFC. Para encontrar un destino RFC relevante, usa la ayuda de búsqueda.

Ayuda de la Búsqueda

Para encontrar los valores disponibles de un campo, haz clic en el ícono como se muestra en la siguiente captura de pantalla:

Ayuda de la Búsqueda

Tabla /GOOG/LOG_CONFIG

En la escritura de registros de aplicaciones, el SDK de ABAP para Google Cloud usa la tabla /GOOG/LOG_CONFIG.

Para ver la tabla /GOOG/LOG_CONFIG, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABP para Google Cloud > Ajustes básicos > Configure Logging Framework.

En la siguiente tabla, se explican los campos de la tabla de configuración del registro:

Campo Descripción
Objeto El nombre del objeto de registro.
Subobjeto El nombre del subobjeto de registro.
Nivel de registro

Muestra el nivel de registro mínimo. Los siguientes son los valores posibles:

  • I: Información, advertencias y errores
  • W: Advertencias y errores
  • E: Solo errores
Retención

Cantidad de días que se retendrán los registros.

Después del período de retención, puedes considerar los registros para su eliminación mediante la transacción SLG2.

Finalizar el La fecha de finalización hasta la que estará activa esta configuración de registro. La fecha de finalización predeterminada es el 9999/12/31.
Es predeterminado Indica si esta es la configuración de registro predeterminada.
Modificado por Nombre de usuario que cambió la configuración del registro.
Se realizaron cambios el Fecha en la que se cambió la configuración del registro.
Se cambió a las Hora en la que se cambió la configuración del registro.

Almacenamiento en caché de tokens

Si el SDK se usa en un caso de uso de gran volumen de llamadas en el que se realizan varias llamadas al método de la API en un período corto, habilita el almacenamiento en caché para el token de acceso o la clave de API que la configuración de la clave del cliente obtiene para acceder a las APIs de Google Cloud.

Habilitar el almacenamiento en caché de tokens garantiza que un token de acceso o una clave de API se vuelva a usar hasta que venza o se revoque, lo que, a su vez, reduce la cantidad de llamadas HTTP realizadas para recuperar nuevos tokens de acceso o claves de API.

Para habilitar el almacenamiento en caché de tokens, selecciona la marca Almacenamiento en caché de tokens en la tabla de claves de cliente.

Cuando habilitas el almacenamiento en caché de tokens, el token de acceso se almacena en la memoria compartida del servidor de la aplicación durante el tiempo que se configura para el campo Segundos de actualización del token en la tabla de claves del cliente. Si no se especifica Segundos de actualización del token o se configura como 0, el token de acceso se almacena en caché para el valor especificado en el parámetro CMD_SECS_DEFLT de la configuración avanzada.

Borra el token de acceso almacenado en caché

Cuando el almacenamiento en caché del token está habilitado y actualizas los roles asignados a la cuenta de servicio que usa el SDK de ABAP para Google Cloud a fin de acceder a las APIs relevantes, se recupera el token de acceso nuevo que corresponde a los roles actualizados solo después de que caduque el token almacenado en caché existente. En esos casos, puedes borrar el token de acceso de forma manual.

Para borrar el token de acceso almacenado en caché, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABP para Google Cloud > Utilidades  > Vaciar caché.

  3. Selecciona una opción según corresponda:

    • Borra el área de memoria compartida: para borrar toda la caché.
    • Borrar instancia de la memoria: para borrar el token de acceso almacenado en caché de una instancia en particular Con esta opción, también especificas un nombre de instancia.
  4. Ejecuta el informe.

Busca roles de IAM para las APIs de Google Cloud

Para implementar el principio de privilegio mínimo, es esencial que conozcas los roles de IAM adecuados para las APIs deGoogle Cloud que planeas usar en tu programa ABAP. Si otorgas solo los roles necesarios, puedes limitar el acceso para una cuenta de servicio. La utilidad del Finder de roles, integrada en el SDK, te permite identificar de forma conveniente los roles de IAM asociados con varias APIs de Google Cloud .

Para encontrar los roles de IAM, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABP para Google Cloud > Utilidades > Recuperar roles relevantes de la API.

    Como alternativa, puedes acceder a la utilidad del Buscador de roles mediante la ejecución del código de transacción /GOOG/ROLE_FINDER.

  3. En el campo Clave de cliente, ingresa un nombre de clave de cliente válido configurado en la tabla /GOOG/CLIENT_KEY.

  4. En el campo Nombre del servicio de Google, especifica la API de Google Cloud para la que necesitas verificar los roles de IAM.

  5. De manera opcional, para ver los permisos de IAM asociados dentro del rol de IAM, selecciona el campo Detalles completos.

  6. Haz clic en Ejecutar. Se muestran los roles de IAM.

Configuración avanzada

De manera opcional, puedes modificar los parámetros de configuración avanzada para el SDK en la tabla /GOOG/SDK_PARAM. Estos valores de parámetros se aplican en el nivel del sistema y son comunes en todos los componentes del SDK.

El SDK aplica de forma interna valores predeterminados para estos parámetros. Usa la configuración avanzada solo si deseas anular los valores predeterminados.

Te recomendamos que modifiques los parámetros de configuración avanzada solo después de un análisis integral y el impacto de los nuevos valores en el rendimiento del SDK. Eres responsable de garantizar que la nueva configuración avanzada no genere fallas y problemas de rendimiento.

Para modificar los parámetros de configuración avanzada, haz lo siguiente:

  1. En la GUI de SAP, ejecuta el código de transacción /GOOG/SDK_IMG.

    Como alternativa, ejecuta el código de transacción SPRO y, luego, haz clic en IMG de referencia de SAP.

  2. Haz clic en SDK de ABAP para Google Cloud > Configuración básica > Configurar parámetros.

  3. Haz clic en Entradas nuevas.

  4. En la fila que se muestra, especifica la siguiente configuración:

    1. En el campo Nombre del parámetro, ingresa el nombre del parámetro. La descripción del parámetro se propaga de forma automática.
    2. En el campo Valor del parámetro, ingresa un valor.

    Para obtener más información sobre los parámetros de Configuración avanzada, consulta parámetros de configuración avanzada.

  5. Guarda la entrada nueva.

Parámetros de configuración avanzada

En la siguiente tabla, se muestran los parámetros de configuración avanzada del SDK de ABAP para Google Cloud.

Nombre del parámetro Descripción Valor predeterminado Valor válido
CMD_SECS_DEFLT Si habilitaste el almacenamiento en caché de tokens, esta es la duración en segundos a partir de la cual vence el token almacenado en caché. 3500 El valor debe ser de 1 a 3599.

Actualiza el SDK de ABAP para Google Cloud

Google Cloud entrega versiones nuevas del SDK de ABAP para Google Cloud como archivos de transporte. Para actualizar el SDK de ABAP para Google Cloud, debes importar los archivos de transporte del SDK a SAP NetWeaver.

Si tienes problemas para importar los archivos de transporte del SDK de ABAP para Google Cloud en tu entorno de SAP, como problemas con la revisión del transporte por parte de SAP o la administración de la cola de importación, comunícate con el servicio de Atención al cliente de Cloud para obtener asistencia. Si deseas obtener más información para comunicarte con el equipo de Atención al cliente, consulta Obtén asistencia para SAP en Google Cloud.

Para actualizar el SDK de ABAP para Google Cloud, haz lo siguiente:

  1. En tu entorno de SAP, haz lo siguiente:

    • Detén los trabajos en segundo plano que usan cualquier stub de cliente de la API existente del SDK de ABAP para Google Cloud.
    • Detén las aplicaciones que usan componentes de BigQuery Toolkit para SAP. Por ejemplo, si ejecutas un trabajo por lotes que utiliza BigQuery Toolkit para SAP, detén el trabajo.
  2. Descarga el paquete de instalación que contiene los archivos de transporte del portal de descarga.

  3. Copia los siguientes archivos de transporte del SDK en los directorios de importación de transporte de SAP Server:

    • Si actualizas el SDK de la versión 1, 1.5 o 1.6 a la versión más reciente, copia los siguientes archivos de transporte:

      • /usr/sap/trans/cofiles/K900461.GM1
      • /usr/sap/trans/data/R900461.GM1

        Estos archivos de transporte quitan los artefactos asociados con las funciones obsoletas en el SDK de ABAP para Google Cloud. Para obtener información sobre las adiciones, mejoras y funciones obsoletas, consulta Novedades de la edición local o en la nube del SDK de ABAP para Google Cloud.

        Si actualizas el SDK de la versión 1.7 o posterior a la versión más reciente, puedes omitir la importación de estos archivos de transporte.

    • Para obtener la funcionalidad principal del SDK de ABAP para Google Cloud, debes copiar los siguientes archivos de transporte:

    • Para autenticarte con credenciales de cliente de OAuth 2.0, copia los siguientes archivos de transporte:

      • /usr/sap/trans/cofiles/K900459.GM1
      • /usr/sap/trans/data/R900459.GM1

        Estos archivos de transporte no proporcionan funcionalidades adicionales, además de la autenticación basada en credenciales de cliente de OAuth 2.0. En la autenticación basada en credenciales de cliente de OAuth 2.0, primero debes importar los archivos de transporte de la funcionalidad principal del SDK de ABAP para Google Cloud y, luego, importar los archivos de transporte de las credenciales de cliente de OAuth 2.0.

        Para usar las credenciales de cliente de OAuth 2.0, tu sistema SAP debe ser compatible con OAuth 2.0. Para obtener información sobre los sistemas SAP que admiten OAuth 2.0, consulta la nota de SAP 3041322 - Cliente de OAuth 2.0 Cliente: Puerto de baja del tipo de credencial de cliente de otorgamiento.

  4. Para importar los archivos de transporte a tu sistema SAP, en la GUI de SAP, usa el código de transacción STMS_IMPORT o STMS.

  5. Después de validar la importación y la activación de objetos exitosas, reanuda los trabajos en segundo plano.

Métricas de uso

La edición local o cualquier edición en la nube del SDK de ABAP para Google Cloud recopila métricas de uso y las envía a Google con fines de asistencia, en conformidad con el Aviso de Privacidad de Google Cloud (Datos del Servicio que recopilamos). Estas métricas de uso se recopilan cada vez que se llama a una API de Google Cloud desde el SDK de ABAP para Google Cloud.

El SDK recopila las siguientes métricas de uso:

  • Método de autenticación: Es información sobre el método de autenticación que se usó para llamar a los servicios de Google Cloud .
  • Versión del SDK de ABAP: Es el número de versión de la edición local o en la nube del SDK de ABAP para Google Cloud.
  • Versión de SAP_ABA: versión del componente de software SAP_ABA
  • Identificador de módulo (se recopila solo para el SDK de Vertex AI para ABAP): Es el nombre del módulo o la función que se usa en el SDK, como Vector Search.

Licencias

Las ediciones locales o cualquier edición en la nube del SDK de ABAP para Google Cloud están disponibles como “Software” en virtud del acuerdo que rige el uso de la Google Cloud Plataforma, incluidas las Condiciones Específicas del Servicio disponibles en https://cloud.google.com/terms/service-terms. Sin limitar la generalidad de las Condiciones Específicas del Servicio, no puedes modificar ni distribuir el SDK de ABAP para Google Cloud sin el permiso expreso por escrito de Google.

El SDK ABAP para el software de Google Cloud se ofrece sin costo. Para mayor claridad, el uso de otros “Software” y “Servicios” en el acuerdo que rige el uso de la Google Cloud Platform, como la API de Cloud Translation y la API de Pub/Sub pueden generar un costo.

El SDK de ABAP para Google Cloud no incluye ninguna licencia para el software de SAP, debes obtener una licencia adecuada para el software de SAP por separado.

Idiomas admitidos

El SDK de ABAP para Google Cloud solo admite inglés (EN).

El SDK se establece de forma predeterminada en inglés (EN) para los siguientes lenguajes de inicio de sesión de SAP: chino (CH) francés (FR), alemán (DE), japonés (JA), portugués (PT) y ruso (RU).

Cualquier mensaje de error que puedas encontrar cuando trabajes con el SDK se genera en inglés, independientemente del idioma actual del sistema.

Ciclo de vida de la asistencia

Google Cloud admite y mantiene la versión principal actual del SDK de ABAP para Google Cloud durante un período de al menos 12 meses después de la publicación de un aviso de baja de la versión principal anterior en la página de notas de la versión de SAP en Google Cloud.

Obtenga asistencia

Si necesitas ayuda para resolver problemas con el SDK de ABAP para Google Cloud, haz lo siguiente: