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.

De Payhawk ABAP-extensie installeren via abapGit (SAP S/4HANA Private Cloud)

Prev Next

In dit artikel lees je hoe je de Payhawk ABAP-extensie installeert in je SAP S/4HANA® Private Cloud-systeem.

Omdat Private Cloud-omgevingen traditionele ABAP-transactietoegang toestaan, maakt de installatie gebruik van abapGit, de open-source Git-client voor ABAP, om code rechtstreeks naar je omgeving te halen. Hierdoor krijg je een schone, traceerbare en moderne installatie.

Vereisten

Voordat je begint met installeren, moet je ervoor zorgen dat je aan de volgende vereisten voldoet:

  • Systeemtoegang: toegang voor ontwikkelaars tot je S/4HANA Private Cloud-ontwikkelingssysteem (client 000 of je voornaamste configuratieclient, afhankelijk van je transportstrategie).

  • abapGit instellen: de abapGit-tool moet beschikbaar zijn in je systeem. Deze wordt meestal uitgevoerd via een afzonderlijk rapport (bijvoorbeeld ZABAPGIT_STANDALONE) of een aangepaste transactiecode (bijvoorbeeld /nZABAPGIT).

  • Netwerk- en SSL-configuratie:

    • Voor de online methode moet je SAP-systeem uitgaande internettoegang hebben tot het Git-repository, en de juiste SSL certificaten moeten geüpload zijn in de transactie STRUST.

    • Als je systeem volledig afgeschermd is, gebruik dan de offline methode (ZIP upload).

  • Details extensie:

    • Doelpakket: ZPAYHAWK (of een subpakket zoals aangegeven door Payhawk).

    • URL van Git-repository of ZIP-bestand: geleverd door Payhawk Support.

    • Persoonlijk toegangstoken (PAT): verstrekt door Payhawk Support (voor de online methode).

Stapsgewijze installatiehandleiding

Stap 1: abapGit starten

  1. Log in op SAP GUI voor je S/4HANA Private Cloud-ontwikkelingssysteem.

  2. Ga naar transactie SE38, voer de naam van je lokale abapGit programma in (meestal ZABAPGIT_STANDALONE) en druk op Uitvoeren(F8). Als je basisteam het in kaart heeft gebracht, kun je ook transactie /nZABAPGIT uitvoeren.

Stap 2: De opslagplaats opzetten

Afhankelijk van je netwerkinfrastructuur kies je Methode A (online) of Methode B (offline).

Methode A: Online repository (aanbevolen)

  1. Klik in het bovenste menu van het abapGit-dashboard op Nieuw Online.

  2. Voer de  URL vande Git-repository in die door Payhawk is verstrekt.

  3. Voer in het veld DoelpakketZPAYHAWK in. Als het pakket nog niet bestaat, klik dan op de optie om een nieuw pakket aan te maken, wijs het toe aan een geldige transportlaag en sla het op.

  4. Klik op Online repo maken.

Methode B: Offline repository (voor omgevingen met firewall)

  1. Download het .zip-bestand met de bronextensie van Payhawk van Payhawk op je computer.

  2. Klik in het bovenste menu van het abapGit-dashboard op Nieuw Offline.

  3. Geef een een naam op voor het repository op (bijvoorbeeld Payhawk_Extensie) en voer het doelpakket ZPAYHAWK in.

  4. Klik op Offline repo maken.

  5. Eenmaal aangemaakt, klik je op ZIP importeren in de repository-opties en upload je het gedownloade .zip-bestand van Payhawk.

Stap 3: Verificatie behouden (alleen online)

Met de online-optie vraagt abapGit om je inloggegevens wanneer het communiceert met de Payhawk remote repository.

  1. Als het systeem daarom vraagt, voer dan de Git-gebruikersnaam in die je hebt gekregen.

  2. Plak het verfijnde persoonlijke toegangstoken in het veld Wachtwoord/token.

Dit token geeft expliciet alleen-lezen-toegang tot de Payhawk-extensie-repository. Behandel het met standaard bedrijfsbeveiliging.

Stap 4: Codeobjecten controleren en ophalen

Zodra de koppeling met de repository is gemaakt, toont abapGit een duidelijke matrix Verschillen die de binnenkomende Payhawk-objecten (klassen, tabellen, data-elementen, enzovoort) laat zien in vergelijking met je lege lokale pakket.

  1. Klik op de knop Ophalen op de actiebalk van de repository.

  2. abapGit deserialiseert de Git-bestanden en instantiëert de ABAP-objecten binnen het ZPAYHAWK pakket.

  3. Wijs de binnenkomende objecten toe aan een transportverzoek wanneer daarom wordt gevraagd, zodat ze later door je omgeving (Test, Kwaliteit, Productie) kunnen worden gemigreerd.

Stap 5: Object activeren

Nadat de objecten zijn opgehaald, moeten ze worden geactiveerd in je NetWeaver-stack.

  1. abapGit activeert normaal gesproken automatisch een activering op grote schaal. Als er objecten inactief blijven, open dan ABAP Development Tools (ADT) in Eclipse of transactie SE80.

  2. Zoek het pakket ZPAYHAWK.

  3. Klik met de rechtermuisknop op het pakket en selecteer Activeren. Zorg ervoor dat de status van alle componenten verandert van Inactief naar Actief.

Stap 6: Transporteren naar QA en productie (niet-ontwikkelsystemen)

Voer de abapGit-stappen 1-5 alleen uit in je ontwikkelsysteem. Quality Assurance (QA)- en Productie-systemen zijn ingesteld op Niet-bewerkbaar om omgevingsstabiliteit af te dwingen, dus directe Git pulls zijn daar geblokkeerd.

Gebruik het standaard SAP Change and Transport System (CTS) om de Payhawk-extensie veilig in te zetten in de hele omgeving:

  1. Geef het transport vrij: open in je ontwikkelsysteem de transportorganizer (transactie SE09 of SE10). Zoek het Workbench-transportverzoek dat in stap 4 is gemaakt, klik met de rechtermuisknop op de taken en geef ze vrij.

  2. Importeren naar QA: log in op je Quality Assurance-systeem. Gebruik transactie STMS (of de implementatietool van je organisatie, zoals SAP ChaRM) om het vrijgegeven transportverzoek te vinden in de importwachtrij en activeer vervolgens de import.

  3. Importeren naar productie: voer je standaard bedrijfs- en regressietests uit in de QA-omgeving. Na goedkeuring gebruik je STMS om dezelfde transportaanvraag te importeren in je productiesysteem.

Deze levenscyclus houdt je bedrijfskritische omgevingen veilig, geïsoleerd van internetrepositories en structureel identiek aan wat is geverifieerd tijdens QA-testen.

Probleemoplossing

  • SSL handshake mislukt (STRUST): het SAP-systeem vertrouwt het GitHub/GitLab root-certificaat autoriteit niet. Download het hoofdcertificaat van de Git URL via je webbrowser, en upload het naar de SSL client (Anonymous) en SSL client (Standard) identiteiten in transactie STRUST.

  • Randvoorwaarden ontbreken: als bepaalde kernelementen niet worden geactiveerd, controleer je of je S/4HANA Private Cloud-versie voldoet aan de minimale basisarchitectuur die is opgegeven in de contractdocumentatie van Payhawk.