# Dati dei fornitori in Pimcore, mappati visivamente Pimcore 11 non ha un webservice REST, quindi SDM Portal scrive tramite l'API GraphQL di Datahub: oggetti trovati per key, creati sotto la cartella che scegli, aggiornati una lingua alla volta. Il connettore è in beta e questa pagina dice esattamente cosa fa e cosa non fa. Versione web: https://sdmportal.com/it/pimcore/ ## La connessione - **Protocollo:** Datahub GraphQL, /pimcore-graphql-webservices/{config} - **Autenticazione:** API key di Datahub sulla security definition della config - **Versione:** Pimcore 11 - **Struttura:** Class - **Indirizzamento:** Key dell'oggetto, sotto una cartella di destinazione per profilo - **Stato:** Beta ## Dove si blocca davvero un feed fornitore per Pimcore ### Nessun webservice REST Pimcore 11 l'ha rimosso. Tutto passa da una configurazione Datahub che crei tu, che decide quali class sono leggibili e scrivibili e che contiene la API key. ### Gli oggetti sono key e percorsi Un oggetto Pimcore non si indirizza con un attributo identifier ma con una key dentro un albero di cartelle. Una riga del fornitore deve arrivare a una key prima che si possa scrivere qualcosa. ### Le lingue sono scritture separate I campi localizzati si aggiornano per lingua, quindi un catalogo ampio e multilingua diventa tante piccole mutation invece di un solo documento. ## Come SDM Portal scrive in Pimcore ### Datahub come superficie di integrazione Crei una configurazione Datahub in Pimcore, esponi le class che vuoi riempire, imposti una API key sulla security definition e la attivi. SDM Portal si collega a quell'endpoint con la chiave. Dentro Pimcore non viene installato nulla. ### Mapping per class Scegli la class e la barra degli attributi si limita ai suoi campi, allo stesso modo in cui una famiglia o un template fanno sugli altri due PIM. ### Verifica dell'esistenza per key Prima di scrivere, SDM Portal cerca le key che sta per toccare e decide riga per riga se è una creazione o un aggiornamento. La verifica trova anche gli oggetti non pubblicati, quindi un oggetto creato in un'esecuzione precedente viene aggiornato invece di essere duplicato. ### Una cartella di destinazione che scegli tu I nuovi oggetti vengono creati sotto un percorso di cartella impostato per profilo. Quando la configurazione Datahub espone le cartelle degli oggetti, la scegli da un albero cercabile letto in tempo reale da Pimcore; quando non le espone, scrivi il percorso a mano. ### Valori scritti per lingua Una creazione, poi una mutation di aggiornamento per lingua, con un ritmo controllato perché un catalogo grande non inondi l'endpoint. Un aggiornamento vuoto viene saltato invece di essere inviato. ### Tutto il resto è identico prima della scrittura Caricamento, link condiviso o acquisizione via email, l'editor di flusso visivo, le trasformazioni compilate dall'IA, i blocchi Translate e Compose, il dry-run riga per riga, il workflow di approvazione, le modalità create, update e upsert e la delta sync sono identici ai percorsi Ergonode e Akeneo. Cambia solo la scrittura. ## Cosa possiamo scrivere in Pimcore I valori vengono scritti tramite le mutation di aggiornamento di Datahub, per lingua. I valori select vengono mappati sui codici che la tua class si aspetta; SDM Portal non crea nuovi valori né nuovi campi nella definizione della class. - Campi di testo - Textarea - Numeri - Date - Campi localizzati per lingua - Key dell'oggetto - Posizionamento nella cartella di destinazione ## Cosa non fa ancora il connettore Pimcore ### Più giovane degli altri due connettori (beta) Oggi scrive su un'istanza Pimcore reale: trova gli oggetti per key, li crea sotto una cartella di destinazione e aggiorna i valori per lingua. Ha meno funzioni dei connettori Ergonode e Akeneo, e sono tutte elencate qui. ### Gli oggetti arrivano non pubblicati (decidi tu) Un oggetto creato da SDM Portal non viene pubblicato. La pubblicazione resta una decisione dentro Pimcore. La verifica per key trova anche gli oggetti non pubblicati, quindi l'esecuzione successiva aggiorna quell'oggetto invece di crearne un secondo. ### Varianti, creazione di opzioni, stato del workflow (non supportato) Nessun genitore di variante e nessun asse, nessuna creazione di valori select o opzioni, nessun arricchimento delle opzioni e nessuna transizione di stato del workflow. Sono funzioni di Ergonode e Akeneo. ### Creare campi (resta in pimcore) Non puoi creare un nuovo campo di una class dall'editor. La definizione della class si gestisce in Pimcore. ### Key duplicate tra cartelle (da tenere d'occhio) La verifica per key confronta tutte le cartelle. Se la stessa key esiste due volte ricevi un avviso di key duplicata e la scrittura va sulla prima corrispondenza. ### Un aggiornamento per lingua per oggetto (velocità) Un catalogo ampio e multilingua va più lento dei percorsi di scrittura in batch di Ergonode e Akeneo, dove molti prodotti viaggiano in una sola richiesta. ### Il selettore di cartella (dipende dalla config) La lettura delle cartelle degli oggetti è disattivata per default in una configurazione Datahub. Attivala per avere l'albero delle cartelle, oppure scrivi il percorso di destinazione a mano. ## FAQ ### Quale versione di Pimcore e quale API usa SDM Portal? Pimcore 11 tramite l'API GraphQL di Datahub. Pimcore 11 non ha un webservice REST, quindi Datahub è la superficie di integrazione. Crei una configurazione Datahub, esponi le class che vuoi riempire, imposti una API key sulla sua security definition e la attivi. ### Cosa significa beta per il connettore Pimcore? Oggi scrive su un'istanza Pimcore reale: trova gli oggetti per key, li crea sotto una cartella di destinazione e aggiorna i valori per lingua. È più giovane dei connettori Ergonode e Akeneo e ha meno funzioni, elencate in questa pagina. Lo chiamiamo beta così puoi giudicare da te. ### Gli oggetti vengono pubblicati automaticamente? No. Gli oggetti creati da SDM Portal arrivano non pubblicati, e la pubblicazione resta una decisione dentro Pimcore. La verifica dell'esistenza trova anche gli oggetti non pubblicati, quindi un'esecuzione successiva aggiorna l'oggetto che hai creato invece di farne un altro. ### Come vengono abbinati gli oggetti Pimcore alle righe del fornitore? Tramite la key dell'oggetto. Prima di scrivere, SDM Portal controlla le key che sta per toccare e decide riga per riga se è una creazione o un aggiornamento. La verifica confronta le key in tutte le cartelle, quindi se la stessa key esiste due volte ricevi un avviso di key duplicata e la scrittura va sulla prima corrispondenza. ### Posso comunque usare l'editor visivo e il dry-run? Sì. Tutto quello che viene prima della scrittura è identico a Ergonode e Akeneo: il canvas del flusso, le trasformazioni, le regole compilate dall'IA, i blocchi Translate e Compose, il dry-run riga per riga, il workflow di approvazione e la delta sync. ## Inizia Prova gratis per 14 giorni: https://app.sdmportal.com/signup?lang=it Altri PIM: https://sdmportal.com/it/ergonode/ · https://sdmportal.com/it/akeneo/ · https://sdmportal.com/it/pimcore/ SDM Portal.