Caricare dati in SAP Commerce Cloud: ImpEx, Hot Folder e API

SAP Commerce Cloud offre quattro modi per caricare i dati. ImpEx per i caricamenti massivi. I Cloud Hot Folder per i feed di file pianificati. Le API REST OCC per le modifiche a singoli record in tempo reale. SAP Integration Suite quando un flusso coinvolge più sistemi, tipicamente Commerce e l’ERP. Scegliere il metodo sbagliato raramente causa problemi il primo giorno, ma con ogni release l’implementazione diventa più lenta e più difficile da mantenere.

Di seguito: come funziona ciascun metodo, dove si applica e quali errori troviamo più spesso quando prendiamo in carico un progetto Commerce Cloud esistente.

In sintesi: ImpEx per i caricamenti iniziali, le migrazioni e la preparazione degli ambienti. Cloud Hot Folder per i feed di file ricorrenti da PIM, sistema di magazzino o ERP. API OCC quando un’azione dell’utente modifica pochi record. SAP Integration Suite per ordini, prezzi e dati anagrafici scambiati tra Commerce Cloud e S/4HANA. La scelta dipende da volume, frequenza e necessità del tempo reale.

Che cos’è ImpEx e quando usarlo?

ImpEx (Import/Export) è il motore testuale di importazione ed esportazione fornito con SAP Commerce. Legge file simili al CSV, le cui righe di intestazione rimandano a tipi di oggetto e attributi, e crea, modifica, elimina o esporta oggetti della piattaforma come prodotti, clienti od ordini (SAP Help: ImpEx). Un principio semplice, con una profondità sorprendente. Quasi ogni implementazione Commerce Cloud parte da qui, e ogni sviluppatore del team dovrebbe padroneggiarlo prima di toccare il resto della piattaforma.

In che cosa ImpEx eccelle:

• Migrazione iniziale: caricare migliaia di prodotti, categorie e clienti da un sistema precedente
• Preparazione degli ambienti: popolare gli ambienti di sviluppo e di staging con dati di test
• Aggiornamenti di contenuto: modificare in blocco prezzi, giacenze e descrizioni dei prodotti
• Configurazione: pagine CMS, configurazione del sito, gruppi di utenti

Esempio di sintassi ImpEx:

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

Dove ImpEx non è lo strumento giusto: tutto ciò che deve avvenire in tempo reale. ImpEx lavora in batch ed esegue script sul database. Se il prezzo di un singolo prodotto deve cambiare in seguito a un’azione del cliente, conviene usare l’API OCC. Prima della prima importazione importante vale la pena leggere le best practice di SAP per ImpEx.

Come funzionano i Cloud Hot Folder?

Gli Hot Folder automatizzano le importazioni ricorrenti senza codice di integrazione. In SAP Commerce Cloud (la versione gestita da SAP) funzionano come Cloud Hot Folder: i file non arrivano in una directory locale o condivisa, ma in Microsoft Azure Blob Storage, da cui la piattaforma li preleva (SAP Help: Cloud Hot Folders). Chi proviene da un’installazione on-premise con gli Hot Folder classici deve pianificare questo passaggio come parte della migrazione.

Come si svolge il processo:

1. Un sistema esterno o un job pianificato carica un file (di solito CSV, eventualmente compresso) nel container di Blob Storage
2. Commerce Cloud lo sposta in un’area di elaborazione e lo prende in carico
3. Un convertitore trasforma i dati grezzi in ImpEx
4. La piattaforma esegue l’importazione ImpEx
5. I file elaborati vengono archiviati, quelli con errori finiscono in un’area dedicata agli errori

Casi d’uso tipici:

• Aggiornamenti pianificati delle giacenze dal sistema di gestione del magazzino
• Feed di prezzi dall’ERP a intervalli fissi
• Sincronizzazione del catalogo da un PIM che esporta file
• Importazione di media: caricamento massivo di immagini con mappatura dei metadati

Predisponete sempre una gestione degli errori. Gli Hot Folder falliscono in silenzio: se nessuno controlla l’area degli errori, le importazioni non riuscite si accumulano senza che nessuno se ne accorga. In un progetto che abbiamo preso in carico, i file di catalogo fallivano da settimane prima che qualcuno notasse prodotti mancanti nello shop. Usate il monitoraggio dei Cloud Hot Folder nel Backoffice e impostate un avviso in caso di errore. È l’errore più frequente che vediamo con gli Hot Folder.

Quando usare le API OCC?

Le API OCC (Omni Commerce Connect) sono gli endpoint REST con cui Commerce Cloud mette le proprie funzioni di commercio a disposizione di qualsiasi sistema in grado di chiamare un’API REST (SAP Help: Omni Commerce Connect). SAP Composable Storefront si basa interamente su di esse. Sono la scelta giusta anche per:

• Storefront personalizzati in React, Vue o Next.js (confrontiamo le opzioni in SAP Composable Storefront o React e Next.js)
• App mobili: app native iOS o Android che accedono a carrello, checkout e dati di prodotto
• Integrazioni di terze parti: sistemi di cassa, chioschi, portali per i partner
• Operazioni su singoli record: modificare il prezzo di un prodotto o l’indirizzo di un cliente

La regola pratica che do ai nostri sviluppatori: meno di un centinaio di record in risposta a un’azione dell’utente, API. Migliaia di record secondo un calendario, ImpEx o Hot Folder.

Che ruolo ha SAP Integration Suite?

SAP Integration Suite su SAP BTP entra in gioco quando Commerce Cloud deve dialogare con più sistemi aziendali, in primo luogo con l’ERP.

Flussi tipici tramite Integration Suite:

• Replica degli ordini: gli ordini effettuati in Commerce Cloud passano a S/4HANA per evasione, fatturazione e contabilità
• Prezzi in tempo reale: il checkout interroga S/4HANA per i prezzi specifici del cliente e la disponibilità (ATP)
• Anagrafica clienti: i nuovi account creati in Commerce Cloud diventano business partner in S/4HANA
• Anagrafica prodotti: attributi, classificazioni e gerarchie passano da S/4HANA a Commerce Cloud

SAP fornisce contenuti di integrazione preconfigurati per i flussi più comuni tra Commerce e S/4HANA (il SAP Commerce Cloud Integration Extension Pack e i pacchetti di integrazione del SAP Business Accelerator Hub). Non sono pronti all’uso: configurazione e mappatura restano necessarie. Ma riducono in modo sostanziale lo sviluppo di integrazioni su misura. Come funziona con S/4HANA Public Cloud come nucleo ERP lo descriviamo in SAP Commerce Cloud e S/4HANA Public Cloud nel B2B.

Quali sono gli errori più comuni nel caricamento dei dati?

L’errore che vediamo più spesso: i team fanno passare tutto da ImpEx, anche operazioni che dovrebbero chiaramente essere chiamate API. Gli altri seguono a breve distanza.

Caricare troppi dati in una volta. Importazioni complete del catalogo durante l’orario di lavoro competono con il traffico reale per le risorse. Pianificate le importazioni massive nelle fasce di minor carico e caricate in modo incrementale: solo i record modificati.

Saltare la validazione dei dati. ImpEx importa anche dati malformati che poi compromettono lo storefront. Prima dell’importazione verificate campi obbligatori, tipi di dati e integrità referenziale. Commerce Cloud non impedisce di importare un prodotto che rimanda a una categoria inesistente.

Trascurare la gestione degli errori degli Hot Folder. I file non elaborati restano nell’area degli errori e nessuno viene avvisato finché non lo si configura.

Usare ImpEx per aggiornamenti in tempo reale. Eseguire script ImpEx in risposta a singole azioni degli utenti crea colli di bottiglia e conflitti di concorrenza. Per le modifiche puntuali in tempo reale ci sono le API OCC.

Non testare i caricamenti in staging. Eseguite prima in staging gli script ImpEx e le configurazioni degli Hot Folder. Uno script difettoso può corrompere dati di prodotto la cui pulizia richiede ore.

State pianificando una migrazione importante o volete un secondo parere sulla configurazione attuale? Parlate con il nostro team Commerce, oppure leggete il nostro confronto dei partner SAP Commerce Cloud in Svizzera.

Domande frequenti

Che cos’è ImpEx in SAP Commerce Cloud?

ImpEx (Import/Export) è il motore testuale di SAP Commerce per le operazioni sui dati in blocco. La sintassi è simile al CSV e le intestazioni rimandano al sistema di tipi di Commerce: si definiscono il tipo di oggetto, gli attributi e le righe di dati. ImpEx gestisce prodotti, clienti, ordini, contenuti CMS e configurazione, quindi praticamente ogni tipo di dato della piattaforma.

Si può usare ImpEx per aggiornamenti in tempo reale?

Tecnicamente sì, in pratica no. ImpEx è pensato per il lavoro in batch: caricamenti iniziali, aggiornamenti pianificati, dati di test. Per le operazioni su singoli record in tempo reale (un prezzo aggiornato al login di un cliente, un ordine da un’app mobile) si usano le API REST OCC, progettate per scambi richiesta-risposta rapidi.

Qual è la differenza tra Hot Folder e ImpEx?

Gli Hot Folder usano ImpEx dietro le quinte. La differenza è l’automazione: un file arriva in una posizione monitorata (in SAP Commerce Cloud, Azure Blob Storage) e la piattaforma lo elabora autonomamente. Con ImpEx da solo gli script si avviano manualmente dal Backoffice o dall’Administration Console (HAC). Per importazioni ricorrenti come feed di giacenze, aggiornamenti di prezzo e sincronizzazione del catalogo, gli Hot Folder sono più adatti.

Come si gestiscono grandi migrazioni di dati verso Commerce Cloud?

Suddividendo la migrazione in fasi: prima i dati di riferimento (categorie, classificazioni), poi prodotti, clienti e infine ordini. Gli script ImpEx devono poter essere rieseguiti senza creare duplicati (INSERT_UPDATE con chiavi univoche) e ogni fase va testata in staging. Con milioni di record, l’esecuzione parallela di ImpEx e le fasce di minor carico mantengono la piattaforma reattiva.

Quando conviene SAP Integration Suite rispetto alle chiamate API dirette?

Quando un flusso di dati coinvolge più sistemi. Se un ordine in Commerce Cloud deve recuperare il prezzo da S/4HANA, aggiornare le giacenze in un sistema di magazzino e inviare un messaggio tramite SAP Engagement Cloud (in precedenza SAP Emarsys), serve Integration Suite. Le chiamate OCC dirette bastano per le integrazioni punto a punto; Integration Suite aggiunge mappatura, gestione degli errori, monitoraggio e nuovi tentativi automatici, indispensabili nei flussi multi-sistema.