Mappa i dati dei fornitori in Akeneo. Senza codice.
Il tuo fornitore ti manda un foglio di calcolo. Akeneo vuole un documento prodotto con la famiglia, il canale, la locale e la valuta giusti su ogni valore. SDM Portal è il livello di mapping in mezzo: lo costruisci una volta per fornitore, e ogni file successivo ripete le stesse regole.
Connessione
- ProtocolloAkeneo REST API, /api/rest/v1
- AutenticazioneOAuth2 password grant: client ID, secret, nome utente, password
- EdizioniCommunity Edition 7 e Serenity, rilevate all'handshake
- StrutturaFamiglia
- ScrittureND-JSON PATCH /products, fino a 100 per batch
- Delta syncHash del documento per prodotto
Dove si blocca davvero un feed fornitore per Akeneo
I file dei fornitori sono fatti per le persone. Akeneo è fatto per uno schema. Il lavoro sta soprattutto nella distanza tra i due, e quella distanza ritorna a ogni nuovo file.
Gli attributi vivono nelle famiglie
Una colonna del fornitore non significa nulla finché non sai a quale famiglia appartiene. Scegli la famiglia e la barra degli attributi si restringe agli attributi di quella famiglia, nell'ordine della famiglia stessa.
Ogni valore ha una dimensione
I valori Akeneo portano una locale e, per gli attributi scopable, un canale. Un prezzo è una collezione con una valuta. Un valore metrico è un numero più un'unità. Sbaglia uno di questi e il valore viene rifiutato.
Le opzioni sono codici, non etichette
Un valore select deve arrivare a un codice opzione esistente, con i caratteri che Akeneo accetta. I file dei fornitori mandano invece etichette come Navy Blue.
Come SDM Portal scrive in Akeneo
Il mapping lo disegni su un canvas. Le regole difficili le descrivi in linguaggio naturale e vengono compilate una volta in una regola fissa, così le esecuzioni restano riproducibili. Qui sotto trovi cosa fa esattamente il lato Akeneo.
Mapping per famiglia
Scegli la famiglia e la barra degli attributi si limita a essa, mantenendo l'ordine degli attributi della famiglia. L'attributo identifier viene escluso e al suo posto viene inserito un campo di sistema chiamato esa_sku, così mappi lo SKU come qualsiasi altra colonna, esattamente come su Ergonode.
La locale sulla connessione
Le locale attive arrivano dalla tua istanza. La locale è una proprietà della connessione che disegni, quindi tre colonne di descrizione possono riempire un attributo in tre lingue. Un attributo localizzabile prende la locale della connessione; uno non localizzabile mantiene il primo valore e segnala un avviso.
Canale e valuta per profilo
Nelle impostazioni di pubblicazione stanno il canale e la valuta predefinita del profilo, proposti dai tuoi canali e limitati alle valute di quel canale. Un valore scopable senza canale configurato viene scartato con un avviso. Imposta questo prima dell'approvazione: cambiarlo cambia ogni hash del documento e forza una ripubblicazione completa.
Collezioni di prezzi, multivaluta
Anche la valuta è una proprietà della connessione. Più colonne di origine, per esempio price_eur e price_usd, si uniscono in una sola collezione di prezzi su un solo attributo. Mescolare connessioni con valuta e connessioni senza valuta fa fallire il dry-run invece di tirare a indovinare.
Attributi metrici
Un valore metrico viene scritto come un numero più l'unità metrica predefinita dell'attributo. Un attributo senza unità predefinita scarta il valore e lo dice, invece di scrivere un numero senza unità.
Creazione di opzioni con etichette
Le opzioni select mancanti vengono create con etichette per locale. I codici devono usare i caratteri che Akeneo permette, e un codice non valido viene rifiutato con una proposta di correzione invece di essere riscritto in silenzio, così il codice che vedi è il codice che arriva.
Nuovi attributi dall'editor
Crea attributi di tipo text, textarea, number, date, simple select, multi select, boolean, price collection e metric senza uscire dal canvas. Ogni tipo richiede un gruppo di attributi; metric richiede anche una famiglia e un'unità predefinita. Il nuovo attributo viene aggiunto alla famiglia del profilo con una PATCH che legge e accoda, così nulla d'altro nella famiglia viene toccato.
Reference entity su Serenity
Un attributo reference entity si comporta come un select e la sua versione collection come un multi select. L'elenco delle opzioni è formato dai record dell'entità collegata, quindi mappi i valori del fornitore direttamente sui codici dei record.
Scritture verificabili
I prodotti partono in batch ND-JSON di massimo 100. Ogni riga torna come creata, aggiornata o rifiutata, e un rifiuto viene riportato per attributo. I rate limit vengono rispettati leggendoli dalla risposta. Ogni prodotto porta un hash del documento, quindi una nuova esecuzione su un file identico non scrive nulla. Nelle modalità create e update si controlla prima cosa esiste già, a blocchi di 500 SKU.
Cosa possiamo scrivere in Akeneo
I valori select e multi select vengono mappati su codici opzione, e le opzioni mancanti possono essere create con le loro etichette. Le categorie vengono assegnate per prodotto come insieme senza duplicati.
Cosa non fa ancora il connettore Akeneo
Preferiamo che lo leggi prima di iscriverti, non che lo scopri nella seconda settimana. Ogni punto qui sotto è un limite reale del connettore Akeneo oggi.
Product models e varianti
Gli assi di variante sono oggi una funzione di Ergonode. Su un profilo Akeneo i marcatori di variante sono nascosti. Se un flusso più vecchio li porta ancora, i figli vengono scritti come prodotti a sé stanti e i genitori vengono saltati con un unico avviso riassuntivo.
Media, tabelle, identifier
Gli attributi immagine e media, gli attributi tabella e l'attributo identifier sono visibili nella barra ma non scrivibili. Restano leggibili così vedi la famiglia completa.
Record delle reference entity
I record di una reference entity vengono letti come opzioni, mai creati. La loro etichetta è il codice del record, quindi il selettore mostra codici.
Stato del workflow
Akeneo non ha uno stato di workflow sui prodotti. Un mapping di stato arrivato da un flusso Ergonode viene ignorato con un avviso invece di fare fallire l'esecuzione.
Custom field sulle opzioni
Le opzioni Akeneo hanno etichette ma non custom field, quindi le funzioni di arricchimento delle opzioni restano nascoste su un profilo Akeneo.
Eliminare attributi
Un attributo creato tramite API non può più essere eliminato tramite l'API di CE 7. Creali con criterio.
Domande su Akeneo e SDM Portal
Quali versioni di Akeneo supporta SDM Portal?
Akeneo Community Edition 7 e Serenity. L'edizione e la versione vengono rilevate durante l'handshake della connessione e mostrate sulla riga della connessione, così vedi esattamente a cosa sei collegato.
Come si autentica SDM Portal con Akeneo?
Tramite una connessione API di Akeneo: client ID, client secret, nome utente e password con l'OAuth2 password grant. Il bearer token viene messo in cache per connessione e rinnovato una volta in caso di 401. Le credenziali sono salvate cifrate e non fanno mai parte di un mapping esportato.
SDM Portal supporta i product models e le varianti di Akeneo?
Non ancora. Gli assi di variante e i bindings sono oggi una funzione di Ergonode. Su un profilo Akeneo i marcatori di variante sono nascosti, e un flusso che li porta ancora scrive i figli come prodotti a sé stanti e salta i genitori con un avviso.
Come vengono gestiti canali, locale e valute?
La locale è una proprietà della connessione di mapping, quindi tre colonne di descrizione possono riempire un attributo in tre lingue. Canale e valuta predefinita si impostano per profilo nelle impostazioni di pubblicazione, proposti dai tuoi canali. Un attributo prezzo può ricevere più valute insieme impostando una valuta per connessione.
Posso vedere cosa succederà prima che qualcosa venga scritto in Akeneo?
Sì. Un dry-run mostra il risultato riga per riga, con avvisi per i valori non mappati e i campi scartati, e non scrive nulla. Le esecuzioni possono andare prima su un Akeneo di staging e poi in produzione, e la delta sync fa sì che vengano ripubblicati solo i prodotti modificati.
Usi un altro PIM?
L'editor, le trasformazioni e il workflow sono condivisi. Solo il percorso di scrittura cambia per PIM, quindi ogni connettore ha la sua pagina.
Mappi Akeneo una volta. Poi va da sé.
Crea un workspace, collega la tua istanza Akeneo e mappa il tuo primo file fornitore. Quattordici giorni gratis, nessun addebito sulla carta durante la prova.