Yhdistä toimittajadata Akeneoon. Ilman koodia.
Toimittajasi lähettää taulukon. Akeneo haluaa tuotedokumentin, jossa jokaisella arvolla on oikea perhe, kanava, locale ja valuutta. SDM Portal on mappauskerros niiden välissä: rakennat sen kerran toimittajaa kohti, ja jokainen myöhempi tiedosto toistaa samat säännöt.
Yhteys
- ProtokollaAkeneo REST API, /api/rest/v1
- TodennusOAuth2 password grant: client ID, secret, käyttäjätunnus, salasana
- EditiotCommunity Edition 7 ja Serenity, tunnistetaan handshakessa
- RakennePerhe
- KirjoitusND-JSON PATCH /products, enintään 100 per erä
- Delta syncDokumenttitiiviste per tuote
Missä Akeneo-toimittajasyöte todella jumittuu
Toimittajatiedostot on tehty ihmisille. Akeneo on tehty skeemalle. Suurin osa työstä on näiden välinen etäisyys, ja se palaa jokaisen uuden tiedoston mukana.
Attribuutit elävät perheissä
Toimittajan sarake ei tarkoita mitään ennen kuin tiedät, mihin perheeseen se kuuluu. Valitse perhe, ja attribuuttipalkki rajautuu sen perheen attribuutteihin, perheen omassa järjestyksessä.
Jokaisella arvolla on ulottuvuus
Akeneon arvoilla on locale ja, scopable-attribuuteilla, kanava. Hinta on kokoelma, jolla on valuutta. Metrinen arvo on luku ja yksikkö. Jos yksi näistä on väärin, arvo hylätään.
Optiot ovat koodeja, eivät nimikkeitä
Select-arvon täytyy ratketa olemassa olevaksi optiokoodiksi, joka noudattaa Akeneon hyväksymiä merkkejä. Toimittajatiedostot lähettävät sen sijaan nimikkeitä kuten Navy Blue.
Miten SDM Portal kirjoittaa Akeneoon
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ä Akeneon puoli siitä tosiasiassa tekee.
Mappaus perheen mukaan
Valitse perhe, ja attribuuttipalkki rajautuu siihen säilyttäen perheen attribuuttijärjestyksen. Identifier-attribuutti jätetään pois ja sen sijaan lisätään järjestelmäkenttä esa_sku, joten mappaat SKU:n kuten minkä tahansa muun sarakkeen, aivan kuten Ergonodessa.
Locale yhteysviivalla
Käytössä olevat localet tulevat omasta instanssistasi. Locale on piirtämäsi yhteysviivan ominaisuus, joten kolme kuvaussaraketta voi täyttää yhden attribuutin kolmella kielellä. Lokalisoitava attribuutti ottaa yhteysviivan localen; ei-lokalisoitava säilyttää ensimmäisen arvon ja varoittaa.
Kanava ja valuutta profiilia kohti
Julkaisuasetuksissa on profiilin kanava ja oletusvaluutta, tarjottuna omista kanavistasi ja rajattuna kyseisen kanavan valuuttoihin. Scopable-arvo ilman määritettyä kanavaa pudotetaan varoituksella. Aseta tämä ennen hyväksyntää: muutos muuttaa jokaisen dokumenttitiivisteen ja pakottaa täyden uuden puskun.
Hintakokoelmat, monivaluutta
Myös valuutta on yhteysviivan ominaisuus. Useat lähdesarakkeet, esimerkiksi price_eur ja price_usd, yhdistyvät yhdeksi hintakokoelmaksi yhdellä attribuutilla. Valuutan sisältävien ja ilman valuuttaa olevien yhteysviivojen sekoittaminen kaataa testiajon sen sijaan, että arvattaisiin.
Metriset attribuutit
Metrinen arvo kirjoitetaan lukuna ja attribuutin oletusyksikkönä. Attribuutti ilman oletusyksikköä pudottaa arvon ja kertoo siitä sen sijaan, että kirjoittaisi luvun ilman yksikköä.
Optioiden luonti nimikkeineen
Puuttuvat select-optiot luodaan nimikkeineen jokaiselle localelle. Koodien on noudatettava Akeneon hyväksymiä merkkejä, ja virheellinen koodi hylätään korjausehdotuksella eikä kirjoiteta hiljaa uudelleen, joten näkemäsi koodi on se koodi, joka menee perille.
Uudet attribuutit editorista
Luo tyyppien text, textarea, number, date, simple select, multi select, boolean, price collection ja metric attribuutteja poistumatta kankaalta. Jokainen tyyppi tarvitsee attribuuttiryhmän; metric tarvitsee lisäksi perheen ja oletusyksikön. Uusi attribuutti liitetään profiilin perheeseen lue-ja-lisää-PATCHilla, joten mihinkään muuhun perheessä ei kosketa.
Reference entities Serenityssä
Reference entity -attribuutti käyttäytyy kuin select ja sen kokoelma kuin multi select. Optiolista koostuu liitetyn entiteetin recordeista, joten mappaat toimittajan arvot suoraan record-koodeihin.
Kirjoitusmekaniikka, jonka voit tarkistaa
Tuotteet lähtevät ND-JSON-erinä, enintään 100 kerrallaan. Jokainen rivi palaa luotuna, päivitettynä tai hylättynä, ja hylkäys raportoidaan attribuutin tarkkuudella. Rate limitit huomioidaan vastauksesta. Jokaisella tuotteella on dokumenttitiiviste, joten muuttumattoman tiedoston uusi ajo ei kirjoita mitään. Tiloissa create ja update tarkistetaan ensin, mikä on jo olemassa, 500 SKU:n erissä.
Mitä voimme kirjoittaa Akeneoon
Select- ja multi select -arvot mapataan optiokoodeihin, ja puuttuvat optiot voidaan luoda nimikkeineen. Kategoriat annetaan tuotekohtaisesti duplikaateista siivottuna joukkona.
Mitä Akeneo-liitin ei vielä tee
Luet tämän mieluummin ennen rekisteröitymistä kuin huomaat sen toisella viikolla. Jokainen alla oleva kohta on Akeneo-liittimen todellinen raja tänään.
Product model -objektit ja variantit
Varianttiakselit ovat tänään Ergonoden ominaisuus. Akeneo-profiilissa varianttimerkinnät on piilotettu. Jos vanhempi flow kantaa niitä vielä, lapset kirjoitetaan itsenäisinä tuotteina ja vanhemmat ohitetaan yhdellä koostetulla varoituksella.
Media, taulukot, identifier
Kuva- ja media-attribuutit, taulukkoattribuutit ja identifier-attribuutti näkyvät palkissa mutta eivät ole kirjoitettavissa. Ne pysyvät luettavina, jotta näet koko perheen.
Reference entity -recordit
Reference entityn recordit luetaan optioina, niitä ei koskaan luoda. Niiden nimike on record-koodi, joten valitsin näyttää koodeja.
Työnkulun tila
Akeneossa ei ole tuotteiden työnkulun tilaa. Ergonode-flow:sta periytynyt tilamappaus ohitetaan yhdellä varoituksella sen sijaan, että ajo kaatuisi.
Optioiden custom fieldit
Akeneon optioilla on nimikkeet mutta ei custom fieldejä, joten optioiden rikastustoiminnot pysyvät piilossa Akeneo-profiilissa.
Attribuuttien poistaminen
API:n kautta luotua attribuuttia ei voi poistaa CE 7:n API:lla. Luo ne siis harkiten.
Kysymyksiä Akeneosta ja SDM Portalista
Mitä Akeneo-versioita SDM Portal tukee?
Akeneo Community Edition 7 ja Serenity. Editio ja versio tunnistetaan yhteyden handshakessa ja näytetään yhteysrivillä, joten näet tarkalleen, mihin olet yhteydessä.
Miten SDM Portal todentautuu Akeneoon?
Akeneon API-yhteyden kautta: client ID, client secret, käyttäjätunnus ja salasana OAuth2 password grantin yli. Bearer-token välimuistitetaan yhteyskohtaisesti ja uusitaan kertaalleen 401-vastauksen jälkeen. Tunnukset tallennetaan salattuina, eivätkä ne koskaan kuulu vietyyn mappaukseen.
Tukeeko SDM Portal Akeneon product model -objekteja ja variantteja?
Ei vielä. Varianttiakselit ja bindingit ovat tänään Ergonoden ominaisuus. Akeneo-profiilissa varianttimerkinnät on piilotettu, ja flow joka kantaa niitä vielä kirjoittaa lapset itsenäisinä tuotteina ja ohittaa vanhemmat yhdellä varoituksella.
Miten kanavat, localet ja valuutat käsitellään?
Locale on mappausyhteyden ominaisuus, joten kolme kuvaussaraketta voi täyttää yhden attribuutin kolmella kielellä. Kanava ja oletusvaluutta asetetaan profiilikohtaisesti julkaisuasetuksissa, tarjottuna omista kanavistasi. Hinta-attribuutti voi ottaa vastaan useita valuuttoja kerralla, kun asetat valuutan jokaiselle yhteysviivalle.
Voinko nähdä, mitä tapahtuu ennen kuin Akeneoon kirjoitetaan mitään?
Kyllä. Testiajo näyttää tuloksen rivi riviltä varoituksineen mappaamattomista arvoista ja pudotetuista kentistä, eikä kirjoita mitään. Ajot voivat mennä ensin staging-Akeneoon ja sen jälkeen tuotantoon, ja delta sync tarkoittaa, että vain muuttuneet tuotteet puskataan uudelleen.
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 Akeneo kerran. Sen jälkeen se toimii itsestään.
Luo työtila, yhdistä Akeneo-instanssisi ja mappaa ensimmäinen toimittajatiedostosi. Neljätoista päivää maksutta, kortilta ei veloiteta mitään kokeilujakson aikana.