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.

Installation der Payhawk-ABAP-Erweiterung über gCTS (SAP S/4HANA Public Edition)

Prev Next

Dieser Artikel enthält eine Schritt-für-Schritt-Anleitung zur Installation der Payhawk ABAP-Erweiterung auf Ihrem SAP S/4HANA® Cloud Public Edition-System.

Payhawk nutzt das native, Git-fähige Change and Transport System (gCTS), um Updates sicher und direkt in Ihre Umgebung zu übertragen. Um die Installation abzuschließen, verwenden Sie das von Payhawk bereitgestellte, fein abgestufte Git-Zugriffstoken und die Repository-URL.

Voraussetzungen

Bevor Sie mit der Installation beginnen, stellen Sie bitte sicher, dass Folgendes vorhanden ist:

  • Systemlandschaft: Zugriff auf Ihren SAP S/4HANA Cloud Public Edition-Entwicklungs-/Test-Mandant (in der Regel eine 3-System-Landschaft).

  • Benutzerberechtigungen: Ihrem Geschäftsbenutzer muss eine Rolle zugewiesen werden, die Lifecycle-Management-Geschäftskataloge enthält (z. B. SAP_CORE_BC_COM oder die Standardvorlage SAP_BR_ADMINISTRATOR), um auf gCTS und Softwarekomponenten-Apps zugreifen zu können.

  • Details zur Erweiterung:

    • Ziel-Paket: ZPARTNER.

    • URL des Git-Repositorys: [provided by Partner].

    • Feinkörniges Zugriffstoken: [provided by Partner].

Schritt-für-Schritt-Anleitung zur Installation

Schritt 1: Git-Anmeldedaten konfigurieren

SAP S/4HANA Cloud verarbeitet Git-Anmeldedaten streng mandantenbezogen. Verwalten Sie Ihr Token innerhalb des jeweiligen Mandanten, in dem Sie das Repository abrufen möchten.

  1. Melden Sie sich bei Ihrem SAP S/4HANA Cloud Fiori Launchpad an.

  2. Öffnen Sie die Git-aktivierte CTS-Anwendung (oder Softwarekomponenten verwalten, je nach Ihrer Verwaltungskonfiguration).

  3. Gehen Sie zum Abschnitt Benutzereinstellungen oder Anmeldedaten.

  4. Wählen Sie Erstellen oder Anmeldedaten hinzufügen und geben Sie die folgenden Angaben ein:

    • Art der Authentifizierung: Persönlicher Zugangstoken / Token.

    • Benutzername: Der Ihnen mitgeteilte Benutzername oder die Git-Identität.

    • Token/Passwort: Fügen Sie das feinkörnige Zugriffstoken genau so ein, wie es bereitgestellt wurde.

  5. Speichern Sie Ihre Änderungen.

Behandeln Sie dieses feinkörnige Token wie ein sicheres Passwort. Sein Geltungsbereich ist speziell darauf beschränkt, Ihrem System Lesezugriff auf das Repository ZPARTNER zu gewähren.

Als nächstes ordnen Sie das von Payhawk gehostete Repository Ihrer lokalen Cloud-Umgebung zu.

  1. Gehen Sie in der Oberfläche von gCTS/Software Components auf die Registerkarte Repositories und wählen Sie Erstellen oder Klonen.

  2. Geben Sie die vom Payhawk-Support bereitgestellte Git-Repository-URL ein.

  3. Konfigurieren Sie die folgenden Parameter während der Einrichtung des Repositorys:

    • Software-Komponente / Paket: ZPARTNER.

    • Repository-Rolle: Wählen Sie Nur abrufen (oder eine gleichwertige schreibgeschützte Konfiguration), um zu verhindern, dass versehentliche Änderungen zurück in die Quelle übertragen werden.

  4. Wählen Sie den Standard-Bereitstellungszweig aus (z. B. Main oder Release).

  5. Klicken Sie auf Klonen oder Speichern. Das System authentifiziert sich mit den in Schritt 1 gespeicherten Anmeldedaten.

Schritt 3: Erweiterungsobjekte abrufen

Sobald die Verknüpfung initialisiert ist, können Sie die ABAP-Objekte direkt in Ihrem Mandanten einsetzen.

  1. Wählen Sie Ihr neu erstelltes ZPARTNER-Repository aus der Liste aus.

  2. Wechseln Sie zur Registerkarte Zweige oder Commits.

  3. Suchen Sie den letzten Commit, Versions-Tag oder aktiven Release-Zweig.

  4. Klicken Sie auf Abrufen (oder Aktualisieren).

  5. Das System löst einen Hintergrund-Bereitstellungsauftrag aus. Sie können den Fortschritt, die Protokolle und die Schritte des Objekttransports über die Registerkarte Jobs oder Verlauf überwachen.

Schritt 4: Weiterleitung an Test- und Produktionssysteme (Nicht-Entwicklungsmandanten)

Führen Sie den gCTS-Pull-Prozess in den Schritten 1 bis 3 ausschließlich in Ihrem Entwicklungs-Mandant durch. Test- und Produktions-Mandants sind streng gesperrt (Nicht änderbar), um die Stabilität der Umgebung zu gewährleisten, und können keinen Code direkt aus Git abrufen. Um die installierte Erweiterung in Ihrer 3-System-Landschaft zu übertragen, verwenden Sie die standardmäßigen SAP-Cloud-Transportwege:

  1. Aus der Entwicklungsumgebung exportieren: Öffnen Sie in Ihrem Entwicklungs-Mandant die App Softwarekomponenten exportieren. Suchen Sie das Paket ZPARTNER und führen Sie einen Export durch. Dadurch werden die Änderungen in einer bestimmten Version der Softwarekomponente gesichert.

  2. In Test importieren: Melden Sie sich beim Fiori Launchpad Ihres Test-Mandants an. Öffnen Sie die App Softwarekomponenten importieren, suchen Sie die soeben exportierte Version und starten Sie den Import.

  3. In die Produktion importieren: Sobald die Tests und die Validierung abgeschlossen sind, wiederholen Sie den Import mithilfe der App Softwarekomponenten importieren in Ihrem Produktions-Mandant.

Fehlersuche und Support

  • Authentifizierungsfehler (401 Unauthorized): Stellen Sie sicher, dass das Feinabstimmungstoken ohne abschließende Leerzeichen eingefügt wurde und nicht abgelaufen ist. Beachten Sie, dass die Anmeldedaten innerhalb des jeweiligen Clients, in dem Sie arbeiten, gepflegt werden müssen.