Lieferantendaten in Akeneo überführen. Ohne Code.
Ihr Lieferant schickt eine Tabelle. Akeneo will ein Produktdokument mit der richtigen Familie, dem richtigen Kanal, der richtigen Locale und der richtigen Währung auf jedem Wert. SDM Portal ist die Mapping-Ebene dazwischen: Sie bauen sie einmal pro Lieferant, und jede weitere Datei wiederholt die gleichen Regeln.
Verbindung
- ProtokollAkeneo REST API, /api/rest/v1
- AuthentifizierungOAuth2 Password Grant: Client ID, Secret, Benutzername, Passwort
- EditionenCommunity Edition 7 und Serenity, beim Handshake erkannt
- StrukturFamilie
- SchreibenND-JSON PATCH /products, bis zu 100 pro Batch
- Delta syncDokument-Hash pro Produkt
Wo ein Akeneo-Lieferantenfeed wirklich hängen bleibt
Lieferantendateien sind für Menschen gemacht. Akeneo ist für ein Schema gemacht. Die meiste Arbeit liegt im Abstand dazwischen, und dieser Abstand kommt mit jeder neuen Datei zurück.
Attribute leben in Familien
Eine Lieferantenspalte bedeutet nichts, solange Sie nicht wissen, zu welcher Familie sie gehört. Wählen Sie die Familie, und die Attributleiste beschränkt sich auf die Attribute dieser Familie, in deren eigener Reihenfolge.
Jeder Wert hat eine Dimension
Akeneo-Werte tragen eine Locale und, bei scopable Attributen, einen Kanal. Ein Preis ist eine Kollektion mit einer Währung. Ein metrischer Wert ist eine Zahl plus eine Einheit. Stimmt davon eines nicht, wird der Wert abgewiesen.
Optionen sind Codes, keine Labels
Ein Select-Wert muss auf einen bestehenden Optionscode auflösen, der zu den Zeichen passt, die Akeneo akzeptiert. Lieferantendateien schicken stattdessen Labels wie Navy Blue.
Wie SDM Portal nach Akeneo schreibt
Sie zeichnen das Mapping auf einer Leinwand. Knifflige Regeln beschreiben Sie in normaler Sprache, und sie werden einmal in eine feste Regel kompiliert, damit Läufe reproduzierbar bleiben. Unten steht, was die Akeneo-Seite davon tatsächlich tut.
Mapping pro Familie
Wählen Sie die Familie, und die Attributleiste beschränkt sich darauf, unter Beibehaltung der Attributreihenfolge dieser Familie. Das Identifier-Attribut fällt weg, stattdessen kommt ein Systemfeld namens esa_sku hinzu, sodass Sie SKU wie jede andere Spalte mappen, genau wie bei Ergonode.
Locale auf der Verbindung
Die aktivierten Locales kommen aus Ihrer eigenen Instanz. Locale ist eine Eigenschaft der Verbindung, die Sie ziehen, also können drei Beschreibungsspalten ein Attribut in drei Sprachen füllen. Ein lokalisierbares Attribut übernimmt die Locale der Verbindung; ein nicht lokalisierbares behält den ersten Wert und warnt.
Kanal und Währung pro Profil
In den Veröffentlichungseinstellungen stehen Kanal und Standardwährung des Profils, angeboten aus Ihren eigenen Kanälen und begrenzt auf die Währungen dieses Kanals. Ein scopable Wert ohne konfigurierten Kanal wird mit einer Warnung weggelassen. Stellen Sie das vor der Freigabe ein: eine Änderung verändert jeden Dokument-Hash und erzwingt einen vollständigen neuen Push.
Preiskollektionen, mehrere Währungen
Auch die Währung ist eine Eigenschaft einer Verbindung. Mehrere Quellspalten, etwa price_eur und price_usd, laufen in einer Preiskollektion auf einem Attribut zusammen. Verbindungen mit Währung mit Verbindungen ohne Währung zu mischen lässt den Dry-Run scheitern, statt zu raten.
Metrische Attribute
Ein metrischer Wert wird als Zahl plus die Standardeinheit des Attributs geschrieben. Ein Attribut ohne Standardeinheit lässt den Wert fallen und sagt das, statt eine Zahl ohne Einheit zu schreiben.
Optionen anlegen mit Labels
Fehlende Select-Optionen werden mit Labels pro Locale angelegt. Codes müssen zu den Zeichen passen, die Akeneo erlaubt, und ein ungültiger Code wird mit einem Korrekturvorschlag abgewiesen statt still umgeschrieben, also ist der Code, den Sie sehen, der Code, der ankommt.
Neue Attribute aus dem Editor
Legen Sie Attribute der Typen text, textarea, number, date, simple select, multi select, boolean, price collection und metric an, ohne die Leinwand zu verlassen. Jeder Typ braucht eine Attributgruppe; metric braucht zusätzlich eine Familie und eine Standardeinheit. Das neue Attribut wird mit einem Read-Append-PATCH an die Familie des Profils angehängt, sodass nichts anderes in der Familie angefasst wird.
Reference Entities auf Serenity
Ein Reference-Entity-Attribut verhält sich wie ein Select und seine Kollektionsvariante wie ein Multi Select. Die Optionsliste besteht aus den Records der verknüpften Entität, Sie mappen Lieferantenwerte also direkt auf Record-Codes.
Schreibverhalten, das Sie prüfen können
Produkte gehen als ND-JSON-Batches von maximal 100 hinaus. Jede Zeile kommt als angelegt, aktualisiert oder abgewiesen zurück, und eine Abweisung wird pro Attribut gemeldet. Rate Limits werden aus der Antwort beachtet. Jedes Produkt trägt einen Dokument-Hash, ein erneuter Lauf einer unveränderten Datei schreibt also nichts. In den Modi create und update wird zuerst geprüft, was schon existiert, in Blöcken von 500 SKUs.
Was wir nach Akeneo schreiben können
Select- und Multi-Select-Werte werden auf Optionscodes gemappt, und fehlende Optionen können mit ihren Labels angelegt werden. Kategorien werden pro Produkt als bereinigte Menge zugewiesen.
Was der Akeneo-Connector noch nicht tut
Lesen Sie das lieber vor der Anmeldung, als es in Woche zwei zu entdecken. Jeder Punkt unten ist eine echte Grenze des Akeneo-Connectors von heute.
Product Models und Varianten
Variantenachsen sind heute eine Ergonode-Funktion. In einem Akeneo-Profil sind die Variantenmarker ausgeblendet. Trägt ein älterer Flow sie noch, werden die Kinder als eigenständige Produkte geschrieben und die Eltern mit einer zusammengefassten Warnung übersprungen.
Medien, Tabellen, Identifier
Bild- und Medienattribute, Tabellenattribute und das Identifier-Attribut sind in der Leiste sichtbar, aber nicht schreibbar. Sie bleiben lesbar, damit Sie die vollständige Familie sehen.
Reference-Entity-Records
Records einer Reference Entity werden als Optionen gelesen, nie angelegt. Ihr Label ist der Record-Code, der Picker zeigt also Codes.
Workflow-Status
Akeneo kennt keinen Workflow-Status auf Produkten. Ein Status-Mapping, das aus einem Ergonode-Flow mitgekommen ist, wird mit einer Warnung ignoriert, statt den Lauf scheitern zu lassen.
Custom Fields auf Optionen
Akeneo-Optionen haben Labels, aber keine Custom Fields, deshalb bleiben die Anreicherungsfunktionen für Optionen in einem Akeneo-Profil ausgeblendet.
Attribute löschen
Ein über die API angelegtes Attribut kann über die CE-7-API nicht wieder gelöscht werden. Legen Sie sie also bewusst an.
Fragen zu Akeneo und SDM Portal
Welche Akeneo-Versionen unterstützt SDM Portal?
Akeneo Community Edition 7 und Serenity. Edition und Version werden beim Handshake der Verbindung erkannt und in der Verbindungszeile angezeigt, sodass Sie genau sehen, womit Sie verbunden sind.
Wie authentifiziert sich SDM Portal bei Akeneo?
Über eine Akeneo-API-Verbindung: Client ID, Client Secret, Benutzername und Passwort über den OAuth2 Password Grant. Das Bearer-Token wird pro Verbindung zwischengespeichert und bei einem 401 einmal erneuert. Zugangsdaten werden verschlüsselt gespeichert und sind niemals Teil eines exportierten Mappings.
Unterstützt SDM Portal Akeneo Product Models und Varianten?
Noch nicht. Variantenachsen und Bindings sind heute eine Ergonode-Funktion. In einem Akeneo-Profil sind die Variantenmarker ausgeblendet, und ein Flow, der sie noch trägt, schreibt die Kinder als eigenständige Produkte und überspringt die Eltern mit einer Warnung.
Wie werden Kanäle, Locales und Währungen behandelt?
Locale ist eine Eigenschaft der Mapping-Verbindung, also können drei Beschreibungsspalten ein Attribut in drei Sprachen füllen. Kanal und Standardwährung stellen Sie pro Profil in den Veröffentlichungseinstellungen ein, angeboten aus Ihren eigenen Kanälen. Ein Preisattribut kann mehrere Währungen gleichzeitig aufnehmen, indem Sie pro Verbindung eine Währung setzen.
Kann ich sehen, was passiert, bevor etwas nach Akeneo geschrieben wird?
Ja. Ein Dry-Run zeigt das Ergebnis Zeile für Zeile mit Warnungen für nicht gemappte Werte und weggelassene Felder und schreibt nichts. Läufe können zuerst zu einem Staging-Akeneo und danach in die Produktion gehen, und Delta Sync bedeutet, dass nur geänderte Produkte erneut gepusht werden.
Nutzen Sie ein anderes PIM?
Editor, Transformationen und Workflow sind für alle gleich. Nur der Schreibpfad unterscheidet sich pro PIM, deshalb hat jeder Connector seine eigene Seite.
Akeneo einmal mappen. Danach läuft es von selbst.
Legen Sie einen Workspace an, verbinden Sie Ihre Akeneo-Instanz und mappen Sie Ihre erste Lieferantendatei. Vierzehn Tage kostenlos, während der Testphase wird Ihre Karte nicht belastet.