Fehlerbehebung

Nutzen Sie diesen Abschnitt, wenn die App keine Verbindung herstellt, die Installation fehlschlägt, exportierte Daten unvollständig wirken oder Sie eine Staging- oder Live-Umgebung vorbereiten.

Häufige Probleme

cURL error 6: Could not resolve host

Wenn Sie den Fehler cURL error 6: Could not resolve host erhalten:

1. Stellen Sie sicher, dass Ihr Shop über eine externe URL erreichbar ist. Lokale Shopware Installationen werden von der App nicht unterstützt.
2. Prüfen Sie, ob APP_URL in Ihrer .env-Datei die korrekte externe Shop-URL mit http:// oder https:// verwendet.
3. Deinstallieren Sie die App und installieren Sie sie erneut. Die App nur aus- und wieder einzuschalten reicht nicht aus.
4. Leeren Sie den Browser-Cache oder testen Sie erneut in einem Inkognito-Fenster.

ACL role write access error

Wenn Sie den Fehler Write access to entity "acl_role" are not allowed in scope "user" erhalten:

1. Prüfen Sie, ob APP_URL in .env mit der korrekten externen Shop-URL übereinstimmt, inklusive http:// oder https://.
2. Deinstallieren Sie die App und installieren Sie sie erneut.
3. Leeren Sie den Browser-Cache oder testen Sie erneut in einem Inkognito-Fenster.

Produkt-Eigenschaftswerte sind nach dem Export leer

Wenn Produkt-Eigenschaftswerte in der Exportdatei leer sind:

1. Stellen Sie sicher, dass die Eigenschaften im Schritt Mapping des Exportprofils sichtbar und ausgewählt sind.
2. Wenn die Eigenschaften im Schritt Mapping fehlen, stellen Sie sicher, dass sie in der Shopware Administration für en-GB übersetzt sind.
3. Die App verwendet die Shopware Systemsprache en-GB. Deshalb benötigen Eigenschaftsnamen en-GB-Übersetzungen, damit sie korrekt erscheinen.

Staging und Go-live

App in einer Staging- oder Entwicklungsumgebung einrichten

1. Melden Sie sich in Ihrem Shopware Merchant Konto an und fügen Sie einen neuen Testshop mit einer Staging-Domain hinzu, zum Beispiel staging.example.com.
2. Melden Sie sich in Ihrer Staging-Shopware-Instanz an und setzen Sie Ihre Live-Lizenzdomain auf example.com.
3. Setzen Sie die Staging-Domain in Ihrer .env-Datei, zum Beispiel https://staging.example.com/.
4. Lösen Sie die App-URL auf:

bin/console app:url-change:resolve reinstall-apps

Für Shopware Versionen neuer als 6.7.3.0 verwenden Sie:

bin/console app:shop-id:change reinstall-apps

Wenn die App noch nicht installiert ist, installieren Sie sie direkt aus dem Shopware Store in Ihrem Staging-Shop.

Hinweis

Import- und Exportprofile werden nicht automatisch von Live nach Staging kopiert. Erstellen Sie sie im Staging-Shop erneut.

Von Staging auf Live wechseln

Wenn Sie die App in einer Staging-Umgebung verwendet haben und nun live gehen möchten, führen Sie Folgendes aus:

bin/console app:url-change:resolve move-shop-permanently

Für Shopware Versionen neuer als 6.7.3.0 verwenden Sie:

bin/console app:shop-id:change move-shop-permanently

Danach kommuniziert die App mit Ihrem Live-Shop statt mit dem Staging-Shop.

Support-Ticket erstellen

Wenn das Problem nach den Schritten zur Fehlerbehebung weiterhin besteht, erstellen Sie ein Support-Ticket über Ihr Shopware Konto:

1. Öffnen Sie den Shopware Support.
2. Melden Sie sich in Ihrem Shopware Konto an.
3. Gehen Sie zu Merchant > Shops > Third Party support.
4. Klicken Sie auf Request Third Party Support.
5. Wählen Sie Ihre Shop-Domain aus.
6. Wählen Sie die Erweiterung Import/Export aus.

Tipp

Geben Sie beim Erstellen des Tickets den Profilnamen, die Entität, den Dateityp und eine kurze Beschreibung des Problems an. So kann der Support den Fall schneller einordnen.