Direkt zu Hauptinhalt

Verbindung zur S/4HANA Cloud Public Edition über OData V4

SAP S/4HANA Cloud Public Edition unterstützt das Importieren des dab RFC Add-On für diese Verbindungsart nicht. Stattdessen konfigurieren Sie den Zugriff über die Kommunikationsanwendungen im SAP Fiori Launchpad. Dazu benötigen Sie einen Communication User, ein Communication System als Repräsentation der Nexus Umgebung sowie eine Communication Arrangement für das erforderliche Kommunikationsszenario.

Nachdem die SAP-seitige Konfiguration abgeschlossen ist, richten Sie den von dem Ziel-Mandanten bereitgestellten OData V4-Endpunkt in dab Nexus als OData Communication Verbindung ein. Nexus bietet in diesem Public Cloud-Szenario keinen Servicekatalog zur automatischen Auswahl von Quellen.

Voraussetzungen​

Überprüfen Sie die SAP System​

Bestätigen Sie Produkt, Edition, Release und den Ziel-Mandanten über Identify SAP System. Bestimmen Sie das Betriebsmodell nicht anhand des Hostnamens oder des Fiori Launchpads allein.

SAP ECC, S/4HANA On-Premise, Private Cloud und Public Edition nutzen unterschiedliche Verbindungs- und Administrationsmodelle. Markieren Sie unbekannte Werte als unbestätigt und verifizieren Sie diese mit dem SAP-Administrator.

Überprüfen Sie die Nexus Umgebung​

  • Kontrollieren Sie die installierte Version unter Einstellungen → Lizenz & Support. Vergewissern Sie sich, dass OData Communication verfügbar ist.
  • Stellen Sie sicher, dass die Umgebung den SAP API-Host über HTTPS auf TCP-Port 443 erreichen und dessen TLS-Zertifikat validieren kann.

Aktivieren Sie den Servicekatalog​

Das Kommunikationsszenario SAP_COM_0181 ist erforderlich, da es den Zugriff auf den von Nexus genutzten SAP Servicekatalog ermöglicht.

Erstellen und pflegen Sie eine Communication Arrangement für:

SAP_COM_0181

Weisen Sie das Communication System und den Communication User für die Nexus Integration zu.

Wichtig

SAP_COM_0181 ist eine zwingende Voraussetzung für die Nexus OData V4 Verbindung, da damit der Servicekatalog verfügbar wird. Es ersetzt nicht das für die eigentliche Datenquelle notwendige Kommunikationsszenario. Beispielsweise erfordert eine CDI_CDS Quelle zudem SAP_COM_0531 und eine entsprechende Communication Arrangement.

Prozessüberblick​

  1. Quelle und Kommunikationsszenario auswählen.
  2. Für CDI_CDS die CDS Allowlist sowie die Berechtigungsgruppe konfigurieren.
  3. Communication User und Communication System erstellen.
  4. Communication Arrangement erstellen.
  5. Entity-Set-Pfad bestimmen.
  6. Nexus Verbindung erstellen, testen und registrieren.
  7. Paket für die hinzugefügte Quelle in Package Studio erstellen und Testextraktion durchführen.

1. Quelle und Kommunikationsszenario auswählen​

Beschaffen Sie einen bekannten Referenzdatensatz mit vollständigem Schlüssel und erwarteten Feldwerten. Nutzen Sie diesen zur Validierung von Verbindung und Extraktion.

QuelleVerifizierungKommunikationsszenario
CDI_CDSSuchen Sie die Quelle im View Browser. Überprüfen Sie deren Felder, Schlüssel, Extraktionsfähigkeit und Delta-Möglichkeit für das Ziel-Release.SAP_COM_0531
Business APIFinden Sie eine veröffentlichte OData V4 API für Public Edition im SAP Business Accelerator Hub. Überprüfen Sie die erforderlichen Entitäten, Felder und die API-Version.Szenario-ID laut API-Dokumentation
Gefahr

Ein von einer Fiori-Anwendung genutzter Service ist nicht automatisch für externe Integration freigegeben.

Bei Business APIs gilt:

  • Die CDI Allowlist ist nicht anzuwenden.
  • SAP_COM_0531 ist nicht zwangsläufig das richtige Szenario.
  • SAP_COM_0532 ersetzt nicht den hier beschriebenen CDI OData Zugriff.
  • Die quellenspezifische Communication Arrangement wird zusätzlich zur service catalog Arrangement für SAP_COM_0181 benötigt.

Custom Key User CDS Views​

Überprüfen Sie in der Custom CDS Views-App, dass die View das Szenario Data Extraction verwendet, ihren Prüfstatus besteht und veröffentlicht ist. Dieser Key-User-Weg ist von vom Entwickler erstellten Z* CDS Views zu unterscheiden; gehen Sie nicht davon aus, dass ABAP-Extraktionsannotation zu beliebigen Custom-Objekten in der Public Edition hinzugefügt werden können. SAP dokumentiert vollständige Extraktion ohne Delta für diesen Key-User-Quellentyp in SAP KBA 2884410 in SAP for Me. Diese Einschränkung gilt nicht automatisch für SAP-Standard-Extraktoren.

Für editionübergreifende Prüfungen—including Servicekatalog-Zugriff, CDI Provider Discovery, Metadaten und Package Studio Troubleshooting—siehe Troubleshooting SAP OData V4 CDS Views Missing from Package Studio.

2. Konfiguration der CDS Allowlist und Berechtigungsgruppe​

Führen Sie diesen Abschnitt nur für CDI_CDS durch. Bei einer Business API fahren Sie fort mit 3. Communication User erstellen.

Falls Sie keinen Zugriff auf die Konfigurationsaktivität haben, muss der verantwortliche SAP Cloud-Konfigurationsverantwortliche diesen Schritt durchführen.

2.1 Öffnen der Konfigurationsaktivität​

Suchen Sie Define Allowlists for CDS View Extraction über einen der folgenden Wege.

Manage Your Solution​

  1. Öffnen Sie Manage Your Solution → Configure Your Solution.
  2. Wenden Sie folgende Filter an:
    • Application Area: Application Platform and Infrastructure
    • Sub Application Area: Data Extraction
  3. Öffnen Sie das zutreffende Suchergebnis.
  4. Wählen Sie Configure für den Konfigurationsschritt.

SAP Central Business Configuration​

Suchen Sie nach dem Aktivitätsnamen unter:

Configuration Activities
→ General Settings
→ Further Settings

Je nach Oberfläche erscheint die Aktivität direkt unter Configuration.

2.2 Berechtigungsgruppe und Allowlist erzeugen​

  1. Wählen Sie New Entries.
  2. Geben Sie eine eindeutige Authorization Group ID an.
  3. Erfassen Sie eine aussagekräftige Beschreibung.
  4. Wählen Sie Explicit allow list als Typ.
  5. Fügen Sie die benötigten CDS-Quellen zur Allowlist der Gruppe hinzu.
  6. Speichern Sie die Konfiguration.
  7. Wählen Sie den erforderlichen Customizing-Transport aus.
  8. Dokumentieren Sie die Authorization Group ID für die quellebezogene Communication Arrangement.
  9. Prüfen Sie bei getrenntem Ziel-Mandanten, ob die Gruppe und deren Einträge dort ebenfalls verfügbar sind.

2.3 Fehlende Allowlist-Aktivität​

Fehlt die Aktivität, muss der Konfigurationsverantwortliche prüfen, ob der Scope-Item Data Protection and Privacy (5LE) aktiviert ist. SAP KBA 3781796 in SAP for Me beschreibt die fehlende Aktivierung dieses Scope-Items als Ursache. Nach Aktivierung suchen Sie die Aktivität erneut.

3. Communication User erstellen​

  1. Öffnen Sie Maintain Communication Users.
  2. Erstellen Sie einen dedizierten Communication User für Nexus oder öffnen Sie den für diese Integration vorgesehenen bestehenden User.
  3. Konfigurieren Sie die vom Service geforderte Authentifizierungsart.

Benutzername und Passwort​

  • Legen Sie das Passwort für den Communication User fest.
  • Übergeben Sie es ausschließlich über den freigegebenen Secret-Management-Prozess.
  • Speichern Sie das Passwort später in der Nexus Verbindung.

Client-Zertifikat​

  • Weisen Sie das öffentliche Client-Zertifikat dem Communication User zu.
  • Nexus benötigt den zugehörigen privaten Schlüssel.
  • Übergeben Sie Nexus eine .p12 Datei mit Client-Zertifikat und privatem Schlüssel.
  • Passwort für die Datei getrennt von der Zertifikatsdatei speichern und übertragen.
  1. Speichern Sie den User.
  2. Dokumentieren Sie dessen Identität für das Communication System.
Hint

Der Communication User ist nicht das persönliche Konto für die Anmeldung am Fiori Launchpad. Ihr Fiori-Benutzer konfiguriert die Integration, während Nexus den Service mit dem Communication User oder dessen Zertifikat aufruft. Eine erfolgreiche Fiori-Anmeldung validiert daher nicht die Nexus Authentifizierung.

4. Communication System für Nexus erstellen​

  1. Öffnen Sie Communication Systems.
  2. Erstellen Sie ein System für die relevante Nexus Umgebung.
  3. Vergeben Sie eine eindeutige System-ID und einen aussagekräftigen Namen, z. B.: DAB_NEXUS_PROD
  4. Unter Host Name geben Sie den Hostnamen der relevanten Nexus Installation oder Managed App an.
  5. Geben Sie nur den Hostnamen an, ohne Schema oder URL-Pfad.
  6. Unter Users for Inbound Communication fügen Sie den in 3. Communication User erstellen erzeugten Communication User hinzu.
  7. Wählen Sie die Authentifizierungsmethode aus.
  8. Speichern Sie das Communication System und überprüfen Sie die Zuordnung des Users.

Inbound bedeutet in diesem Kontext, dass Nexus eine Anfrage an SAP stellt.

Gefahr

Das Communication System repräsentiert Nexus als Kommunikationspartner. Sein Host Name ist nicht der SAP API Hostname, der als Nexus Base URL verwendet wird. Die SAP API URL erhalten Sie aus den Inbound Services der Communication Arrangement.

Verwenden Sie separate Communication Systems, wenn DEV, QA und PROD unterschiedliche Nexus Runtimes oder technische Identitäten verwenden.

5. Communication Arrangements erstellen​

Mindestens zwei Communication Arrangements können erforderlich sein. Erstellen Sie folgende Communication Arrangements:

  1. Eine Servicekatalog-Arrangement für SAP_COM_0181.
  2. Eine quellenspezifische Arrangement für SAP_COM_0531 oder das in der ausgesuchten Business API dokumentierte Kommunikationsszenario.

5.1 Servicekatalog-Arrangement erstellen​

  1. Öffnen Sie Communication Arrangements.
  2. Wählen Sie New.
  3. Wählen Sie das Kommunikationsszenario:
    SAP_COM_0181
  4. Vergeben Sie einen aussagekräftigen Namen für die Arrangement.
  5. Wählen Sie das Nexus Communication System, erstellt in 4. Communication System für Nexus erstellen.
  6. Unter Inbound Communication prüfen Sie:
    • den zugeordneten Communication User,
    • die konfigurierte Authentifizierungsmethode.
  7. Speichern Sie die Arrangement.
  8. Öffnen Sie Inbound Services und prüfen Sie den angebotenen Servicekatalog-Zugriff.
Wichtig

Die SAP_COM_0181 Arrangement ermöglicht den Servicekatalog. Sie berechtigt nicht zum Zugriff auf die Entitäten der ausgewählten Datenquelle.

5.2 Quellebezogene Arrangement erstellen​

  1. Öffnen Sie Communication Arrangements.
  2. Wählen Sie New.
  3. Wählen Sie das in 1. Quelle und Kommunikationsszenario auswählen identifizierte Szenario:
    • für CDI: SAP_COM_0531,
    • für eine Business API: die dokumentierte Kommunikationsszenario-ID.
  4. Vergeben Sie einen Namen für die Arrangement.
  5. Wählen Sie das Nexus Communication System, erstellt in 4. Communication System für Nexus erstellen.
  6. Unter Inbound Communication prüfen Sie:
    • den zugeordneten Communication User,
    • die konfigurierte Authentifizierungsmethode.
  7. Für CDI tragen Sie die in 2.2 Berechtigungsgruppe und Allowlist erzeugen erzeugte Authorization Group ID unter Additional Properties → Authorization Group ID ein.
  8. Speichern Sie die Arrangement.
  9. Öffnen Sie Inbound Services.
  10. Kopieren Sie die für den Ziel-Mandanten angezeigten URLs.

Häufige Konfigurationsfehler​

Authorization Group muss gepflegt werden​

Prüfen Sie, ob:

  • die Authorization Group ID exakt eingetragen wurde,
  • die Gruppe im Ziel-Mandanten vorhanden ist,
  • die erforderlichen CDS-Quellen in deren Allowlist enthalten sind.

SAP KBA 3118974 in SAP for Me beschreibt diesen Fehler.

Servicekatalog ist nicht verfügbar​

Prüfen Sie, ob:

  • eine Communication Arrangement für SAP_COM_0181 existiert,
  • das richtige Communication System zugeordnet ist,
  • der erforderliche Communication User eingetragen ist,
  • die konfigurierte Authentifizierungsmethode mit der Nexus Verbindung übereinstimmt.

Betrachten Sie die quellenspezifische Arrangement nicht als Ersatz für SAP_COM_0181.

Erforderlicher Service wird nicht angeboten​

Vergleichen Sie:

  • das ausgewählte Kommunikationsszenario,
  • die API-Version,
  • SAP Cloud Release,
  • SAP-Dokumentation zum jeweiligen Release.

Setzen Sie kein unzutreffendes Szenario ein, nur weil es einen ähnlich bezeichneten Service enthält.

6. Entitätenspezifischer Pfad bestimmen​

6.1 CDI_CDS​

Anbieter-Verzeichnis abfragen​

Verwenden Sie den Communication User, um das CDI Provider Directory über den CDI-Endpunkt der Arrangement aufzurufen. SAP dokumentiert dieses Muster:

https://<SAP-API-Host>/sap/opu/odata4/sap/cdi/default/sap/cdi/0001/Providers
  1. Suchen Sie den technischen Extraktornamen aus 1. Quelle und Kommunikationsszenario auswählen. Bei einer klassischen CDS View kann dies der generierte SQL View Name mit Kategorie-Suffix sein; CMMPURORDHIST$F ist bspw. ein Fakt/Transaktions-Extraktor. Bei einer CDS View Entity nutzen Sie den Entity-Namen.
  2. Der Extraktornamen ist nicht die CDI Provider-URL. Konstruieren Sie keine URL daraus; übernehmen Sie die von SAP zurückgegebene Provider-URL. Siehe CDI_CDS Troubleshooting Guide für Namensbeispiele und Details.
  3. Folgen Sie jeder zurückgegebenen @odata.nextLink Seite.
  4. Kopieren Sie die von SAP für den Ziel-Mandanten angebotene Provider-URL.
  5. Konstruieren Sie keinen CDI_CDS Pfad allein aus dem View-Namen.

Service und Metadaten prüfen​

Rufen Sie auf:

  • das Service-Dokument am Service-Root, inklusive abschließendem /,
  • das Metadaten-Dokument unter service root + /$metadata.

Überprüfen Sie:

  • das Facts Entity Set,
  • die benötigten Felder,
  • den vollständigen Schlüssel,
  • Feldtypen, Währungen und Einheiten.

Ein Anbieter im Ziel-Mandanten kann beispielsweise folgende Pfade zurückgeben:

Service root: /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/c_billingdocitembasicdex_1/0001/
Metadata: /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/c_billingdocitembasicdex_1/0001/$metadata
Entity set: /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/c_billingdocitembasicdex_1/0001/Facts

Ersetzen Sie dieses Beispiel durch die vom Ziel-Mandanten zurückgegebene Provider-URL. Providers wird für die Quellenerkennung verwendet. Die vom Ziel-Mandanten bereitgestellte Provider-URL muss während des Setups in den Nexus Einstellungen ergänzt werden.

Ist der Provider nicht vorhanden oder erscheint er in SAP, aber nicht in Package Studio, befolgen Sie den CDI_CDS Troubleshooting Guide.

6.2 Business API​

  1. Kopieren Sie den Service Root aus Inbound Services der relevanten Communication Arrangement.
  2. Rufen Sie das Service-Dokument auf.
  3. Rufen Sie /$metadata auf.
  4. Identifizieren Sie das benötigte Entity Set, Felder und den vollständigen Schlüssel.
  5. Verwenden Sie den veröffentlichten Entity-Set-Namen mit dokumentierter Groß-/Kleinschreibung.
Hint

Facts ist kein generisches Suffix für Business APIs. Verwenden Sie stets den im Metadaten-Dokument der jeweiligen API deklarierten Entity-Set-Namen.