Yhdistä toimittajadata Ergonodeen. Ilman koodia.
Ergonode tarjoaa vain GraphQL:n, ja jokaisella attribuuttilajilla on oma tyypitetty mutaationsa. SDM Portal tietää, mitä käyttää, kirjoittaa varianttisi siinä järjestyksessä jota Ergonode vaatii, ja toistaa samat säännöt jokaisessa tiedostossa jonka toimittaja lähettää.
Yhteys
- ProtokollaVain GraphQL, /api/graphql/
- TodennusAPI-avain X-API-KEY-otsakkeessa
- RakenneTemplate
- KirjoitusAliasoidut GraphQL-mutaatiot, 25 operaatiota per pyyntö
- VariantitEnsin simple productit, sitten variable product bindingeineen
- Delta syncTiiviste per kirjoitusoperaatio
Missä Ergonode-toimittajasyöte todella jumittuu
Toimittajatiedostot on tehty ihmisille. Ergonode on tehty skeemalle. Suurin osa työstä on näiden välinen etäisyys, ja se palaa jokaisen uuden tiedoston mukana.
Jokaisella lajilla on oma mutaationsa
Text, numeric, select, multi select, unit, price ja relation tarvitsevat kukin eri tyypitetyn mutaation. Jos lähetät arvon väärän kautta, Ergonode vastaa tuntemattomalla virheellä ilman yksityiskohtia.
Variantit tarvitsevat järjestyksen
Lasten täytyy olla olemassa ennen kuin variable product voi sitoa ne. Jos järjestys on väärä, bindingit epäonnistuvat.
Tila on graafi, ei kenttä
Ergonode validoi työnkulun siirtymät palvelimella, joten et voi vain asettaa haluamaasi tilaa siitä, missä tuote nyt on.
Miten SDM Portal kirjoittaa Ergonodeen
Piirrät mappauksen kankaalle. Hankalat säännöt kuvaat tavallisella kielellä, ja ne käännetään kerran kiinteäksi säännöksi, jotta ajot pysyvät toistettavina. Alla on se, mitä Ergonoden puoli siitä tosiasiassa tekee.
Mappaus templaten mukaan
Valitse template, ja attribuuttipalkki rajautuu sen attribuutteihin. Templateilla ei ole API:ssa näyttönimeä, joten valitsin näyttää templaten koodin. Sisäänrakennettu SKU ei kuulu attribuuttivirtaan, joten lisätään kenttä nimeltä esa_sku ja mappaat SKU:n kuten minkä tahansa muun sarakkeen.
Tyypitetyt kirjoitukset, ratkaistuna livenä
Text, textarea ja date lähtevät merkkijonona, numeric, price ja unit floattina, select optiokoodina, multi select optiokoodien listana ja relation SKU-listana. Laji tulee live-katalogistasi, ei arvon muodosta, joten numeeriselta näyttävä artikkelinumero menee silti tekstinä.
Arvot localea kohti
Locale on piirtämäsi yhteysviivan ominaisuus. Kolme kuvaussaraketta täyttää yhden attribuutin kolmella kielellä, ja ajon kieli ratkaisee oletuksen.
Variantit akseleineen ja bindingeineen
Merkitse lähdesarakkeisiin parent key, yksi tai useampi varianttiakseli ja variantin SKU. Ensin luodaan simple productit, sitten variable product bindingeineen, mikä on Ergonoden vaatima järjestys. Akseliarvot jotka kulkevat ValueMapin läpi ratkeavat silti binding-koodeiksi.
Työnkulun tila lyhimmän polun kautta
Koska Ergonode pakottaa siirtymägraafin, tuotteen nykyisestä tilasta mappaamaasi tilaan laskettu lyhin polku kuljetaan askel askeleelta sen sijaan, että se asetettaisiin yhdellä hyppäyksellä.
Kategoriat useasta taksonomiasta
Flow voi sisältää useamman kuin yhden taksonomiasolmun. Jokainen mappaa lähdearvon kategoriaan, ja tuote saa kaiken ratkenneen duplikaateista siivotun yhdisteen yhdellä kategoriakutsulla.
Optiot, luotuina ja rikastettuina
Puuttuvat optiot luodaan lyhyellä ehdotetulla koodilla pienin kirjaimin, ja voit muokata sitä arvoittain. Option custom fieldit tyypeiltään text, textarea ja rich text voidaan täyttää saman rivin muista sarakkeista, joten pitkä hoito-ohjeteksti menee custom fieldiin ja optiolle jää luettava nimi. Optioiden nimet rajautuvat 255 merkkiin.
Uudet attribuutit editorista
Luo tyyppien text, textarea, numeric, date, select, multi select, unit, price ja relation attribuutteja suoraan kankaalta. Ergonodella ei ole API:a attribuutin lisäämiseen templateen, joten luotu attribuutti on instanssin laajuinen ja lisäät sen templateen Ergonodessa itse. Editori kertoo tämän sillä hetkellä, kun luot attribuutin.
Erät jotka selviävät huonosta solusta
Kirjoitukset lähtevät aliasoituina GraphQL-mutaatioina, 25 operaatiota per pyyntö, tahdistettuna. Yksi hylätty arvo voi kaataa koko niputetun dokumentin, joten erä jossa jokainen operaatio kaatui samaan virheeseen ajetaan uudelleen operaatio kerrallaan. Vain todellinen syyllinen kaatuu, ja Ergonoden oma validointiselite näkyy rivillä.
Pehmeät virheet pysyvät pehmeinä
Arvo kuten nvt numeerisella attribuutilla ohitetaan varoituksella, joka nimeää SKU:n. Kaksoiskappale unique-attribuutilla, esimerkiksi yhteinen tullikoodi, kirjataan ohitukseksi sen sijaan, että tuote kaatuisi. Relaatio SKU:hun jota ei vielä ole poistetaan siitä kirjoituksesta ja nimetään varoituksessa, joten loput relaatiosta menee silti perille.
Mitä voimme kirjoittaa Ergonodeen
Select ja multi select mapataan optiokoodeihin, ja puuttuvat optiot voidaan luoda ja rikastaa. Hinta-attribuutti on yksi float, jonka valuutta määritetään attribuutille Ergonodessa, ja unit-attribuutti lukee yksikkösymbolinsa attribuutilta.
Mitä Ergonode-liitin ei vielä tee
Luet tämän mieluummin ennen rekisteröitymistä kuin huomaat sen toisella viikolla. Jokainen alla oleva kohta on Ergonode-liittimen todellinen raja tänään.
Kuvat, galleriat, tiedostot
Media-attribuutit näkyvät palkissa mutta niitä ei kirjoiteta. Option custom fieldit tyypiltään image suodatetaan pois samasta syystä.
Hinnat
Ergonoden hinta-attribuutti sisältää yhden floatin, ja sen valuutta määritetään attribuutille Ergonodessa. Yhteysviivakohtainen valuutta, jossa useat sarakkeet yhdistyvät yhdeksi kokoelmaksi, on Akeneon ominaisuus.
Grouping productit
Vain simple ja variable productit. Grouping producteja ei luoda.
Attribuutin lisääminen templateen
Ergonodella ei ole tähän API:a. Editorista luotu attribuutti on olemassa koko instanssissa, ja lisäät sen templateen Ergonodessa ennen kuin se ilmestyy rajattuun palkkiin.
Yli 255 merkin optionimet
Ergonode hylkää pidemmät optionimet läpinäkymättömällä virheellä, joten nimet katkaistaan 255 merkkiin. Laita koko teksti option custom fieldiin.
Templatejen nimet
Ergonoden API ei palauta templatelle näyttönimeä, joten valitsimet ja varoitukset näyttävät templaten koodin.
Kysymyksiä Ergonodesta ja SDM Portalista
Miten SDM Portal yhdistyy Ergonodeen?
Ergonode tarjoaa vain GraphQL:n osoitteessa /api/graphql/. Lisäät instanssin URL-osoitteen ja API-avaimen, joka lähetetään X-API-KEY-otsakkeena, ja yhteys varmistetaan aidolla handshakella. Avain tallennetaan salattuna, eikä se koskaan kuulu vietyyn mappaukseen.
Käsitteleekö SDM Portal Ergonoden variantteja?
Kyllä. Merkitset lähdesarakkeisiin parent keyn, varianttiakselit ja variantin SKU:n. Ensin luodaan simple productit ja sitten variable product bindingeineen, mikä on Ergonoden vaatima järjestys. Akseliarvot jotka kulkevat ValueMapin läpi ratkeavat silti binding-koodeiksi.
Voiko se asettaa Ergonoden työnkulun tilan?
Kyllä. Ergonode validoi tilasiirtymät palvelimella, joten SDM Portal laskee lyhimmän polun tuotteen nykyisestä tilasta mappaamaasi tilaan ja kulkee sen askel askeleelta.
Miten yksi huono solu ei kaada koko erää?
Kirjoitukset niputetaan aliasoituina GraphQL-mutaatioina, 25 operaatiota per pyyntö. Yksittäinen hylätty arvo voi kaataa koko niputetun dokumentin, joten erä jossa jokainen operaatio kaatui samaan virheeseen ajetaan uudelleen operaatio kerrallaan. Vain todellinen syyllinen kaatuu, ja Ergonoden palauttama syy näkyy rivillä.
Puskaako toinen ajo kaiken uudelleen?
Ei. Jokainen kirjoitus tiivistetään operaatiokohtaisesti, joten muuttumattoman tiedoston uusi ajo raportoi tuotteet muuttumattomina eikä kirjoita mitään. Niitä kertoja varten kun haluat puskea kaiken uudelleen, on pakotettu täysi uudelleensynkronointi.
Käytätkö toista PIM-järjestelmää?
Editori, muunnokset ja työnkulku ovat samat kaikille. Vain kirjoituspolku eroaa PIM-järjestelmän mukaan, joten jokaisella liittimellä on oma sivunsa.
Mappaa Ergonode kerran. Sen jälkeen se toimii itsestään.
Luo työtila, yhdistä Ergonode-instanssisi ja mappaa ensimmäinen toimittajatiedostosi. Neljätoista päivää maksutta, kortilta ei veloiteta mitään kokeilujakson aikana.