API-services inschakelen op met SAP S/4HANA Cloud, Private Edition

Bij het bouwen van aangepaste of standaardintegraties met SAP S/4HANA® Private Cloud is het toekennen van gebruikersautorisaties slechts de helft van het werk. De doelinterfaces moeten expliciet worden geactiveerd en gepubliceerd binnen de communicatieraamwerken van het systeem.

SAP S/4HANA-omgevingen maken gebruik van drie verschillende communicatiearchitecturen: OData V2, OData V4 en SOAP Web Services. Omdat ze op afzonderlijke technische engines draaien, worden ze met verschillende transacties geactiveerd.

Deze handleiding biedt een eenvoudige blauwdruk voor het publiceren van je vereiste financiële, project- en stamgegevens-eindpunten.

Deel 1: OData V2 Services activeren (Transactie /IWFND/MAINT_SERVICE)

Traditionele op SAP REST gebaseerde API's maken gebruik van de OData V2-architectuur. Deze services moeten worden toegevoegd aan de servicecatalogus van het systeem en worden gekoppeld aan een systeemalias om hun URL's in te schakelen.

Doel servicecatalogus V2

Controleer en activeer de volgende services op deze manier:

• Rekeningschema:API_CHARTOFACCOUNTS_SRV

• Grootboekrekeningen in rekeningschema:API_GLACCOUNTINCHARTOFACCOUNTS_SRV

• Bedrijfscode:API_COMPANYCODE_SRV

• Bankafstemming:API_CN_BANK_RECONCILIAITON_SRV

• Zakenpartner:API_BUSINESS_PARTNER

• Ondernemingsproject:API_ENTERPRISE_PROJECT_SRV (Zorg er op het moment van installatie voor dat de versie is ingesteld op 0002)

• Proces voor facturen van leveranciers:API_SUPPLIERINVOICE_PROCESS_SRV

• Bijlagen:API_CV_ATTACHMENT_SRV

• Boekhoudkundige documentitems:API_OPLACCTGDOCITEMCUBE_SRV

• WBS-elementen:API_FINWBSELEMENT_SRV

• Interne orders:API_INTERNALORDER_SRV

• Winstcentrum:API_PROFITCENTER_SRV

Stappen voor activering

1. Voer transactie /IWFND/MAINT_SERVICE uit in de SAP GUI.

2. Kijk naar de tabel Servicecatalogus. Als een service uit het overzicht ontbreekt, klik dan op de knop Service toevoegen op de bovenste werkbalk.

3. In het volgende scherm voer je LOCAL in het veld Systeemalias in.

4. Plak de technische naam van je service (bijvoorbeeld API_COMPANYCODE_SRV) in het veld Technical Service Name (Naam technische service) en druk op Enter.

5. Selecteer de overeenkomende rij services in de zoekresultaten en klik op Geselecteerde services toevoegen.

6. Wijs in het venster dat verschijnt een pakkettoewijzing toe (of kies $TMP voor lokaal, niet getransporteerd testen) en bevestig.

7. Ga terug naar het hoofdscherm van de catalogus, selecteer je nieuw toegevoegde service en controleer onder ICF Nodes (linksonder) of het statuslampje groen is. Als het rood is, klik dan op ICF Node > Activeren.

Deel 2: OData V4 Services publiceren (Transactie /IWFND/V4_ADMIN)

Moderne S/4HANA-applicaties maken gebruik van de krachtige OData V4-architectuur. In tegenstelling tot V2 worden OData V4-eindpunten gepubliceerd als geconsolideerde servicegroepen.

Doel servicecatalogus V4

Publiceer de volgende volgende generatie eindpunten met de OData V4 gateway-engine:

Stappen voor activering

1. Voer transactie /IWFND/V4_ADMIN uit in de SAP GUI.

2. Klik op de knop Service Groups publiceren op de bovenste werkbalk.

3. Voer LOCAL in in het veld Systeemalias.

4. Voer je Servicegroep-ID in vanuit de bovenstaande tabel (bijvoorbeeld API_COST_CENTER) en klik op Servicegroepen ophalen.

5. Selecteer het regelitem van de servicegroep in het raster en klik op Servicegroepen publiceren.

6. Geef een beschrijving op als daarom wordt gevraagd, selecteer je ontwikkelpakket (of $TMP) en wijs een Transportaanvraag op maat toe als dat verplicht is voor de transportregels van je omgeving.

7. Klik op bevestigen. De servicegroep verschijnt nu in je actieve V4-catalogus.

Deel 3: Vereenvoudigde configuratie van webservice (via SOAMANAGER)

Voor transactionele documentverwerking en de overdracht van meerdere gegevens tegelijk (zoals het boeken van journaalposten of het verwerken van bankafschriften) maakt S/4HANA gebruik van inkomende SOAP Web Services. In plaats van een complexe implementatiewizard te doorlopen voor elke afzonderlijke interface, kun je ze allemaal in één keer activeren met behulp van de vereenvoudigde configuratiemanager.

Doel servicecatalogus SOAP Web Service

Schakel communicatiekanalen in voor deze specifieke backend-interfaces:

• Bankafschriften posten:BANKSTATEMENTPOST_IN

• Meerdere journaalposten tegelijk wissen:JOURNALENTRYBULKCLEARINGREQUES

• Bevestiging journaalpost:JOURNALENTRYCREATEREQUESTCONFI

Stappen van de configuratie

1. Voer transactie SOAMANAGER uit in je SAP GUI. Hierdoor open je automatisch de SOA Manager beheerconsole in je webbrowser.

2. Navigeer naar de tool Vereenvoudigde configuratie van webservice (te vinden onder het tabblad Servicebeheer).

3. Typ bovenin het scherm JOURNAL* in in het veld Zoekpatroon (of kies een specifieke service uit de lijst) en klik op Go.

4. Zoek je doelservices in de rasterrijen.

5. Vink voor elke service de vakjes aan in de kolommen Gebruikersnaam/Wachtwoord (Basis) en X.509 Clientcertificaat.

6. Klik linksboven in de werkbalk op de knop opslaan.

Het systeem zal de eindpunten onmiddellijk activeren en een bericht Activeren geslaagd onderaan het scherm weergeven, waardoor de interfaces meteen inkomende gegevens kunnen ontvangen.

Volgende stappen

• Een technische gebruiker instellen in SAP S/4HANA Cloud, Private Edition