API-Dienste in SAP S/4HANA Cloud, Private Edition aktivieren

Bei der Entwicklung von benutzerdefinierten oder Standardintegrationen mit SAP S/4HANA® Private Cloud ist die bloße Vergabe von Benutzerberechtigungen nur die halbe Arbeit. Die Zielschnittstellen müssen innerhalb der Kommunikationsframeworks des Systems explizit aktiviert und veröffentlicht werden.

SAP-S/4HANA-Umgebungen nutzen drei unterschiedliche Kommunikationsarchitekturen: OData V2, OData V4 und SOAP-Webdienste. Da diese auf separaten technischen Engines laufen, werden sie über unterschiedliche Transaktionen aktiviert.

Dieser Leitfaden bietet eine übersichtliche Anleitung zur Veröffentlichung Ihrer erforderlichen Endpunkte für Finanz-, Projekt- und Stammdaten.

Teil 1: Aktivieren von OData V2-Diensten (Transaktion /IWFND/MAINT_SERVICE)

Herkömmliche SAP-REST-basierte APIs nutzen die OData-V2-Architektur. Diese Dienste müssen in den Servicekatalog Ihres Systems aufgenommen und mit einem Systemalias verknüpft werden, damit ihre URLs aktiviert werden.

Ziel-V2 – Dienstübersicht

Überprüfen und aktivieren Sie die folgenden Dienste mit dieser Methode:

• Kontenplan:API_CHARTOFACCOUNTS_SRV

• Hauptbuchkonten im Kontenplan:API_GLACCOUNTINCHARTOFACCOUNTS_SRV

• Unternehmenscode:API_COMPANYCODE_SRV

• Kontenabstimmung:API_CN_BANK_RECONCILIAITON_SRV

• Geschäftspartner:API_BUSINESS_PARTNER

• Enterprise-Projekt:API_ENTERPRISE_PROJECT_SRV (Stellen Sie sicher, dass die Version während der Einrichtung auf 0002 gesetzt ist)

• Bearbeitung von Lieferantenrechnungen:API_SUPPLIERINVOICE_PROCESS_SRV

• Anhänge:API_CV_ATTACHMENT_SRV

• Buchhaltungsbelegpositionen:API_OPLACCTGDOCITEMCUBE_SRV

• WBS-Elemente:API_FINWBSELEMENT_SRV

• Interne Aufträge:API_INTERNALORDER_SRV

• Profit Center:API_PROFITCENTER_SRV

Aktivierungsschritte

1. Führen Sie die Transaktion /IWFND/MAINT_SERVICE im SAP GUI aus.

2. Sehen Sie sich die Tabelle Dienstkatalog an. Falls ein Dienst aus der Bestandsliste fehlt, klicken Sie in der oberen Symbolleiste auf die Schaltfläche Dienst hinzufügen.

3. Geben Sie im nächsten Bildschirm im Feld System Alias die Adresse LOCAL ein.

4. Fügen Sie den technischen Namen Ihres Zieldienstes (zum Beispiel API_COMPANYCODE_SRV) in das Feld Technischer Dienstname ein und drücken Sie die Eingabetaste.

5. Wählen Sie die entsprechende Dienstzeile aus der Suchergebnisliste aus und klicken Sie auf Ausgewählte Dienste hinzufügen.

6. Weisen Sie im Popup-Fenster eine Paketzuordnung zu (oder wählen Sie $TMP für lokale, nicht transportierte Tests) und bestätigen Sie.

7. Kehren Sie zum Hauptbildschirm des Katalogs zurück, wählen Sie Ihren neu hinzugefügten Dienst aus und überprüfen Sie unter ICF-Knoten (unten links), ob die Statusanzeige grün leuchtet. Falls sie rot ist, klicken Sie auf ICF-Knoten > Aktivieren.

Teil 2: OData V4-Dienstgruppen veröffentlichen (Transaktion /IWFND/V4_ADMIN)

Moderne S/4HANA-Anwendungen nutzen die leistungsstarke OData-V4-Architektur. Im Gegensatz zu V2 werden OData-V4-Endpunkte als konsolidierte Dienstgruppen veröffentlicht.

Ziel-V2 – Dienstgruppenübersicht

Veröffentlichen Sie die folgenden Endpunkte der nächsten Generation mithilfe der OData-V4-Gateway-Engine:

Aktivierungsschritte

1. Führen Sie die Transaktion /IWFND/V4_ADMIN im SAP GUI aus.

2. Klicken Sie in der oberen Symbolleiste auf die Schaltfläche Dienstgruppen veröffentlichen.

3. Geben Sie LOCAL in das Feld System Alias ein.

4. Geben Sie Ihre Ziel-Dienstgruppen-ID aus der obigen Tabelle ein (zum Beispiel API_COST_CENTER) und klicken Sie auf Dienstgruppen abrufen.

5. Wählen Sie die Position der Dienstgruppe in der Tabelle aus und klicken Sie auf Dienstgruppen veröffentlichen.

6. Geben Sie bei Aufforderung eine Beschreibung ein, wählen Sie Ihr Entwicklungspaket aus (oder $TMP) und weisen Sie gegebenenfalls einen Customizing-Transportauftrag zu, sofern dies gemäß den Transportregeln Ihrer Landschaft erforderlich ist.

7. Klicken Sie auf Bestätigen. Die Dienstgruppe wird nun in Ihrem aktiven V4-Katalog angezeigt.

Teil 3: Vereinfachte Konfiguration von Webdiensten (über SOAMANAGER)

Für die Verarbeitung von Transaktionsbelegen und die Übertragung von Massendaten (wie das Buchen von Journalbuchungen oder die Verarbeitung von Kontoauszügen) nutzt S/4HANA eingehende SOAP-Webdienste. Anstatt für jede einzelne Schnittstelle einen komplexen Bereitstellungsassistenten durchzuarbeiten, können Sie diese mithilfe des vereinfachten Konfigurationsmanagers auf einmal aktivieren.

Ziel-SOAP-Webdienste - Übersicht

Aktivieren Sie Kommunikationskanäle für diese spezifischen Backend-Schnittstellen:

• Verbuchung von Kontoauszügen:BANKSTATEMENTPOST_IN

• Massenabrechnung von Journalbuchungen:JOURNALENTRYBULKCLEARINGREQUES

• Bestätigung des Journal-Eintrags:JOURNALENTRYCREATEREQUESTCONFI

Konfigurationsschritte

1. Führen Sie die Transaktion SOAMANAGER in Ihrem SAP GUI aus. Dadurch wird die SOA Manager-Verwaltungskonsole automatisch in Ihrem Webbrowser geöffnet.

2. Navigieren Sie zum Tool Vereinfachte Webdienstkonfiguration (auf der Registerkarte Dienstverwaltung ).

3. Geben Sie in das Feld Suchmuster am oberen Rand des Bildschirms JOURNAL* ein (oder wählen Sie einen bestimmten Dienst aus der Liste) und klicken Sie auf Los.

4. Suchen Sie Ihre gewünschten Dienste in den Zeilen der Tabelle.

5. Markieren Sie für jeden Dienst einfach die Kästchen in den Spalten Benutzername/Passwort (Basic) und X.509-Client-Zertifikat.

6. Klicken Sie auf die Schaltfläche Speichern in der oberen linken Symbolleiste.

Das System aktiviert die Endpunkte umgehend und zeigt am unteren Bildschirmrand die Meldung Aktivierung erfolgreich an, wodurch die Schnittstellen sofort für den Empfang eingehender Daten bereit sind.

Nächste Schritte

• Technischen Benutzer in SAP S/4HANA Cloud, Private Edition, anlegen