Hoe te migreren van de Shopware 6-plugin naar de Shopware 6-app

We hebben onze eigen Shopware 6-app ontwikkeld, die de Shopware 6-plugin van Response GmbH zal vervangen. Deze plugin wordt niet langer actief onderhouden en geüpdatet, daarom vragen we je de app te installeren en je bestaande projecten te migreren.

Opmerking: Dit artikel gaat over het migreren van je producten van de Shopware 6-plugin naar de Shopware 6-app. Als je een nieuwe Shopware-appkoppeling wilt instellen, zie dan het artikel over deze pagina. Als je Shopware 5 hebt, volg dan in plaats daarvan de stappen van het artikel op deze pagina in plaats daarvan.

Tip: Neem contact op met ons supportteam om een kopie van je project(en) te laten maken en de volgende stappen in het gekopieerde project uit te voeren. Zo kun je het originele project vergelijken met de kopie om zeker te weten dat alle velden correct zijn gemapt.

Installeer de app

Zie deze handleiding voor instructies over hoe je de Channable-app voor Shopware 6 downloadt en installeert.

Migreer je bestaande projecten

Als je je producten met de app in plaats van de plugin importeert, kun je kleine verschillen verwachten in sommige velden (zie "Welke verschillen kun je verwachten" hieronder). Deze verschillen hebben mogelijk geen effect op je projecten; in dat geval kun je je koppelingen wijzigen via de stappen onder "Importkoppeling wijzigen" en "Orderkoppeling wijzigen". Als de verschillen wel invloed kunnen hebben op je projecten, raden we aan extra stappen te volgen die aan het einde van het artikel worden getoond om problemen te voorkomen.

Opmerking: Voor de plugin had elke combinatie van verkoopkanaal en taal een eigen koppeling. Voor de app maak je één koppeling per verkoopkanaal, waardoor je dezelfde koppeling voor meerdere talen kunt hergebruiken.

Importkoppeling wijzigen

1

Wijzig de importkoppeling — selecteer de nieuwe app-koppeling

• Ga naar "Setup > Setup Import".

• Zoek je Shopware 6-import en klik op "Settings".

• Klik op "Change import".

• Selecteer de nieuwe app-koppeling in de importopties.

• Zorg dat je de juiste taal kiest in de dropdown (dezelfde als je eerder voor deze import gebruikte) en klik op "Save".

• Je wordt nu doorgestuurd naar de importmapping. Klik op "Save & import".

2

Controleer en werk de mapping bij

Veldnamen kunnen verschillen, dus zorg voordat je verdergaat dat je nieuwe importvelden correct zijn gemapt naar je bestaande projectvelden. Volg deze stappen:

• Ga naar "Setup > Edit mapping" van je nieuwe koppeling.

• Zorg dat alle velden correct zijn gemapt door de nieuwe mapping te vergelijken met de mapping in het originele project. Velden die niet meer in de import zitten, kun je veilig verwijderen.

• Als je klaar bent, klik op "Save & import".

Orderkoppeling wijzigen

We kunnen de platformkoppeling in een orderkoppeling niet aanpassen, dus je moet de oude orderkoppeling voor de plugin deactiveren en een nieuwe voor de app aanmaken.

1

Deactiveer de oude orderkoppeling(en)

• Ga naar "Setup > Setup orders".

• Voor elke actieve orderkoppeling die de Shopware 6-plugin gebruikt, klik op "Settings".

• Klik op "Deactivate order connection" en klik daarna op "Save".

• Zorg dat je dit voor alle actieve orderkoppelingen doet!

2

Maak nieuwe orderkoppeling(en) voor de app

• Voeg nieuwe orderkoppelingen toe met de knop "Setup orders".

• Bij de Platform-koppeling zorg je dat je de nieuwe Shopware-appkoppeling selecteert. Voor alle andere instellingen kies je gewoon wat je in de oude, zojuist gedeactiveerde orderkoppeling had.

• Zorg dat je de orderkoppeling activeert en klik op "Save".

Welke verschillen kun je verwachten?

• Als een veldnaam een speciaal teken bevat, kunnen je veldnamen iets veranderen. Bijvoorbeeld, als je een veld hebt genaamd properties_grösse, zou de plugin-importer dit importeren als properties_groesse maar de nieuwe app-importer importeert dit veld als properties_grosse. Je kunt dit oplossen in de importermapping. Bijvoorbeeld:

1

Voorbeeld: mapping van veldnamen met speciale tekens

• Het veld properties_groesse werd geïmporteerd via de plugin en gemapt naar het projectveld properties_groesse

• De app importeert dit veld nu als properties_grosse. Door het te mappen naar properties_groessezorg je dat veldnamen niet veranderen.

• Het oude properties_groesse veld van de plugin kan dan veilig worden verwijderd.

• De plugin rondde sommige prijzen niet af. De nieuwe app-importer zal alle prijzen afronden op twee decimalen.

• Als je een custom field hebt met een True/False waarde, importeren wij deze als 1 (voor True) en 0 (voor False). Indien nodig kun je deze met een (master)regel weer terugtransformeren naar True/False door gebruik te maken van een (master)regel.

• De plugin liet je een aangepast verkoopkanaaldomein instellen in de plugininstellingen. Dit domein werd gebruikt om de link en shopware_url velden voor elk product op te bouwen. De app heeft deze optie niet en gebruikt het verkoopkanaaldomein uit de verkoopkanaalinstellingen:

• Als price_net in je backend 0 is, zal het ook 0 zijn in Channable. De plugin zou dit zelf berekenen, maar de app doet dit niet meer. Je kunt dit oplossen door ervoor te zorgen dat price_net altijd een waarde heeft in je backend, of door de price_net te berekenen met een regel, gebruikmakend van de price_net price_gross en de tax_rate Als je custom fields hebt van het type.

• Media field , halen we niet langer automatisch de URL van het media-item op. Dit zou extra belasting voor je server betekenen omdat we één extra verzoek per product doen, dus we willen dit alleen doen wanneer het nodig is. Als je merkt dat sommige custom fields in Channable een ID bevatten waar je een URL verwacht, kun jecontact opnemen om de functie te activeren die de URL's ophaalt. Neem contact met ons op

Opmerking: dit werkt alleen voor media field-types!