Instalar la extensión ABAP de Payhawk mediante gCTS (SAP S/4HANA Public Edition)

Este artículo proporciona instrucciones paso a paso sobre cómo instalar la extensión ABAP de Payhawk en tu sistema SAP S/4HANA® Cloud Public Edition.

Payhawk utiliza el sistema nativo de cambios y transporte habilitado con Git (gCTS) para entregar actualizaciones de forma segura y directa en tu entorno. Para completar la instalación, utiliza el token de acceso de Git con permisos detallados y la URL del repositorio proporcionados por Payhawk.

Requisitos previos

Antes de comenzar la instalación, asegúrate de tener lo siguiente:

• Entorno del sistema: acceso a tu tenant de desarrollo/pruebas de SAP S/4HANA Cloud Public Edition (normalmente una configuración de entorno de 3 sistemas).

• Autorizaciones de usuario: tu usuario de negocio debe tener asignado un rol que incluya los catálogos de negocio de gestión del ciclo de vida (como SAP_CORE_BC_COM o la plantilla estándar SAP_BR_ADMINISTRATOR) para acceder a gCTS y a las aplicaciones de componentes de software.

• Detalles de la extensión:

  • Paquete de destino: ZPARTNER.

  • URL del repositorio Git: [proporcionada por el socio].

  • Token de acceso de permisos detallados: [proporcionado por el socio].

Guía de instalación paso a paso

Paso 1: configurar tus credenciales de Git

SAP S/4HANA Cloud procesa las credenciales de Git de forma estricta y específica por cliente. Mantén tu token dentro del cliente concreto en el que vayas a importar el repositorio.

1. Inicia sesión en tu SAP S/4HANA Cloud Fiori launchpad.

2. Abre la aplicación Git-Enabled CTS (o Manage Software Components, según tu configuración administrativa).

3. Ve a la sección Configuración de usuario o Credenciales.

4. Selecciona Crear o Añadir credenciales e introduce los siguientes datos:

   • Tipo de autenticación: token de acceso personal/token.

   • Nombre de usuario: el nombre de usuario o identidad Git que se te ha proporcionado.

   • Token/contraseña: pega el token de acceso de permisos detallados exactamente como se te ha proporcionado.

5. Guarda los cambios.

Trata este token de permisos detallados como una contraseña segura. Su ámbito está limitado específicamente para conceder a tu sistema acceso de solo lectura para importar el repositorio ZPARTNER.

Paso 2: vincular el repositorio a tu sistema

A continuación, asigna el repositorio alojado de Payhawk a tu entorno en la nube.

1. En la interfaz de gCTS/Software Components, ve a la pestaña Repositorios y selecciona Crear o Clonar.

2. Introduce la URL del repositorio Git proporcionada por el equipo de soporte de Payhawk.

3. Configura los siguientes parámetros durante la configuración del repositorio:

   • Componente de software/paquete: ZPARTNER.

   • Rol del repositorio: selecciona Solo importación (o una configuración equivalente de solo lectura) para evitar que se envíen cambios accidentalmente al origen.

4. Selecciona la rama de despliegue por defecto (por ejemplo, principal o versión).

5. Haz clic en Clonar o Guardar. El sistema se autentica utilizando las credenciales guardadas en el paso 1.

Paso 3: importar los objetos de la extensión

Una vez inicializado el enlace, puedes desplegar los objetos ABAP directamente en tu tenant.

1. Selecciona el repositorio ZPARTNER que acabas de crear en la lista.

2. Ve a la pestaña Ramas o Commits.

3. Localiza el último commit, la etiqueta de versión o la rama de versión activa.

4. Haz clic en Importar (o Actualizar).

5. El sistema inicia un trabajo de despliegue en segundo plano. Puedes supervisar el progreso, los registros y los pasos de transporte de objetos a través de la pestaña Trabajos o Historial.

Paso 4: reenvío a los sistemas de prueba y producción (tenants que no son de desarrollo)

Ejecuta el proceso de extracción de gCTS descrito en los pasos 1 a 3 únicamente en tu tenant de desarrollo. Los tenants de pruebas y producción están estrictamente configurados como (No modificables) para garantizar la estabilidad del entorno y no pueden importar código directamente desde Git. Para trasladar la extensión instalada a través de tu entorno de 3 sistemas, utiliza las rutas de transporte estándar de SAP Cloud:

1. Exportar desde desarrollo: en tu tenant de desarrollo, abre la aplicación Exportar componentes de software. Localiza el paquete ZPARTNER y ejecuta una exportación. Esto consolida los cambios en una versión específica del componente de software.

2. Importar en pruebas: inicia sesión en el Fiori Launchpad de tu tenant de pruebas. Abre la aplicación Importar componentes de software, localiza la versión que acabas de exportar y ejecuta la importación.

3. Importar en producción: una vez completadas las pruebas y la validación, repite la importación aplicando Importar componentes de software en tu tenant de producción.

Resolución de problemas y soporte

• Errores de autenticación (401 No autorizado): asegúrate de que el token de acceso de permisos detallados se ha pegado sin espacios al final y de que no ha caducado. Recuerda que las credenciales deben mantenerse en el cliente específico en el que estés trabajando.