Koble leverandørdata til Ergonode. Uten kode.
Ergonode er kun GraphQL, og hver attributtype har sin egen typede mutation. SDM Portal vet hvilken som skal brukes, skriver variantene dine i den rekkefølgen Ergonode krever, og gjentar de samme reglene på hver fil den leverandøren sender.
Tilkobling
- ProtokollKun GraphQL, /api/graphql/
- AutentiseringAPI-nøkkel i en X-API-KEY-header
- StrukturTemplate
- SkrivingGraphQL-mutations med alias, 25 operasjoner per forespørsel
- VarianterSimple products først, deretter variable-produktet med bindings
- Delta syncHash per skriveoperasjon
Der en leverandørfeed til Ergonode faktisk stopper
Leverandørfiler er laget for mennesker. Ergonode er laget for et skjema. Mesteparten av arbeidet er avstanden mellom de to, og den kommer tilbake med hver nye fil.
Hver type har sin egen mutation
Text, numeric, select, multi select, unit, price og relation krever hver sin typede mutation. Sender du en verdi gjennom feil mutation, svarer Ergonode med en ukjent feil og ingen detaljer.
Varianter krever en rekkefølge
Barna må finnes før variable-produktet kan binde dem. Tar du feil rekkefølge, feiler bindings.
Status er en graf, ikke et felt
Ergonode validerer arbeidsflytoverganger på serversiden, så du kan ikke bare sette statusen du vil ha fra der produktet står nå.
Slik skriver SDM Portal til Ergonode
Du tegner mappingen på et lerret. Vanskelige regler beskriver du i vanlig språk, og de kompileres én gang til en fast regel, slik at kjøringene forblir reproduserbare. Under står hva Ergonode-siden av dette faktisk gjør.
Mapping per template
Velg templatet og attributtskinnen begrenses til attributtene i det. Templates har ikke noe visningsnavn i API-et, så velgeren viser template-koden. Den innebygde SKU-en er ikke del av attributtstrømmen, så et felt kalt esa_sku legges inn, og du mapper SKU som enhver annen kolonne.
Typede skrivinger, løst i sanntid
Text, textarea og date sendes som en streng, numeric, price og unit som en float, select som en alternativkode, multi select som en liste med alternativkoder og relation som en liste med SKU-er. Typen hentes fra det live katalogen din, ikke fra formen på verdien, så et artikkelnummer som ser numerisk ut, havner likevel som tekst.
Verdier per lokalitet
Lokalitet er en egenskap ved forbindelsen du tegner. Tre beskrivelseskolonner fyller ett attributt på tre språk, og kjøringens språk bestemmer standardverdien.
Varianter med akser og bindings
Merk en parent key, en eller flere variantakser og variant-SKU-en på kildekolonner. Simple products opprettes først, deretter variable-produktet med sine bindings, som er rekkefølgen Ergonode krever. Aksverdier som går gjennom en ValueMap, ender likevel opp i binding-koder.
Arbeidsflytstatus via korteste vei
Fordi Ergonode håndhever overgangsgrafen, beregnes den korteste veien fra produktets nåværende status til den du mappet, og den går steg for steg i stedet for å settes i ett sprang.
Kategorier fra flere taksonomier
En flyt kan holde mer enn én taksonominode. Hver av dem mapper en kildeverdi til en kategori, og et produkt får unionen uten duplikater av alt som ble løst, i ett kategorikall.
Alternativer, opprettet og beriket
Manglende alternativer opprettes med en kort foreslått kode i små bokstaver, som du kan redigere per verdi. Custom fields på alternativer av typen text, textarea og rich text kan fylles fra andre kolonner i samme rad, slik at den lange vedlikeholdsteksten havner i et custom field mens alternativet beholder et lesbart navn. Alternativnavn stopper på 255 tegn.
Nye attributter fra editoren
Opprett attributter av typen text, textarea, numeric, date, select, multi select, unit, price og relation fra lerretet. Ergonode har ikke noe API for å legge et attributt til et template, så et opprettet attributt gjelder hele instansen, og du legger det til templatet i Ergonode selv. Editoren sier dette i det øyeblikket du oppretter ett.
Batcher som overlever en dårlig celle
Skrivinger sendes som GraphQL-mutations med alias, 25 operasjoner per forespørsel, med jevn takt. Én avvist verdi kan velte et helt batchet dokument, så en batch der hver operasjon feilet med samme feil, prøves på nytt én operasjon om gangen. Bare den virkelige synderen feiler, og Ergonodes egen valideringsdetalj vises på raden.
Myke feil forblir myke
En verdi som nvt på et numerisk attributt hoppes over med en advarsel som navngir SKU-en. En duplikatverdi på et unique-attributt, for eksempel en delt tollkode, registreres som et hopp i stedet for at produktet feiler. En relasjon til en SKU som ikke finnes ennå, fjernes fra den skrivingen og navngis i advarselen, slik at resten av relasjonen likevel havner der.
Hva vi kan skrive til Ergonode
Select og multi select mappes til alternativkoder, og manglende alternativer kan opprettes og beriges. Et prisattributt er en enkelt float der valutaen konfigureres på attributtet inne i Ergonode, og et unit-attributt leser symbolet sitt fra attributtet.
Hva Ergonode-connectoren ikke gjør ennå
Vi vil heller at du leser dette før du registrerer deg enn at du oppdager det i uke to. Hvert punkt under er en reell grense for Ergonode-connectoren i dag.
Bilder, gallerier, filer
Mediaattributter er synlige i skinnen, men skrives ikke. Custom fields på alternativer av typen bilde filtreres bort av samme grunn.
Priser
Et Ergonode-prisattributt inneholder én float, og valutaen konfigureres på attributtet inne i Ergonode. Valuta per forbindelse, der flere kolonner slås sammen til én samling, er en Akeneo-funksjon.
Grouping products
Bare simple- og variable-produkter. Grouping products opprettes ikke.
Legge et attributt til et template
Ergonode har ikke noe API for det. Et attributt opprettet fra editoren finnes for hele instansen, og du legger det til templatet i Ergonode før det vises i den avgrensede skinnen.
Alternativnavn over 255 tegn
Ergonode avviser lengre alternativnavn med en uklar feil, så navn kuttes ved 255. Legg den fulle teksten i et custom field på alternativet.
Template-navn
Ergonode-API-et returnerer ikke noe visningsnavn for et template, så velgere og advarsler viser template-koden.
Spørsmål om Ergonode og SDM Portal
Hvordan kobler SDM Portal seg til Ergonode?
Ergonode eksponerer kun GraphQL, på /api/graphql/. Du legger inn instans-URL-en og en API-nøkkel, som sendes som en X-API-KEY-header, og tilkoblingen verifiseres med en reell handshake. Nøkkelen lagres kryptert og er aldri en del av en eksportert mapping.
Håndterer SDM Portal Ergonode-varianter?
Ja. Du merker parent key, variantaksene og variant-SKU-en på kildekolonner. Simple products opprettes først og deretter variable-produktet med sine bindings, som er rekkefølgen Ergonode krever. Aksverdier som går gjennom en ValueMap, ender likevel opp i binding-koder.
Kan den sette arbeidsflytstatusen i Ergonode?
Ja. Ergonode validerer statusoverganger på serversiden, så SDM Portal beregner den korteste veien fra produktets nåværende status til den du mappet, og går den steg for steg.
Hvordan kan én dårlig celle unngå å velte en hel batch?
Skrivinger batches som GraphQL-mutations med alias, 25 operasjoner per forespørsel. En enkelt avvist verdi kan velte hele det batchede dokumentet, så en batch der hver operasjon feilet med samme feil, prøves på nytt én operasjon om gangen. Bare den virkelige synderen feiler, og årsaken Ergonode returnerte, vises på raden.
Vil en ny kjøring sende alt på nytt?
Nei. Hver skriving hashes per operasjon, så en ny kjøring av en uendret fil rapporterer produktene som uendret og skriver ingenting. En tvungen full resync finnes for de gangene du faktisk vil sende alt på nytt.
Bruker du et annet PIM?
Editoren, transformasjonene og arbeidsflyten er felles. Bare skrivebanen er ulik per PIM, så hver connector har sin egen side.
Map Ergonode én gang. Så går resten av seg selv.
Opprett et arbeidsområde, koble til din Ergonode-instans og map din første leverandørfil. Fjorten dager gratis, ingen kortbelastning i prøveperioden.