Import et export planifiés

Fonctionnalité Adobe Commerce {width="20"} Fonctionnalité exclusive uniquement dans Adobe Commerce (En savoir plus)

Les imports et exports planifiés peuvent être exécutés sur une base quotidienne, hebdomadaire ou mensuelle. Les fichiers à importer ou exporter peuvent résider sur des serveurs Adobe Commerce locaux ou sur des serveurs FTP distants. L’importation/exportation planifiée est implémentée par défaut et ne nécessite pas de configuration supplémentaire. Tous les imports et exports planifiés sont gérés par le planificateur de tâches Cron.

Accès à l’importation/exportation planifiée

  1. Sur la barre latérale Admin, accédez à System > Data Transfer>Scheduled Imports/Exports.

    Importation/exportation de données planifiées {width="700" modal="regular"}

  2. Pour créer une tâche d’importation ou d’exportation planifiée, cliquez sur le bouton approprié et suivez les instructions correspondant au type de tâche planifiée.

  3. Lorsque l’enregistrement est enregistré, la tâche s’affiche dans la grille Scheduled Import/Export.

    note note
    NOTE
    Lorsque vous créez ou mettez à jour une importation/exportation planifiée, la configuration du système change. Après l’enregistrement, veillez à respecter l’avis d’invalidation du cache qui s’affiche en haut de la page Admin et à vider le cache afin d’appliquer la planification nouvelle ou mise à jour.
  4. Après chaque tâche planifiée, une copie du fichier est placée dans le répertoire var/log/import_export sur le serveur local Adobe Commerce.

    Les détails de chaque opération ne sont pas écrits dans le journal. Si une erreur se produit, une notification est envoyée de la tâche d’importation/exportation ayant échoué, avec une description de l’erreur.

Planification d’une importation

Pour le format de fichier d’importation disponible et les types d’entités d’importation, le processus d’importation planifié est similaire au processus d’importation manuelle :

  • Le fichier d’importation doit être au format .CSV
  • Vous pouvez importer des données sur les produits et les clients.

L’avantage de l’import planifié est que vous pouvez importer automatiquement un fichier de données plusieurs fois après avoir spécifié les paramètres d’import et planifier une seule fois.

Les détails de chaque opération d’importation ne sont pas écrits dans un journal, mais en cas d’échec, vous recevez un e-mail Import Failed avec une description de l’erreur. Le résultat de la dernière tâche d’importation planifiée s’affiche dans la colonne Dernier résultat de la page Importation/Exportation planifiée .

Après chaque opération d’importation, une copie du fichier d’importation est placée dans le répertoire var/log/import_export sur le serveur sur lequel Adobe Commerce ou Magento Open Source est déployé. L'horodatage, le marqueur de l'entité importée (produits ou clients) et le type d'opération (dans ce cas, import) sont ajoutés au nom du fichier d'import.

Après chaque tâche d’importation planifiée, une opération de réindexation est effectuée automatiquement. En amont, les modifications apportées aux descriptions et aux autres informations textuelles sont répercutées une fois les données mises à jour récupérées dans la base de données, et les modifications apportées aux prix ne sont répercutées qu’après l’opération de réindexation.

Etape 1 : paramétrage de l'import

  1. Sur la barre latérale Admin, accédez à System > Data Transfer>Scheduled Import/Export.

  2. Dans le coin supérieur droit, cliquez sur Add Scheduled Import.

  3. Définissez les options de planification et d’importation :

    • Name — Saisissez un nom pour l’importation planifiée.

    • Description — Entrez une brève description qui explique l’objectif de l’importation et son utilisation.

    • Entity Type — Définissez sur l’une des options suivantes :

      • Products
      • Advanced Pricing
      • Customers and Addresses (single file)
      • Customer Addresses
      • Customer Finances
      • Customers Main File
      • Stock Sources
    • Import Behavior — Définissez sur l’une des options suivantes :

      • Add/Update Complex Data — Ajoute ou met à jour de nouvelles données complexes aux données complexes existantes pour les entrées existantes dans la base de données. Il s’agit de la valeur par défaut.
      • Replace — Écrit sur le complexe existant pour les entités existantes dans la base de données.
      • Delete Entities — Supprime les entrées existantes dans la base de données.
      • Custom Action - Personnalise les entités existantes dans la base de données.
      note note
      NOTE
      Pour les types d’entités Advanced Pricing,Products, Customers and Addresses (single file) ​et​_Stock Sources_, ces comportements d’importation s’affichent : Add/Update, Replace et Delete. Pour les types d'entités Customer Finances, Customers Main File et Customers and Addresses, ces comportements d'importation s'affichent : Add/Update Complex Data, Delete Entities et Custom Action.
    • Start Time — Défini sur l’heure, la minute et la seconde auxquelles l’importation est planifiée pour commencer.

    • Frequency — Défini sur l’une des valeurs suivantes : Daily, Weekly ou Monthly

    • On Error - Défini sur l’une des valeurs suivantes : Stop Import ou Continue Processing

    • Status — Pour activer l’importation planifiée, définissez sur Enabled.

    • Field Separator — Entrez le caractère utilisé pour séparer les champs dans le fichier d’importation. Le caractère par défaut est une virgule.

    • Multiple Value Separator — Entrez le caractère utilisé pour séparer plusieurs valeurs dans un champ.

    Importation de données - paramètres d’importation planifiés {width="600" modal="regular"}

Etape 2 : renseigner les informations sur le fichier d'import

  1. Définissez Server Type sur l’une des options suivantes :

    • Local Server - Importe les données du même serveur que celui sur lequel Adobe Commerce est installé.
    • Remote FTP - Importe les données d’un serveur distant.

    Importation de données - informations de fichier d’importation planifié {width="600" modal="regular"}

    note note
    NOTE
    Lorsque le module de stockage distant est activé, Local Server passe automatiquement à Remote Storage.
  2. Saisissez le File Directory d’où provient le fichier d’importation.

    • Local Server - Entrez un chemin relatif dans l’installation de Commerce. Par exemple, var/import. Si le module de stockage à distance est configuré, utilisez import_export/import.
    • Remote FTP server - Entrez l’URL complète et le chemin d’accès au dossier d’importation sur le serveur distant.
  3. Saisissez le File Name à importer.

  4. Pour Images File Directory, saisissez le chemin d’accès au répertoire dans lequel les images de produit sont stockées.

    Sur un serveur local, saisissez un chemin relatif tel que : var/import. Sur un stockage distant, saisissez un chemin relatif tel que : import_export/import ou import_export/import/some/dir.

Etape 3 : configurer l'import des emails en échec

Import de données - échec de l’importation des emails échoués

  1. Définissez Failed Email Receiver sur le contact du magasin qui doit recevoir la notification si une erreur se produit pendant l’importation.

  2. Définissez Failed Email Sender sur le contact du magasin qui apparaît comme l’expéditeur de la notification.

  3. Définissez Failed Email Template sur le modèle utilisé pour la notification.

  4. Pour Send Failed Email Copy To, saisissez l’adresse électronique de toute personne devant recevoir une copie de la notification.

    Séparez plusieurs adresses électroniques par une virgule.

  5. Définissez Failed Email Copy Method sur l’une des options suivantes :

    • Bcc - Envoie une copie de courtoisie aveugle de la notification d’importation ayant échoué. Le nom et l’adresse du destinataire sont inclus dans la distribution de l’email d’origine, mais sont masqués de la vue.
    • Separate Email - Envoie une copie de la notification d’importation ayant échoué sous la forme d’un email distinct.
  6. Une fois l’opération terminée, cliquez sur Save.

    La nouvelle tâche d’importation planifiée est ajoutée à la liste sur la page Scheduled Import/Export. À partir de cette page, il peut être exécuté immédiatement pour le test et modifié. Le fichier d'import est validé avant l'exécution de chaque traitement d'import.

NOTE
Lorsque vous créez ou mettez à jour une importation/exportation planifiée, la configuration du système change. Après l’enregistrement, veillez à respecter l’avis d’invalidation du cache qui s’affiche en haut de la page Admin et à vider le cache afin d’appliquer la planification nouvelle ou mise à jour.

Descriptions des champs

Import Settings

Champ
Description
Name
Nom de l’importation. Permet de le distinguer si de nombreux imports planifiés différents sont créés.
Description
(Facultatif) Vous pouvez saisir une description.
Entity Type
Définit les données à importer.
Import Behavior
Définit comment les données complexes sont traitées si les entités importées existent dans la base de données. Les données complexes relatives aux produits comprennent les catégories, les sites web, les options personnalisées, les prix de niveau, les produits associés, les ventes incitatives, les ventes croisées et les données sur les produits associés. Les données complexes pour les clients incluent les adresses. Options :
Add/Update Complex Data- Les nouvelles données complexes sont ajoutées ou mises à jour aux données complexes existantes pour les entrées existantes dans la base de données. Il s’agit de la valeur par défaut.
Add/Update - De nouvelles données sont ajoutées aux entrées existantes dans la base de données. Tous les champs, à l’exception de sku, peuvent être mis à jour pour les produits. Toutes les valeurs de champs multiples qui ne sont pas répertoriées dans le fichier CSV, telles que les catégories ou les sites web, restent dans la base de données après l’importation.
Replace- Les données complexes existantes pour les entités existantes sont remplacées.
Delete Entities - Si des entités importées existent dans la base de données, elles sont supprimées de la base de données.
Custom Action- Les entités complexes existantes sont personnalisées pendant le processus d’importation.
Start Time
Définissez l’heure de début, les minutes et les secondes de l’importation.
Frequency
Définissez la fréquence d’exécution de l’importation. Options : Daily / Weekly / Monthly
On Error
Définissez le comportement du système au cas où des erreurs seraient détectées lors de la validation du fichier. Options :
Arrêter l’importation — Le fichier n’est pas importé si des erreurs sont détectées lors de la validation. Il s’agit de la valeur par défaut.
Continuer le traitement - Si des erreurs sont détectées lors de la validation, mais que l’importation est possible, le fichier est importé.
Status
L’importation est activée par défaut. Vous pouvez le suspendre en définissant l’état sur Disabled.
Field Separator
Détermine le caractère utilisé pour séparer les champs. Valeur par défaut : , (virgule)
Multiple Value Separator
Détermine le caractère utilisé pour séparer plusieurs valeurs dans un champ. Valeur par défaut : , (virgule)

Import File Information

Champ
Description
Server Type
Vous pouvez importer depuis un fichier sur le même serveur que celui sur lequel Commerce est déployé (sélectionnez Local Server) ou depuis le serveur FTP distant (sélectionnez Remote FTP). Si vous sélectionnez Remote FTP, des options supplémentaires pour les informations d’identification et les paramètres de transfert de fichiers s’affichent. Si le module de stockage distant est activé, le type Local Server est automatiquement activé sur Remote Storage.
File Directory
Spécifiez le répertoire dans lequel se trouve le fichier d’importation. Si Server Type est défini sur Local Server, spécifiez le chemin d’accès relatif au répertoire d’installation de Commerce. Par exemple : var/import ou import_export/import pour le stockage à distance.
File Name
Indiquez le nom du fichier d'importation.
Images File Directory
Entrez le chemin d’accès au répertoire dans lequel les images de produit sont stockées. Pour un serveur local, saisissez un chemin relatif. Par exemple : var/import ou import_export/import pour le stockage à distance.

Import Failed Emails

Champ
Description
Failed Email Receiver
Indiquez l’adresse électronique à laquelle une notification électronique (message électronique d’importation en échec) est envoyée en cas d’échec de l’importation.
Failed Email Sender
Indiquez l’adresse électronique utilisée comme expéditeur de l’e-mail d’importation qui a échoué.
Failed Email Template
Sélectionnez un modèle pour le courrier électronique importé en échec. Par défaut, seule l’option Échec de l’importation (modèle par défaut à partir des paramètres régionaux) est disponible. Les modèles personnalisés peuvent être créés sous System>Transactional Emails.
Send Failed Email Copy To
Adresse électronique à laquelle une copie du courrier électronique d’importation a échoué est envoyée.
Send Failed Email Copy Method
Sélectionnez la méthode d'envoi de copie pour l'email importé en échec.

Planification d’une exportation

L’exportation planifiée est similaire à une exportation manuelle dans le format de fichier d’exportation disponible et les types d’entités qui peuvent être exportés :

  • Vous pouvez effectuer une exportation au format CSV.
  • Vous pouvez exporter des données sur les produits et les clients

L’avantage de l’utilisation de l’option Exportation planifiée est que vous pouvez exporter les données plusieurs fois automatiquement, après avoir spécifié les paramètres d’exportation, et ne planifier qu’une seule fois.

Les détails de chaque exportation ne sont pas écrits dans un journal, mais en cas d’échec, vous recevez un email Export Failed (Échec de l’exportation), qui contient la description de l’erreur. Le résultat de la dernière tâche d’exportation apparaît dans la colonne Dernier résultat de la page Importation/Exportation planifiée .

Après chaque exportation, le fichier d’exportation est placé à l’emplacement défini par l’utilisateur et une copie dans le répertoire var/log/import_export sur le serveur sur lequel Adobe Commerce ou Magento Open Source est déployé. L’horodatage et le marqueur de l’entité exportée (produits ou clients) et le type d’opération (dans ce cas, export) sont ajoutés au nom du fichier d’export.

Étape 1 : Définition des paramètres d’exportation

  1. Sur la barre latérale Admin, accédez à System > Data Transfer>Scheduled Import/Export.

  2. Dans le coin supérieur droit, cliquez sur Add Scheduled Export et procédez comme suit :

    • Saisissez un Name pour l’exportation planifiée.

    • Saisissez un résumé Description expliquant l’objectif de l’exportation et la manière dont elle doit être utilisée.

    • Définissez Entity Type sur l’une des options suivantes :

      • Advanced Pricing
      • Products
      • Customer Financing
      • Customers Main File
      • Customer Addresses
      • Stock Sources

      La section Entity Attributes ​au bas de la page est mise à jour pour prendre en compte le type d’entité sélectionné.

    • Définissez Start Time sur l’heure, la minute et la seconde auxquelles l’exportation est planifiée pour commencer.

    • Définissez Frequency sur l’une des options suivantes :

      • Daily
      • Weekly
      • Monthly
  3. Pour activer l’exportation planifiée, définissez Status sur Enabled.

  4. Acceptez CSV comme valeur par défaut File Format.

    Paramètres d’exportation planifiés {width="600" modal="regular"}

Etape 2 : renseigner les informations sur le fichier d'export

  1. Définissez Server Type sur l’une des options suivantes :

    • Local Server - Pour enregistrer le fichier d’exportation sur le même serveur que celui sur lequel Commerce est installé.
    • Remote FTP — Pour enregistrer le fichier d’exportation sur un serveur distant.

    Informations sur les fichiers d’exportation planifiés {width="600" modal="regular"}

    note note
    NOTE
    Lorsque le module de stockage distant est activé, le Local Server passe automatiquement à Remote Storage.
  2. Pour File Directory, saisissez le répertoire dans lequel le fichier d'export doit être enregistré comme suit :

    • Pour Local Server, saisissez un chemin relatif dans l’installation de Commerce, par exemple var/export. Si le module de stockage distant est configuré, utilisez import_export/export.
    • Pour Remote FTP server, saisissez l’URL complète et le chemin d’accès au dossier cible sur le serveur de destination.
  3. Si le serveur Remote FTP ​est sélectionné, saisissez les informations de connexion au serveur et sélectionnez des paramètres supplémentaires :

    • Pour FTP Host[:Port], saisissez l’adresse d’hôte FTP distante.
    • Pour User Name, saisissez le nom d’utilisateur utilisé pour accéder au serveur distant.
    • Pour Password, saisissez le mot de passe du compte de nom d’utilisateur fourni.
    • Pour File Mode, choisissez Binary ou ASCII.
    • Pour Passive Mode, choisissez No ou Yes.

Etape 3 : configuration des emails d'échec d'export

  1. Définissez Failed Email Receiver sur le contact du magasin qui doit recevoir la notification si une erreur se produit pendant l’exportation.

  2. Définissez Failed Email Sender sur le contact du magasin qui apparaît comme l’expéditeur de la notification.

  3. Définissez Failed Email Template sur le modèle utilisé pour la notification.

  4. Pour Send Failed Email Copy To, saisissez l’adresse électronique de toute personne devant recevoir une copie de la notification.

    Pour plusieurs adresses électroniques, séparez-les par une virgule.

  5. Définissez Failed Email Copy Method sur l’une des options suivantes :

    • Bcc - Envoie une copie de courtoisie pour aveugles. Le nom et l’adresse du destinataire sont inclus dans la distribution d’email d’origine, mais sont masqués.
    • Separate Email — Envoie la copie en tant qu’email distinct.

Étape 4 : Sélection des attributs d’entité

  1. Dans la section Entity Attributes, sélectionnez les attributs que vous souhaitez inclure dans les données d'exportation.

    • Pour filtrer les données d’exportation par valeur d’attributs, saisissez la valeur d’attribut dans la colonne Filter.
    • Pour exclure des produits ou des clients avec certaines valeurs d’attribut, saisissez les valeurs des attributs que vous souhaitez exclure, puis cochez la case dans la colonne Ignorer.
  2. Une fois l’opération terminée, cliquez sur Save.

    La nouvelle tâche d’exportation planifiée est ajoutée à la liste sur la page Scheduled Import/Export. À partir de cette page, il peut être exécuté immédiatement, testé et modifié.

NOTE
Lorsque vous créez ou mettez à jour une importation/exportation planifiée, la configuration du système change. Après l’enregistrement, veillez à respecter l’avis d’invalidation du cache qui s’affiche en haut de la page Admin et à vider le cache afin d’appliquer la planification nouvelle ou mise à jour.

Descriptions des champs

Export Settings

Champ
Description
Name
Nom de l’exportation. Permet de le distinguer si de nombreuses exportations planifiées différentes sont créées.
Description
(Facultatif) Description de l’exportation planifiée.
Entity Type
Identifie les données à exporter. Une fois la sélection effectuée, les attributs d’entité apparaissent ci-dessous. Options : Advanced Pricing / Products / Customer Finances / Customers Main File / Customer Addresses / Stock Sources
Start Time
Définissez l’heure de début, les minutes et les secondes de l’exportation.
Frequency
Définissez la fréquence d’exécution de la tâche d’exportation. Options : Daily / Weekly / Monthly
Status
Une nouvelle exportation planifiée est activée par défaut. Vous pouvez la suspendre en définissant État sur Désactivé. Options : Enabled / Disabled
File Format
Sélectionnez le format du fichier d'export. Actuellement, seule l’option .CSV est disponible.

Export Settings Information

Champ
Description
Server Type
Détermine l’emplacement du fichier d’exportation. Options :
Serveur local — Place le fichier d’exportation sur le même serveur que celui sur lequel Commerce est déployé. Si le module de stockage à distance est activé, Local Server est remplacé par Remote Storage.
FTP distant : place le fichier d’exportation sur un serveur distant. Des options supplémentaires pour les informations d’identification et les paramètres de transfert de fichiers s’affichent.
File Directory
Indiquez le répertoire dans lequel se trouve le fichier d’exportation. Si Server Type ​est défini sur Local Server, indiquez le chemin d’accès relatif au chemin d’installation de Commerce. Par exemple, var/export ou import_export/export pour le stockage à distance.

Export Failed Emails

Champ
Description
Failed Email Receiver
Indiquez l’adresse électronique à laquelle une notification électronique (adresse électronique en échec de l’exportation) est envoyée en cas d’échec de l’exportation.
Failed Email Sender
Indiquez l’adresse électronique utilisée comme expéditeur de courrier électronique en échec de l’exportation.
Failed Email Template
Sélectionnez un modèle pour l’email d’exportation en échec. Par défaut, seule l’option Export Failed (Default Template from Locale) est disponible.
Send Failed Email Copy To
Adresse électronique à laquelle une copie de l’adresse électronique d’exportation en échec est envoyée.
Send Failed Email Copy Method
Indiquez la méthode d’envoi de copie pour le courrier électronique dont l’exportation a échoué.
recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1