So migrierst du vom Shopware-6-Plugin zur Shopware-6-App

Migriere deine bestehende Shopware-6-Verbindung vom Plugin zur App.

Wir haben unsere eigene Shopware 6-App entwickelt, die das von Response GmbH entwickelte Shopware 6-Plugin ersetzen wird. Dieses Plugin wird nicht mehr aktiv gepflegt und aktualisiert. Daher bitten wir dich, stattdessen die App zu installieren und deine bestehenden Projekte zu migrieren.

Hinweis: Dieser Artikel beschreibt die Migration deiner Produkte vom Shopware 6-Plugin zur Shopware 6-App. Wenn du versuchst, eine neue Shopware-App-Verbindung einzurichten, lies bitte den Artikel auf dieser Seite. Wenn du Shopware 5 hast, folge den Schritten von dem Artikel auf dieser Seite stattdessen.

Tipp: Kontaktiere unser Support-Team um deine Projekte zu kopieren und die folgenden Schritte in einem kopierten Projekt auszuführen. So kannst du das ursprüngliche Projekt mit der Kopie vergleichen, um sicherzustellen, dass alle Felder korrekt zugeordnet sind.

Installiere die App

Bitte sieh dir diese Anleitung für Anweisungen an, wie du die Channable-App für Shopware 6 herunterlädst und installierst.

Migriere deine bestehenden Projekte

Wenn du deine Produkte mit der App statt mit dem Plugin importierst, kannst du mit kleinen Abweichungen bei einigen der Felder rechnen (siehe „Welche Unterschiede kannst du erwarten“ unten). Diese Unterschiede wirken sich möglicherweise nicht auf deine Projekte aus; in diesem Fall kannst du deine Verbindungen über die unter „Importverbindung ändern“ und „Bestellverbindung ändern“ beschriebenen Schritte umstellen. Wenn die Unterschiede deine Projekte möglicherweise doch betreffen, empfehlen wir dir, am Ende des Artikels einige zusätzliche Schritte durchzuführen, damit keine Probleme entstehen.

Hinweis: Beim Plugin hatte jede Kombination aus Verkaufskanal und Sprache ihre eigene Verbindung. Für die App erstellst du nur eine Verbindung für jeden Verkaufskanal, sodass du dieselbe Verbindung für mehrere Sprachen wiederverwenden kannst.

Importverbindung ändern

1

Ändere die Importverbindung — wähle die neue App-Verbindung aus

• Gehe zu „Setup > Import einrichten“.
• Suche deinen Shopware 6-Import und klicke auf „Einstellungen“.
• Klicke auf „Import ändern“.
• Wähle die neue App-Verbindung aus den Importoptionen aus.
• Achte darauf, dass du die richtige Sprache aus dem Dropdown auswählst (dieselbe wie zuvor für diesen Import) und klicke auf „Speichern“.
• Du wirst jetzt zum Import-Mapping weitergeleitet. Klicke auf „Speichern & Importieren“.

2

Mapping prüfen und aktualisieren

Feldnamen können unterschiedlich sein, also stell vor dem Fortfahren sicher, dass deine neuen Importfelder korrekt deinen bestehenden Projektfeldern zugeordnet sind. Folge diesen Schritten:

• Gehe bei deiner neuen Verbindung zu „Setup > Mapping“.
• Stell sicher, dass alle Felder korrekt zugeordnet sind, indem du das neue Mapping mit dem Mapping in deinem ursprünglichen Projekt vergleichst. Felder, die nicht mehr im Import enthalten sind, kannst du sicher löschen.
• Wenn du fertig bist, klicke auf „Speichern & Importieren“.

Bestellverbindung ändern

Wir können die Plattform-Verbindung in einer Bestellverbindung nicht ändern. Deshalb musst du die alte Bestellverbindung für das Plugin deaktivieren und eine neue für die App erstellen.

1

Deaktiviere die alte(n) Bestellverbindung(en)

• Gehe zu „Setup > Bestellungen einrichten“.
• Klicke für jede aktive Bestellverbindung, die das Shopware 6-Plugin verwendet, auf „Einstellungen“.
• Klicke auf „Bestellverbindung deaktivieren“ und dann auf „Speichern“.
• Stell sicher, dass du das für alle aktiven Bestellverbindungen machst!

2

Neue Bestellverbindung(en) für die App erstellen

• Füge neue Bestellverbindungen mit der Schaltfläche „Bestellungen einrichten“ hinzu.
• Für die Plattform-Verbindung stell sicher, dass du die neue Shopware-App-Verbindung auswählst. Bei allen anderen Einstellungen wählst du einfach die gleichen wie in der alten Bestellverbindung, die du gerade deaktiviert hast.
• Stell sicher, dass du die Bestellverbindung aktivierst, und klicke auf „Speichern“.

Welche Unterschiede kannst du erwarten?

• Wenn ein Feldname ein Sonderzeichen enthält, können sich deine Feldnamen leicht ändern. Wenn du zum Beispiel ein Feld hast, das heißt properties_grösse, würde der Plugin-Importer das als properties_groesse aber der neue App-Importer importiert dieses Feld als properties_grosse. Das kannst du im Importer-Mapping beheben. Zum Beispiel:

1

Beispiel: Feldnamen mit Sonderzeichen zuordnen

• Das Feld properties_groesse wurde über das Plugin importiert und dem Projektfeld properties_groesse
• Die App importiert dieses Feld jetzt als properties_grosse. Indem du es dem properties_groessezuordnest, stellst du sicher, dass keine Feldnamen geändert werden.
• Das alte properties_groesse Feld aus dem Plugin kann dann sicher gelöscht werden.

• Das Plugin hat einige Preise nicht gerundet. Der neue App-Importer rundet alle Preise auf zwei Dezimalstellen.
• Wenn du ein benutzerdefiniertes Feld mit einem True/False Wert hast, importieren wir diese als 1 (für True) und 0 (für False). Wenn nötig, kannst du diese zurück in True/False mit einer (Master-)Regel umwandeln.

• Im Plugin konntest du in den Plugin-Einstellungen eine benutzerdefinierte Domain für den Verkaufskanal festlegen. Diese Domain wurde verwendet, um die Link und shopware_url Felder für jedes Produkt zu erstellen. Die App hat diese Option nicht. Sie verwendet die Domain des Verkaufskanals aus den Verkaufskanal-Einstellungen:

• Wenn price_net in deinem Backend 0 ist, ist es auch in Channable 0. Das Plugin würde price_net selbst berechnen, die App macht das aber nicht mehr. Du kannst das beheben, indem du entweder sicherstellst, price_net dass price_net immer in deinem Backend einen Wert hat, oder indem du die price_gross mit einer Regel berechnest, mithilfe von tax_rate.
• Wenn du benutzerdefinierte Felder vom Typ Medienfeldhast, rufen wir die URL der Medien nicht mehr automatisch ab. Das würde deinen Server zusätzlich belasten, da wir eine zusätzliche Anfrage pro Produkt machen. Deshalb wollen wir das nur dann tun, wenn es nötig ist. Wenn du feststellst, dass in einigen benutzerdefinierten Feldern in Channable eine ID steht, wo du eine URL erwartest, kannst du uns kontaktieren um stattdessen die Funktion zu aktivieren, die die URLs abruft.

Hinweis: Das funktioniert nur für Medienfeld-Typen!