Mass Product Import & Update vous permet de mettre à jour ou d’importer massivement des produits dans Magento en temps record grâce à des fichiers CSV ou XML disponibles sur votre serveur, sur un serveur distant via FTP ou sur un serveur distant via HTTP.
Mass Product Import & Update permet de mettre à jour et/ou de créer les attributs de produit suivants pour une ou toutes les vues magasin :
- Tous les attributs système (sku, type, attribute set, visibility, status)
- Tous les types d’attributs créés dans Magento (input, dropdown, yes/no, multiselect, texte...)
- Tous les attributs images (image gallery, base image, thumbnail, small images... )
- Tous les attributs de stock (qty, availability, back order, manage stock, low stock notification…)
- Les catégories associées aux produits
- Les prix, prix spéciaux, dates des prix spéciaux, tax class…
Comment utiliser Mass Product Import & Update
Pour pouvoir utiliser Mass Product Import & Update, vous devez dans un premier temps aller dans :
SystemConfigurationWyomindMass Product Import & Update
Configurer Mass Product Import & Update de manière générale
Email reporting
Mass Product Import & Update inclut un outil de reporting des tâches cron qui vous permettra d’être averti chaque fois qu’un profil aura été exécuté et le cas échéant si une erreur s’est produite.
Pour plus d’information sur les tâches cron, reportez-vous aux sections suivantes :
Configurer les tâches cron dans un profil
Enable reporting
Send the reports to
Vous permet de préciser la/les adresses emails sur lesquelles les rapports sont envoyés.
Pour indiquer plusieurs adresses emails, utilisez la virgule comme séparateur.
Report title
Settings
Enable log file
Le fichier est nommé :
Wyomind_MassStockUpdate.log
System Configuration Advanced Developer Logs settings
Créer un profil d’import dans Mass Product Import & Update
Pour pouvoir mettre à jour les produits dans Magento ou en créer de nouveaux, il vous faut dans un premier temps créer un profil dans :
SystemImport/ExportMass PRODUCT IMPORT & Update
Vous devriez y trouver des exemples de profils que vous pouvez éditer. Pour créer un nouveau profil, cliquez sur Create a new profile.
Blackbox
La blackbox est un outil qui vous aidera à configurer votre mapping facilement. Cet outil est composé de 3 options majeures.
Input Data
Output Data
Library
La library vous permet de vérifier quelles valeurs vous pouvez utiliser pour chaque attribut. Vous y trouverez aussi des exemples pour vous aider.
Settings
Dans cette partie, vous pourrez définir la source de vos données.
Profile setting
- Profile name
Nom que vous souhaitez donner au profil. Seuls les caractères alphanumérique, les tirets et les underscores sont acceptés. - Profile method
Définissez quelle action le profil déclenchera :Mettre à jour les produits uniquement
Importer des nouveaux produits uniquement
Mettre à jour les produits et importer des nouveaux produits - SQL mode
Lorsque le mode SQL est activé, aucune donnée n'est mise à jour ou importée. En exécutant le profil, un fichier SQL sera créé. Ce fichier peut être exécuté directement depuis votre base de données.
En activant le mode SQL, vous devrez définir :
- SQL file path
Il s'agit du chemin où le fichier SQL sera généré (par rapport au répertoire racine de Magento). - SQL file name
Nom du fichier SQL à générer.
File location
Cette partie vous permet de définir où le fichier source est stocké et quel est le chemin vers le fichier (incluant son nom et son extension). Vous avez plusieurs options :
- Magento File System
Le fichier est stocké à la racine de l’instance Magento ou dans un sous-répertoire de l’instance Magento.
Chemin du fichier par rapport au répertoire racine de Magento.
Vous pouvez utiliser les expressions régulières dans le nom du fichier. - FTP server
Le fichier est stocké sur un serveur à distance disponible via FTP ou SFTP.
Chemin du fichier par rapport au répertoire racine de l'utilisateur FTP. - URL
Fichier disponible via une URL utilisant HTTP ou HTTPS.
Le chemin du fichier est l'URL du fichier.
S'il y a besoin d'accès, ajoutez le login/mot de passe directement dans les champs correspondants. - Dropbox
Vous pouvez générer vos accès depuis votre compte Dropbox :
https://www.dropbox.com/developers/apps
Le chemin du fichier est l'URL du service dropbox. - Webservice
Le fichier est disponible via un serveur distant accessible en ligne.
Le chemin du fichier est l'URL du service web.
File Type
Vous permet de définir le type de fichier utilisé pour la mise à jour : XML ou CSV.
- File type
Vous avez le choix entre un fichier CSV ou XML.
Pour les fichiers CSV, définissez :
- Field separator
Définissez le séparateur de champs. - Field enclosure
Sélectionnez le délimiteur de champs.
Pour les fichiers XML, définissez :
- Xpath to products
Dans le cas d'une mise à jour à partir d'un fichier XML, définissez le XPath qui cible les produits. Le Xpath est sensible à la casse.
Exemple de fichier
Le XPath qui cible les produits dans le fichier ci-dessus est /Import/PRODUCTS/product<Import> <PRODUCTS> <product> <name>Product A</name> <sku>001A</sku> <qty>864</qty> </product> <product> <name>Product B</name> <sku>002B</sku> <qty>594</qty> </product> </PRODUCTS> </Import>
- XML structure
Vous avez deux options; la Détection automatique ou la Structure prédéfinie. La détection automatique convient aux fichiers simples composés d'un niveau de nœuds seulement tel que l'exemple ci-dessous. - Predefined structure
Si vous avez sélectionné Predefined structure, vous avez la possibilité de définir votre propre structure de fichier. Lorsque la structure de votre fichier est assez compliquée, l'information peut être dispatchée dans des nœuds profonds et quelques fois dans des attributs tag tels que :
url="something"
Ci-dessous, un exemple de fichier complexe où vous avez besoin d'une structure prédéfinie :
<offers xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="1"> <offer price="165.07" msrp="189.00" availability="3"> <name><![CDATA[Amazing product]]></name> <images> <img url="https://www.example.com/path/to/product/image/1.jpg" /> <img url="https://www.example.com/path/to/product/image/2.jpg" /> </images> <videos /> <categories> <category><![CDATA[Category A]]></category> <category><![CDATA[Category B]]></category> <category><![CDATA[Category C]]></category> </categories> <description><![CDATA[Amazing product description]]></description> <attributes> <attibute name="sku"><![CDATA[XYZ]]></attibute> <attibute name="ean"><![CDATA[123456789]]></attibute> <attibute name="tax"><![CDATA[VAT 20%]]></attibute> </attributes> </offer> </offers>
Le XPath qui cible les produits dans le fichier ci dessus est /offers/offer
La syntaxe JSON que vous devez utiliser est :{ "sku":"attributes/attribute[@name='sku']", "ean":"attributes/attribute[@name='ean']", "price":"@price", "msrp":"@msrp", "tax":"attributes/attribute[@name='tax']", "name":"name", "description":"description", "category_1":"categories/category[1]", "category_2":"categories/category[2]", "category_3":"categories/category[3]", "image_1":"images/img[1]/@url", "image_2":"images/img[2]/@url" }
REGLES D'UTILISATION DANS LE CHAMP STRUCTURE PRÉDÉFINIE XML
- Utilisez une chaîne de caractères valide Json composée d'une liste de clé/valeur qui définit les noms des colonnes et les Xpath associés aux colonnes.
- Utilisez @ pour accéder aux valeurs d'attribut.
@price - Utilisez [@attribute=value] pour accéder à un nœud pour lequel l'attribut est une valeur.
[@name='ean'] - Utilisez [number] pour accéder à un autre nœud qui a le même nom.
category - Utilisez Xpath axis pour représenter une relation au nœud, et identifier des nœuds. Par exemple, sélectionnez tous les enfants/parents d'un nœud :
child::attributesparent::category
Post Process Action
Vous permet de définir une action après l'exécution du profil.
- Action
Vous avez le choix entre :
Do Nothing : ne rien faire
Delete the import file : supprimer le profil d'import
Move import file : déplacer le profil d'import - Move to folder
Chemin du fichier depuis le repertoire racine de Magento
Advanced Settings
System Settings
- The first line is a header
Spécifiez lorsque la première ligne est une entête (pour les fichiers CSV seulement). - Filter lines
Laissez vide pour exporter toutes les lignes.
Signifie que toutes les lignes seront importées.
Entrez le numéros des lignes que vous souhaitez importer, en faisant attention à séparer chaque ligne par une virgule (,).
2,4,6,8,10Signifie que les lignes 2,4,6,8,10 seront importées.
Utilisez un tiret (-) pour définir un ensemble de lignes.
8-10
Signifie que les lignes 8,9,10 seront importées.
Utilisez un plus (+) pour importer toutes les lignes depuis un numéro de ligne.
4+Signifie que toutes les lignes à partir de la ligne 4 seront importées.
Utilisez les expressions régulières entourées de # pour indiquer un groupe d'identifiant spécifique à importer.
#ABC-[0-9]+#Signifie que toutes les lignes avec l'identifiant correspondant à l'expression régulière seront importées
- Automatic action for missing products
Définissez ce que vous souhaitez faire pour chaque produit qui manque au fichier. Vous avez plusieurs options :
Ne rien faire
Désactiver le produit
Supprimer de manière permanente le produit
Marquer le produit comme hors stock - Target
Lorsqu'un produit est importé avec Mass Product Import & Update, il est associé avec le profil. Si vous avez sélectionné une action pour les produits manquants, vous devrez choisir une cible :
Only products related to current profile : les produits qui sont importés/mis à jour avec le même profil
Only products not related to current profile : tous les produits qui ne sont pas créés/mis à jour par le profil
All products : tous les produits
Stock Settings
Automatic stock status update:
Vous pouvez choisir de mettre à jour automatiquement le statut de stock (in stock / out of stock).
Image Settings
- Images location
Serveur HTTP (url)
Système de fichiers Magento
serveur FTP
Selon ce que vous avez défini comme emplacement pour les images, vous devrez remplir différents champs.
Pour le serveur FTP :
- Use SFTP
- Use active mode
- Host
- Login
- Password
Pour le serveur FTP et les système de fichiers Magento, définissez :
- Path to images directory
Le chemin du répertoire images.
Category Settings
- Create categories on the fly
Créer des catégories à la volée. - New categories active by default
Définir les nouvelles catégories actives par défaut. - New categories included in menu by default
Définir les nouvelles catégories dans le menu par défaut. - Category tree auto-detection
Pour détecter automatiquement l'arborescence des catégories.
Vous devez utiliser le chemin complet de la catégorie. Les niveaux de catégories doivent être séparés par des slashes (A/B/C). Par exemple, au lieu de "Shirts", vous pouvez écrire :
Default Category/Men/ShirtsLorsque que Category tree auto-detection est désactivé, la catégorie est ajoutée à la catégorie racine définie dans New categories are children of. - New categories are children of
Choisissez la catégorie parente.
Jetez un œil à la documentation pour plus de détails sur la configuration des attributs des catégories.
Configurable Product Settings
Create parent of configurable products on the fly
Vous pouvez aussi créer/mettre à jour un produit configurable à partir des produits simples existants dans le fichier source en activant cette option.
Lorsque cette option est activée, dans l'onglet Mapping & Rules, vous pouvez trouver pour chaque attribut cible une option pour les produits configurables à créer à la volée. Vous avez la possibilité d'appliquer ce mapping sur :
- The current product only
Le produit simple seulement - The configurable product created on the fly only
Le produit configurable créé à la volée seulement - Both, configurable product created on the fly and simple product associated
Les deux, le produit configurable et le produit simple associé
Les attributs systèmes des produits configurables créés à la volée doivent impérativement recevoir une valeur soit en mappant un champ du fichier source pour le produit simple et le produit configurable ou uniquement pour le produit configurable.
La liaison entre le produit configurable et les produits simples nécessite de mapper les attributs suivants :
- le SKU du produit parent ou le SKU des produits enfants
- les attributs configurables
- l'attribut Options Container, dans le cas où vous créez des produits configurables à partir d'un fichier source ("container1" est le conteneur par défaut dans Magento)
Mapping & Rules
Dans cette section vous pouvez mapper chaque colonne du fichier avec un des attributs de stock.
Column Mapping
Chaque colonne peut être mappée avec un des attributs de stock. Notez qu'à n'importe quel moment vous pouvez visualiser les données sources et les données telles qu'elles seront mises à jour dans la blackbox directement.
- Target Attribute
Sélectionnez l'attribut cible depuis ceux disponibles dans votre système (sur la première ligne, définissez l'identifiant de vos produits). Vous pouvez trouver tous les attributs regroupés par type dans notre documentation. - Data source
Dans Data source, vous pouvez définir l'attribut source qui correspond à l'attribut cible de votre fichier source. - Custom value
Quelques fois, certaines colonnes peuvent manquer. Par exemple, en mettant à jour les stocks, le fichier ne comprend pas forcément tous les attributs de stock (backorders, minimum quantity in the cart...). Dans ce cas, vous pouvez choisir Custom value et appliquer une valeur par défaut.
- Ajoutez autant de colonnes que vous le souhaitez en cliquant sur +. Dans beaucoup de cas, le fichier de mise à jour peut contenir plus de colonnes que nécessaire; vous n'avez pas besoin d'ajouter toutes ces colonnes et de les mapper.
- SUPPRIMEZ une ligne facilement.
- Changez le sens de chaque ligne en utilisant le drag and drop.
- Désactivez une ligne tout en conservant ses paramètres en cliquant sur le symbole lIEN.
- Ajoutez votre propre script </>. Ces scripts seront visibles dans les données de sortie. Notez que lorsqu'un script est défini, le symbole </> est souligné.
- Appliquez la couleur que vous souhaitez pour la ligne.
- Appliquez le titre que vous souhaitez pour la ligne.
- Définissez pour quelle(s) vue(s) magasin vous souhaitez appliquer ces paramètres en cliquant sur APPLY TO DEFAULT VALUE.
- Définissez pour quel(s) produit(s) vous souhaitez appliquer ces paramètres en cliquant sur APPLY TO THE CURRENT PRODUCT ONLY.
- Prévisualisez votre fichier en cliquant sur INPut Data.
- Retrouvez tous les attributs regroupés par type dans la Library.
- Vérifiez les données telles qu'elles seront mises à jour en cliquant sur Output Data.
Scheduled tasks
Vous pouvez planifier l'exécution d’un profil selon le jour et l’heure avec un interval de 30 minutes par défaut entre chaque tâche planifiée.
Vous pouvez changer l'interval des tâches cron dans :
SystemConfigurationWyomindMass PRODUCT IMPORT & UpdateSettings
Exécuter un profil Mass Product Import & Update
Vous avez plusieurs options pour exécuter vos profils.
Depuis la grille des profils
Pour exécuter le profil depuis la grille, il vous suffit de cliquer sur RUN Profile dans le dropdown associé au profil. Une barre de progression affichera la progression de la tâche.
Depuis la page du profil
Ouvrez le profil en cliquant sur l’option edit du dropdown associé au profil dans la grille et cliquez sur le bouton RUN Profile NOW. Lorsque l’import ou la mise à jour est fini, un message s’affiche détaillant combien de produits ont été mis à jour et combien de produits ont été ignorés.
Grâce aux tâches cron
Lorsque vous avez configuré la tâche cron d’un profil, celui-ci sera exécuté automatiquement au jour et à l’heure sélectionnée.
Pour que les tâches cron de Mass Product Import & Update fonctionnent, la tâche cron Magento doit être configurée correctement.
Pour plus d’information sur les tâches cron Magento, référez-vous au guide officiel Magento :
http://devdocs.magento.com/guides/v2.0/config-guide/cli/config-cli-subcommands-cron.html
Vous recevrez une notification par mail lorsque la tâche cron est exécutée, si vous avez configuré l’option dans :
system configurationMass Product Import & Update
En ligne de commande
Mass Product Import & Update inclut des lignes de commande accessibles depuis n’importe quel terminal shell.
php -f shell/wyomind_massproductupdate.php -- [options]
Les paramètres suivant peuvent être utilisés :
- -h
Aide - --generate
Génère tous les profils - --generate id1,id2,...,idN
Génère les profils de la liste - --list
Liste les profils
Utiliser l'option SQL
Mettre à jour ou importer des produits massivement peut garder votre serveur occupé un certain temps, surtout lorsque la mise à jour concerne de nombreux produits et/ou de nombreux attributs.
Mass Product Import & Update découpe donc le processus en 2 étapes distinctes :
- L’analyse du fichier source, la collecte des données et la construction du fichier SQL d’import ou de mise à jour des produits.
- L’exécution du fichier SQL de mise à jour ou d’import des produits qui peut être exécuté de manière asynchrone.
Générer le fichier SQL
Si vous souhaitez générer un fichier SQL de mise à jour ou d’import sans l'exécuter, vous devez activer l’option dans la configuration du profil.
Puis, lancez l’exécution du profil en cliquant sur RUN Profile NOW.
Exécuter le fichier SQL
Un fois le fichier généré dans le répertoire de travail (voir la section Settings ), il vous suffit de mettre à jour la base donnée avec ce fichier via les lignes de commande :
mysql -h host -p DbPassword -u DbLogin DatabaseName < path/to/mysql/file.sql
Vous pouvez aussi utiliser la ligne de commande :
php -f shell/wyomind_massproductimport.php --sql id1
Spécifications des attributs
Attributs système
Ces attributs sont indispensables lors de l'importation de nouveaux produits.
Si vous ne précisez pas de valeurs pour ces attributs dans le mapping, les produits importés ne seront jamais visibles ni sur le front-end ni dans le back-end.
Sku
L'identifiant unique du produit à mettre à jour ou à importer.
sku1
Attribute set
Le jeu d'attribut à appliquer au produit.
Vous pouvez soit utiliser le nom du jeu d'attributs (non sensible à la casse) soit l'ID du jeu d'attributs.
bag
15
Pour connaitre les jeux d'attributs disponibles dans votre système, allez dans :
Catalog AttributesManage attributE Sets
Type
Le type de produit.
Vous devez utiliser le nom du type de produit (non sensible à la casse).
- simple
- configurable
- grouped
- bundle
- virtual
- downloadable
- n'importe quel type de produit personnalisé
simple
Website
Le(s) website(s) dans lequel/lesquels le produit doit être visible.
Vous pouvez soit utiliser le nom du website (non sensible à la casse) soit l'ID du website.
Main Website Store
1
Pour connaitre les noms et IDs des websites disponibles dans votre système, allez dans :
systemManage stores
Tax Class
La classe de taxe du produit.
Vous devez utiliser l'ID de la classe de taxe produit.
Taxable Goods
2
Pour connaitre les IDs des classes de taxe produit, allez dans :
SalesTaxPRoduct tax classes
Visibility
La visibilité du produit.
Vous pouvez utiliser soit le nom de la visibilité soit la valeur numérique associée.
- Not visible Individually (1),
- Catalog (2),
- Search (3),
- Catalog & Search (4)
Catalog,Search
4
Status
Le statut du produit : enabled ou disabled.
Vous pouvez utiliser le nom du statut ou tout autre valeur parmi :
- 1 / 0
- yes / no
- true / false
- enable / disable
- enabled / disabled
enabled
Attributs produit
Tous les attributs produit créés pour votre boutique et/ou tous les attributs qui ne sont pas référencés dans les autres sections, sont disponibles dans la section Products attributes.
Attribut de type texte ou textarea
Les attributs de type texte ou textarea peuvent être mis à jour avec n'importe quelle valeur sans aucune restriction.
Votre texte
Attribut de type yes/no
- 1 / 0
- yes / no
- true / false
- enable / disable
- enabled / disabled
true
Attribut de type dropdown ou multiselect
Les attributs de type dropdown peuvent être mis à jour à partir du label de l'option ou de l'id de l'option.
4
Les attributs de type multiselect peuvent être mis à jour à partir des labels de l'option ou des ids de l'option séparés par des virgules.
Men, Boys
Pour connaitre les labels ou les ids d'un attribut de type dropdown ou multiselect, allez dans :
Catalog AttributesManage attribut edit attributE Manager label / option
Attribut de type date
Les attributs de type date doivent être formatés comme suit :
YYYY-MM-DD hh:mm::ss
2019-06-11 15:09:52
Valeur décimale
Les attributs EAV peuvent désormais être mis à jour avec des valeurs décimales.
Vous pouvez par exemple définir une valeur pour l'attribut price.
15.45
Valeur entière
Les attributs EAV peuvent désormais être mis à jour avec des valeurs entières.
Vous pouvez par exemple définir une valeur pour l'attribut weight.
368
Valeur nulle
Les attributs EAV peuvent désormais être mis à jour avec des valeurs nulles.
Vous pouvez par exemple définir une valeur nulle pour l'attribut prix. Pour cela, NULL doit être écrit en majuscules et sans espace.
NULL
Attributs prix
Prix
L'attribut Price peut être un nombre entier ou à virgules.
Il doit être formaté avec un point comme séparateur des décimales.
15.50
Prix spéciaux
L'attribut Special price peut être un nombre entier ou à virgules.
Il doit être formaté avec un point comme séparateur des décimales.
10.50
Special price from/to date
Les attributs Special price from/to date doivent être formatés avec la date et l'heure GMT comme ci-dessous :
AAAA-MM-JJ hh:mm:ss
2019-06-17 11:29:51
Tier price/Group price
Les Tier /Group prices doivent être séparés par ~ comme suit :
[Group id 1]|[Qty 1]|[Price 1]~[Group Id 2]|[Qty 2]|[Price 2]~...
*|5|9.99~*|10|7.99~...
Pour importer vos tier prices sous forme de pourcentages, ajoutez % à la fin the chaque prix. Sinon, ils seront importés sous forme d'un montant.
*|5|10%~*|10|5%~...
Ci-dessous, vous trouverez la liste des codes à utiliser pour les identifiants des groupes clients :
- * : Tous les groupes
- 0 : Not logged in
- 1 : General
- 2 : Wholesale
- 3 : Retailer
- 4 : VIP Member
- 5 : Private Sales Member
Weee tax
Les taxes doivent être séparées par ~ comme ci-dessous :
pays1|region1|taxe1~pays2|region2|taxe2~...
- Code pays
Par exemple : FR, US, CA, NZ... - Region
Utilisez * pour tous les états - Tax
Il s'agit d'une valeur fixe
FR|*|13~UK|*|18
Attributs stock
Tous les attributs relatifs à la gestion des stocks sont disponibles dans cette section.
L'ensemble des ces attributs doivent être mise à jour par des valeurs booléennes ou numériques.
Valeurs booléennes
- 1 / 0
- yes / no
- true / false
- enable / disable
- enabled / disabled
- in stock / out of stock
in stock
Valeurs numériques
- Integer number : sans espace
- Float number : avec un point comme séparateur
10.50
Attributs Advanced Inventory
Tous les attributs relatifs à la gestion des stocks dans Advanced Inventory sont disponibles dans cette section.
Tous ces attributs doivent être mis à jour par des valeurs booléennes ou numériques.
Valeurs booléennes
- 1 / 0
- yes / no
- true / false
- enable / disable
- enabled / disabled
- in stock / out of stock
yes
Valeurs numériques
- Integer number : sans espace
- Float number : avec un point comme séparateur
1050
Attributs dynamiques
Vous avez la possibilité de créer un mappage dynamique, ce qui vous donne plus de souplesse dans la configuration de votre profil. Dans votre fichier source, pour une même colonne vous pouvez indiquer l'attribut Magento à mapper ainsi que la valeur associée.
Dynamic attribute
Code de l'attribut à mapper et valeur associée.
La syntaxe à utiliser est :
code_attribut=valeur
length=150
Attributs image
Les attributs relatifs à la gestion des images sont disponibles dans cette section.
Le dossier source des images doit avoir été défini dans l'onglet Image Settings.
Image Gallery
Les images composant la galerie d'images doivent être listées dans ce champ sous la forme de chemin relatif au dossier source défini dans l'onglet Image Settings.
La syntaxe à utiliser est :
repertoire/image-1.png;
repertoire/image-2.png;
...
Les différents liens doivent être séparés par l'un des caractères suivants :
- | (pipe)
- , (comma)
- ; (semi-colon)
repertoire_1/dossier_2/image-A.png;
repertoire_1/dossier_2/image_2.png;
dossier_3/image-XYZ.png;
Vous pouvez utilise le paramètre suivant :
- le préfixe * (étoile) et le titre de l'image :
Paramètre optionnel pour associer un titre à l'image.
dossier_1/dossier_2/image-A.png*image A;
dossier_1/dossier_2/image_2.png*image B;
dossier_3/image-XYZ.png*image XYZ;
Base Image, Thumbnail, Small Image
Par défaut 3 types d'images sont disponibles dans Magento :
- Base Image : l'image associée au produit sur la page produit
- Small Image : l'image visible dans la page catégorie pour le produit
- Thumbnail : l'image visible dans le panier, le checkout, le compte client
Attributs catégorie
La/les catégorie(s) associées aux produits peuvent être mises à jour ou importées avec des nouvelles valeurs.
Category mapping
Listez vos noms de catégories (sensible à la case) ou les ids des catégories séparés par une virgule.
category ID 1 [position],category ID 2 [position]...
Vous pouvez utiliser le paramètre ci-dessous afin de définir la position des produits dans les catégories :
- position
La valeur par défaut est vide.
Par exemple, pour importer un produit en position 2 dans la catégorie 10 et en première position dans la catégorie 13, vous pouvez écrire :
10[2],13[1]
Les valeurs seront traduites en chemins de catégories selon les paramètres que vous avez définis dans la configuration de votre profil depuis :
Advanced SettingsCategory Settings
Par exemple, afin d'importer des produits dans les catégories New Arrivals (ID: 10) et Dresses & Skirts (ID: 13), depuis l'onglet Mapping & rules de la configuration de votre profil, mappez l'attribut Category mapping avec une valeur custom value.
Dans le champ d'après, vous pouvez écrire :10,13
Si vous préférez utiliser les noms de catégories, vous pouvez écrire :
Default Category/Women/New Arrivals,Default Category/Women/Dresses & Skirts
Les catégories seront créées selon ce que vous avez défini dans l'onglet Advanced Settings.
Attributs merchandising
Les produits associés/up-sell/complémentaires peuvent être importés/mis à jour avec de nouvelles valeurs.
Produits Related / Cross sell / Up sell
Liste des SKU des produits associés séparés par |.
SKU1|SKU2|SKU3...
Attributs produits configurables
Avec Mass Product Import & Update vous pouvez créer des produits configurables à la volée ainsi que des relations entre les produits parents et les produits enfants.
Parent SKU
Lors de la création/mise à jour d'un produit simple, vous pouvez ajouter la référence au produit configurable de sorte que les produits simples seront automatiquement associés au produit configurable :
SKU du produit parent
parentsku
Children SKUs
Lors de la création/la mise à jour d'un produit configurable, vous pouvez ajouter les références aux produits simples de sorte que les produits simples seront automatiquement associés au produit configurable :
Liste des SKUs des enfants séparés par des virgules
sku1,sku2,sku3
Configurable attributes
Lors de la création/mise à jour d'un produit configurable, les attributs configurable doivent être précisés en utilisant les codes d'attributs ou IDs des attributs séparés par des virgules comme suit :
Code attribut 1,Code attribut 2...
size,color
Options Container
L'attribut Options Container, doit être ajouté à votre mapping dans le cas où vous créez des produits configurables à partir d'un fichier source comme suit :
Code du Container
container1
Attributs produits téléchargeables
Avec Mass Product Import & Update vous pouvez importer ou mettre à jour les produits téléchargeables.
Links title
Titre de la resource téléchargeable.
Fichier téléchargeable
Samples title
Titre de la resource téléchargeable.
Fichier téléchargeable
Link URLs
Lien du fichier (chemin relatif ou absolu) et nom du fichier optionnel séparé par un (|) :
Lien | Nom du fichier
http://www.exemple.com/filename.ext | Mon fichier téléchargeable
Sample URLs
Lien du fichier (chemin relatif ou absolu) et nom du fichier optionnel séparé par un (|) :
Lien | Nom du fichier
http://www.exemple.com/filename.ext | Mon fichier téléchargeable
Attributs produits groupés
Avec Mass Product Import & Update vous pouvez importer ou mettre à jour les produits groupés, et créer des relations entre les produits parents et enfants.
Parent SKUs
Lors de la création/la mise à jour d'un produit groupé, vous pouvez ajouter les références aux produits parents de sorte que les produits simples seront automatiquement associés au produit groupé comme suit :
Liste des SKUs des parents séparés par des virgules
parentsku
Children SKUs
Lors de la création/la mise à jour d'un produit groupé, vous pouvez ajouter les références aux produits simples de sorte que les produits simples seront automatiquement associés au produit groupé comme suit :
Liste des SKUs des enfants séparés par des virgules
sku1,sku2,sku3
Options personnalisées
Avec Mass Product Import & Update vous pouvez importer ou mettre à jour les custom options de vos produits.
Dropdown / Radio / Checkbox / Muli-select
Listez les titres des custom options séparés par * et les valeurs des options séparées par | comme suit :
Titre*Option1|Sku Option 1| Prix Option 1| Position option 1*Option2|Sku Option 2| Prix Option 2| Position option 2*...
Gravure*Gravure or|gravureor01|45|1*Gravure argent|gravureargent02|25|2*...
API PHP pour Mass Product Import & Update
Mass Product Import & Update vous permet de personnaliser et contrôler totalement les données en utilisant des scripts PHP.
Normes de codage de l'API
Pour chaque ligne dans l'onglet Mapping & Rules de votre profil, vous pouvez ajouter votre propre script basé sur une syntaxe PHP.
Pour ajouter votre script, cliquez sur </> à la fin d'une ligne. Vous pouvez ensuite mettre à jour la valeur de chaque colonne.
Balises ouvrantes et fermantes
<?php /* Votre script */ return $self;
Retourner une valeur
return
Pour retourner n'importe quelle valeur dans votre profil, vous devez utiliser l'instruction return.
Objet $this
$this->skip() ou return false (boolean false)
Pour ignorer la ligne (toutes les colonnes de la ligne).
$this->skipRow() ou $this->skip() ou return false;
Pour ignorer la cellule ainsi que les cellules suivantes.
$this->skipCell() ou return true;
Pour ignorer la cellule.
Variable $cell
Vous pouvez appeler n'importe quelle colonne du fichier source en utilisant $cell. Il s'agit d'un tableau qui indexe chaque colonne numériquement (1,2,3,...) et avec une clé correspondant au nom de l'entête de la colonne ("name","description","price"...).
$cell["name of the column"] ou $cell[INDEX]
Par exemple :
return $cell["description"]. " ".$cell["name"]
Variable $self
$self
Pour récupérer la valeur de la colonne et contrôler les données :
<?php return $self;
Par exemple :
<?php return strtolower($self);
Exemples d'utilisation
Vous trouverez ci-dessous des exemples d'utilisation avec l'API PHP.
Changer le séparateur
Transformez un nombre à virgule avec un point à la place.
Par exemple :
<?php return number_format(str_replace(",",".",$self),2,".",""); ?>
Changer un texte en lettres minuscules ou majuscules
Changez un texte en lettres minuscules et ajoutez une lettre majuscule à la première lettre de chaque mot.
Par exemple :
<?php return ucwords(strtolower($self)); ?>
Récupérer des images
Récupérez seulement une image à partir d'une liste.
Par exemple :
<?php return array_pop(explode(",",$self)); ?>
Regrouper plusieurs colonnes
Additionnez plusieurs colonnes pour créer une description.
Par exemple :
<?php return $self." ".$cell["product_name"].", starting at $".$cell["price"]; ?>
Définir la visibilité d'un produit
Définissez la visibilité d'un produit selon la valeur d'une colonne.
Par exemple :
<?php
switch($self){
case "parent":
return "Catalog, Search";
break;
default:
return "Not visible individually";
}
?>
Mapper des valeurs à d'autres valeurs
Mappez les valeurs entre elles.
Par exemple :
<?php
if($self=="something"){
return "something else";
}
else if($self=="foo"){
return "bar";
}
else{
return "default value";
}
?>
Récupérer des valeurs basées sur des conditions
Récupère des valeurs basées sur différentes conditions.
Par exemple :
<?php
if ($self > 200) return "0";
else return $self;
?>