Page History

Paramètres d'import CSV

Les fonctions d'import CSV vous permettent de rapidement remplir votre catalogue de produits quand vous disposez d'une grande quantité d'entrées à intégrer, ou d'importer les données que vous avez exportées et converties depuis un autre outil e-commerce, sous forme de fichiers CSV.

Le processus d'import CSV demande de la préparation, et commence avec un formulaire fait des premiers réglages :

• Votre fichier CSV. Vous pouvez importer plus d'un fichier à la fois, mais assurez-vous d'abord d'avoir le bon type de données.
  Vous trouverez un lien "Cliquez ici pour voir nos exemples de fichiers CSV pour l'import". Cliquez-le pour afficher plus de liens : vous pouvez télécharger des fichiers d'exemple pour chaque type de données, ce qui vous aide à vérifier que les fichiers que vous importez sont bien prêts à être importés par PrestaShop. Dans les faits, ces fichiers se trouvent dans le dossier /docs/csv_import de votre installation de PrestaShop.
• Quel type d'entités souhaitez-vous importer ?. Les entités sont les types de données que vous pouvez importer. PrestaShop vous permet d'importer ces types de données:
  • Catégories ;
  • Produits ;
  • Déclinaisons (qui étaient appelées "versions" dans les versions précédentes de PrestaShop) ;
  • Clients ;
  • Adresses ;
  • Fabricants ;
  • Fournisseurs ;
  • Alias ;
  • Commandes aux fournisseurs (si la gestion des stocks avancées est activée) ;
  • Détails de commandes aux fournisseurs (si la gestion des stocks avancées est activée).

• Sélectionnez votre fichier .csv. Vous pouvez importer plus d'un fichier à la fois, mais assurez qu'ils contiennent tous le même type de données.

  Tip

  Vous trouvez des fichiers d'exemples dans la section "Téléchargez des fichiers .csv d'exemple" à droite. Ils peuvent vous aider à comparer vos fichiers avec ceux recommandés par PrestaShop, et donc à vérifier que les fichiers que vous importez sont bien prêts à être importés par PrestaShop. Dans les faits, ces fichiers se trouvent dans le dossier /docs/csv_import de votre installation de PrestaShop.

• Langue du fichier. Les données ne peuvent être importées que pour un fichier à la fois. Si vos données existent dans plus d'une langue, vous devriez les découper en autant de fichiers.
• Fichier encodé en ISO-8859-1 ?. Par défaut, les fichiers d'import devraient être encodés en UTF-8. Mais si vos fichiers utilisent l'encodage ISO-8859-1 et que vous préféreriez ne pas les convertir, cochez cette case.
• Séparateur de champs. Tous les fichiers CSV n'utilisent pas la virgule comme séparateur de données : certains utilisent des tabulations, d'autres des points-virgules, etc. Vous pouvez indiquer ce qu'utilisent vos fichiers dans ce champ.
• Séparateur de champs à valeurs multiples. Quand un attribut peut contenir plus d'une valeur, ces valeurs doivent être séparées par un séparateur spécifique. Après avoir vérifié la manière dont sont conçus vos fichiers, indiquez le bon séparateur dans ce champ.
• Supprimer toutes les catégories ___ avant l'import ?. Cette option effacera toutes les entrées actuelles du type de données que vous importez. Cela vous aide à partir de zéro.
• Forcer tous les identifiants lors de l'importation ?. Uniquement pour l'import produit. Vous pouvez choisir de laisser PrestaShop déterminer l'identifiant d'un produit, ou utiliser sa référence comme identifiant. Dans ce cas, vérifiez bien que le fichier contient effectivement des références pour tous les produits importés.
• Utiliser la référence du produit comme clé ?. Uniquement pour l'import de produits. Vous pouvez choisir de laisser PrestaShop déterminer la clé du produit, ou d'utiliser la référence du produit comme ID. Dans ce cas, assurez que le fichier contient bien une référence pour tous les produits importés.
• Pas de régénération des miniatures. Import de catégories et de produits uniquement. Vous pouvez choisir de laisser PrestaShop regénérer les miniatures qui sont liées depuis votre fichier CSV (dans les champs "Image URL" ou "Image URLs").
• Forcer les identifiants. Vous pouvez soit utiliser les identifiants importés, ou laisser l'importateur faire l'auto-incrémentation.

Lorsque vous changez d'entité, la section à droite, intitulée "Champs disponibles", affiche les champs attendus. Bien que l'outil d'import soit conçu pour vous aider à faire correspondre les champs de vos fichiers à ceux de PrestaShop, vous devriez vous efforcer de rendre vos données aussi simples à importer que possible, notamment en suivant le format de nommage et l'ordre des champs présentés. Sans cela, l'importation sera laborieuse, mais pas impossible.
Certains de ces champs ont une petite icône d'information affichant une fenêtre pop-up au survol de la souris. Ils se rapportent pour la plupart au mode multiboutique de PrestaShop, ou à la gestion des stocks avancées. Lisez-les bien tous avant de construire ou modifier vos fichiers de données.

Data format

Les données importées doivent l'être sous la forme d'un fichier texte, utilisant un format de données de type CSV (Comma-Separated Values), pour "valeurs séparées par des virgules", et l'extension de fichier liée .csv. Nous vous recommandons d'avoir recours au point-virgule ";" comme séparateur de champ. Si vos données textuelles (descriptions de produit et autres) contiennent des signes point-virgule, vous devriez soit les enlever, soit utiliser un autre caractère pour la séparation des champs.

Vous pouvez créer un tel fichier avec n'importe quel éditeur de texte (nous vous recommandons Notepad++ : http://notepad-plus-plus.org/), mais il est préférable d'utiliser un tableur, puis d'enregistrer votre travail au format CSV. En comparaison avec un éditeur de texte, un tableur vous permet de travailler plus rapidement et de manière visuelle. Vous pouvez utiliser le logiciel payant Microsoft Excel (http://office.microsoft.com/fr-fr/excel/) ou le logiciel gratuit OpenOffice.org Calc (http://www.openoffice.org/fr/).

...

• La colonne de prix utilise la devise par défaut de votre boutique ;
• Les catégories sont indiquées à l'aide de leur identifiant existant (il vous faut donc les importer en premier), et séparées par des virgules ;
• L'adresse Web des images doit être spécifiée en totalitéun lien absolu. En d'autres termes, vous devez utiliser l'adresse que le navigateur doit appeler pour afficher l'image ; par exemple, http://www.monprestashop/images/produitXXX.gif ;
• Préférez l'encodage de données UTF-8. Sinon, ou au pire utilisez ISO-8859-1 et validez l'option "Fichier encodé en ISO-8859-1".
• Les dates utilisent le format ISO 8601, sans l'indicateur de fuseau horaire (le fuseau horaire étant celui de votre boutique) : 2013-06-21 15:07:27.

Mise en ligne du fichier

Une fois que toutes vos données sont au format CSV, vous pouvez les envoyer dans la base de données de votre boutique à l'aide du formulaire de cette page. Chargez le(s) fichier(s) depuis votre ordinateur en cliquant

Vous avez deux manières d'ajouter des fichiers à importer :

• À l'aide de voter navigateur : cliquez sur le bouton "

...

• Ajouter un fichier",

...

• trouvez votre fichier puis validez. Répétez ce processus autant de fois que nécessaire pour lister tous vos fichiers d'import.
• À l'aide de votre client FTP : mettez le fichier en ligne dans le dossier /admin-dev/import de votre installation de PrestaShop. Rechargez la page d'import : le bouton "Sélectionnez un fichier dans l'historique" devrait maintenant afficher un nombre. Cliquez le bouton pour afficher la liste de fichiers disponibles (y compris ceux qui vous avez déjà mis en ligne à l'aide de votre navigateur), puis cliquez sur le bouton "Utiliser" pour le fichier que vous souhaitez importer

Une fois tous vos fichiers listés dans la section "Votre fichier CSV", vous pouvez continuer à remplir le formulaire :

...

En cliquant sur le bouton "Étape suivante", la page se recharge avec l'outil de correspondance des données. Cette interface vous aide à faire correspondre les colonnes de données de votre fichier avec celles dont PrestaShop a besoin.

...

• Première colonne. Nous l'avions marquée comme "Enabled", PrestaShop utilise l'en-tête "ID". Cliquez sur le menu déroulant de l'en-tête, et sélectionnez "Actif (0/1)".
• Deuxième colonne. Marquée "Name", mais l'en-tête utilise "Actif (0/1)". Changeons cela pour "Nom".
• Troisième colonne. Et ainsi de suite...

L'écran ne peut contenir toutes vos plus de c colonnes de données, aussi il vous faut cliquer sur les boutons ">>>" et "<<<" pour vous déplacer dans les colonnes, et toutes les faire correspondre au bon aux bons en-têtetêtes.

Dans notre exemple, nous avons utilisé la première ligne pour servir d'indicateurs de noms de colonne. Étant donné que nous ne voulons importer cette ligne, saisissez "1" dans le champ "Sauter X lignes".

Une fois que toutes vos colonnes auront trouvé correspondance, cliquez sur le bouton "Importer les données" (en haut à droite de l'écran), et PrestaShop lancera le processus d'import. Quand ce processus est terminé, vous êtes renvoyé à l'écran principal, qui en fonction du résultat, soit vous confirmera que tout a bien été importé, soit vous notifiera des problèmes rencontrés. Dans le second cas, vous devrez relire vos fichiers CSV et faire en sorte de tout corriger.

Configurations des correspondances

Le processus de configuration peut être une tâche laborieuse si vous ne pouvez pas choisir l'ordre des colonnes de votre fichier CSV en concordance avec celui utilisé par l'outil d'import de PrestaShop. C'est pourquoi PrestaShop comprend un petit outil permettant d'enregistrer l'ordre de correspondance que vous avez mis en place avec tous les menus sélecteurs déroulants des en-têtes de colonnes.

L'outil est un simple champ en haut de l'outil de correspondance. Vous avez trois fonctions de base base (une seule si vous n'avez pas encore enregistré de configuration de correspondances) :

• Sauvegarder. Saisissez un nom descriptif dans le champ, et cliquez sur "Sauvegarder". L'interface se met à jour pour afficher les configurations enregistrées dans sa liste déroulante.
• Charger. Choisissez une configuration de correspondances dans le menu déroulant, et cliquez sur "Charger".
• Supprimer*. Choisissez une configuration de correspondances dans le menu déroulant, et cliquez sur "Supprimer".