Mappa i dati dei fornitori in Ergonode. Senza codice.
Ergonode è solo GraphQL, e ogni tipo di attributo ha la sua mutation tipizzata. SDM Portal sa quale usare, scrive le tue varianti nell'ordine che Ergonode richiede e ripete le stesse regole su ogni file che quel fornitore invia.
Connessione
- ProtocolloSolo GraphQL, /api/graphql/
- AutenticazioneAPI key in un header X-API-KEY
- StrutturaTemplate
- ScrittureMutation GraphQL con alias, 25 operazioni per richiesta
- VariantiPrima i simple product, poi il variable product con i bindings
- Delta syncHash per operazione di scrittura
Dove si blocca davvero un feed fornitore per Ergonode
I file dei fornitori sono fatti per le persone. Ergonode è fatto per uno schema. Il lavoro sta soprattutto nella distanza tra i due, e quella distanza ritorna a ogni nuovo file.
Ogni tipo ha la sua mutation
Text, numeric, select, multi select, unit, price e relation richiedono ognuno una mutation tipizzata diversa. Manda un valore in quella sbagliata e Ergonode risponde con un errore sconosciuto e nessun dettaglio.
Le varianti hanno un ordine
I figli devono esistere prima che il variable product possa collegarli. Sbaglia l'ordine e i bindings falliscono.
Lo stato è un grafo, non un campo
Ergonode valida le transizioni di workflow lato server, quindi non puoi semplicemente impostare lo stato che vuoi partendo da dove si trova il prodotto adesso.
Come SDM Portal scrive in Ergonode
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 Ergonode.
Mapping per template
Scegli il template e la barra degli attributi si limita ai suoi attributi. Nell'API i template non hanno un nome visualizzato, quindi il selettore mostra il codice del template. Lo SKU integrato non fa parte dello stream degli attributi, quindi viene inserito un campo chiamato esa_sku e mappi lo SKU come qualsiasi altra colonna.
Scritture tipizzate, risolte in tempo reale
Text, textarea e date partono come stringa, numeric, price e unit come float, select come codice opzione, multi select come elenco di codici opzione e relation come elenco di SKU. Il tipo arriva dal tuo catalogo in tempo reale, non dalla forma del valore, quindi un codice articolo che sembra numerico arriva comunque come testo.
Valori per locale
La locale è una proprietà della connessione che disegni. Tre colonne di descrizione riempiono un attributo in tre lingue, e la lingua dell'esecuzione decide il valore predefinito.
Varianti con assi e bindings
Segna una parent key, uno o più assi di variante e lo SKU della variante sulle colonne di origine. Prima vengono creati i simple product, poi il variable product con i suoi bindings, che è l'ordine richiesto da Ergonode. I valori degli assi che passano per una ValueMap arrivano comunque a codici di binding.
Stato del workflow per percorso più breve
Poiché Ergonode fa rispettare il grafo delle transizioni, il percorso più breve dallo stato attuale del prodotto a quello che hai mappato viene calcolato e percorso passo per passo, invece di essere impostato in un solo salto.
Categorie da più tassonomie
Un flusso può contenere più di un nodo tassonomia. Ognuno mappa un valore di origine su una categoria, e un prodotto riceve l'unione senza duplicati di tutto ciò che è stato risolto, in una sola chiamata sulle categorie.
Opzioni, create e arricchite
Le opzioni mancanti vengono create con un codice breve proposto, in minuscolo, che puoi modificare valore per valore. I custom field delle opzioni di tipo text, textarea e rich text possono essere riempiti da altre colonne della stessa riga, così il testo lungo di manutenzione finisce in un custom field mentre l'opzione mantiene un nome leggibile. I nomi delle opzioni si fermano a 255 caratteri.
Nuovi attributi dall'editor
Crea attributi di tipo text, textarea, numeric, date, select, multi select, unit, price e relation dal canvas. Ergonode non ha un'API per aggiungere un attributo a un template, quindi un attributo creato vale per tutta l'istanza e lo aggiungi al template dentro Ergonode. L'editor te lo dice nel momento in cui ne crei uno.
Batch che sopravvivono a una cella sbagliata
Le scritture partono come mutation GraphQL con alias, 25 operazioni per richiesta, con un ritmo controllato. Un solo valore rifiutato può far fallire un intero documento in batch, quindi un batch in cui ogni operazione è fallita con lo stesso errore viene ritentato un'operazione alla volta. Fallisce solo il vero colpevole, e il dettaglio di validazione di Ergonode viene mostrato sulla riga.
Gli errori non bloccanti restano non bloccanti
Un valore come nvt su un attributo numerico viene saltato con un avviso che nomina lo SKU. Un valore duplicato su un attributo unique, per esempio un codice doganale condiviso, viene registrato come salto invece di far fallire il prodotto. Una relazione verso uno SKU che non esiste ancora viene rimossa da quella scrittura e nominata nell'avviso, così il resto della relazione arriva comunque.
Cosa possiamo scrivere in Ergonode
Select e multi select vengono mappati su codici opzione, e le opzioni mancanti possono essere create e arricchite. Un attributo prezzo è un singolo float la cui valuta è configurata sull'attributo dentro Ergonode, e un attributo unit legge il suo simbolo dall'attributo.
Cosa non fa ancora il connettore Ergonode
Preferiamo che lo leggi prima di iscriverti, non che lo scopri nella seconda settimana. Ogni punto qui sotto è un limite reale del connettore Ergonode oggi.
Immagini, gallerie, file
Gli attributi media sono visibili nella barra ma non vengono scritti. I custom field delle opzioni di tipo immagine sono filtrati per lo stesso motivo.
Prezzi
Un attributo prezzo di Ergonode contiene un solo float e la sua valuta è configurata sull'attributo dentro Ergonode. La valuta per connessione, con più colonne che si uniscono in una collezione, è una funzione di Akeneo.
Grouping products
Solo simple e variable product. I grouping product non vengono creati.
Aggiungere un attributo a un template
Ergonode non ha un'API per farlo. Un attributo creato dall'editor esiste per tutta l'istanza, e lo aggiungi al template dentro Ergonode prima che compaia nella barra limitata al template.
Nomi delle opzioni oltre 255 caratteri
Ergonode rifiuta i nomi di opzione più lunghi con un errore opaco, quindi i nomi vengono tagliati a 255. Metti il testo completo in un custom field dell'opzione.
Nomi dei template
L'API di Ergonode non restituisce un nome visualizzato per un template, quindi selettori e avvisi mostrano il codice del template.
Domande su Ergonode e SDM Portal
Come si collega SDM Portal a Ergonode?
Ergonode espone solo GraphQL, su /api/graphql/. Aggiungi l'URL dell'istanza e una API key, che viene inviata come header X-API-KEY, e la connessione viene verificata con un handshake reale. La chiave è salvata cifrata e non fa mai parte di un mapping esportato.
SDM Portal gestisce le varianti di Ergonode?
Sì. Segni la parent key, gli assi di variante e lo SKU della variante sulle colonne di origine. Prima vengono creati i simple product e poi il variable product con i suoi bindings, che è l'ordine richiesto da Ergonode. I valori degli assi che passano per una ValueMap arrivano comunque a codici di binding.
Può impostare lo stato del workflow in Ergonode?
Sì. Ergonode valida le transizioni di stato lato server, quindi SDM Portal calcola il percorso più breve dallo stato attuale del prodotto a quello che hai mappato e lo percorre passo per passo.
Come si evita che una cella sbagliata faccia fallire un intero batch?
Le scritture vengono raggruppate in mutation GraphQL con alias, 25 operazioni per richiesta. Un solo valore rifiutato può far fallire l'intero documento in batch, quindi un batch in cui ogni operazione è fallita con lo stesso errore viene ritentato un'operazione alla volta. Fallisce solo il vero colpevole, e il motivo restituito da Ergonode viene mostrato sulla riga.
Una seconda esecuzione ripubblica tutto?
No. Ogni scrittura viene hashata per operazione, quindi una nuova esecuzione su un file identico segnala i prodotti come non modificati e non scrive nulla. Esiste una risincronizzazione completa forzata per le volte in cui vuoi davvero ripubblicare tutto.
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 Ergonode una volta. Poi va da sé.
Crea un workspace, collega la tua istanza Ergonode e mappa il tuo primo file fornitore. Quattordici giorni gratis, nessun addebito sulla carta durante la prova.