Import et export planifiés
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
-
Sur la barre latérale Admin, accédez à System > Data Transfer>Scheduled Imports/Exports.
{width="700" modal="regular"}
-
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.
-
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. -
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
-
Sur la barre latérale Admin, accédez à System > Data Transfer>Scheduled Import/Export.
-
Dans le coin supérieur droit, cliquez sur Add Scheduled Import.
-
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
etDelete
. 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
etCustom 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
ouMonthly
-
On Error - Défini sur l’une des valeurs suivantes :
Stop Import
ouContinue 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.
{width="600" modal="regular"}
-
Etape 2 : renseigner les informations sur le fichier d'import
-
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.
{width="600" modal="regular"}
note note NOTE Lorsque le module de stockage distant est activé, Local Server
passe automatiquement àRemote Storage
. -
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é, utilisezimport_export/import
.Remote FTP server
- Entrez l’URL complète et le chemin d’accès au dossier d’importation sur le serveur distant.
-
Saisissez le File Name à importer.
-
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
ouimport_export/import/some/dir
.
Etape 3 : configurer l'import des emails en échec
-
Définissez Failed Email Receiver sur le contact du magasin qui doit recevoir la notification si une erreur se produit pendant l’importation.
-
Définissez Failed Email Sender sur le contact du magasin qui apparaît comme l’expéditeur de la notification.
-
Définissez Failed Email Template sur le modèle utilisé pour la notification.
-
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.
-
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.
-
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.
Descriptions des champs
Import Settings
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.
Daily
/ Weekly
/ Monthly
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é.
Disabled
.,
(virgule),
(virgule)Import File Information
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
.var/import
ou import_export/import
pour le stockage à distance.var/import
ou import_export/import
pour le stockage à distance.Import Failed Emails
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
-
Sur la barre latérale Admin, accédez à System > Data Transfer>Scheduled Import/Export.
-
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
-
-
Pour activer l’exportation planifiée, définissez Status sur
Enabled
. -
Acceptez
CSV
comme valeur par défaut File Format.{width="600" modal="regular"}
Etape 2 : renseigner les informations sur le fichier d'export
-
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.
{width="600" modal="regular"}
note note NOTE Lorsque le module de stockage distant est activé, le Local Server
passe automatiquement àRemote Storage
. -
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é, utilisezimport_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.
- Pour Local Server, saisissez un chemin relatif dans l’installation de Commerce, par exemple
-
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
ouASCII
. - Pour Passive Mode, choisissez
No
ouYes
.
Etape 3 : configuration des emails d'échec d'export
-
Définissez Failed Email Receiver sur le contact du magasin qui doit recevoir la notification si une erreur se produit pendant l’exportation.
-
Définissez Failed Email Sender sur le contact du magasin qui apparaît comme l’expéditeur de la notification.
-
Définissez Failed Email Template sur le modèle utilisé pour la notification.
-
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.
-
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é
-
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.
-
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é.
Descriptions des champs
Export Settings
Advanced Pricing
/ Products
/ Customer Finances
/ Customers Main File
/ Customer Addresses
/ Stock Sources
Daily
/ Weekly
/ Monthly
Enabled
/ Disabled
.CSV
est disponible.Export Settings Information
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.
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
Export Failed (Default Template from Locale)
est disponible.