Importation du catalogue depuis Excel

La section Import data permet de charger un catalogue à partir d'un fichier Excel (ou d'un dossier contenant le fichier et des images) : l'assistant analyse les colonnes, regroupe les catégories et crée des produits avec des données, des attributs et des images. La configuration peut être enregistrée dans un modèle et réutilisée lors des importations ultérieures.

L'assistant se compose de quatre étapes : Choose Files → Choose Data → Settings → Import. Chaque paramètre est expliqué ci-dessous à l'aide d'un exemple de fichier de vêtements pour hommes.

Restrictions de téléchargement

• Fichiers principaux — jusqu'à 20, fichiers supplémentaires — jusqu'à 1000.
• Un fichier séparé — jusqu'à 10 Mo, tous les fichiers au total — selon les restrictions du projet.
• Le nombre maximum d'enregistrements par importation est limité (la valeur est indiquée dans le bloc Attention!).
• Les colonnes sans données sont ignorées lors de l'importation.

Étape 1. Fichiers et type de traitement

1. Ouvrez la section Import data dans le menu de gauche.
2. Type de traitement — format des données source :
   • Fichiers Excel — fichiers .xlsx;
   • Fichiers CSV — fichiers .csv;
   • Fichiers XML — fichiers .xml;
   • Fichiers et dossiers locaux — importation depuis des fichiers et dossiers locaux.
3. Type de stockage des données — où les données seront stockées. Pour le catalogue, choisissez Catalog.
4. Modèles — liste déroulante des modèles enregistrés. Le choix d'un modèle remplit automatiquement le type de traitement, le type de stockage et tous les paramètres des colonnes de l'Étape 2 (voir la section « Édition du modèle »). Après avoir sélectionné un modèle, un message apparaît sous les champs : When importing with a template, first select additional files, then the main one.
5. Qu'est-ce que vous téléchargez ? — ce que vous téléchargez :
   • Fichiers principaux (avec option pour supplémentaires) — fichiers principaux (plus possibilité de fichiers supplémentaires). Mode par défaut.
   • Uniquement des fichiers supplémentaires — uniquement des fichiers supplémentaires. Disponible uniquement pour les modèles permettant le chargement de fichiers supplémentaires.
6. Chargement des fichiers principaux — faites glisser le dossier contenant le fichier Excel dans la zone Drag and drop the folder with the required files here ou cliquez dans la zone et sélectionnez le dossier (l'assistant choisit le dossier, et non un fichier séparé). Pour de grands ensembles, utilisez un dossier compact — cela accélère le chargement.
7. Chargement des fichiers supplémentaires — si nécessaire, ajoutez un dossier contenant des images (lorsque les images sont des fichiers séparés, et non à l'intérieur d'Excel). Cette zone n'apparaît qu'après la sélection des fichiers principaux (ou en mode Only additional files) et n'est pas affichée pour le type Local files and folders.
8. Cliquez sur File upload, attendez le traitement et cliquez sur Further.

À droite, vous verrez Import history (journal des importations passées ; l'icône « × » à côté d'une entrée la supprime du journal) et Templates (liste des modèles enregistrés ; l'icône « × » supprime le modèle).

Étape 2. Sélection et configuration des colonnes

Une table maître est affichée avec toutes les colonnes du fichier. Cochez les colonnes nécessaires avec la case à cocher dans l'en-tête — pour chacune, une carte de configuration apparaîtra sous le tableau.

Paramètres généraux de la colonne

Dans la carte, définissez le nom de l'attribut (le marqueur est généré automatiquement), le type de données et le rôle de la colonne :

Paramètre	Désignation
Type	Type d'attribut : String, Text, Integer, Float, Image, Group of Images, List, etc.
Name	La colonne contient le nom du produit.
Collect categories from the values of this column	Les valeurs de la colonne sont utilisées pour rassembler les catégories du catalogue.
Contains price	La colonne est le prix (utilisé avec le type Float). La case est disponible pour les colonnes de types String, Integer et Float.
Contains currency	La colonne est la devise. S'affiche avec la case Contains price.
Includes SKU	La colonne est le SKU.
Unique key	Valeur — identifiant unique du produit : lors d'une nouvelle importation, les produits avec une valeur correspondante sont mis à jour, et non dupliqués.
Is record ID?	La colonne est l'identifiant de l'enregistrement. Ne s'affiche pas pour le type Local files and folders.
Multi-select	Autoriser plusieurs éléments de liste dans la valeur (pour le type List).
Divider for multi-select	Caractère séparateur des valeurs lors de la sélection multiple (dans l'exemple — virgule ,).

Exemple de configuration des colonnes

Pour le catalogue masculin, les colonnes sont configurées comme suit :

Colonne	Type et paramètres
Category	Collect categories from the values of this column
Product Name	case à cocher Name
Style, Details	List + Multi-select + séparateur ,
Product Description	Text
Brand, Gender, Size, Country, Lable	List
Color, Material, Lining, Insulation, Care Instructions, Season	List + Multi-select + séparateur ,
Units, Stock Qty	Integer
Price	Float + Contains price
SKU	String + Includes SKU + Unique key
Pictures	Image (voir ci-dessous)
Status	liaison conditionnelle aux statuts du produit (voir ci-dessous)

Colonne avec images

1. Type — Image.
2. Sélectionnez le mode Search pattern for filenames et indiquez la colonne selon laquelle rechercher les fichiers. Le champ de modèle est par défaut rempli avec l'expression régulière .*#attr#.*, où #attr# est la valeur de la colonne sélectionnée ; vous pouvez la remplacer par la vôtre. L'assistant trouvera les images parmi les fichiers supplémentaires selon ce modèle.
3. Optimize uploaded images — optimisation des images téléchargées (activée par défaut).
4. Cochez Use as a preview in the product list — un sélecteur Preview templates s'ouvrira ; choisissez un modèle d'aperçu.

Liaison conditionnelle aux statuts du produit (colonne Status)

La colonne de statut peut ne pas être importée « telle quelle », mais associer ses valeurs aux statuts du produit selon des conditions :

1. Cochez Attribute contains status values, puis Convert value et Use special values — dans cet ordre (le sélecteur de type valeurs spéciales n'apparaît qu'après la troisième case à cocher).
2. Special value type — choisissez Product Statuses.
3. Définissez les conditions d'association. Pour chaque condition :
   • colonne de comparaison (par défaut — la colonne Status elle-même) ;
   • opérateur — par exemple, equal to (égal à). Les options disponibles incluent également contains, does not contain, not equal to, more, less, comparaison avec un modèle, avec un autre attribut, avec la date/heure actuelle, etc. ;
   • valeur pour la comparaison (par exemple, In Stock) ;
   • statut cible du produit dans la liste des Product Statuses.
4. Avec le bouton Add condition, ajoutez la condition suivante (par exemple, Out of Stock → un autre statut).

Dans l'exemple : la valeur In Stock et la valeur Out of Stock sont associées au statut du produit demo_status_update.

Si plusieurs tableaux sont liés, indiquez une clé commune (généralement le SKU) via les champs d'association des colonnes. Une fois la configuration terminée, cliquez sur Further.

Étape 3. Catégories à importer

Les catégories sont rassemblées à partir des valeurs de la colonne marquée avec la case à cocher Collect categories… à l'Étape 2. S'il n'y a pas de telle colonne, pour Excel, la case Collect categories from file est disponible — les catégories seront rassemblées à partir des fichiers.

Pour choisir la catégorie racine dans laquelle le catalogue importé sera placé, cochez la case Choose category — un choix Choose Parent apparaîtra en dessous. Cliquez sur Further.

Étape 4. Lancer l'importation

1. Process records — nombre d'enregistrements traités ; sous le champ, il est indiqué combien de possibles (la valeur peut être réduite).
2. Load files — la case indique simplement si les fichiers (images) seront chargés avec les données ; elle ne peut pas être modifiée.
3. Save as template — enregistrer la configuration actuelle comme modèle ; dans le champ Template name qui apparaît, donnez un nom significatif (par exemple, Men catalog Excel import), afin de pouvoir le réutiliser plus tard.
4. Cliquez sur Start import et attendez la fin.

Selon les données, des cases supplémentaires apparaissent à l'étape :

• Process all data sets — uniquement pour XML : tous les ensembles de données sont traités, et non seulement l'ensemble de la table maître. La case indique le mode et n'est pas modifiable.
• Clear group names — uniquement pour XML : supprime tous les noms de groupes dans les ensembles de données, définis à l'Étape 2. Disponible si des noms de groupes sont définis.
• Allow additional files upload — apparaît si Save as template est activé, et que les colonnes de fichiers ont une recherche par modèle de noms configurée ; permet de charger des fichiers supplémentaires au modèle (mode Only additional files à l'Étape 1).
• Rewrite Files Data — apparaît si des colonnes contiennent des fichiers ou des images ; si activé, les valeurs des attributs de fichiers sont écrasées lors de l'importation.

L'enregistrement de modèles n'est pas disponible si les données sont chargées depuis le système de fichiers (Local files and folders) ou si des ensembles de données ont été déplacés à l'Étape 2 — au lieu des cases, un message s'affiche : Saving templates is disabled because you are loading data from the file system or have moved datasets at step #2.

Après l'importation, des catégories et sous-catégories apparaîtront dans le catalogue, et des produits seront créés avec des données, des attributs, des statuts et des images.

Modèles : sauvegarde et édition

La configuration d'importation peut être enregistrée dans un modèle et réutilisée plus tard — et si nécessaire, complétée par une nouvelle colonne et réimportée, mettant à jour les produits déjà créés. La vidéo ci-dessous montre tout le cycle : d'abord une importation simple avec sauvegarde du modèle, puis son édition.

Sauvegarde du modèle

1. Effectuez l'importation (dans l'exemple, deux colonnes sont cochées : Category — Collect categories… et Product Name — Name).
2. À l'Étape 4, cochez Save as template, dans le champ Template name, donnez un nom (dans l'exemple — Mens clothing) et cliquez sur Start import.

Le modèle apparaîtra dans la liste Templates à droite (l'icône « × » à côté supprime le modèle).

Édition du modèle

1. À l'Étape 1, dans la liste Templates, sélectionnez le modèle enregistré — le type de traitement, le stockage et la configuration des colonnes seront automatiquement remplis.
2. Cochez la case Edit template — cela active le mode d'édition (sinon, le modèle est appliqué sans modifications).
3. Téléchargez le fichier. En mode d'édition, l'assistant ouvre immédiatement l'Étape 2 avec les colonnes du modèle déjà cochées.
4. Cochez la nouvelle colonne (dans l'exemple — Style) et définissez son type (List).
5. Passez à l'Étape 4. Deux boutons sont disponibles ici :
   • Save template only — enregistrer les modifications dans le modèle sans importer ;
   • Save template and import data — enregistrer les modifications et réimporter le catalogue avec les données mises à jour.
6. Cliquez sur Save template and import data.

Après la réimportation, ouvrez n'importe quel produit de la catégorie et dans l'onglet Attributes, assurez-vous que le nouvel attribut (Style) a été ajouté.