Mappa leverantörsdata till Akeneo. Ingen kod.
Din leverantör skickar ett kalkylblad. Akeneo vill ha ett produktdokument med rätt familj, kanal, lokal och valuta på varje värde. SDM Portal är mappningslagret mellan dem: du bygger det en gång per leverantör, och varje senare fil upprepar samma regler.
Anslutning
- ProtokollAkeneo REST API, /api/rest/v1
- AutentiseringOAuth2 password grant: client ID, secret, användarnamn, lösenord
- UtgåvorCommunity Edition 7 och Serenity, identifieras vid handshake
- StrukturFamilj
- SkrivningND-JSON PATCH /products, upp till 100 per batch
- Delta syncDokumenthash per produkt
Där ett leverantörsflöde till Akeneo verkligen fastnar
Leverantörsfiler är gjorda för människor. Akeneo är byggt för ett schema. Det mesta av arbetet är avståndet mellan de två, och det kommer tillbaka med varje ny fil.
Attribut hör till familjer
En leverantörskolumn betyder ingenting förrän du vet vilken familj den hör till. Välj familjen och attributskenan begränsas till den familjens attribut, i familjens egen ordning.
Varje värde har en dimension
Akeneo-värden bär en lokal och, för scopable attribut, en kanal. Ett pris är en samling med en valuta. Ett metriskt värde är ett tal plus en enhet. Får du ett av dem fel avvisas värdet.
Alternativ är koder, inte etiketter
Ett select-värde måste landa på en befintlig alternativkod med de tecken Akeneo accepterar. Leverantörsfiler skickar i stället etiketter som Navy Blue.
Så skriver SDM Portal till Akeneo
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 Akeneo-sidan av detta faktiskt gör.
Mappning per familj
Välj familjen och attributskenan begränsas till den, med familjens attributordning bevarad. Identifier-attributet utesluts och i stället läggs ett systemfält som heter esa_sku till, så att du mappar SKU som vilken annan kolumn som helst, precis som i Ergonode.
Lokal på förbindelsen
De aktiverade lokalerna kommer från din egen instans. Lokal är en egenskap hos förbindelsen du drar, så tre beskrivningskolumner kan fylla ett attribut på tre språk. Ett lokaliserbart attribut tar förbindelsens lokal; ett icke-lokaliserbart behåller det första värdet och varnar.
Kanal och valuta per profil
Publiceringsinställningarna håller kanalen och standardvalutan för profilen, föreslagna från dina egna kanaler och begränsade till den kanalens valutor. Ett scopable värde utan konfigurerad kanal släpps med en varning. Ställ in detta före godkännandet: en ändring ändrar varje dokumenthash och tvingar en full ny push.
Prissamlingar, flera valutor
Valuta är också en egenskap hos en förbindelse. Flera källkolumner, till exempel price_eur och price_usd, slås samman till en prissamling på ett attribut. Att blanda förbindelser med valuta och förbindelser utan gör att testkörningen misslyckas i stället för att gissa.
Metriska attribut
Ett metriskt värde skrivs som ett tal plus attributets standardenhet. Ett attribut utan standardenhet släpper värdet och säger det, i stället för att skriva ett tal utan enhet.
Skapande av alternativ med etiketter
Saknade select-alternativ skapas med etiketter per lokal. Koderna måste använda de tecken Akeneo tillåter, och en ogiltig kod avvisas med ett förslag på rättelse i stället för att skrivas om i tysthet, så koden du ser är koden som landar.
Nya attribut från editorn
Skapa attribut av typen text, textarea, number, date, simple select, multi select, boolean, price collection och metric utan att lämna ytan. Varje typ kräver en attributgrupp; metric kräver också en familj och en standardenhet. Det nya attributet läggs till profilens familj med en PATCH som läser och lägger till, så inget annat i familjen berörs.
Reference entities i Serenity
Ett reference entity-attribut beter sig som en select och collection-varianten som en multi select. Alternativlistan är den länkade entitetens poster, så du mappar leverantörsvärden direkt på postkoder.
Skrivmekanik du kan granska
Produkter skickas som ND-JSON-batchar på upp till 100. Varje rad kommer tillbaka som skapad, uppdaterad eller avvisad, och en avvisning rapporteras per attribut. Rate limits respekteras utifrån svaret. Varje produkt bär en dokumenthash, så en ny körning av en oförändrad fil skriver ingenting. I lägena create och update sveps först vad som redan finns, i block om 500 SKU.
Vad vi kan skriva till Akeneo
Select- och multi select-värden mappas till alternativkoder, och saknade alternativ kan skapas med sina etiketter. Kategorier tilldelas per produkt som en mängd utan dubbletter.
Vad Akeneo-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 Akeneo-connectorn i dag.
Product models och varianter
Variantaxlar är i dag en Ergonode-funktion. På en Akeneo-profil är variantmarkörerna dolda. Om ett äldre flöde fortfarande bär dem skrivs barnen som fristående produkter och föräldrarna hoppas över med en samlad varning.
Media, tabeller, identifier
Bild- och mediaattribut, tabellattribut och identifier-attributet syns i skenan men går inte att skriva till. De förblir läsbara så att du ser hela familjen.
Reference entity-poster
Poster i en reference entity läses som alternativ, aldrig skapade. Deras etikett är postkoden, så väljaren visar koder.
Arbetsflödesstatus
Akeneo har ingen arbetsflödesstatus på produkter. En statusmappning som följt med från ett Ergonode-flöde ignoreras med en varning i stället för att köringen misslyckas.
Custom fields på alternativ
Akeneo-alternativ har etiketter men inga custom fields, så berikningsfunktionerna för alternativ förblir dolda på en Akeneo-profil.
Ta bort attribut
Ett attribut som skapats via API:et kan inte tas bort igen via CE 7-API:et. Skapa dem medvetet.
Frågor om Akeneo och SDM Portal
Vilka Akeneo-versioner stöder SDM Portal?
Akeneo Community Edition 7 och Serenity. Utgåvan och versionen identifieras under anslutningens handshake och visas på anslutningsraden, så du ser exakt vad du är ansluten till.
Hur autentiserar SDM Portal mot Akeneo?
Via en Akeneo API-anslutning: client ID, client secret, användarnamn och lösenord över OAuth2 password grant. Bearer-token cachas per anslutning och förnyas en gång vid en 401. Autentiseringsuppgifterna lagras krypterade och ingår aldrig i en exporterad mappning.
Stöder SDM Portal Akeneo product models och varianter?
Inte ännu. Variantaxlar och bindings är i dag en Ergonode-funktion. På en Akeneo-profil är variantmarkörerna dolda, och ett flöde som fortfarande bär dem skriver barnen som fristående produkter och hoppar över föräldrarna med en varning.
Hur hanteras kanaler, lokaler och valutor?
Lokal är en egenskap hos mappningsförbindelsen, så tre beskrivningskolumner kan fylla ett attribut på tre språk. Kanal och standardvaluta ställs in per profil i publiceringsinställningarna, föreslagna från dina egna kanaler. Ett prisattribut kan ta emot flera valutor samtidigt genom att du sätter en valuta per förbindelse.
Kan jag se vad som händer innan något skrivs till Akeneo?
Ja. En testkörning visar resultatet rad för rad, med varningar för omappade värden och släppta fält, och skriver ingenting. Körningar kan gå till ett staging-Akeneo först och produktion därefter, och delta sync innebär att bara ändrade produkter skickas om.
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 Akeneo en gång. Sedan sköter det sig självt.
Skapa en arbetsyta, anslut din Akeneo-instans och mappa din första leverantörsfil. Fjorton dagar gratis, inget dras från kortet under provperioden.