Ce module vous permet d'exporter votre catalogue au format CSV. Il gére les exportations multiples et la planification par cron.

Ce module fonctionne comme suit: Vous pouvez définir un ou plusieurs modèles d'exportation et autant d'exportations planifiées que vous le souhaitez.

Un modèle d'exportation définit les données à exporter et la manière dont le fichier généré sera structuré.

Le but d'un modèle d'exportation est de générer un fichier CSV. Un fichier CSV est composé d'un certain nombre d'enregistrements (ici les produits), un par ligne, chaque enregistrement est constitué de champs (nommés ici colonnes), séparés par un caractères quelconque, le plus souvent une virgule ou point virgule.

Nom du modèle

Vous pouvez créer autant de modèles d'exportation que vous voulez donc choisir un nom approprié est une bonne idée pour les retrouver facilement.

Structure de fichier

Colonnes

Sélectionnez les données que vous souhaitez exporter. Utilisez le bouton (+) pour ajouter une colonne au-dessous de l'actuelle et le bouton (-) pour supprimer la colonne courante.

Valeur

Chaque colonne a une valeur, celles-ci sont calculées au moment de l'exportation.

Une valeur spéciale "Valeur fixe" est indépendante du produit et peut être ce que vous voulez.

Liste des valeurs exportables :

Titre

Cette colonne n'apparait que si vous avez activé l'option Ajouter la ligne d'en-tête. Indiquez ici les noms des colonnes qui apparaîtront en haut du fichier généré.

Habillage

Cette colonne n'apparait que si vous avez activé l'option Habillage des colonnes. Indiquez ici les textes à insérer avant et après les valeurs calculées.

Nom du fichier

Nom du fichier généré. Il peut être une valeur fixe comme "catalog.csv" ou calculée comme "catalog_%Y-%m-%d.csv".

Les caractères suivants sont reconnus et seront remplacés:

format Description Exemple de valeurs retournées
Jour --- ---
%a Nom abrégé du jour de la semaine De Sun à Sat
%A Nom complet du jour de la semaine De Sunday à Saturday
%d Jour du mois en numérique, sur 2 chiffres (avec le zéro initial) De 01 à 31
%e Jour du mois, avec un espace précédant le premier chiffre. L'implémentation Windows est différente, voyez après pour plus d'informations. De 1 à 31
%j Jour de l'année, sur 3 chiffres avec un zéro initial 001 à 366
%u Représentation ISO-8601 du jour de la semaine De 1 (pour Lundi) à 7 (pour Dimanche)
%w Représentation numérique du jour de la semaine De 0 (pour Dimanche) à 6 (pour Samedi)
Semaine --- ---
%U Numéro de la semaine de l'année donnée, en commençant par le premier Lundi comme première semaine 13 (pour la 13ème semaine pleine de l'année)
%V Numéro de la semaine de l'année, suivant la norme ISO-8601:1988, en commençant comme première semaine, la semaine de l'année contenant au moins 4 jours, et où Lundi est le début de la semaine De 01 à 53 (où 53 compte comme semaine de chevauchement)
%W Une représentation numérique de la semaine de l'année, en commençant par le premier Lundi de la première semaine 46 (pour la 46ème semaine de la semaine commençant par un Lundi)
Mois --- ---
%b Nom du mois, abrégé, suivant la locale De Jan à Dec
%B Nom complet du mois, suivant la locale De January à December
%h Nom du mois abrégé, suivant la locale (alias de %b) De Jan à Dec
%m Mois, sur 2 chiffres De 01 (pour Janvier) à 12 (pour Décembre)
Année --- ---
%C Représentation, sur 2 chiffres, du siècle (année divisée par 100, réduit à un entier) 19 pour le 20ème siècle
%g Représentation, sur 2 chiffres, de l'année, compatible avec les standards ISO-8601:1988 (voyez %V) Exemple : 09 pour la semaine du 6 janvier 2009
%G La version complète à quatre chiffres de %g Exemple : 2008 pour la semaine du 3 janvier 2009
%y L'année, sur 2 chiffres Exemple : 09 pour 2009, 79 pour 1979
%Y L'année, sur 4 chiffres Exemple : 2038
Heure --- ---
%H L'heure, sur 2 chiffres, au format 24 heures De 00 à 23
%k Une représentation de l'heure sur 2 chiffres, au format 24 heures, avec un espace précédant un seul chiffre De 0 à 23
%I Heure, sur 2 chiffres, au format 12 heures De 01 à 12
%l ('L' minuscule) Heure, au format 12 heures, avec un espace précédant un seul chiffre De 1 à 12
%M Minute, sur 2 chiffres De 00 à 59
%p 'AM' ou 'PM', en majuscule, basé sur l'heure fournie Exemple : AM pour 00:31, PM pour 22:23
%P 'am' ou 'pm', en minuscule, basé sur l'heure fournie Exemple : am pour 00:31, pm pour 22:23
%r Identique à "%I:%M:%S %p" Exemple : 09:34:17 PM pour 21:34:17
%R Identique à "%H:%M" Exemple : 00:35 pour 12:35 AM, 16:44 pour 4:44 PM
%S Seconde, sur 2 chiffres De 00 à 59
%T Identique à "%H:%M:%S" Exemple : 21:34:17 pour 09:34:17 PM
%X Représentation de l'heure, basée sur la locale, sans la date Exemple : 03:59:16 ou 15:59:16
%z Le décalage horaire. Non implémenté tel que décrit sous Windows. Voir plus bas pour plus d'informations. Exemple : -0500 pour l'heure US de l'est
%Z L'abréviation du décalage horaire. Non implémenté tel que décrit sous Windows. Voir plus bas pour plus d'informations. Exemple : EST pour l'heure de l'Est
L'heure et la date --- ---
%c Date et heure préférées, basées sur la locale Exemple : Tue Feb 5 00:45:10 2009 pour le 5 Février 2009 à 12:45:10 AM
%D Identique à "%m/%d/%y" Exemple : 02/05/09 pour le 5 Février 2009
%F Identique à "%Y-%m-%d" (utilisé habituellement par les bases de données) Exemple : 2009-02-05 pour le 5 février 2009
%s Timestamp de l'époque Unix (identique à la fonction time()) Exemple : 305815200 pour le 10 Septembre 1979 08:40:00 AM
%x Représentation préférée de la date, basée sur la locale, sans l'heure Exemple : 02/05/09 pour le 5 Février 2009
Divers --- ---
%n Une nouvelle ligne ("\n") ---
%t Une tabulation ("\t") ---
%% Le caractère de pourcentage ("%") ---

Plus d'informations sur php.net: http://www.php.net/strftime

Séparateur CSV

Caractère séparant les colonnes. La plupart du temps , ou ; mais cela peut être n'importe quel caractère comme | ou §.

Si vous voulez utiliser le fichier avec Microsoft Excel, vous devez utiliser ; comme séparateur Plus d'informations sur les tableurs et CSV.

Encodage des caractères

Il définit la façon d'écrire les données dans le fichier. La plupart du temps, UTF-8 est le bon choix (mais pas pour Microsoft Excel, voir ci-dessous).

Plus d'informations: https://fr.wikipedia.org/wiki/Codage_des_caract%C3%A8res

Remarque sur Microsoft Excel: http://dev.webdesigneuse.com/spip/Encodage-et-fichiers-CSV

Ajouter la ligne d'en-tête

Ajoutez une première ligne dans le fichier CSV avec les titres des colonnes définies ci-dessus

Séparateur décimal

Sera utilisé pour les prix. Vous pouvez choisir d'avoir 12,34 ou 12.34 (ou 12@43 si vous voulez).

Nombre de décimales

Sera utilisé pour les prix. Vous pouvez choisir d'avoir 12,34 au lieu de 12,34321, dans ce cas, le nombre de décimales est 2.

Habillage des prix

Sera utilisé pour les prix. Par défaut les prix sont exporté au format numérique, simple (12.34) Mais si vous voulez quelque chose comme '12.34€', '12.34 EUR' ou encore '%%12.34%%', ce champs est là pour ça.

Indiquez ce que vous voulez dans ce champs en remplaçant le prix par [PRICE]. Ainsi '[PRICE]€' donnera des prix de la forme '12.34€'.

Habillage des colonnes

Vous avez la possibilité d'insérer du texte avant et après les valeurs calculés pour chaque colonne. Par exemple vous pouvez ajouter à la fin de toutes les descriptions de vos produits " ©monsite.com™"

Produits à exporter

Ici vous pouvez filtrer les produits que vous voulez exporter.

Exporter les produits inactifs

Choisissez si les produits non activés dans le contexte d'exportation apparaîtront dans le fichier généré.

Exporter les produits en rupture de stock

Choisissez si les produits en rupture de stock au moment de l'exportation apparaîtront dans le fichier généré.

Exporter les déclinaisons

Si activé, une ligne sera créée pour chaque déclinaison de produit et les prix et les quantités seront calculés pour chacune d'elles.

Catégories

Choisissez les catégories à exporter. Si aucune catégorie est cochée, toutes les catégories seront exportées.

Ce sont les catégories par défaut des produits.

Contexte

Dans Prestashop, vous n'avez pas qu'une liste de produits et un prix par produit. Les prix peuvent être personnalisés par groupes, boutiques, pays. Même chose pour les catégories.

Ici vous pouvez choisir le contexte de l'exportation.

Taille de l'image exportée

Si vous choisissez d'exporter les URL des images, ceci défini la taille des images exportées.

Langue / Monnaie / Groupe / Pays / Boutique

Choisissez le contexte de l'exportation. Il peut modifier la liste des produits, les prix, les frais de port, les noms ...

Certaines options ne s'affichent pas en fonction de la configuration de votre boutique. Par exemple, si vous avez une seule langue, l'option de langue ne s'affichera pas.

L'objectif d'une exportation planifiée est de générer un fichier CSV en utilisant un modèle d'exportation et d'en faire quelque chose. Donc, vous devrez indiquer le modèle à utiliser, quand et quoi faire avec le fichier créé.

Remarque: Si aucun modèle d'exportation est créé, vous ne pourrez pas planifier d'exportation.

Nom de l'exportation

Vous pouvez créer autant d'exportation planifiée que vous voulez donc choisir un nom approprié est une bonne idée pour les retrouver facilement.

Modèle

Choisissez le modèle d'exportation à utiliser.

Remarque: Si un modèle d'exportation est supprimé, les exportations planifiées liées seront supprimés aussi.

Jours et heure d'exportation

Choisissez quand exécuter l'exportation. Si vous voulez exécuter une exportation de deux fois par jour, vous devrez créer deux exportations planifiées .

Envoyer un fichier à

Enverra le fichier généré par courrier électronique à l'employé sélectionné.

Enregistrer dans le dossier

Enregistrera le fichier généré dans le dossier sélectionné. Ce dossier doit être accessible en écriture.

Utiliser le module "Crontab pour Prestashop"

Si vous avez créé une exportation planifiée , vous pouvez utiliser le module "Crontab pour Prestashop" pour l'executer. Ce module est gratuit.

Cette option ne s'affiche que si le module "Crontab pour Prestashop" est installé sur votre site.

Répertoire de travail

Ce module a besoin de créer des fichiers temporaires comme des fichiers CSV ou les données d'exportation, pour cela il a besoin d'un dossier accessible en écriture.

La plupart du temps vous n'aurez pas à modifier ce paramètre.

Ce dossier doit être accessible en écriture.

Questions fréquentes communes à tous les modules Samdha

Qu'est-ce qu'un fichier CSV?

Un fichier CSV est composé d'un certain nombre d'enregistrements (ici les produits), un par ligne, chaque enregistrement est constitué de champs (ic appelés colonnes), séparés par un caractères quelconque, le plus souvent une virgule ou point virgule.

CSV est un format de fichier commun relativement simple qui est largement utilisé par les applications grand public les entreprises et scientifique. L'une des utilisations les plus courantes est le déplacement des données tabulaires entre les programmes qui fonctionnent nativement sur les formats incompatibles (souvent propriétaires et / ou non documentés). Cela fonctionne carde nombreux programmes utilisent le format CSV comme un format d'import / export alternatif.

Comment lire un fichier CSV ?

(À partir de http://www.computerhope.com/issues/ch001357.htm)

Un fichier CSV peut être ouvert par n'importe quel programme, cependant, pour la plupart des utilisateurs un fichier CSV sera lisible grâce à un tableur comme Microsoft Excel, Open Office Calc ou Google Docs.

Astuce: Si vous ne disposez pas d'un tableur installé sur votre ordinateur envisager d'utiliser un tableur en ligne comme Google Docs ou un tableur gratuit.

Microsoft Excel

Si Microsoft Excel a été installé sur l'ordinateur, par défaut les fichiers CSV doivent s'ouvrir automatiquement dans Excel lorsque l'icône du fichier est double-cliqué. Si vous trouvez un "Ouvrir avec" lors de l'ouverture du fichier CSV, choisissez Microsoft Excel à partir des programmes disponibles pour ouvrir le fichier.

Sinon, vous pouvez ouvrir Microsoft Excel et cliquez sur Fichier, Ouvrir, sélectionnez le fichier. CSV. Si le fichier n'est pas répertorié assurez-vous que l'extension du fichier est bien .csv.

Plus d'informations : http://office.microsoft.com/en-us/excel-help/import-or-export-text-txt-or-csv-files-HP010099725.aspx

Open/Libre Office Calc

Si Open Office a été installé sur l'ordinateur, par défaut les fichiers CSV doivent s'ouvrir automatiquement dans Calc lorsque l'icône du fichier est double-cliqué. Si vous trouvez un "Ouvrir avec" lors de l'ouverture du fichier CSV, choisissez Open Office Calc à partir des programmes disponibles pour ouvrir le fichier.

Sinon, vous pouvez ouvrir Open Office Calc et cliquez sur Fichier, Ouvrir, sélectionnez le fichier CSV..

Plus d'informations : http://www.linuxtopia.org/online_books/office_guides/openoffice_3_calc_user_guide/openoffice_calc_Starting_opening_saving_Opening_CSV_files.html

Google Docs

Ouvrir Google Docs, cliquez sur l'icône de téléchargement, Fichiers et accédez au répertoire contenant le fichier .CSV. Si une fenêtre de paramétrage du téléchargement apparaît vérifier les documents converti, présentations, feuilles de calcul et des dessins au format Google Docs et cliquez sur Démarrer le téléchargement.

Plus d'informations: http://www.geek.com/apps/geek-101-how-to-open-a-csv-document-with-google-docs-1551489/

Le comparateur de prix X a besoin de colonnes arbitraires. Comment faire ?

La plupart du temps, les comparateurs de prix ont besoin d'un ID de catégorie qui est différent du vôtre, comme '15423 ' pour de la nourriture pour animaux ou 'AZ23' pour les accessoires informatiques.

Vous pouvez gérer cela en utilisant les caractéristiques produits de Prestashop. Créer une caractéristique "Catégorie du comparateur X" (plus de détails) et compléter vos détails de produits avec cette caractéristique (plus d'informations). Ensuite, dans votre modèle d'exportation, ajouter la caractéristique "Catégorie du comparateur X".

Si la valeur est constante, vous pouvez aussi utiliser la valeur "Valeur fixe" qui vous permet de mettre ce que vous voulez.

Un comparateur de prix me demande le flux de mon catalogue. Comment faire ?

pour cela il faut créer un fichier sur votre serveur et en donner l'URL à votre comparateur de prix.

Il faut tout d'abord créer un modèle d'export correspondant aux attentes du comparateur dans l'onglet "Modèles d'exportation". il faut aussi choisir un nom du fichier à générer en face de "Nom du fichier" (par exemple "export.csv")

Ensuite il faut créer une exportation planifiée dans l'onglet "Exportations planifiées" pour créer ce fichier et le mettre à jour régulièrement. Dans cet onglet en face de "Enregistrer dans le dossier" choisissez un dossier (par exemple "/export/")

Une fois le fichier créé, vous pouvez fournir l'URL à votre comparateur. Ce sera l'url de votre boutique suivi du dossier suivi du nom du fichier donc pour l'exemple : http://example.com/export/export.csv