Je leverancier stuurt een spreadsheet. Akeneo wil een productdocument met op elke waarde de juiste familie, het juiste kanaal, de juiste locale en de juiste valuta. mappio is de mappinglaag daartussen: je bouwt die één keer per leverancier, en elk volgend bestand herhaalt dezelfde regels.
ConnectionLeveranciersbestanden zijn gemaakt voor mensen. Akeneo is gemaakt voor een schema. Het werk zit vooral in de afstand daartussen, en die afstand komt terug bij elk nieuw bestand.
Een leverancierskolom betekent niets tot je weet bij welke familie die hoort. Kies de familie en de attribuutrail beperkt zich tot de attributen van die familie, in de eigen volgorde van die familie.
Akeneo-waarden dragen een locale en, bij scopable attributen, een kanaal. Een prijs is een collectie met een valuta. Een metrische waarde is een getal plus een eenheid. Zit daar één ding fout, dan wordt de waarde geweigerd.
Een selectwaarde moet uitkomen op een bestaande optiecode die past binnen de tekens die Akeneo accepteert. Leveranciersbestanden sturen in plaats daarvan labels als Navy Blue.
Je tekent de mapping op een canvas. Lastige regels beschrijf je in gewone taal en die worden één keer gecompileerd tot een vaste regel, zodat runs reproduceerbaar blijven. Hieronder staat wat de Akeneo-kant daarvan precies doet.
Kies de familie en de attribuutrail beperkt zich daartoe, met behoud van de attribuutvolgorde van die familie. Het identifier-attribuut valt weg en in plaats daarvan komt er een systeemveld esa_sku bij, zodat je SKU mapt als elke andere kolom, precies zoals bij Ergonode.
De ingeschakelde locales komen uit je eigen instantie. Locale is een eigenschap van de verbinding die je tekent, dus drie omschrijvingskolommen kunnen één attribuut in drie talen vullen. Een localiseerbaar attribuut neemt de locale van de verbinding over; een niet-localiseerbaar attribuut houdt de eerste waarde en geeft een waarschuwing.
In de publicatie-instellingen staan het kanaal en de standaardvaluta van het profiel, aangeboden uit je eigen kanalen en beperkt tot de valuta van dat kanaal. Een scopable waarde zonder ingesteld kanaal wordt met een waarschuwing weggelaten. Stel dit in vóór de goedkeuring: een wijziging verandert elke documenthash en dwingt een volledige nieuwe push.
Valuta is ook een eigenschap van een verbinding. Meerdere bronkolommen, bijvoorbeeld price_eur en price_usd, komen samen in één prijscollectie op één attribuut. Verbindingen met een valuta mengen met verbindingen zonder valuta laat de dry-run mislukken in plaats van te gokken.
Een metrische waarde wordt geschreven als een getal plus de standaard metrische eenheid van het attribuut. Een attribuut zonder standaardeenheid laat de waarde vallen en meldt dat, in plaats van een getal zonder eenheid te schrijven.
Ontbrekende selectopties worden aangemaakt met labels per locale. Codes moeten passen binnen de tekens die Akeneo toestaat, en een ongeldige code wordt geweigerd met een voorstel voor een geldige code in plaats van stil herschreven, dus de code die je ziet is de code die aankomt.
Maak attributen van het type text, textarea, number, date, simple select, multi select, boolean, price collection en metric aan zonder het canvas te verlaten. Elk type heeft een attribuutgroep nodig; metric heeft ook een familie en een standaardeenheid nodig. Het nieuwe attribuut wordt met een read-append PATCH aan de familie van het profiel toegevoegd, zodat er niets anders in die familie wordt aangeraakt.
Een reference entity-attribuut gedraagt zich als een select en de collectievariant als een multi select. De optielijst bestaat uit de records van de gekoppelde entiteit, dus je mapt leverancierswaarden rechtstreeks op recordcodes.
Producten gaan uit als ND-JSON-batches van maximaal 100. Elke regel komt terug als aangemaakt, bijgewerkt of geweigerd, en een weigering wordt per attribuut gemeld. Rate limits worden uit het antwoord gerespecteerd. Elk product draagt een documenthash, dus een nieuwe run van een ongewijzigd bestand schrijft niets. In de modi create en update wordt eerst gecontroleerd wat al bestaat, in blokken van 500 SKU's.
Select- en multi select-waarden worden gemapt op optiecodes, en ontbrekende opties kunnen met hun labels worden aangemaakt. Categorieën worden per product als een ontdubbelde set toegekend.
We vertellen dit liever voordat je je aanmeldt dan dat je het in week twee ontdekt. Elk punt hieronder is een echte grens van de Akeneo-connector vandaag.
Variantassen zijn vandaag een Ergonode-functie. Op een Akeneo-profiel zijn de variantmarkers verborgen. Draagt een ouder flow ze nog, dan worden de kinderen als losse producten geschreven en worden de ouders overgeslagen met één samengevatte waarschuwing.
Afbeeldings- en media-attributen, tabelattributen en het identifier-attribuut zijn zichtbaar in de rail maar niet schrijfbaar. Ze blijven leesbaar zodat je de volledige familie ziet.
Records van een reference entity worden gelezen als opties, nooit aangemaakt. Hun label is de recordcode, dus de picker toont codes.
Akeneo kent geen workflowstatus op producten. Een statusmapping die uit een Ergonode-flow is meegekomen wordt genegeerd met één waarschuwing in plaats van de run te laten mislukken.
Akeneo-opties hebben labels maar geen custom fields, dus de verrijkingsfuncties voor opties blijven verborgen op een Akeneo-profiel.
Een attribuut dat via de API is aangemaakt kan via de CE 7-API niet meer worden verwijderd. Maak ze dus bewust aan.
Akeneo Community Edition 7 en Serenity. De editie en de versie worden tijdens de handshake van de connectie gedetecteerd en op de connectieregel getoond, zodat je precies ziet waarmee je verbonden bent.
Via een Akeneo API-connectie: client ID, client secret, gebruikersnaam en wachtwoord over de OAuth2 password grant. Het bearer token wordt per connectie gecachet en bij een 401 één keer vernieuwd. Inloggegevens worden versleuteld opgeslagen en gaan nooit mee in een geëxporteerde mapping.
Nog niet. Variantassen en bindings zijn vandaag een Ergonode-functie. Op een Akeneo-profiel zijn de variantmarkers verborgen, en een flow die ze nog draagt schrijft de kinderen als losse producten en slaat de ouders over met één waarschuwing.
Locale is een eigenschap van de mappingverbinding, dus drie omschrijvingskolommen kunnen één attribuut in drie talen vullen. Kanaal en standaardvaluta stel je per profiel in bij de publicatie-instellingen, aangeboden uit je eigen kanalen. Een prijsattribuut kan meerdere valuta tegelijk ontvangen door per verbinding een valuta te zetten.
Ja. Een dry-run toont het resultaat rij voor rij, met waarschuwingen voor niet-gemapte waarden en weggelaten velden, en schrijft niets. Runs kunnen eerst naar een staging-Akeneo en daarna naar productie, en delta sync betekent dat alleen gewijzigde producten opnieuw worden gepusht.
De editor, de transformaties en de workflow zijn gedeeld. Alleen het schrijfpad verschilt per PIM, dus elke connector heeft zijn eigen pagina.
Start een werkruimte, koppel je Akeneo-instantie en map je eerste leveranciersbestand. Veertien dagen gratis, tijdens de proefperiode wordt niets van je kaart afgeschreven.
