Migration von Akeneo zu UnoPim: Schritt für Schritt

Kostenloser Magento-Kurs · Modul 3: Produktinformationen mit UnoPim · Lektion 3.2

Warum Teams von Akeneo zu UnoPim wechseln

Akeneo ist seit Jahren das Standard-Open-Source-PIM für Magento-Shops. UnoPim ist ein neueres Open-Source-PIM auf Laravel-Basis unter der MIT-Lizenz, mit integrierten KI-Werkzeugen für Inhalte, einer REST-API und einem Modul für den Digitalen Produktpass. Die Gründe für einen Wechsel, die wir hören, sind praktisch: ein selbst gehostetes PIM ohne Lizenzgebühren, ein moderner Technologie-Stack und KI-Unterstützung für Texte und Übersetzungen. Einen ausführlichen Vergleich finden Sie in UnoPim als Akeneo-Alternative. In dieser Lektion geht es um den Umzug selbst.

Alles im Folgenden stammt aus einem echten Machbarkeitstest, den wir für den Katalog eines Kunden durchgeführt haben: ein Produkt aus jeder Familie, über beide APIs von Akeneo zu UnoPim übertragen und anschließend Wert für Wert geprüft. In diesem Test wurden 150 Familien, 172 Produktdatensätze und rund 3.000 Dateien übertragen, und alle 64.660 Produktwerte kamen an. Auf dem Weg dorthin mussten wir allerdings mehrere Probleme beheben, die erst der Vergleich sichtbar machte.

Schritt 1: das Datenmodell abbilden

Die gute Nachricht: Beide Systeme denken sehr ähnlich über Produktdaten. Beide nutzen Attribute mit Optionen, Familien, die Attribute bündeln, Kategorien, Kanäle, Sprachen und Währungen. An einigen Stellen heißen die Dinge anders, und das sollten Sie wissen, bevor Sie die erste Zeile Importcode schreiben.

Zwei Punkte brauchen vorab eine Entscheidung. Erstens haben die Reference Entities und Asset Families von Akeneo (kostenpflichtige Editionen) keine direkte Entsprechung; Dateien werden meist zu Datei- oder Bildattributen oder landen in der kostenlosen UnoPim-DAM-Erweiterung. Zweitens: Notieren Sie jede Sprache und jeden Kanal, den Sie nutzen. UnoPim speichert Werte wie Akeneo pro Kanal und Sprache, die Zuordnung muss also exakt sein.

Schritt 2: Daten in der richtigen Reihenfolge übertragen

Installieren Sie UnoPim zuerst auf einem Testserver; unsere Anleitung zur UnoPim-Installation zeigt, wie. Lesen Sie dann alles über die Akeneo-REST-API in lokale Dateien ein, damit Sie den Import wiederholen können, ohne Akeneo erneut anzufassen. Laden Sie die Daten in dieser Reihenfolge über die REST-API in UnoPim, denn jede Ebene hängt von der vorherigen ab:

Verknüpfungen kommen zuletzt, weil beide Enden einer Verbindung existieren müssen. In unserem Test ließ sich nur ein Teil der Verknüpfungen anlegen, schlicht weil die Zielprodukte nicht in der Testauswahl waren. Das ist in einem Testlauf normal und löst sich im vollständigen Durchlauf.

Schritt 3: jeden Wert vergleichen

Eine Migration, die „0 Fehler“ meldet, ist noch nicht fertig. Schreiben Sie ein Skript, das jedes Produkt aus beiden Systemen liest und jedes Attribut pro Kanal und Sprache vergleicht. Unsere Regel war einfach: Akeneo exakt so übernehmen, wie es ist. Ein leerer Wert bleibt leer, und ein deutscher Text für die Schweiz darf sich durchaus von dem für Deutschland unterscheiden. Nur Unterschiede, die der Vergleich nicht erklären kann, sind Fehler.

Die Fallstricke, auf die wir gestoßen sind

• HTML in Beschreibungen. UnoPim bereinigt Rich Text mit einem HTML-Purifier. Tags, die Akeneo akzeptierte, etwa div oder span, und aus Word eingefügtes HTML wurden verändert oder entfernt. Wir haben die Purifier-Einstellungen angepasst und den gerenderten Text anschließend in einem echten Browser geprüft.
• Variantenachsen. In unserem Test ließen sich Maßattribute (zum Beispiel ein Volumen) in UnoPim nicht als Variantenachsen verwenden, daher brauchten einige Variantenstrukturen einen anderen Aufbau.
• Dateiregeln. Jedes Datei- oder Bildattribut in UnoPim hat eigene erlaubte Dateiendungen und eine maximale Dateigröße, und Uploads werden geprüft. Gleichen Sie diese Grenzen vor dem vollständigen Durchlauf mit Ihren größten PDFs und Bildern ab.
• Dateinamen und Duplikate. Bereinigen Sie ungewöhnliche Dateinamen und verwenden Sie eine identische Datei nur innerhalb desselben Produkts und Attributs wieder, sonst lehnt UnoPim den Medienpfad womöglich ab.

Einstellungen, die Sie für eine Migration ändern, etwa Purifier-Regeln oder Upload-Grenzen, gehören zu Ihrer Installation. Dokumentieren Sie sie und spielen Sie sie nach jedem UnoPim-Upgrade erneut ein.

Schritt 4: den Wechsel planen

Beginnen Sie wie wir mit einem Produkt pro Familie. So berühren Sie jede Struktur mit wenig Daten und sehen Probleme früh. Übertragen Sie dann den gesamten Katalog auf den Testserver, vergleichen Sie erneut und binden Sie Ihren Shop an. Am Tag des Wechsels frieren Sie die Bearbeitung in Akeneo ein, führen einen letzten Delta-Import durch und behalten Akeneo einige Wochen lang schreibgeschützt als Rückfallebene.

Testen Sie sich

Quellen

• api.akeneo.com/api-reference-index.html
• github.com/unopim/unopim
• devdocs.unopim.com/3.1/introduction/installation.html
• github.com/unopim/unopim/blob/3.x/CHANGELOG.md

Brauchen Sie Hilfe dabei?

Planen Sie den Umzug von Akeneo? Als offizieller UnoPim-Partner übernehmen wir die Testmigration und den Wert-für-Wert-Vergleich für Sie. Sehen Sie sich unsere UnoPim-Leistungen an oder hinterlassen Sie unten Ihre Daten.