Daten laden in SAP Commerce Cloud: ImpEx, Hot Folders und APIs

SAP Commerce Cloud kennt vier Wege, Daten ins System zu bringen. ImpEx für grosse Datenmengen. Cloud Hot Folders für geplante, dateibasierte Feeds. OCC REST APIs für Änderungen an einzelnen Datensätzen in Echtzeit. SAP Integration Suite, wenn ein Ablauf mehrere Systeme umfasst, typischerweise Commerce und das ERP. Wer die falsche Methode wählt, merkt es am ersten Tag selten. Aber die Implementierung wird mit jedem Release langsamer und schwerer zu warten.

Im Folgenden: wie jede Methode funktioniert, wofür sie passt und welche Fehler wir am häufigsten finden, wenn wir ein bestehendes Commerce-Cloud-Projekt übernehmen.

Kurzfassung: ImpEx für Erstbefüllung, Migrationen und das Aufsetzen von Umgebungen. Cloud Hot Folders für wiederkehrende Datei-Feeds aus PIM, Lagerverwaltung oder ERP. OCC APIs, wenn eine Benutzeraktion eine Handvoll Datensätze ändert. SAP Integration Suite für Aufträge, Preise und Stammdaten zwischen Commerce Cloud und S/4HANA. Entscheidend sind Volumen, Häufigkeit und die Frage, ob die Änderung in Echtzeit passieren muss.

Was ist ImpEx und wann setzen Sie es ein?

ImpEx (Import/Export) ist die textbasierte Import- und Export-Engine, die mit SAP Commerce ausgeliefert wird. Sie liest CSV-ähnliche Dateien, deren Kopfzeilen auf Item-Typen und Attribute verweisen, und legt damit Plattformobjekte wie Produkte, Kunden oder Aufträge an, ändert, löscht oder exportiert sie (SAP Help: ImpEx). Einfaches Prinzip, erstaunlich viel Tiefe. Fast jede Commerce-Cloud-Implementierung beginnt hier, und jeder Entwickler im Team sollte ImpEx gut beherrschen, bevor er etwas anderes auf der Plattform anfasst.

Wofür ImpEx gut ist:

• Erstmigration: Tausende Produkte, Kategorien und Kunden aus einem Altsystem laden
• Umgebungen aufsetzen: Entwicklungs- und Staging-Umgebungen mit Testdaten befüllen
• Inhaltsänderungen: Preise, Lagerbestände und Produkttexte im Batch anpassen
• Konfiguration: CMS-Seiten, Site-Konfiguration, Benutzergruppen

ImpEx-Beispiel:

INSERT_UPDATE Product; code[unique=true]; name[lang=en]; catalogVersion(catalog(id),version)
; PROD001 ; Widget A ; productCatalog:Staged
; PROD002 ; Widget B ; productCatalog:Staged

Wofür ImpEx das falsche Werkzeug ist: alles in Echtzeit. ImpEx arbeitet im Batch und führt Skripte gegen die Datenbank aus. Muss sich ein einzelner Produktpreis ändern, weil ein Kunde etwas ausgelöst hat, ist die OCC API die richtige Wahl. Vor dem ersten grossen Import lohnen sich die ImpEx-Best-Practices von SAP.

Wie funktionieren Cloud Hot Folders?

Hot Folders automatisieren wiederkehrende Importe ohne Integrationscode. In SAP Commerce Cloud (der von SAP betriebenen Version) laufen sie als Cloud Hot Folders: Die Dateien landen nicht in einem lokalen oder freigegebenen Verzeichnis, sondern in Microsoft Azure Blob Storage, und die Plattform holt sie dort ab (SAP Help: Cloud Hot Folders). Wer von einer On-Premise-Installation mit klassischen Hot Folders kommt, sollte diese Umstellung als Teil der Migration einplanen.

So läuft der Prozess ab:

1. Ein externes System oder ein geplanter Job lädt eine Datei (meist CSV, optional gezippt) in den Blob-Storage-Container
2. Commerce Cloud verschiebt sie in einen Verarbeitungsbereich und nimmt sie auf
3. Ein Konverter übersetzt die Rohdaten in ImpEx
4. Die Plattform führt den ImpEx-Import aus
5. Verarbeitete Dateien werden archiviert, fehlerhafte landen in einem Fehlerbereich

Typische Einsatzfälle:

• Geplante Bestandsupdates aus der Lagerverwaltung
• Preis-Feeds aus dem ERP in festem Rhythmus
• Katalogabgleich aus einem PIM, das Dateien exportiert
• Medienimporte: Bilder in grosser Zahl mit Metadaten-Mapping

Richten Sie in jedem Fall eine Fehlerbehandlung ein. Hot Folders scheitern leise: Schaut niemand in den Fehlerbereich, stapeln sich fehlgeschlagene Importe unbemerkt. In einem Projekt, das wir übernommen haben, schlugen Katalogdateien wochenlang fehl, bis jemand die fehlenden Produkte im Shop bemerkte. Nutzen Sie das Cloud-Hot-Folder-Monitoring im Backoffice und richten Sie eine Warnung bei Fehlern ein. Das ist der häufigste Hot-Folder-Fehler, den wir sehen.

Wann setzen Sie OCC APIs ein?

OCC-APIs (Omni Commerce Connect) sind die REST-Endpunkte, über die Commerce Cloud ihre Commerce-Funktionen für alles bereitstellt, was REST aufrufen kann (SAP Help: Omni Commerce Connect). SAP Composable Storefront läuft vollständig darüber. Die richtige Wahl sind sie auch für:

• Eigene Storefronts in React, Vue oder Next.js (die Optionen vergleichen wir in SAP Composable Storefront vs. React und Next.js)
• Mobile Apps: native iOS- oder Android-Apps mit Zugriff auf Warenkorb, Checkout und Produktdaten
• Integrationen von Drittsystemen: Kassensysteme, Kioske, Partnerportale
• Einzelne Datensätze: den Preis eines Produkts oder die Adresse eines Kunden ändern

Meine Faustregel für unsere Entwickler: weniger als etwa 100 Datensätze als Reaktion auf eine Benutzeraktion, dann API. Tausende Datensätze nach Zeitplan, dann ImpEx oder Hot Folders.

Welche Rolle spielt SAP Integration Suite?

SAP Integration Suite auf SAP BTP kommt ins Spiel, wenn Commerce Cloud mit mehreren Unternehmenssystemen sprechen muss, allen voran mit dem ERP.

Typische Abläufe über die Integration Suite:

• Auftragsreplikation: Aufträge aus Commerce Cloud gehen zur Auslieferung, Fakturierung und Buchhaltung an S/4HANA
• Preise in Echtzeit: Der Checkout fragt S/4HANA nach kundenspezifischen Preisen und verfügbarem Bestand (ATP)
• Kundenstammdaten: Neue Konten in Commerce Cloud werden in S/4HANA zu Geschäftspartnern
• Produktstammdaten: Attribute, Klassifikationen und Hierarchien fliessen von S/4HANA in Commerce Cloud

SAP liefert vorkonfigurierte Integrationsinhalte für die häufigsten Abläufe zwischen Commerce und S/4HANA (das SAP Commerce Cloud Integration Extension Pack und die Integrationspakete im SAP Business Accelerator Hub). Einstecken und loslegen ist das nicht, Konfiguration und Mapping bleiben. Aber sie ersparen einen grossen Teil der individuellen Integrationsarbeit. Wie das mit S/4HANA Public Cloud als ERP-Kern aussieht, beschreiben wir in SAP Commerce Cloud und S/4HANA Public Cloud im B2B.

Welches sind die häufigsten Fehler beim Laden von Daten?

Der Fehler, den wir am häufigsten sehen: Teams schicken alles durch ImpEx, auch Vorgänge, die eindeutig API-Aufrufe sein sollten. Die übrigen folgen dicht dahinter.

Zu viele Daten auf einmal laden. Vollständige Katalogimporte während der Geschäftszeiten konkurrieren mit dem Live-Verkehr um Ressourcen. Planen Sie Massenimporte in Randzeiten und laden Sie inkrementell: nur geänderte Datensätze.

Keine Datenprüfung. ImpEx importiert auch fehlerhafte Daten, die dann die Storefront beschädigen. Prüfen Sie vor dem Import Pflichtfelder, Datentypen und referenzielle Integrität. Commerce Cloud hindert Sie nicht daran, ein Produkt zu importieren, das auf eine nicht existierende Kategorie verweist.

Fehlerbehandlung der Hot Folders vernachlässigen. Fehlgeschlagene Dateien bleiben im Fehlerbereich liegen, und niemand wird benachrichtigt, solange Sie das nicht einrichten.

ImpEx für Echtzeit-Updates nutzen. ImpEx-Skripte als Reaktion auf einzelne Benutzeraktionen führen zu Engpässen und Race Conditions. Für Einzeländerungen in Echtzeit sind die OCC APIs da.

Ladevorgänge nicht im Staging testen. Führen Sie ImpEx-Skripte und Hot-Folder-Konfigurationen zuerst im Staging aus. Ein fehlerhaftes Skript kann Produktdaten beschädigen, deren Bereinigung Stunden dauert.

Sie planen eine grössere Migration oder möchten eine zweite Meinung zu Ihrem bestehenden Setup? Sprechen Sie mit unserem Commerce-Team, oder lesen Sie, wie wir die SAP-Commerce-Cloud-Partner in der Schweiz vergleichen.

Häufige Fragen

Was ist ImpEx in SAP Commerce Cloud?

ImpEx (Import/Export) ist die textbasierte Engine von SAP Commerce für Massendatenoperationen. Die Syntax ist CSV-ähnlich, die Kopfzeilen verweisen auf das Typsystem von Commerce: Sie definieren den Item-Typ, die Attribute und die Datenzeilen. ImpEx verarbeitet Produkte, Kunden, Aufträge, CMS-Inhalte und Konfiguration, also praktisch jeden Datentyp der Plattform.

Kann ich ImpEx für Echtzeit-Updates verwenden?

Technisch ja, in der Praxis nein. ImpEx ist für Batch-Arbeit gebaut: Erstbefüllung, geplante Updates, Testdaten für Umgebungen. Für Einzeländerungen in Echtzeit (eine Preisänderung beim Login eines Kunden, ein Auftrag aus einer mobilen App) nutzen Sie die OCC REST APIs, die für schnelle Anfrage-Antwort-Zyklen gebaut sind.

Was ist der Unterschied zwischen Hot Folders und ImpEx?

Hot Folders nutzen im Hintergrund ImpEx. Der Unterschied ist die Automatisierung: Eine Datei landet an einem überwachten Ort (in SAP Commerce Cloud ist das Azure Blob Storage), und die Plattform verarbeitet sie selbständig. Mit reinem ImpEx starten Sie Skripte manuell über das Backoffice oder die Administration Console (HAC). Für wiederkehrende Importe wie Bestands-Feeds, Preisupdates und Katalogabgleiche passen Hot Folders besser.

Wie gehe ich bei grossen Datenmigrationen in Commerce Cloud vor?

Teilen Sie die Migration in Phasen: zuerst Referenzdaten (Kategorien, Klassifikationen), dann Produkte, dann Kunden, dann Aufträge. Schreiben Sie ImpEx-Skripte, die sich ohne Duplikate erneut ausführen lassen (INSERT_UPDATE mit eindeutigen Schlüsseln), und testen Sie jede Phase im Staging. Bei Millionen von Datensätzen helfen parallele ImpEx-Ausführung und Randzeiten, damit die Plattform reaktionsfähig bleibt.

Wann ist SAP Integration Suite besser als direkte API-Aufrufe?

Wenn ein Datenfluss mehrere Systeme umfasst. Muss ein Auftrag aus Commerce Cloud Preise aus S/4HANA holen, den Bestand in einer Lagerverwaltung aktualisieren und eine Nachricht in SAP Engagement Cloud (ehemals SAP Emarsys) auslösen, ist das ein Fall für die Integration Suite. Direkte OCC-Aufrufe reichen für Punkt-zu-Punkt-Integrationen. Die Integration Suite bringt Mapping, Fehlerbehandlung, Monitoring und Wiederholungslogik mit, die Abläufe über mehrere Systeme brauchen.