DocumentationGuide des systèmes d’administration

Importer des données

Dernière mise à jour : 2 juin 2026

Créé pour :

  • {"id":"b5a62a22-46f7-4f0d-b151-3fc640bef588"},{"id":"e8ccd51f-da0d-4e3b-939b-e30d5ebb1ea5"}
  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"},{"id":"f8a45b24-4be7-4f1b-909b-60d06b483a20"}

Les données de tous les types de produits peuvent être importées dans le magasin. En outre, vous pouvez importer des produits, des données de tarification avancées, des données client, des données d’adresse client et des images de produits. L’importation prend en charge les opérations suivantes :

  • Ajouter/Mettre à jour
  • Replace
  • Supprimer

Instructions d’importation

Nouvelles entités

  • Les entités sont ajoutées avec les valeurs d’attribut spécifiées dans le fichier CSV.
  • Pour un attribut obligatoire sans valeur par défaut définie, l’entité (la ou les lignes correspondantes) ne peut pas être importée s’il n’existe aucune valeur ou si une valeur n’est pas valide.
  • Pour un attribut obligatoire dont la valeur par défaut est définie, l’entité (la ou les lignes correspondantes) est importée et la valeur par défaut est définie pour l’attribut s’il n’existe aucune valeur ou une valeur non valide.
  • Si les données complexes ne sont pas valides, l’entité (la ou les lignes correspondantes) ne peut pas être importée.

Entités existantes

  • Pour les attributs qui ne sont pas des données complexes, les valeurs du fichier d’importation, y compris les valeurs vides pour les attributs non obligatoires, remplacent les valeurs existantes.
  • S’il n’existe aucune valeur, ou s’il existe une valeur non valide, pour un attribut obligatoire, la valeur existante n’est pas remplacée.
  • Si les données complexes de l’entité ne sont pas valides, l’entité (la ou les lignes correspondantes) ne peut pas être importée, sauf dans le cas où Supprimer les entités a été sélectionné dans le menu déroulant Comportement d’importation .
NOTE
Pour les catalogues volumineux, omettez les colonnes categories et url_key du fichier d’importation si vous ne modifiez pas les affectations de catégorie ou les clés d’URL. Si l’une des colonnes est présente, Adobe Commerce régénère les réécritures d’URL pour chaque produit du fichier . Ce travail supplémentaire allonge l’importation et peut entraîner des erreurs de délai d’expiration sur Adobe Commerce on Cloud.

Données complexes

S’il existe un attribut spécifié dans le fichier d’importation et que sa valeur est dérivée d’un ensemble défini de valeurs, les conditions suivantes s’appliquent :

  • Si la valeur n’est pas déjà incluse dans l’ensemble de valeurs défini, la ligne peut être importée et une valeur par défaut, si elle est définie, est définie pour l’attribut .
  • Si la valeur est déjà incluse dans le jeu défini, la ligne correspondante ne peut pas être importée.
  • Si le fichier d’importation spécifie un nom d’attribut qui n’est pas encore défini dans le système, il n’est pas créé et ses valeurs ne sont pas importées.

Fichiers non valides

  • Impossible d’importer un fichier si toutes les lignes ne sont pas valides.
  • Une donnée de service non existante ou un nom de données complexe est spécifié dans le fichier d’importation, par exemple une colonne avec un en-tête _<non-existing name>.

Le processus d’importation d’Adobe Commerce peut ne pas reconnaître correctement les fichiers codés en UTF-8 qui utilisent une nomenclature d’octets. Les fichiers contenant une nomenclature peuvent entraîner des problèmes ou des échecs au cours du processus d’importation.

Opérations d’import

Fonctionnement
Description
Ajouter/Mettre à jour
Les nouvelles données de produit sont ajoutées aux données de produit existantes pour les entrées existantes dans la base de données. Tous les champs, à l’exception de sku, peuvent être mis à jour.

Les nouvelles classes de taxe spécifiées dans les données d’importation sont créées automatiquement.

Les nouvelles catégories de produits spécifiées dans le fichier d’importation sont créées automatiquement.

Les nouveaux SKU spécifiés dans le fichier d’importation sont créés automatiquement

Note:​Pour les produits, vous pouvez mettre à jour tous les champs à l’exception du SKU par le biais de l’importation.

Important: Plusieurs valeurs de champ, telles que des sites web ou des catégories, ne peuvent pas être supprimées à l’aide du comportement d’importation Ajouter/Mettre à jour. Ces champs restent dans la base de données après l’importation s’ils ne sont pas répertoriés dans le fichier CSV.
Replace
Les données de produit existantes sont remplacées par de nouvelles données.

Important: Faites preuve de prudence lors du remplacement des données, car les données de produit existantes sont effacées et toutes les références du système sont perdues.

Si un SKU des données d’importation correspond au SKU d’une entité existante, tous les champs, y compris le SKU, sont supprimés et un nouvel enregistrement est créé à l’aide des données CSV. Une erreur se produit si le fichier CSV fait référence à un SKU qui n’existe pas dans la base de données. Vous pouvez Vérifier les données pour afficher l’erreur.
Supprimer
Toutes les entités présentes dans la base de données d’importation sont supprimées de la base de données.

Supprimer ignore toutes les colonnes des données d’importation, à l’exception de la SKU. Vous pouvez ignorer tous les autres attributs dans les données.

Une erreur se produit si le fichier CSV fait référence à un SKU qui n’existe pas dans la base de données. Vous pouvez Vérifier les données pour afficher l’erreur.

Processus d’import

La taille du fichier d’importation est déterminée par les paramètres du fichier php.ini sur le serveur. Le message système de la page Importer indique la limite de taille actuelle. La taille par défaut est de 2 Mo.

Les caractères spéciaux (tels que le signe égal, les symboles supérieur et inférieur à, les guillemets simples et doubles, la barre oblique inverse, la barre verticale et les esperluettes) peuvent entraîner des problèmes lors du transfert des données. Pour garantir que ces caractères spéciaux sont correctement interprétés, ils peuvent être marqués comme une séquence d’échappement. Par exemple, si les données incluent une chaîne de texte telle que code="str", code="str2", le fait de placer le texte entre guillemets doubles garantit que les guillemets doubles d’origine sont compris comme faisant partie des données. Lorsque le système rencontre un double ensemble de guillemets doubles, il comprend que l’ensemble externe de guillemets doubles entoure les données réelles.

Lors de l’importation de données de produit, les nouvelles données de produit sont ajoutées aux entrées de données de produit existantes dans la base de données. Tous les champs sauf le SKU peuvent être mis à jour par le biais de l’importation. Toutes les données de produit existantes sont remplacées par les nouvelles données importées. Faites preuve de prudence lorsque vous remplacez des données. Toutes les données de produit existantes sont effacées et toutes les références du système sont perdues.

Import de données {width="600" modal="regular"}

Étape 1 : préparation des données

  1. Dans la barre latérale Admin, accédez à System > Data Transfer>Import.

  2. Sous Paramètres d’importation, définissez Entity Type sur l’une des options suivantes :

    • Advanced Pricing
    • Products
    • Customer Finances
    • Customers and Addresses
    • Customers Main File
    • Customer Addresses
    • Stock Sources

  3. Cliquez sur Download Sample File.

  4. Recherchez le fichier d’exportation à l’emplacement de téléchargement de votre navigateur web et ouvrez le fichier.

    L’exemple de fichier comprend des en-têtes de colonne avec des données d’espace réservé pour les types de produits.

    Importer un fichier d’exemple de données {width="600" modal="regular"}

  5. Examinez la structure du fichier d’exemple et utilisez-le pour préparer votre fichier d’importation CSV en vous assurant que les en-têtes des colonnes sont correctement orthographiés.

  6. Vérifiez que la taille du fichier d’importation ne dépasse pas la limite indiquée dans le message.

    Notification de la taille de l’importation des données {width="600"}

  7. Si les données d’importation comprennent des chemins d’accès aux images du produit, assurez-vous que les fichiers image ont été chargés à l’emplacement approprié.

    L’emplacement par défaut sur le serveur Commerce est : pub/media/import.

    Si les images se trouvent sur un serveur externe, vérifiez que vous disposez de l’URL complète du répertoire contenant les images.

Etape 2 : choix du comportement de l’import

Comportement de l’import de données {width="600" modal="regular"}

  1. Définissez Import Behavior sur l’une des options suivantes :

    • Add/Update (pour les produits, vous pouvez mettre à jour tous les champs à l’exception du SKU via l’importation.)
    • Replace
    • Delete

  2. Pour déterminer ce qui se produit lorsqu’une erreur se produit lors de l’importation de données, choisissez l’une des options suivantes :

    • Stop on Error
    • Skip error entries

  3. Par Allowed Errors Count, saisissez le nombre d’erreurs qui peuvent se produire avant l’annulation de l’importation.

    La valeur par défaut est 10.

  4. Acceptez la valeur par défaut d’une virgule (,) pour Field separator.

  5. Acceptez la valeur par défaut d’une virgule (,) pour Multiple value separator.

    Dans un fichier CSV, une virgule est le séparateur par défaut. Pour utiliser un autre caractère, assurez-vous que les données du fichier CSV correspondent au caractère spécifié.

  6. Acceptez la valeur par défaut _EMPTY_VALUE_ pour Empty attribute value constant.

  7. Si vous souhaitez placer des caractères spéciaux susceptibles d’être trouvés dans les données sous la forme d’une séquence d’échappement, cochez la case Fields Enclosure.

Étape 3 : identifier le fichier d’importation

Fichier d’import de données {width="600" modal="regular"}

  1. Cliquez sur Choose File pour sélectionner le fichier à importer.

  2. Recherchez le fichier CSV que vous êtes prêt à importer et cliquez sur Open.

  3. Par Images File Directory, saisissez le chemin d’accès relatif à l’emplacement sur le serveur Commerce où sont stockées les images chargées.

    Par exemple : product_images.

    note
    NOTE
    À partir de la version Adobe Commerce et Magento Open Source 2.3.2, le chemin spécifié dans Images File Directory​concatène pour l’importation dans le répertoire de base des images : <Magento-root-folder>/var/import/images. Par exemple, placez les fichiers product_images dans le dossier <Magento-root-directory>/var/import/images/product_images. Le répertoire de base des images d'import peut être paramétré dans le fichier \Magento\ImportExport\etc\config.xml. Si le module de stockage distant est activé, importez les fichiers dans le dossier <remote-storage-root-directory>/var/import/images/product_images.

    Pour en savoir plus sur l’importation d’images de produit, voir Importer des images de produit.

Étape 4 : vérifier les données d’importation

  1. Dans le coin supérieur droit, cliquez sur Check Data.

  2. Patientez quelques instants le temps que le processus de validation se termine.

    Si les données d’importation sont valides, le message suivant s’affiche :

    Message de succès - Le fichier est valide {width="600"}

  3. Si le fichier est valide, cliquez sur Import.

    Sinon, corrigez chaque problème avec les données répertoriées dans le message, puis réessayez d’importer le fichier.

  4. Le processus d’importation se poursuit jusqu’à la fin des données, sauf si une erreur se produit.

    Si un message d’erreur s’affiche dans les résultats de la validation, corrigez le problème dans les données et importez à nouveau le fichier.

    Message d’erreur - La clé URL existe déjà {width="600"}

    Un message s’affiche une fois l’importation terminée.

Importer l’historique

Commerce conserve un enregistrement des données importées dans votre boutique, notamment la date et l’heure de début, l’utilisateur, l’heure d’exécution et un lien vers le fichier importé. Le Délai d’exécution correspond à la durée du processus d’importation.

Pour afficher l’historique des imports:

Dans la barre latérale Admin, accédez à System > Data Transfer>Import History.

Historique des imports de données {width="600" modal="regular"}

NOTE
Par défaut, les fichiers d’historique d’importation se trouvent dans le dossier <Magento-root-directory>/var/import_history . Si le module de stockage distant est activé, les fichiers d’historique d’importation se trouvent dans le dossier <remote-storage-root-directory>/import_export/import_history.
Champ
Description
ID
Numéro interne utilisé pour désigner un transfert.
Start Date & Time
Date et heure spécifiques auxquelles le transfert a eu lieu.
User
Client qui a effectué le transfert.
Imported file
Lien de téléchargement du fichier importé.
Error file
Le fichier d’erreur correspondant.
Execution Time
Intervalle de temps du processus d’importation.
Summary
Le nombre d’éléments créés, mis à jour et supprimés, ou le message d’erreur.

Pour télécharger le fichier Importé/Erreur, cliquez sur Download.

recommendation-more-help
commerce-admin-help-systems