Mappa leverantörsdata till Ergonode. Ingen kod.
Ergonode är enbart GraphQL, och varje attributtyp har sin egen typade mutation. SDM Portal vet vilken som ska användas, skriver dina varianter i den ordning Ergonode kräver och upprepar samma regler på varje fil den leverantören skickar.
Anslutning
- ProtokollEndast GraphQL, /api/graphql/
- AutentiseringAPI-nyckel i en X-API-KEY-header
- StrukturTemplate
- SkrivningGraphQL-mutations med alias, 25 operationer per förfrågan
- VarianterSimple products först, sedan variable-produkten med bindings
- Delta syncHash per skrivoperation
Där ett leverantörsflöde till Ergonode verkligen fastnar
Leverantörsfiler är gjorda för människor. Ergonode är byggt för ett schema. Det mesta av arbetet är avståndet mellan de två, och det kommer tillbaka med varje ny fil.
Varje typ har sin egen mutation
Text, numeric, select, multi select, unit, price och relation kräver var sin typade mutation. Skickar du ett värde genom fel mutation svarar Ergonode med ett okänt fel och inga detaljer.
Varianter kräver en ordning
Barnen måste finnas innan variable-produkten kan binda dem. Får du ordningen fel misslyckas bindings.
Status är en graf, inte ett fält
Ergonode validerar arbetsflödesövergångar på serversidan, så du kan inte bara sätta den status du vill ha från där produkten står nu.
Så skriver SDM Portal till Ergonode
Du ritar mappningen på en yta. Svåra regler beskriver du på vanligt språk och de kompileras en gång till en fast regel, så att körningarna förblir reproducerbara. Nedan står vad Ergonode-sidan av detta faktiskt gör.
Mappning per template
Välj templatet och attributskenan begränsas till dess attribut. Templates har inget visningsnamn i API:et, så väljaren visar template-koden. Det inbyggda SKU:t ingår inte i attributströmmen, så ett fält som heter esa_sku läggs till och du mappar SKU som vilken annan kolumn som helst.
Typade skrivningar, upplösta i realtid
Text, textarea och date skickas som en sträng, numeric, price och unit som en float, select som en alternativkod, multi select som en lista med alternativkoder och relation som en lista med SKU. Typen hämtas från din katalog i realtid, inte från värdets form, så ett artikelnummer som ser numeriskt ut landar ändå som text.
Värden per lokal
Lokal är en egenskap hos förbindelsen du drar. Tre beskrivningskolumner fyller ett attribut på tre språk, och körningens språk avgör standardvärdet.
Varianter med axlar och bindings
Markera en parent key, en eller flera variantaxlar och variantens SKU på källkolumner. Simple products skapas först, sedan variable-produkten med sina bindings, vilket är den ordning Ergonode kräver. Axelvärden som går genom en ValueMap landar ändå på binding-koder.
Arbetsflödesstatus via kortaste vägen
Eftersom Ergonode upprätthåller övergångsgrafen beräknas den kortaste vägen från produktens nuvarande status till den du mappat, och den gås steg för steg i stället för att sättas i ett hopp.
Kategorier från flera taxonomier
Ett flöde kan innehålla mer än en taxonominod. Var och en mappar ett källvärde till en kategori, och en produkt får unionen utan dubbletter av allt som löstes, i ett enda kategorianrop.
Alternativ, skapade och berikade
Saknade alternativ skapas med en kort föreslagen kod i små bokstäver, som du kan redigera per värde. Custom fields på alternativ av typen text, textarea och rich text kan fyllas från andra kolumner i samma rad, så att den långa skötseltexten landar i ett custom field medan alternativet behåller ett läsbart namn. Alternativnamn stannar vid 255 tecken.
Nya attribut från editorn
Skapa attribut av typen text, textarea, numeric, date, select, multi select, unit, price och relation från ytan. Ergonode har inget API för att lägga ett attribut till ett template, så ett skapat attribut gäller hela instansen och du lägger till det i templatet i Ergonode själv. Editorn säger detta i samma stund som du skapar ett.
Batchar som klarar en dålig cell
Skrivningar skickas som GraphQL-mutations med alias, 25 operationer per förfrågan, i jämn takt. Ett enda avvisat värde kan fälla ett helt batchat dokument, så en batch där varje operation misslyckades med samma fel körs om en operation i taget. Bara den verkliga syndaren misslyckas, och Ergonodes egen valideringsdetalj visas på raden.
Mjuka fel förblir mjuka
Ett värde som nvt på ett numeriskt attribut hoppas över med en varning som namnger SKU:t. Ett dubblettvärde på ett unique-attribut, till exempel en delad tullkod, registreras som ett hopp i stället för att produkten misslyckas. En relation till ett SKU som inte finns ännu tas bort från den skrivningen och namnges i varningen, så att resten av relationen ändå landar.
Vad vi kan skriva till Ergonode
Select och multi select mappas till alternativkoder, och saknade alternativ kan skapas och berikas. Ett prisattribut är en enda float vars valuta konfigureras på attributet inne i Ergonode, och ett unit-attribut läser sin symbol från attributet.
Vad Ergonode-connectorn inte gör ännu
Vi vill hellre att du läser det här innan du registrerar dig än att du upptäcker det i vecka två. Varje punkt nedan är en verklig gräns för Ergonode-connectorn i dag.
Bilder, gallerier, filer
Mediaattribut syns i skenan men skrivs inte. Custom fields på alternativ av typen bild filtreras bort av samma skäl.
Priser
Ett Ergonode-prisattribut innehåller en float och dess valuta konfigureras på attributet inne i Ergonode. Valuta per förbindelse, där flera kolumner slås samman till en samling, är en Akeneo-funktion.
Grouping products
Bara simple- och variable-produkter. Grouping products skapas inte.
Lägga ett attribut till ett template
Ergonode har inget API för det. Ett attribut som skapats från editorn finns i hela instansen, och du lägger till det i templatet i Ergonode innan det syns i den avgränsade skenan.
Alternativnamn över 255 tecken
Ergonode avvisar längre alternativnamn med ett ogenomskinligt fel, så namn kapas vid 255. Lägg den fullständiga texten i ett custom field på alternativet.
Template-namn
Ergonodes API returnerar inget visningsnamn för ett template, så väljare och varningar visar template-koden.
Frågor om Ergonode och SDM Portal
Hur ansluter SDM Portal till Ergonode?
Ergonode exponerar enbart GraphQL, på /api/graphql/. Du lägger in instansens URL och en API-nyckel, som skickas som en X-API-KEY-header, och anslutningen verifieras med en riktig handshake. Nyckeln lagras krypterad och ingår aldrig i en exporterad mappning.
Hanterar SDM Portal Ergonode-varianter?
Ja. Du markerar parent key, variantaxlarna och variantens SKU på källkolumner. Simple products skapas först och sedan variable-produkten med sina bindings, vilket är den ordning Ergonode kräver. Axelvärden som går genom en ValueMap landar ändå på binding-koder.
Kan den sätta arbetsflödesstatusen i Ergonode?
Ja. Ergonode validerar statusövergångar på serversidan, så SDM Portal beräknar den kortaste vägen från produktens nuvarande status till den du mappat och går den steg för steg.
Hur undviker en dålig cell att fälla en hel batch?
Skrivningar batchas som GraphQL-mutations med alias, 25 operationer per förfrågan. Ett enda avvisat värde kan fälla hela det batchade dokumentet, så en batch där varje operation misslyckades med samma fel körs om en operation i taget. Bara den verkliga syndaren misslyckas, och skälet Ergonode returnerade visas på raden.
Skickar en andra körning om allt?
Nej. Varje skrivning hashas per operation, så en ny körning av en oförändrad fil rapporterar produkterna som oförändrade och skriver ingenting. En framtvingad full omsynk finns för de gånger du verkligen vill skicka om allt.
Kör du ett annat PIM?
Editorn, transformationerna och arbetsflödet är gemensamma. Bara skrivvägen skiljer sig per PIM, så varje connector har sin egen sida.
Mappa Ergonode en gång. Sedan sköter det sig självt.
Skapa en arbetsyta, anslut din Ergonode-instans och mappa din första leverantörsfil. Fjorton dagar gratis, inget dras från kortet under provperioden.