Comment migrer du plugin Shopware 6 vers l'application Shopware 6

Nous avons développé notre propre application Shopware 6, qui remplacera le plugin Shopware 6 développé par Response GmbH. Ce plugin ne sera plus maintenu ni mis à jour activement ; nous vous demandons donc d’installer l’application à la place et de migrer vos projets existants.

Remarque : Cet article traite de la migration de vos produits depuis le plugin Shopware 6 vers l’application Shopware 6. Si vous essayez de configurer une nouvelle connexion d’application Shopware, veuillez consulter l’article sur cette page. Si vous utilisez Shopware 5, suivez les étapes de l’article sur cette page à la place.

Astuce : Contactez notre équipe de support pour créer une copie de votre(vos) projet(s) et effectuer les étapes suivantes dans un projet copié. Ainsi, vous pourrez comparer le projet original avec la copie pour vous assurer que tous les champs sont correctement mappés.

Installer l’application

Veuillez vous référer à ce guide pour les instructions sur le téléchargement et l’installation de l’application Channable pour Shopware 6.

Migrer vos projets existants

Si vous importez vos produits avec l’application au lieu du plugin, vous pouvez constater de légères différences sur certains champs (voir « Quelles différences pouvez-vous attendre » ci-dessous). Ces différences peuvent ne pas affecter vos projets ; dans ce cas, vous pouvez changer vos connexions via les étapes décrites sous « Changer la connexion d’import » et « Changer la connexion de commande ». Si les différences peuvent potentiellement affecter vos projets, nous vous conseillons d’effectuer des étapes supplémentaires présentées à la fin de l’article, afin d’éviter tout problème.

Remarque : Pour le plugin, chaque combinaison canal de vente/langue disposait de sa propre connexion. Pour l’application, vous créerez simplement une connexion par canal de vente, ce qui vous permet de réutiliser la même connexion pour plusieurs langues.

Changer la connexion d’import

1

Changer la connexion d’import — sélectionner la nouvelle connexion d’application

• Allez dans « Installation > Installez votre import ».

• Trouvez votre import Shopware 6, puis cliquez sur « Paramètres ».

• Cliquez sur « Changer l’import ».

• Sélectionnez la nouvelle connexion d’application dans les options d’import.

• Assurez-vous de sélectionner la bonne langue dans le menu déroulant (la même que celle que vous utilisiez précédemment pour cet import) puis cliquez sur « Sauvegarder ».

• Vous êtes maintenant redirigé vers le mapping d’import. Cliquez sur « Sauvegarder & Importer ».

2

Vérifier et mettre à jour le mapping

Les noms de champs peuvent être différents : avant de continuer, assurez-vous que vos nouveaux champs d’import sont correctement mappés aux champs existants du projet. Suivez ces étapes :

• Allez dans « Installation > Modifier mapping » de votre nouvelle connexion.

• Vérifiez que tous les champs sont correctement mappés en comparant le nouveau mapping avec celui du projet original. Les champs qui ne figurent plus dans l’import peuvent être supprimés en toute sécurité.

• Lorsque vous avez terminé, cliquez sur « Sauvegarder & Importer ».

Changer la connexion de commande

Nous ne pouvons pas changer la connexion de plateforme dans une connexion de commande ; vous devez donc désactiver l’ancienne connexion de commande du plugin et en créer une nouvelle pour l’application.

1

Désactiver l’ancienne connexion de commande

• Allez dans « Installation > Configurer commandes ».

• Pour chaque connexion de commande active utilisant le plugin Shopware 6, cliquez sur « Paramètres ».

• Cliquez sur « Désactiver la connexion de commande » puis cliquez sur « Sauvegarder ».

• Assurez-vous de faire cela pour toutes les connexions de commande actives !

2

Créer de nouvelles connexions de commande pour l’application

• Ajoutez de nouvelles connexions de commande en utilisant le bouton « Configurer commandes ».

• Pour la connexion Plateforme, veillez à sélectionner la nouvelle connexion d’application Shopware. Pour tous les autres paramètres, choisissez simplement ce que vous aviez dans l’ancienne connexion de commande que vous venez de désactiver.

• Veillez à activer la connexion de commande et cliquez sur « Sauvegarder ».

Quelles différences pouvez-vous attendre ?

• Si un nom de champ contient un caractère spécial, vos noms de champs peuvent légèrement changer. Par exemple, si vous avez un champ nommé properties_grösse, l’importeur du plugin l’importait sous la forme properties_groesse mais le nouvel importeur de l’application importe ce champ sous la forme properties_grosse. Vous pouvez corriger cela dans le mapping de l’importeur. Par exemple :

1

Exemple : mapping des noms de champs avec caractères spéciaux

• Le champ properties_groesse a été importé via le plugin, et mappé sur le champ du projet properties_groesse

• L’application importe désormais ce champ sous la forme properties_grosse. En le mappant sur properties_groesse, vous vous assurez qu’aucun nom de champ n’est modifié.

• L’ancien properties_groesse champ du plugin peut alors être supprimé en toute sécurité.

• Le plugin n’arrondissait pas certains prix. Le nouvel importeur de l’application arrondira tous les prix à deux décimales.

• Si vous avez un champ personnalisé avec une valeur True/False , nous importerons ces valeurs comme 1 (pour True) et 0 (pour False). Si nécessaire, vous pouvez les transformer de nouveau en True/False en utilisant une (master)règle.

• Le plugin vous permettait de définir un domaine personnalisé pour le canal de vente dans les paramètres du plugin. Ce domaine était utilisé pour construire les champs link et shopware_url pour chaque produit. L’application n’a pas cette option ; elle utilisera le domaine du canal de vente défini dans les paramètres du canal de vente :

• Si price_net est 0 dans votre back-end, il sera également 0 dans Channable. Le plugin le calculait lui-même, mais l’application ne le fait plus. Vous pouvez corriger cela soit en vous assurant que price_net a toujours une valeur dans votre back-end, soit en calculant le price_net à l’aide d’une règle, en utilisant le price_net price_gross et le tax_rate Si vous avez des champs personnalisés de type.

• Media field , nous ne récupérerons plus automatiquement l’URL du média. Cela solliciterait davantage votre serveur car nous effectuerions une requête supplémentaire par produit ; nous ne voulons le faire que si nécessaire. Si vous constatez que certains champs personnalisés contiennent un ID dans Channable alors que vous attendez une URL, vous pouveznous contacter pour activer la fonctionnalité qui récupère les URL à la place. Remarque : cela ne fonctionne que pour les types de champs media !

Note: this only works for media field types!