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.

Payhawk ABAP-Erweiterung über abapGit installieren (SAP S/4HANA Private Cloud)

Prev Next

Dieser Artikel erklärt, wie Sie die Payhawk ABAP Extension in Ihrem SAP S/4HANA® Private Cloud System installieren.

Da Private-Cloud-Umgebungen den Zugriff über herkömmliche ABAP-Transaktionen ermöglichen, nutzt die Installation abapGit, den branchenüblichen Open-Source-Git-Client für ABAP, um Code direkt in Ihre Umgebung zu laden. So erhalten Sie eine saubere, nachvollziehbare und moderne Installation.

Voraussetzungen

Bevor Sie mit der Installation beginnen, vergewissern Sie sich, dass Sie die folgenden Voraussetzungen erfüllt haben:

  • Systemzugang: Entwicklerzugang zu Ihrem S/4HANA Private Cloud-Entwicklungssystem (Mandant 000 oder Ihr Hauptkonfigurationsmandant, je nach Ihrer Transportstrategie).

  • abapGit-Einrichtung: Das abapGit-Tool muss in Ihrem System verfügbar sein. Es wird in der Regel über einen eigenständigen Report (z. B. ZABAPGIT_STANDALONE) oder einen benutzerdefinierten Transaktionscode (z. B. /nZABAPGIT) ausgeführt.

  • Netzwerk- und SSL-Konfiguration:

    • Für die Online-Methode muss Ihr SAP-System über einen ausgehenden Internetzugang zum Git-Repository verfügen, und die entsprechenden SSL-Zertifikate müssen in der Transaktion STRUST hochgeladen werden.

    • Wenn Ihr System vollständig mit einer Firewall geschützt ist, verwenden Sie die Offline-Methode (ZIP-Upload).

  • Details zur Erweiterung:

    • Ziel-Paket: ZPAYHAWK (oder ein Teilpaket nach Anweisung von Payhawk).

    • Git-Repository-URL oder ZIP-Datei: wird vom Payhawk-Support bereitgestellt.

    • Persönliches Zugangstoken (PAT): wird vom Payhawk-Support zur Verfügung gestellt (für das Online-Verfahren).

Schritt-für-Schritt-Anleitung zur Installation

Schritt 1: abapGit starten

  1. Melden Sie sich am SAP GUI für Ihr S/4HANA Private Cloud-Entwicklungssystem an.

  2. Rufen Sie die Transaktion SE38 auf, geben Sie den Namen Ihres lokalen abapGit-Programms ein (in der Regel ZABAPGIT_STANDALONE) und drücken Sie Ausführen (F8). Alternativ können Sie, sofern Ihr Basis-Team dies eingerichtet hat, die Transaktion /nZABAPGIT ausführen.

Schritt 2: Repository einrichten

Je nach Ihrer Netzinfrastruktur wählen Sie Methode A (online) oder Methode B (offline).

Methode A: Online-Repository (empfohlen)

  1. Klicken Sie im oberen Menü des abapGit-Dashboards auf Neu online.

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

  3. Geben Sie im Feld Zielpaket den Eintrag ZPAYHAWK ein. Falls das Paket noch nicht existiert, klicken Sie auf die Option zum Anlegen eines neuen Pakets, ordnen Sie es einer gültigen Transportschicht zu und speichern Sie es.

  4. Klicken Sie auf Online-Repos erstellen.

Methode B: Offline-Repository (für Umgebungen mit Firewalls)

  1. Laden Sie die von Payhawk bereitgestellte Datei „Payhawk-Quell-Erweiterung .zip“ auf Ihren lokalen Computer herunter.

  2. Klicken Sie im oberen Menü des abapGit-Dashboards auf Neu offline.

  3. Geben Sie einen Repository-Namen an (z. B. Payhawk_Extension) und geben Sie das Zielpaket ZPAYHAWK ein.

  4. Klicken Sie auf Offline-Repos erstellen.

  5. Klicken Sie nach der Erstellung in den Repository-Optionen auf ZIP importieren und laden Sie die heruntergeladene Payhawk-.zip-Datei hoch.

Schritt 3: Authentifizierung beibehalten (nur online)

Bei der Online-Option fordert abapGit Sie zur Eingabe von Anmeldeinformationen auf, wenn es mit dem entfernten Payhawk-Repository kommuniziert.

  1. Wenn Sie vom System dazu aufgefordert werden, geben Sie den Git-Benutzernamen ein, den Sie erhalten haben.

  2. Fügen Sie den persönlichen Zugriffstoken in das Feld „Passwort/Token“ ein.

Dieses Token gewährt expliziten Lesezugriff auf das Payhawk-Erweiterungs-Repository. Behandeln Sie es gemäß den üblichen Sicherheitsvorkehrungen für Unternehmenszugangsdaten.

Schritt 4: Codeobjekte überprüfen und abrufen

Sobald der Repository-Link erstellt ist, zeigt abapGit eine übersichtliche Diff-Matrix an, in der die von Payhawk importierten Objekte (Klassen, Tabellen, Datenelemente usw.) mit Ihrem leeren lokalen Paket verglichen werden.

  1. Klicken Sie in der Aktionsleiste des Repositorys auf die Schaltfläche Abrufen.

  2. abapGit deserialisiert die Git-Dateien und instanziiert die ABAP-Objekte innerhalb des ZPAYHAWK-Pakets.

  3. Weisen Sie die eingehenden Objekte einem Transportauftrag zu, wenn Sie dazu aufgefordert werden, damit sie später durch Ihre Landschaft (Test, Qualität, Produktion) migriert werden können.

Schritt 5: Objektaktivierung

Nach Abschluss des Abrufs müssen die Objekte in Ihrem NetWeaver-Stack aktiviert werden.

  1. abapGit löst in der Regel automatisch eine Massenaktivierung aus. Sollten noch Objekte inaktiv sein, öffnen Sie die ABAP Development Tools (ADT) in Eclipse oder die Transaktion SE80.

  2. Suchen Sie das Paket ZPAYHAWK.

  3. Klicken Sie mit der rechten Maustaste auf das Paket und wählen Sie Aktivieren. Vergewissern Sie sich, dass alle Komponenten den Status von Inaktiv zu Aktiv ändern.

Schritt 6: Übertragung in die Qualitätssicherung und in die Produktion (Nicht-Entwicklungssysteme)

Führen Sie die abapGit-Schritte 1–5 ausschließlich in Ihrem Entwicklungssystem aus. Qualitätssicherungs- (QA) und Produktionssysteme sind auf Nicht änderbar eingestellt, um die Stabilität der Umgebung zu gewährleisten; daher sind direkte Git-Pulls dort gesperrt.

Um die Payhawk-Erweiterung sicher in Ihrer Landschaft einzusetzen, verwenden Sie das standardmäßige SAP Change and Transport System (CTS):

  1. Transport freigeben: Öffnen Sie in Ihrem Entwicklungssystem den Transport Organizer (Transaktion SE09 oder SE10). Suchen Sie den in Schritt 4 erstellten Workbench-Transportauftrag, klicken Sie mit der rechten Maustaste auf die Aufgaben und geben Sie diese frei; geben Sie anschließend den Hauptcontainer des Transportauftrags frei.

  2. In die Qualitätssicherung importieren: Melden Sie sich bei Ihrem Qualitätssicherungssystem an. Verwenden Sie die Transaktion STMS (oder das Bereitstellungstool Ihrer Organisation, z. B. SAP ChaRM), um den freigegebenen Transportauftrag in der Importwarteschlange zu finden, und lösen Sie anschließend den Import aus.

  3. In die Produktion importieren: Führen Sie Ihre Standard-Geschäftstests und Regressionstests in der QA-Umgebung durch. Nach der Freigabe verwenden Sie STMS, um denselben Transportauftrag in Ihr Produktionssystem zu importieren.

Dieser Lebenszyklus gewährleistet, dass Ihre geschäftskritischen Umgebungen sicher und von Internet-Repositorys isoliert bleiben und strukturell mit dem übereinstimmen, was im Rahmen der Qualitätssicherungstests überprüft wurde.

Fehlersuche

  • SSL-Handshake fehlgeschlagen (STRUST): Das SAP-System vertraut der GitHub/GitLab-Stammzertifizierungsstelle nicht. Laden Sie das Stammzertifikat über Ihren Webbrowser von der Git-URL herunter und laden Sie es in der Transaktion STRUST in die Identitäten SSL-Client (Anonym) und SSL-Client (Standard) hoch.

  • Fehlende Voraussetzungen: Sollten bestimmte Kernkomponenten nicht aktiviert werden, überprüfen Sie bitte, ob Ihre S/4HANA Private Cloud-Version die in Ihrer Payhawk-Vertragsunterlage festgelegten Mindestanforderungen an die Basisarchitektur erfüllt.