Mass Product Import & Update

 

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 :
System › Configuration › Wyomind › Mass 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

Vous permet de définir si vous souhaitez activer la fonction de reporting ou non.

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

Vous permet de définir le titre du message que verront les destinataires du reporting.

Settings

Enable log file

Vous permet d’activer le fichier de log disponible dans var/log.
Le fichier est nommé : 
Wyomind_MassStockUpdate.log

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 :
System › Import/Export › Mass 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

Pour avoir un aperçu de vos données sources, cliquez sur Input data.

Output Data

Pour avoir un aperçu des données telles qu'elles seront mises à jour, cliquez sur 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

  <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>

  Le XPath qui cible les produits dans le fichier ci-dessus est /Import/PRODUCTS/product

• 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::attributes

  parent::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,10

  Signifie 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

Indique le chemin du répertoire dans lequel les images à importer sont stockées.

• 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

Mass Product Import & Update vous permet de créer des catégories à la volée.  

• 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/Shirts

• 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.

APERÇU DE L'INTERFACE

1. 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. 
2. SUPPRIMEZ une ligne facilement.
3. Changez le sens de chaque ligne en utilisant le drag and drop.
4. Désactivez une ligne tout en conservant ses paramètres en cliquant sur le symbole  lIEN.
5. 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é.
6. Appliquez la couleur que vous souhaitez pour la ligne.
7. Appliquez le titre que vous souhaitez pour la ligne.
   
8. Définissez pour quelle(s) vue(s) magasin vous souhaitez appliquer ces paramètres en cliquant sur APPLY TO DEFAULT VALUE. 
9. Définissez pour quel(s) produit(s) vous souhaitez appliquer ces paramètres en cliquant sur APPLY TO THE CURRENT PRODUCT ONLY.
10. Prévisualisez votre fichier en cliquant sur  INPut Data.
11. Retrouvez tous les attributs regroupés par type dans la Library.
12. 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 :
System › Configuration › Wyomind › Mass PRODUCT IMPORT & Update › Settings

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 › configuration › Mass 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 :

1. L’analyse du fichier source, la collecte des données et la construction du fichier SQL d’import ou de mise à jour des produits.
2. 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 › Attributes › Manage 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 :
system › Manage 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

Les attributs de type yes/no, peuvent être mis à jour avec n'importe quelles valeurs parmi les suivantes :

• 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 › Attributes › Manage 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

Les valeurs booléennes peuvent être mises à jour avec n'importe quelles valeurs parmi les suivantes :

• 1 / 0
• yes / no
• true / false
• enable / disable
• enabled / disabled
• in stock / out of stock

in stock

Valeurs numériques

 Les valeurs numériques peuvent être :

• 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

Les valeurs booléennes peuvent être mises à jour avec n'importe quelle valeur parmi les suivantes :

• 1 / 0
• yes / no
• true / false
• enable / disable
• enabled / disabled
• in stock / out of stock

yes

Valeurs numériques

 Les valeurs numériques peuvent être :

• 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

Vous pouvez associer une image provenant de la galerie à l'un ou plusieurs des attributs 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 

Si vous disposez de vos propres attributs image dans votre boutique, ces attributs seront également visibles dans la section image.

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 Settings › Category 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

Chaque script doit inclure une balise ouvrante PHP <?php. Notez qu'il n'est pas nécessaire d'utiliser la balise fermante. 

<?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;
?>