Auguria_PCM

Auguria_PCM
Product & Combination Manager
Guide utilisateurs
v1.5
Auguria
9, rue Alfred Kastler
44300 NANTES
FRANCE
+33251135012
[email protected]
Plan
1 Description générale du module.........................................................................................................3
2 Mise en place du module....................................................................................................................3
2.1 Compatibilité Prestashop.............................................................................................................3
2.2 Obtention du module....................................................................................................................3
2.3 Installation....................................................................................................................................3
2.3.1 Pré-requis.............................................................................................................................3
2.3.2 Méthode d'installation...........................................................................................................3
2.3.2.1 Déploiement du module................................................................................................3
2.3.2.2 Installation.....................................................................................................................3
3 Configuration du module.....................................................................................................................3
4 Utilisation.............................................................................................................................................4
4.1 Imports.........................................................................................................................................4
4.2 Exports.........................................................................................................................................4
4.3 Archivage et astuces....................................................................................................................5
5 Fonctionnement détaillé du module....................................................................................................6
5.1 Import des déclinaisons et attributs.............................................................................................6
5.2 Exports des déclinaisons/attributs ou des produits.....................................................................7
6 Solutions aux problèmes...................................................................................................................10
2/11
1 Description générale du module
Le module de gestion des produits/déclinaisons développé par Auguria permet d'importer des
combinaisons ou d'exporter les produits et combinaisons de votre boutique via fichier csv afin de
permettre une gestion massive des déclinaisons et des produits.
C'est un outil simple et efficace, particulièrement pour automatiser la génération de
déclinaisons, et mettre à jour vos données massivement depuis un simple fichier csv avant de les
réimportées sous ce même format.
2 Mise en place du module
2.1
Compatibilité Prestashop
Ce module est compatible avec les versions 1.4.5 à 1.4.8.2 de Prestashop.
2.2
Obtention du module
Pour obtenir une version du module, vous pouvez :
✗
Nous contacter à l'adresse suivante : [email protected]
✗
L'acheter sur http://addons.prestashop.com/fr/
2.3
Installation
2.3.1
Pré-requis
Aucun pré-requis particulier en dehors d'une version de Prestashop compatible (voir 2.1).
2.3.2
Méthode d'installation
2.3.2.1
Déploiement du module
Dans l'onglet Modules de votre back-office, cliquez sur le lien d'ajout de modules et chargez le
fichier compressé depuis votre machine ou depuis le site de téléchargement du module. Vous
pourrez ensuite installer celui-ci.
2.3.2.2
Installation
Dans votre back-office, allez dans « Modules → Autres modules ». Dans ce menu apparaîtra
une ligne dédiée au module de gestion des produits/déclinaisons :
Cliquez sur « Installer » pour mettre en place le module.
3 Configuration du module
Ce module ne dispose d'aucune d'option d'administration et ne requiert aucune configuration.
3/11
4 Utilisation
Ce module ajoute l'utilitaire de gestion des produits/déclinaisons au back-office Prestashop.
Vous le trouverez dans la partie outils → import des attributs de ce dernier.
4.1
Imports
Ce module ne génère ni groupes d'attributs, ni produits. Vous devez par conséquent créer ces
différents éléments par le biais des procédures standards de Prestashop. Le module génèrera
automatiquement les attributs en fonction du groupe défini dans votre fichier .csv et des valeurs que
vous lui avez affecté.
Ici, les groupes d'attributs (créés précédemment
selon les
procédures standards de Prestashop) sont le Coloris et la Taille. Les
valeurs affectées au déclinaisons qui vont être créées en tant
qu'attributs lors de l'import sont respectivement C01 NOIR et C03
ROUGE pour le Coloris; 53/18/14 , 53/18/15 et 52/18/135 pour la
Taille. Les attributs identiques ne seront créés qu'une et une seule fois.
Vous devrez donc dans un premier temps créer un fichier .csv ou modifier le fichier
example.csv que vous trouverez dans le dossier imports du module. La description de la structure à
adopter et les champs possibles sont indiqués sur la page principale de l'utilitaire d'import.
Chaque colonne du fichier correspond à un champ requis ou optionnelle que vous devez ou
souhaitez renseigner, chaque ligne (au-delà de la première) correspond à une déclinaisons dotées
d'un jeu d'attributs spécifiés dans la colonne destinée à cet effet et de valeurs propres.
Une fois votre fichier .csv renseigné, vous pouvez l'uploader grâce au champ prévu à cet effet
et valider pour importer les déclinaisons et les attributs associées.
Une fois l'import terminé, le module vous indiquera les noms des produits dont des
déclinaisons ont été modifiées ou ajoutées, et le cas échéant les références des déclinaisons en cas
de modifications.
Exemple d'import à partir du fichier example.csv
Ci-contre : la table de déclinaisons
d'un produit dont ont a affecté
l'identifiant à chaque ligne du fichier
example.csv fourni dans le dossier
'import' du module (dans la colonne
'id_product').
Cet exemple peut vous servir à
titre comparatif avec le support du
fichier example.csv afin de mieux
appréhender la nature des données à
introduire dans ce dernier.
4.2
Exports
Vous pouvez exporter vos données de déclinaisons/attributs ou de produits depuis ce module.
Sélectionnez le type d'export que vous souhaitez effectuer grâce au menu déroulant « Entités à
exporter », puis cliquez sur « Exporter ».
4/11
Une fois le fichier .csv généré, une fenêtre popup s'ouvrira pour vous proposer celui-ci en
téléchargement ;
vous
pourrez
également
récupérer vos exports dans le dossier d'export du
module (accessible par client FTP si vous utilisé un
hébergement distant). Le nom du fichier
correspond à son type (products ou combinations)
préfixé par la date de sa génération.
Si vous exportez vos déclinaisons, vous pouvez réimporter le fichier produit tel quel, sans
aucune modification, grâce à ce même module.
Si vous exportez vos produits, vous pouvez réimporter le fichier produit grâce à l'utilitaire
d'import standard de Prestashop. Notez cependant qu'il sera alors conseillé d'installer le module de
gestion des produits/déclinaisons sur la boutique où vous effectuerez cet import, celui ci ajoutant une
configuration prédéfinie permettant d'utiliser l'import standard des produits sans avoir à définir sa
configuration détaillée (cf 5.2 Exports des déclinaisons/attributs ou des produits pour plus de
détails).
Il est également possible de modifier les données des entités exportées grâce à un utilitaire
d'édition de texte ou, plus pratique, de feuille de calcul, tel que les tableur OpenOffice ou LibreOffice,
à privilégier à un Excel connaissant des difficultés avec les formats de type .csv. Vous pouvez ainsi
vérifier et modifier rapidement votre catalogue à l'aide d'un simple tableur.
Notes :
• Depuis la version 1.3 du module, il est possible de préciser la langue d'import/export parmi les
langues installées sur votre site. Vous ne pouvez importer/exporter les données que pour une
langue à la fois.
• Depuis cette même version, les valeurs des champs à valeurs multiples sont séparées par
défaut par des barres verticales (« | ») à la place des virgules (« , ») afin de permettre l'usage
de nombres à virgules comme valeurs de ces champs. Il est conseillé d'utiliser le séparateur
par défaut, cependant, si vous avez effectué des exports dans les version précédentes du
modules, vous pouvez les importez telles quelles en cochant l'option « Utiliser la virgule
comme séparateur de valeurs ».
4.3
Archivage et astuces
Le dossier imports compris dans le répertoire du module conserve l'historique de tous les
fichiers .csv importés (toutes les archives sont renommées selon le format suivant :
dateHeureProducts_attributes.csv – YYYYMMJJ(date)hhmmss(heure).
Si vous avez importé des déclinaison par erreur en renseignant une chaine de caractère plutôt
qu'un id, n'hésitez pas à récupérer cette chaine pour effectuer une recherche dans votre catalogue à
partir de celle-ci afin de les supprimer plus rapidement.
5/11
5 Fonctionnement détaillé du module
Cette partie est consacrée au fonctionnement détaillé du module, afin de vous permettre
d'exploiter au mieux les possibilités de celui-ci.
5.1
Import des déclinaisons et attributs
L'import des déclinaisons et attributs se déroule en deux temps.
Dans un premier temps, la procédure établit les informations définies dans le fichier .csv afin
de déterminer si le format de données de celui-ci est correct et satisfait aux pré-requis de l'opération.
Il s'agit en fait d'une lecture de la première ligne, afin de déterminer les attributs des déclinaisons que
vous souhaitez générer.
Dans un second, la procédure récupérera les données ligne à ligne, et procédera aux
différents traitements requis afin de générer la déclinaison voulue. Certaines de ces information
peuvent prendre de multiples syntaxes pour obtenir de tout autant d'effets différents, que nous
détaillons ci-après.
Détail des colonnes (les information requises sont indiquées, les autres sont facultatives):
✗
id_product (requis): Identifiant numérique ou référence d'un produit. Notez que la
sélection par référence ajoutera la déclinaison à tous les produits comprenant la
chaine de caractère renseignée.
✗
images : Noms d'images que vous souhaitez ajouter à la déclinaison à générer. Ces
images doivent se trouver, depuis la racine de votre application Prestashop, dans un
dossier download/import/. Attention, si vous entrez plusieurs images pour une même
déclinaison, elles seront toutes sélectionnées, la première sera donc sélectionnée par
défaut.
✗
attributes (requis) : Liste des attributs propres de cette déclinaison. Les différents
attributs sont définis par leurs groupes (devant être préalablement créer) et leur nom ou
valeur (les attributs n'existant pas seront créer), et doivent être séparés par des barres
verticales. La syntaxe à respecter est donc de la forme :
▪ {groupe d'attributs} : {attribut} [ |{groupe d'attributs} : {attribut}][|etc...]
◦ ou un attribut peut-être :
▪ un nom pour désigner l'attribut (ci-dessus : '53/15/15', 'C01 NOIR', etc...)
◦ OU, si son groupe d'attributs est un groupe de couleurs
▪ l'url d'une image à utiliser comme texture (doit alors mesurer 20px*20px)
6/11
▪ une couleur en notation hexadécimal html à six chiffres (Prestashop ne
supportant pas les couleurs hexadécimal à trois chiffres au moment de la
rédaction de cette documentation ; par exemple '#a1b2c3', ou '#FFFFFF')
✗
quantity : Quantité d'éléments de cette déclinaison en stock.
✗
reference : Référence de cette déclinaison de produit.
✗
default (requis) : Pour indiquer la déclinaison à utiliser par défaut pour les commande
de ce produit (1 pour définir comme déclinaison par défaut, 0 dans l'autre cas).
✗
palette : Indiquer ici un groupe d'attributs à utiliser comme palette de couleurs.
✗
supplier_reference : Référence du fournisseur.
✗
location : Emplacement.
✗
ean13 : Code-barres de la déclinaison
✗
wholesale_price : Prix d'achat pour cette déclinaison
✗
price : Impact sur le prix (en augmentation)
✗
weight : Impact sur le poids (en augmentation)
Le module d'import gère également la reconnaissance des déclinaisons existantes. Si les
attributs de deux déclinaisons pour un même produit sont identique, la procédure d'import
considèrera comme étant une seule et même déclinaison, elle mettra donc à jour l'existante plutôt
que d'en créer une nouvelle.
Dans ce cas, vous recevrez un message sur la page de synchronisation vous indiquant les
références des déclinaisons modifiées, en plus du message de confirmation habituel vous indiquant
les produit auxquels la procédure a ajouté ou mis à jour des déclinaisons.
5.2
Exports des déclinaisons/attributs ou des produits
L'export suit deux procédures distinctes selon le type choisi.
L'export des déclinaisons récupère simplement les données correspondantes et les enregistre
dans un format identique à celui de l'import, mais sans les images. Le fichier généré est importable
par le module de gestion des produits/déclinaisons sur n'importe quelle boutique Prestashop (tous
les pré-requis de l'import doivent bien entendu être satisfait au préalable : les groupes d'attributs
doivent exister et les produits déclinés également).
L'export des produits récupère l'intégralité des données de vos produits et génère un fichier
.csv destiné à être importé grâce au module d'import standard de Prestashop, accessible depuis
le menu outil → import de votre back-office.
Pour effectuer rapidement l'import de
vos produits :
•
•
assurez-vous d'avoir installer le
module
de
gestion
des
produits/déclinaisons sur le site
où vous souhaitez réaliser l'import
Cliquez sur parcourir, puis sélectionnez le fichier généré par l 'export
7/11
•
Chargez le fichier
S'il était caché, vous devriez voir apparaître le menu suivant. Assurez-vous alors :
•
que le type d'entité sélectionné
correspond bien au produit
•
que
le
fichier
sélectionné
correspond bien au fichier exporté
•
que le séparateur de champs est
bien « ; »
•
que le séparateur de champs à
valeurs multiples est bien « | » ou
« , » selon l'option choisie à l'export
•
que la case Supprimer les produits
n'est pas cochée
Puis cliquez sur « Etape suivante » pour arriver à l'écran suivant :
Si vous avez bien installé le module de gestion des produits/déclinaisons comme conseillé
précédemment, vous pourrez chargez la configuration « AuguriaExportedCsv », puis cliquer sur
importer les données pour importé ou mettre à jour les produits.
Dans le cas contraire, vous pouvez définir vous même votre propre configuration. Le fichier
généré par l'export est en effet doté d'une ligne d'en-tête indiquant le type de données contenues
dans chaque colonne – ces titres correspondent aux différents attributs gérés par l'import standard.
Pensez en ce cas à sauter la première ligne (en haut à gauche, indiquez « 1 »), afin d'ignorer la ligne
de titre lors de l'import.
Il est possible de cette manière, par exemple, de forcer l'import plutôt que la mise à jour (en
sélectionnant « ignorer cette colonne » dans le menu déroulant de la colonne « identifiant », ou
encore de rajouter des colonnes avec des données non-supportées par l'export (images, etc...).
8/11
Note à propos des images :
Il n'est pas possible d'exporter les images grâce au module de gestion des
produits/déclinaisons. En effet, les produit ne comprennent pas les images qui les représentent, mais
les url de ces dernière. Exporter les url dans le fichier .csv ne permettrait pas pour autant de les
importer ensuite, excepté dans le cas trivial ou l'on importerait les produits dans une boutique... où ils
sont déjà.
De même pour les déclinaisons. Par conséquent, l'export ne gère pas les images des produits
et des déclinaisons.
9/11
6 Solutions aux problèmes
10/11
Problème
Solution
Après l'import, le module affiche un encart
d'erreur indiquant qu'aucune déclinaison n'a
été importée.
Assurez-vous que les id de votre fichier .csv
correspondent bel et bien à ceux de produits
de votre site. Si vous avez entré une chaine de
caractère plutôt qu'un id, vérifiez qu'au moins
un produit nommé ainsi existe et/ou que la
casse est la bonne. En effet, certains serveurs
MySQL peuvent ignorer cette dernière et
d'autres non, tout dépendant de la
configuration de l'hébergeur.
Des déclinaisons ont été accidentellement
ajoutés à des produits (la chaine de caractère
renseignée dans le champ id_product du fichier
.csv était présente dans les noms de plusieurs
produits imprévus)
Le module vous affiche les produits modifiés
après l'import afin de pouvoir les retrouver.
Vous pouvez également jeter un œil au dossier
imports contenu dans le dossier du module. Il
contient tous les imports précédemment
réalisés (cf 4.1 Archivage et astuce ).
J'obtiens systématiquement un message
d'erreur indiquant que le fichier n'est pas au
format .csv.
Essayez d'ouvrir votre fichier .csv avec un
éditeur de feuille de calcul Open Office ou
LibreOffice et demandez à 'conserver le
format'; à plus forte raison si vous avez utilisé
des utilitaires Microsoft pour éditer ce dernier.
En effet, ceux-ci ont tendances à altérer les
caractères spéciaux tels que les virgules et les
points-virgules, qui sont des caractères
structurels des fichiers .csv.
11/11