ERP & Logistics Suite

Black Box

La black-box est un outil qui vous aidera à configurer votre mapping facilement. Cet outil est composé de 3 options majeures.

Input Data

Library

Output Data

Settings

Dans cette section, vous pouvez définir la source des données.

Profile settings

Définissez les paramètres pour votre profil.  

• Enabled
  Vous pouvez activer/désactiver le profil.
  Notez que le profil est désactivé par défaut s'il a été dupliqué.
• Profile Name
  Nom que vous souhaitez donner au profil. Seuls les caractères alphanumériques, les tirets et les underscores sont acceptés.
• 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 produit. Ce fichier peut être exécuté directement depuis votre base de données.
  Si vous activez le mode SQL, vous devrez remplir plusieurs champs :
• SQL file name
  Nom du fichier SQL à génerer. 
  

  XML_sample.sql

• SQL file path
  Il s'agit du chemin où le fichier SQL sera généré (par rapport au répertoire racine de Magento). 
  

  var/sample

• Profile method
  Vous pouvez choisir une action que le profil déclenchera :
  Mettre à jour les produits uniquement
  Importer des nouveaux produits uniquement
  Mettre à jour les produits et importer des nouveaux produits
• 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 + 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 
  

Lorsque l'option Profile method est configurée sur Update products and import new products, dans l'onglet Mapping & Rules  vous pouvez définir pour chaque attribut si la valeur s'applique sur les nouveaux produits, et/ou sur les produits existants :

• New products only
  Les produits nouveaux seulement
• Existing products only
  Les produits existants seulement
• Both, new and existing products
  Les produits nouveaux et déjà existants

File Location

Cette partie vous permet de définir où le fichier source est stocké ainsi que le chemin du fichier incluant le nom du fichier et l'extension tel qu'il apparait dans le système de fichiers du serveur. Notez que vous ne pourrez pas sauvegarder le chemin du fichier source si celui-ci n'est pas valide.

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 aussi utiliser les expressions régulières dans le nom du fichier.
• FTP server
  Le fichier est stocké sur un serveur distant accessible via FTP ou SFTP. Ne pas ajouter de préfixe au nom de domaine ou l'IP avec FTP://.
  Vous pourrez vérifier si la connexion FTP est valide.
  Chemin du fichier par rapport au répertoire racine de l'utilisateur FTP.
  Vous pouvez aussi utiliser les expressions régulières dans les noms de fichiers lorsqu'ils sont stockés sur un serveur FTP.
  
• URL
  Fichier disponible via une URL utilisant HTTP ou HTTPS. 
  Le chemin du fichier est l'URL du fichier . 
  

  http://www.website.com/Inventory/AvailableInventory

  
  Si vous utilisez une authentification HTTP, vous devez ajouter les identifiants avant l'URL comme ci-dessous :
  

  http://login:password@www.website.com/Inventory/AvailableInventory

  Pour ajouter un port spécifique, utilisez le format suivant:

  http://login:password@www.website.com:port/Inventory/AvailableInventory
  

• Webservice
  Le fichier est disponible via un server distant accessible en ligne. L'extension utilise la librairie CURL PHP pour connecter le service web.
  Le chemin du fichier est l'URL du webservice . 
  Vous pouvez fournir un login/mot de passe et des paramètres formatés comme suit :
  

  parameter1=value1&parameter2=value2&parameter3=value3

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

File Type

Vous permet de définir le type de fichier utilisé pour la mise à jour : XML, JSON ou CSV.

• File type
  Vous avez le choix entre des fichiers CSV, XML, et JSON.

Pour les fichiers CSV, définissez :

• Column separator
  Définissez le séparateur de colonnes.
• Text delimiter
  Sélectionnez le délimiteur de texte.
• The first line is a header
  Spécifiez lorsque la première ligne est une entête (pour les fichiers CSV seulement).
• Magento export file
  Les fichiers d'export par défaut de Magento sont composés de lignes vides avec des valeurs des lignes principales. En activant cette option, les valeurs seront alors fusionnées dans les lignes principales.

Pour les fichiers JSON et XML, définissez :

• Path to products
  Définissez le chemin qui cible les produits. Le chemin est sensible à la casse.
  Comment définir le chemin qui cible les produits de votre fichier XML ou JSON. 
• Data 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 seul niveau de nœuds.
  Si vous avez sélectionné Predefined structure, vous avez la possibilité de définir votre propre structure de fichier pour vos fichiers XML ou JSON.

Post Process Action

• Action
  Ne rien faire
  Supprimer le fichier d'import
  Déplacer le fichier d'import
• Move to folder
  Définir le chemin du fichier où vous souhaitez déplacer le fichier d'import, par rapport au répertoire racine de Magento.
  
• Run indexers
  Vous pouvez choisir d'exécuter les index après l'import.
  No : aucun index ne sera exécuté, vous devrez le faire à partir de la ligne de commande
  Only the required indexers : exécute automatiquement les index
  Only the selected indexers : vous laisse choisir quels index vous souhaitez exécuter
• Indexer to run
  Choisissez les index à exécuter : 
  

  catalogrule_rule
  catalogrule_product
  catalog_product_price
  cataloginventory_stock
  inventory
  catalog_product_attribute
  catalog_url
  catalogsearch_fulltext
  catalog_category_product
  catalog_product_category

Advanced Settings

System Settings

Vous avez plusieurs options :

• Ne rien faire
• Désactiver le produit
• Supprimer de manière permanente le produit
• Marquer le produit comme hors stock
• Marquer le produit comme hors stock et définir la quantité sur 0

Lorsque vous décidez de marquer les produits manquants comme hors stock, vous devez séléctionner les sources impactées par l'action dans Targeted Source.

Great lake Store

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 dans Targeted Products : 

• 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 status de stock (in stock / out of stock).
• Use relative quantity update
  La quantité sera ajoutée/soustraite de la quantité actuelle.
  

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 SSL
• Use active mode
• Host
• Port
• Login
• Password

Pour le serveur FTP et les système de fichiers Magento, définissez :

• Path to images directory

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

• New categories are children of
  Choisissez la catégorie parente.

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

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.
  Vous pouvez trouver tous les attributs regroupés par type dans notre documentation.
  La première ligne est là où vous définissez l'identifiant de vos produits). L'identifiant doit être unique. 
  

  SKU

• Data source
  Dans les données sources, vous pouvez définir l'attribut source qui correspond à l'attribut cible de votre fichier. 
  

  id

• Default value
  Parfois, plusieurs colonnes peuvent être manquantes. Par exemple, lors de la mise à jour des stocks, le fichier ne comprend pas toujours tous les attributs de stock (backorders, minimum quantity in the cart...). Dans ce cas, vous pouvez choisir des valeurs personnalisées depuis la colonne Data source et appliquer une valeur par défaut. 
  

  yes

APERÇU DE L'INTERFACE

1. Ajoutez autant de colonnes que vous le souhaitez en cliquant sur  + ADD A NEW ROW. 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é. Comment utiliser l'API PHP
6. Ajoutez votre propre règle de remplacement en cliquant sur l'icone  a b. Ces règles peuvent être prévisualisées dans l'output. Notez que lorsqu'il y a une règle de sélectionnée, a b  est souligné. Comment créer vos règles de remplacement. 
7. Appliquez la couleur que vous souhaitez pour la ligne.
8. Appliquez le titre que vous souhaitez pour la ligne.
9. Définissez pour quelle(s) vue(s) magasin vous souhaitez appliquer ces paramètres en cliquant sur  APPLY TO DEFAULT VALUE.
10. Définissez pour quel(s) produit(s) vous souhaitez appliquer ces paramètres en cliquant sur  APPLY TO THE CURRENT PRODUCT ONLY.
    Pour que ce paramètre apparaisse, l'option Create parent of configurable products on the fly doit être activée.
11. Définissez pour quel(s) produit(s) vous souhaitez appliquer ces paramètres en cliquant sur  Apply to Both, new and existing products.
    Pour que ce paramètre apparaisse, la méthode du profil doit être configurée sur Update products and import new products.
12. Prévisualisez votre fichier en cliquant sur  INPUT DATA.
13. Retrouvez tous les attributs regroupés par type dans la  LIBRARY.
14. 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 par défaut de 30 minutes entre chaque tâche planifiée.

Vous avez la possibilité de changer l'interval des tâches cron depuis l'onglet General Settings. 

Action History

Dans l'onglet Action History, vous pouvez trouver un historique des générations et configurations précédentes. 

Vous trouverez : 

• ID
  C'est l'identifiant de la ligne de l'historique. 
  
• Version ID
  C'est l'identifiant de la version de configuration du profil.
  
• Origin
  C'est l'origine de l'action : Backend / Cron / CLI / API
• Username
  Il s'agit du nom de l'utilisateur à l'origine de l'action.
• Action
  Les actions disponibles sont: create (créer) / generate (générer) / update (mettre à jour) / delete (supprimer)
  
• Details
  Si vous cliquez sur More details, vous pouvez voir le détail de la mise à jour du profil depuis une grille.
  

  

  Si vous cliquez sur une ligne de cette grille, vous pouvez alors voir les différences des champs mis à jour : en rouge sont affichées les données supprimées, en vert celles ajoutées.
  
  
  

  

• Date
  Il s'agit de la date de la modification.

Lire plus de documentation sur le module Mass Product Import & Update.

La boîte à outils ou Black Box

Mass Order Export comporte un outil qui vous permettra de configurer votre profil comme vous le souhaitez. Lorsque vous éditez un profil, vous trouverez des outils sur la droite de la fenêtre.

En ouvrant cette boîte, vous pouvez voir deux onglets.

Library

Preview

Configuration du profil

Pendant la création ou la modification d'un profil export dans Mass Order Export, vous devez prêter attention à quelques réglages de base.

Configuration

• File name
  C'est le nom de base des fichiers exportés (ex : myOrders). Nul besoin d'ajouter une extension de fichier (xml, csv, txt), l'extension le fait automatiquement pour vous.
• Encoding type
  Choisissez le type d'encodage.
       UTF-8 : Il s'agit du format le plus utilisé
       UTF-8 without BOM : En savoir plus sur les BOM
       ANSI
• File type
  Il s'agit du réglage principal qui définit si vous souhaitez un fichier de type XML ou de type CSV/TXT. Selon ce réglage, le template sera différent.
• File name format
  Le nom de votre fichier peut être complété avec la date du jour de l'export. Différents formats sont disponibles.
• Create one file for each order
  Choisissez d'exporter une commande par fichier ou non.
• File name suffix
  Lorsque vous choisissez d'exporter une commande par fichier, vous devez sélectionner un suffixe de nom de fichier.
• Add a counter as the 1st column
  Définissez ou non la première colonne comme un compteur.
• Increment column header
  Définissez un nom pour la première colonne (compteur).

Products to export

Choisissez les types de produits que vous souhaitez inclure dans votre export.

Orders to export

Cette partie vous donne la possibilité de définir quel groupe de commandes doit être exporté.

• Export from Store view
  Vous permet de choisir une ou plusieurs vues de magasin depuis votre ou vos magasin(s) en ligne lors du processus d'export.
• Start with order #
  Vous permet de définir un numéro de commande depuis lequel le processus d'export commencera.
• Register the last exported #
  Vous permet dans le champ Start with order # d'enregistrer automatiquement la dernière commande exportée.
• Mark each exported order
  Vous permet de signaler chaque commande exportée comme 'exporté' dans :
  Sales › Operations › Orders
• Export only unmarked orders
  Vous permet de définir que seulement les commandes qui n'ont pas encore été signalées doivent être exportées.

• Update the order status
  Vous permet de mettre à jour le statut de la commande.

Dans le cas où cette dernière option est définie sur YES, deux nouveaux champs sont ajoutés à la configuration :

• New order status
  Vous permet de définir un statut pour la commande.
• Message in the order history
  Vous pouvez également définir un message dans l'historique de la commande.

Template

Dans cet onglet, vous pourrez configurer le template de votre profil comme vous le souhaitez. Mass Order Export vous permet de créer différents types de fichiers :

• XML
• CSV
• TXT
• TSV
• DIN

Paramètres de fichiers d'export XML

Vous pouvez sélectionner un fichier de type XML.

• File type
  XML
• Enclose XML tag content inside CDATA
  Choisissez d'encadrer le contenu de vos balises XML avec CDATA afin d'éviter les problèmes dus aux caractères spéciaux tels que < (plus petit que), > (plus grand que) ou & (esperluette). Cette option est recommandée.

Template de fichier XML

Un template XML est composé de 3 parties :

• Header
  Il comprend le haut du fichier : 

  <orders>

• Body 
  Il est itéré pour chaque commande y compris dans le fichier :
  

  <order>
  ...
  </order>​​

• Footer
  Il comprend le bas du fichier :
  

  </orders>

La structure XML permet d'utiliser une syntaxe itérative dans différentes parties du template, comme ci-dessous :

<items>
<?php foreach($products as $product): ?>
<item id={{product.item_id}}>{{product.name}}</item>
<weight>{{product.weight}}</weight>
<?php endforeach; ?>
</items>

Dans la plupart des cas, les commandes contiennent plus d'un produit donc il peut s'avérer être utile de créer une itération qui boucle pour chaque produit commandé. Tout le contenu entre les caractères d'ouverture et de fermeture sera répété pour chaque produit et toutes les valeurs dynamiques seront remplacées :

<?php foreach($products as $product): ?>
...
<?php endforeach; ?>

Ces repères d'iteration peuvent être utilisés pour toutes les instances de commande :

<?php foreach($payments as $payment): ?>
...
<?php endforeach; ?>
<?php foreach($invoices as $invoice): ?>
...
<?php endforeach; ?>
<?php foreach($shipments as $shipment): ?>
...
<?php endforeach; ?>
<?php foreach($creditmemos as $creditmemo): ?>
...
<?php endforeach; ?>

Paramètres de fichiers d'export CSV/TXT/TSV/DIN

Le fichier peut être de type CSV, TXT, TSV ou DIN. Vous avez la possibilité de créer des fichiers simples ou avancés.

• File format: Advanced format
  Il se compose d'une structure de fichiers complexe divisée en plusieurs parties.

• File format: Basic format 
  Il se compose d'un header optionnel ainsi que de plusieurs rangs qui appliqueront le même template.
• Include header
  Vous permet d'inclure ou non le nom des colonnes dans la première ligne de votre fichier CSV/TXT.

• Delimiter character
  Vous laisse choisir quel type de séparateur vous souhaitez utiliser pour délimiter vos champs.
• Enclosure character
  Vous permet de choisir quel type de caractère d'encadrement vous souhaitez utiliser pour vos données.
• Escape character
  Vous permet de choisir quel caractère d'échappement vous souhaitez utiliser pour vos données.

Template de fichier CSV/TXT/TSV/DIN

L'onglet template sera mis à jour pour correspondre au type de fichier que vous avez sélectionné.

Basic file format

Le format de fichier basique pour les fichiers de type TXT est composé d'un header optionnel et de plusieurs rangs qui appliquent le même template.

• Extra Header
  Il s'agit de rang(s) additionnel(s) qui seront ajoutés au début du fichier.
• Header
  C'est pour le nom de l'attribut qui peut être affiché au début du fichier.
• Field Pattern
  Fonctionne de la même manière que les fichiers XML. Vous pouvez ajouter du code PHP si vous souhaitez personnaliser le template. Vous devez simplement écrire votre code PHP sur une ligne.
• Insert a new field
  Vous pouvez ajouter un champ en utilisant ce bouton. Les champs peuvent être réorganisés facilement en utilisant les flèches.
• Extra Footer
  Il s'agit de rang(s) additionnel(s) qui seront ajoutés à la fin du fichier.

La principale différence avec le mode XML est que vous ne pouvez utiliser aucunes instructions d'itération. Par contre, Mass Order Export utilise un processus interne d'auto-consolidation à la place. Cela signifie que si vous essayez d'obtenir la valeur d'un attribut d'une instance (un produit par exemple) qui contient plusieurs articles, l'extension va automatiquement dupliquer la ligne TXT/CSV pour chaque article.

Avec la configuration suivante :

Logiquement, le module devrait exporter une ligne pour chaque commande, mais quelques commandes peuvent contenir plusieurs articles de produit. L'extension va créer plusieurs lignes pour la même commande, comme dans l'exemple suivant :

Order#         Product Name          Product Sku
#10000001      my product A          AAA
#10000001      my product B          BBB
#10000001      my product C          CCC
#10000002      my product D          DDD
#10000003      my product B          BBB
#10000003      my product E          EEE
...

Advanced file format

Le format de fichier avancé pour les fichiers de type TXT est composé d'une structure de fichiers complexes divisés en plusieurs parties.

• Extra Header
  Il s'agit de rang(s) supplémentaire(s) du header qui seront ajoutés en début du fichier.
• Body
  Il est itéré pour chaque commande.
• Extra Footer
  Il s'agit de rang(s) supplémentaire(s) du footer qui seront ajoutés à la fin du fichier.

Ce format permet d'utiliser une syntaxe itérative dans différentes parties du template comme suit :

<?php foreach($products as $product): ?>
PRODUCT=
{{product.sku}}
{{product.qty_ordered}}
{{product.base_row_total output="number_format($self,2)"}}$
<?php endforeach; ?>

Filters

Dans l'onglet Filters, vous pouvez définir les types de commandes et de clients que vous souhaitez inclure dans votre profil d'export. Vous avez aussi la possibilité de créer des filtres plus avancés afin d'affiner votre configuration.

Order status

Ici, vous pouvez définir le type de commande que vous souhaitez exporter. Vous devez sélectionner au moins un statut.

Customer Group

Dans cet onglet, choisissez les groupes de clients des commandes que vous souhaitez exporter. Au moins un groupe de client doit être sélectionné.

Advanced Filters

Dans cet onglet, vous pouvez configurer des filtres beaucoup plus précis. Par exemple, choisissez d'exporter seulement une commande bien spécifique :

order > increment_id | = | ID de votre commande

Vous pouvez également exporter les commandes effectuées par des clients dont le nom de famille se termine par 'son' :

order > customer_lastname | like | %mind

Vous avez plusieurs options :

• =, >, <...
  Egale à, supérieur à, inférieur à, supérieur ou égale à, inférieur ou égale à, différent de.
• LIKE / NOT LIKE
  like : commence par / se termine par / inclue la chaîne de caractère.
  not like : ne commence pas / ne se termine pas / n'inclue pas la chaîne de caractère.
• IS NULL / IS NOT NULL
  is null : la valeur est nulle.
  is not null : la valeur n'est pas nulle.
• IN / NOT IN
  in : se trouve dans (sélection de plusieurs options).
  not in : ne se trouve pas dans (sélection de plusieurs options).
• REGULAR EXPRESSION / FIND IN SET
  Utilisez les expression régulières pour décrire un ensemble de chaînes de caractères possibles.

Output

Avec Mass Order Export, vous avez plusieurs possibilités pour exporter les profils des commandes.

Storage settings

La première solution est de stocker le fichier directement sur votre serveur.

FTP settings

Vous pouvez également configurer des paramètres FTP pour uploader le profil généré sur un serveur FTP externe... Par exemple :

• Upload by FTP
  Sélectionnez Yes si vous souhaitez télécharger votre profil via FTP.
• Host
  Dans ce champ, indiquez le serveur. Par exemple : wyomind.com.
• Login
  Il s'agit de votre login pour vous connecter au serveur.
• Password
  Il s'agit de votre mot de passe pour accéder au serveur.
• Destination directory
  C'est le chemin depuis le répertoire d'entrée lorsque vous vous connectez au FTP. Par exemple : "/var/export/ftp".
• Use SFTP
  Sélectionnez Yes si vous utilisez un protocol SFTP.
• Use Active mode
  Si vous utilisez le protocol SFTP, vous n'avez pas à vous préoccuper du mode actif/passif.

Email settings

Enfin, vous pouvez choisir d'envoyer vos profils par email. N'oubliez pas de séparer les adresses email d'une virgule.

Cron Schedule

Dans cet onglet, vous pouvez choisir les jours et heures auxquels vos profils seront générés.

Lire plus de documentation sur le module Mass Order Export.

La Toolbox

La toolbox est très utile pour vous aider à configurer le fichier de mise à jour plus rapidement.

Retrouvez ci-dessous les différentes options de la toolbox.

Input data

Execution preview

Différentes notifications peuvent être affichées :

• Order not found
  La commande est introuvable dans votre instance Magento.
• Order is not...
  La commande ne peut pas être expédiée, facturée...
• Conditions not fulfilled for rule ***
  La commande ne répond pas aux conditions pour la règle.
• Trying to ...
  La commande remplit les conditions pour la règle, et l'action sera traitée sur la commande.

Paramètres

Paramètres du profil d'import

Définissez les paramètres pour votre profil.

• Profile Name
  Le nom du profil doit être unique.
• Filter lines
  Laissez vide pour importer toutes les lignes :
  

  Signifie que toutes les lignes seront importées

  
  Entrez le numéro des lignes que vous souhaitez importer en séparant chaque ligne ou groupe de lignes par une virgule :
  

  2,4,6,8,10

  Signifie que les lignes 2,4,6,8,10 seront importées

  
  Utilisez le tiret (-) pour définir un groupe de lignes :
  

  8-10

  Signifie que les lignes 8,9,10 seront importées

  
  Utilisez un plus (+) pour importer toutes les lignes à partir d'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 :
  

  #0000002[0-9]+#
  

  Signifie que toutes les lignes avec l'identifiant correspondant à l'expression régulière seront importées

Emplacement du fichier

Cette section vous permet de spécifier la localisation du fichier source. Vous avez plusieurs options :

• Magento File System
  Le fichier est stocké dans le répertoire racine de Magento ou un sous-répertoire.
  Le chemin du fichier est relatif au dossier racine de Magento.
• FTP server
  Le fichier est stocké sur un serveur distant disponible via FTP ou SFTP. Ne préfixez pas le nom de domaine ou l'adresse IP avec FTP://.
  Vous pourrez vérifier également vérifier si la connexion FTP est valide.
  Le chemin du fichier est relatif au dossier racine de l'utilisateur FTP
• URL
  Le fichier est stocké sur un serveur distant disponible via HTTP ou HTTPS.
  Remplissez le chemin du fichier avec l'URL du fichier.
• Webservice
  Le fichier est disponible sur un serveur distant accessible via un service web.
  Remplissez le chemin du fichier avec l'URL du service web.
  L'extension utilise la librairie CURL PHP pour se connecter au service. Vous pouvez fournir un login/password ainsi que n'importe quel paramètre comme ci-dessous :
  

  parameter1=value1&parameter2=value2&parameter3=value3

• Dropbox
  Remplissez le chemin du fichier avec l'URL du service dropbox.
  Générez votre token depuis votre compte Dropbox : https://www.dropbox.com/developers/apps

• File path
  Le chemin du fichier comprenant le nom du fichier et l'extension comme elle est affichée dans le système de fichier du serveur. 
  Vous pouvez aussi utiliser les expressions régulières dans le nom du fichier.
  
  

Identification des commandes

Choisissez comment vos commandes seront identifiées dans le fichier d'import :

• Order identification
  Vous avez la possibilité de choisir l'identifiant de commande ou l'incrément de commande.
  

  3420

  ou
  

  1000003421

• Identifier offset
  Vous devez sélectionner le champ qui contient l'identifiant de la commande.

Type de fichier

Ceci vous permet de définir le type de fichier utilisé entre un fichier XML et CSV.

Pour les fichiers CSV, définissez :

• Column separator
  Le séparateur des colonnes
• Text delimiter
  Le délimiteur de texte
• The first line is a header
  Si la première ligne est l'entête

Pour les fichiers XML, définir :

• Xpath to orders
  Dans le cas d'une mise à jour depuis un fichier XML, remplissez le XPath qui cible les commandes. 
  Le Xpath est sensible à la casse.
• XML structure
  Vous avez deux options; la détection automatique (Automatic detection) ou la structure prédéfinie (Predefined structure).
  La détection automatique convient aux fichiers composés d'un niveau de nœuds seulement.
• 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 complexe, l'information peut être dispatchée dans des nœuds plus profonds et quelques fois dans des attributs de balise comme :
  

  url="quelque chose"
  

  
  
  Ci-dessous, vous trouverez un exemple de fichier pour lequel vous pourriez avoir besoin d'une structure prédéfinie :
  

  <orders>
   <order>
    <CustomerOrderId>000000028</CustomerOrderId>
    <order-shipment>
     <OrderTrackingNumber>334678MCLK</OrderTrackingNumber>
     <OrderCarrier>ups</OrderCarrier>
     <OrderTrackingURL>https://www.fedex.com/apps/fedextrack/?action=track&amp;trackingnumber=334678MCLK&amp;cntry_code=us&amp;locale=en_US</OrderTrackingURL>
    </order-shipment>
   </order>
  </orders>

  Le XPath qui cible les commandes dans le fichier ci-dessus est /orders/order

  La syntaxe JSON à utiliser est :
  

  {
  "incrementid":"CustomerOrderId",
  "tracking_number":"order-shipment/OrderTrackingNumber",
  "carrier":"order-shipment/OrderCarrier"
  }

Action Post Process

Vous pouvez définir une action qui sera traitée après l'exécution.

• Action
  Do Nothing : Ne rien faire
  Delete the import file : Supprimer le fichier d'import
  Move import file : Déplacer le fichier d'import
• Move to folder
  Définir le chemin du fichier où déplacer le fichier d'import par rapport au répertoire racine de Magento.
  

Règles

Dans cette section, vous pouvez définir vos propres règles et leur donner un nom. 

Une règle est une combinaison de 0 à n conditions et de 1 à n actions. Les règles sont testées pour chaque commande correspondant à un élément du fichier. Si les conditions sont remplies pour l'élément en cours, alors les actions de la règle seront exécutées pour la commande.

S'il n'y a pas de condition pour une règle, les actions sont alors toujours exécutées pour la commande.

Aperçu de l'interface

Retrouvez ci-dessous un aperçu de la section Rules. 

1. Activez ou désactivez la règle en cliquant sur le symbole  LIEN .
2. Appliquez un titre à la règle.
3. Ajoutez une condition à votre règle en cliquant sur  +. 
4. Supprimez une condition de la règle.
5. Ajoutez une action. 
6. Supprimez une action de la règle.
7. Changez l'ordre de chaque ligne en utilisant le glisser-déposer.
8. Appliquez un titre à l'action.
9. Appliquez une couleur à l'action.
10. Appliquez un script personnalisé  </> sur les options des actions.
    Ces scripts peuvent être prévisualisés. 
    Comment utiliser l'API PHP
11. Prévisualisez votre fichier en cliquant sur  INPUT DATA.
12. Vérifiez les actions qui seront traitées sur vos commandes en cliquant sur  Execution preview.

Conditions

Vous pouvez définir des conditions selon :

• le fichier : les conditions sont basées sur les informations disponibles dans le fichier source
• la commande : les conditions sont basées sur les données des commandes

Vous avez la possibilité de définir des conditions selon plusieurs options, telles que :

• EQUAL : Égale à
  NOT EQUAL : Différent de
• GREATER : Supérieur à
  LOWER : Inférieur à
• GREATER OR EQUAL : Supérieur ou égale à
  LOWER OR EQUAL : Inférieur ou égale à
• LIKE : commence par / se termine par / inclue la chaîne de caractère
  NOT LIKE : ne commence pas / ne se termine pas / n'inclue pas la chaîne de caractère
• IS NULL : la valeur est nulle.
  IS NOT NULL : la valeur n'est pas nulle.
• IN : se trouve dans (sélection de plusieurs options)
  NOT IN : ne se trouve pas dans (sélection de plusieurs options)

Actions

Vous pouvez sélectionner l'une des actions suivantes : 

• Set status
  Vous devrez sélectionner le statut (select the status) que vous souhaitez appliquer aux commandes. 
  

  

• Add comment
  Vous pouvez définir le commentaire (comment) que vous souhaitez ajouter aux commandes ainsi que si vous souhaitez envoyer l'email (send the comment email) et rendre ce commentaire visible dans le compte du client en front-end (make the comment visible on the front-office, in the customer account).

  

• Invoice
  Vous pouvez définir si vous souhaitez envoyer la facture (send the invoice) et l'email.
  

  

• Creditmemo
  Vous pouvez définir si vous souhaitez envoyer l'avoir (send the credit memo) et l'email.
  

  

• Ship
  Définissez le livreur (carrier), le titre (title), le numéro de suivi (tracking number), la source à utiliser lorsque MSI est activé (source to use) et si vous souhaitez envoyer un email (send shipping email).
  

  

• Cancel
  Définissez si vous souhaitez annuler la commande. 
  

  

Tâches planifiées

Vous pouvez exécuter le profil chaque jour de la semaine avec un interval par défaut de 30 minutes entre chaque exécution.

Cet interval est modifiable dans les paramètres généraux : 
Stores › Settings › Configuration › Wyomind › Mass Order Update

Lire plus de documentation sur le module Mass Order Update.