Documentation Index

Fetch the complete documentation index at: https://payhawk.document360.io/llms.txt

Use this file to discover all available pages before exploring further.

Instalar la extensión ABAP de Payhawk mediante abapGit (SAP S/4HANA Private Cloud)

Prev Next

Este artículo explica cómo instalar la extensión ABAP de Payhawk en tu sistema SAP S/4HANA® Private Cloud.

Como los entornos Private Cloud permiten el acceso a transacciones ABAP tradicionales, la instalación utiliza abapGit, el cliente Git de código abierto estándar del sector para ABAP, para importar el código directamente a tu entorno. Esto proporciona una instalación limpia, trazable y moderna.

Requisitos previos

Antes de iniciar la instalación, asegúrate de cumplir los siguientes requisitos:

  • Acceso al sistema: acceso de desarrollador a tu sistema de desarrollo de S/4HANA Private Cloud (cliente 000 o tu cliente principal de configuración, según tu estrategia de transporte).

  • Configuración de abapGit: la herramienta abapGit debe estar disponible en tu sistema. Normalmente se ejecuta mediante un informe independiente (por ejemplo, ZABAPGIT_STANDALONE) o un código de transacción personalizado (por ejemplo, /nZABAPGIT).

  • Configuración de red y SSL:

    • Para el método en línea, tu sistema SAP debe disponer de acceso saliente de Internet para conectarse al repositorio Git, y los certificados SSL correspondientes deben cargarse en la transacción STRUST.

    • Si tu sistema está completamente aislado por un firewall, utiliza el método sin conexión (carga de archivos ZIP).

  • Detalles de la extensión:

    • Paquete de destino: ZPAYHAWK (o un subpaquete según las indicaciones de Payhawk).

    • URL del repositorio Git o archivo ZIP: proporcionado por el equipo de soporte de Payhawk.

    • Token de acceso personal (PAT): proporcionado por el equipo de soporte de Payhawk (para el método en línea).

Guía de instalación paso a paso

Paso 1: iniciar abapGit

  1. Inicia sesión en SAP GUI para tu sistema de desarrollo de S/4HANA Private Cloud.

  2. Ve a la transacción SE38, introduce el nombre de tu programa local de abapGit (normalmente ZABAPGIT_STANDALONE) y pulsa Ejecutar (F8). Alternativamente, si lo ha configurado tu equipo de administración de SAP Basis, ejecuta la transacción /nZABAPGIT.

Paso 2: establecer el repositorio

En función de tu infraestructura de red, elige el método A (en línea) o el método B (sin conexión).

Método A: repositorio en línea (recomendado)

  1. En el menú superior del panel de control de abapGit, haz clic en Nuevo en línea.

  2. Introduce la URL del repositorio Git proporcionada por Payhawk.

  3. En el campo Paquete de destino, introduce ZPAYHAWK. Si el paquete aún no existe, selecciona la opción para crear un nuevo paquete, asígnalo a una capa de transporte válida y guarda los cambios.

  4. Haz clic en Crear repositorio en línea.

Método B: repositorio sin conexión (para entornos aislados por firewall)

  1. Descarga el archivo .zip de la extensión de código fuente de Payhawk proporcionado por Payhawk en tu equipo local.

  2. En el menú superior del panel de control de abapGit, haz clic en Nuevo sin conexión.

  3. Introduce un nombre de repositorio (por ejemplo, Extensión_Payhawk) y especifica el paquete de destino ZPAYHAWK.

  4. Haz clic en Crear repositorio sin conexión.

  5. Una vez creado, haz clic en Importar ZIP en las opciones del repositorio y sube el archivo .zip de Payhawk descargado.

Paso 3: configurar la autenticación (solo método en línea)

Con la opción en línea, abapGit solicita credenciales cuando se comunica con el repositorio remoto de Payhawk.

  1. Cuando el sistema lo solicite, introduce el nombre de usuario de Git que se te ha proporcionado.

  2. Pega el token de acceso personal de permisos detallados en el campo de contraseña/token.

Este token proporciona acceso explícito de solo lectura al repositorio de la extensión de Payhawk. Trátalo siguiendo las medidas estándar de seguridad corporativa para credenciales.

Paso 4: revisar e importar los objetos de código

Una vez creado el enlace del repositorio, abapGit muestra una matriz de diferencias (Diff) en la que se comparan los objetos entrantes de Payhawk (clases, tablas, elementos de datos, etc.) con tu paquete local vacío.

  1. Haz clic en el botón Importar de la barra de acciones del repositorio.

  2. abapGit deserializa los archivos de Git e instancia los objetos ABAP dentro del paquete ZPAYHAWK.

  3. Cuando el sistema lo solicite, asigna los objetos entrantes a una orden de transporte para que puedan migrarse posteriormente a través de tu entorno (entorno de pruebas, calidad y producción).

Paso 5: activación de objetos

Una vez finalizada la importación, los objetos deben activarse dentro de tu NetWeaver stack.

  1. abapGit normalmente activa automáticamente los objetos de forma masiva. Si algún objeto permanece inactivo, abre ABAP Development Tools (ADT) en Eclipse o la transacción SE80.

  2. Localiza el paquete ZPAYHAWK.

  3. Haz clic derecho en el paquete y selecciona Activar. Asegúrate de que todos los componentes cambien de estado de Inactivo a Activo.

Paso 6: transporte a aseguramiento de la calidad y producción (sistemas que no son de desarrollo)

Ejecuta los pasos 1-5 de abapGit únicamente en tu sistema de desarrollo. Los sistemas de aseguramiento de la calidad y producción están configurados como No modificables para garantizar la estabilidad del entorno, por lo que no se permiten importaciones directas desde Git en ellos.

Para desplegar de forma segura la extensión de Payhawk en todo tu entorno, utiliza el sistema estándar de cambios y transporte de SAP (CTS):

  1. Liberar la orden de transporte: en tu sistema de desarrollo, abre el Organizador de transporte (transacción SE09 o SE10). Localiza la orden de transporte de Workbench creada en el paso 4, haz clic derecho sobre las tareas y libéralas. A continuación, libera la orden de transporte principal.

  2. Importar a aseguramiento de la calidad: inicia sesión en tu sistema de aseguramiento de la calidad. Utiliza la transacción STMS (o la herramienta de despliegue de tu organización, como SAP ChaRM) para localizar la orden de transporte liberada en la cola de importación y, a continuación, ejecuta la importación.

  3. Importar a producción: realiza las pruebas funcionales y de regresión habituales en el entorno de aseguramiento de la calidad. Una vez aprobadas, utiliza STMS para importar la misma orden de transporte en tu sistema de producción.

Este ciclo de vida mantiene tus entornos críticos de negocio seguros, aislados de repositorios de Internet y estructuralmente idénticos a lo verificado durante las pruebas de aseguramiento de la calidad.

Solución de problemas

  • Error de negociación SSL (STRUST): el sistema SAP no confía en la autoridad de certificación raíz de GitHub/GitLab. Descarga el certificado raíz desde la URL Git a través de tu navegador web y cárgalo en las identidades SSL Client (anónimo) y SSL Client (estándar) mediante la transacción STRUST.

  • Requisitos previos no cumplidos: si algunos elementos fundamentales no se activan, verifica que tu versión de S/4HANA Private Cloud cumple la arquitectura base mínima especificada en la documentación contractual de Payhawk.