DokumentationCommerceAdministratorsystemanleitung

Daten importieren

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • Einsteiger
  • Fortgeschrittener
  • Admin
  • Führungskraft

Daten für alle Produktarten können in den Store importiert werden. Darüber hinaus können Sie Produkte, erweiterte Preisdaten, Kundendaten, Kundenadressen und Produktbilder importieren. Import unterstützt die folgenden Vorgänge:

  • Hinzufügen/Aktualisieren
  • Ersetzen
  • Löschen

Importrichtlinien

Neue Entitäten

  • Entitäten werden mit den in der CSV-Datei angegebenen Attributwerten hinzugefügt.
  • Für ein erforderliches Attribut ohne festgelegten Standardwert kann die Entität (die entsprechende(n) Zeile(n)) nicht importiert werden, wenn kein Wert oder ein ungültiger Wert vorhanden ist.
  • Für ein erforderliches Attribut mit einem Standardwert wird die Entität (die entsprechende(n) Zeile(n)) importiert und der Standardwert für das Attribut festgelegt, wenn kein Wert oder ein ungültiger Wert vorhanden ist.
  • Wenn die komplexen Daten nicht gültig sind, kann die Entität (die entsprechende(n) Zeile(n)) nicht importiert werden.

Bestehende Entitäten

  • Bei Attributen, die keine komplexen Daten sind, ersetzen die Werte aus der Importdatei, einschließlich der leeren Werte für die nicht erforderlichen Attribute, die vorhandenen Werte.
  • Wenn für ein erforderliches Attribut kein Wert vorhanden ist oder ein nicht gültiger Wert vorhanden ist, wird der vorhandene Wert nicht ersetzt.
  • Wenn die komplexen Daten für die Entität ungültig sind, kann die Entität (die entsprechende(n) Zeile(n)) nicht importiert werden. Eine Ausnahme bildet der Fall, wenn im Dropdown-Menü "Importverhalten"die Option Entitäten löschen ausgewählt wurde.

Komplexe Daten

Wenn ein in der Importdatei angegebenes Attribut vorhanden ist und sein Wert aus einem definierten Wertesatz abgeleitet wird, gilt Folgendes:

  • Wenn der Wert nicht bereits im definierten Satz von Werten enthalten ist, kann die Zeile importiert werden und für das Attribut wird, sofern definiert, ein Standardwert festgelegt.
  • Wenn der Wert bereits im definierten Satz enthalten ist, kann die entsprechende Zeile nicht importiert werden.
  • Wenn die Importdatei einen Attributnamen angibt, der noch nicht im System definiert ist, wird er nicht erstellt und die entsprechenden Werte werden nicht importiert.

Ungültige Dateien

  • Eine Datei kann nicht importiert werden, wenn alle Zeilen ungültig sind.
  • In der Importdatei werden nicht vorhandene Dienstdaten oder komplexe Datennamen angegeben, z. B. eine Spalte mit der Überschrift _<non-existing name> .

Der Importprozess von Adobe Commerce erkennt möglicherweise in UTF-8 kodierte Dateien, die eine Byte Order Mark (BOM) verwenden, nicht ordnungsgemäß. Dateien, die ein BOM enthalten, können während des Importvorgangs zu Problemen oder Fehlern führen.

Importvorgänge

Vorgang
Beschreibung
Hinzufügen/Aktualisieren
Zu den vorhandenen Produktdaten für die vorhandenen Einträge in der Datenbank werden neue Produktdaten hinzugefügt. Alle Felder mit Ausnahme von sku können aktualisiert werden.

Neue in den Importdaten angegebene Steuerklassen werden automatisch erstellt.

Neue Produktkategorien, die in der Importdatei angegeben sind, werden automatisch erstellt.

Neue SKUs, die in der Importdatei angegeben sind, werden automatisch erstellt

Hinweis: ​Für Produkte können Sie alle Felder außer SKU durch Importieren aktualisieren.

Wichtig: Mehrere Feldwerte wie Websites oder Kategorien können nicht mit dem Importverhalten Hinzufügen/Aktualisieren entfernt werden. Diese Felder bleiben nach dem Import in der Datenbank, wenn sie nicht in der CSV-Datei aufgeführt sind.
Ersetzen
Die vorhandenen Produktdaten werden durch neue Daten ersetzt.

Wichtig: ​Gehen Sie beim Ersetzen von Daten vorsichtig vor, da die vorhandenen Produktdaten gelöscht werden und alle Verweise im System verloren gehen.

Wenn eine SKU in den Importdaten mit der SKU einer vorhandenen Entität übereinstimmt, werden alle Felder, einschließlich der SKU, gelöscht und mithilfe der CSV-Daten wird ein neuer Datensatz erstellt. Ein Fehler tritt auf, wenn die CSV-Datei auf eine SKU verweist, die nicht in der Datenbank vorhanden ist. Sie können die Option Daten zur Anzeige eines Fehlers überprüfen.
Löschen
Alle Entitäten in den Importdaten, die in der Datenbank vorhanden sind, werden aus der Datenbank gelöscht.

Beim Löschen werden alle Spalten in den Importdaten außer der SKU ignoriert. Sie können alle anderen Attribute in den Daten ignorieren.

Es tritt ein Fehler auf, wenn die CSV-Datei auf eine SKU verweist, die nicht in der Datenbank vorhanden ist. Sie können die Option Daten zur Anzeige eines Fehlers überprüfen.

Importprozess

Die Größe der Importdatei wird durch die Einstellungen in der Datei php.ini auf dem Server bestimmt. Die Systemmeldung auf der Seite Import gibt die aktuelle Größenbeschränkung an. Die Standardgröße beträgt 2 MB.

Sonderzeichen (wie Gleichheitszeichen, Größer- und Kleiner-als-Symbole, einfache und doppelte Anführungszeichen, umgekehrter Schrägstrich, senkrechte Strich und Und-Zeichen) können Probleme bei der Datenübertragung verursachen. Um sicherzustellen, dass solche Sonderzeichen korrekt interpretiert werden, können sie als Escape-Sequenz markiert werden. Wenn die Daten beispielsweise eine Textzeichenfolge wie code="str" oder code="str2" enthalten, stellt die Wahl, den Text in doppelte Anführungszeichen zu setzen, sicher, dass die ursprünglichen doppelten Anführungszeichen als Teil der Daten verstanden werden. Wenn das System auf einen doppelten Satz doppelter Anführungszeichen trifft, versteht es, dass der äußere Satz doppelter Anführungszeichen die tatsächlichen Daten umschließt.

Beim Importieren von Produktdaten werden neue Produktdaten zu vorhandenen Produktdateneinträgen in der Datenbank hinzugefügt. Alle Felder mit Ausnahme der SKU können durch den Import aktualisiert werden. Alle vorhandenen Produktdaten werden durch die importierten neuen Daten ersetzt. Gehen Sie beim Ersetzen von Daten vorsichtig vor. Alle vorhandenen Produktdaten werden gelöscht und alle Verweise im System gehen verloren.

Datenimport

Schritt 1: Vorbereiten der Daten

  1. Wechseln Sie in der Seitenleiste Admin zu System > Data Transfer>Import.

  2. Legen Sie unter Importeinstellungen Entity Type eine der folgenden Einstellungen fest:

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

  3. Klicken Sie auf Download Sample File.

  4. Suchen Sie die Exportdatei im Speicherort für Downloads Ihres Webbrowsers und öffnen Sie die Datei.

    Die Beispieldatei enthält Spaltenüberschriften mit Platzhalterdaten für die Produkttypen.

    Import data sample file {width="600" modal="regular"}

  5. Untersuchen Sie die Struktur der Beispieldatei und bereiten Sie mit ihr Ihre CSV-Importdatei vor, um sicherzustellen, dass die Spaltenüberschriften richtig geschrieben sind.

  6. Vergewissern Sie sich, dass die Größe Ihrer Importdatei die in der Nachricht angegebene Grenze nicht überschreitet.

    Benachrichtigung über die Datenimportgröße {width="600"}

  7. Wenn die Importdaten Pfade zu Produktbildern enthalten, stellen Sie sicher, dass die Bilddateien an den entsprechenden Speicherort hochgeladen wurden.

    Der Standardspeicherort auf dem Commerce-Server lautet: pub/media/import.

    Wenn sich die Bilder auf einem externen Server befinden, stellen Sie sicher, dass Sie über die vollständige URL zu dem Verzeichnis verfügen, das die Bilder enthält.

Schritt 2: Importverhalten auswählen

Verhalten beim Datenimport

  1. Setzen Sie Import Behavior auf einen der folgenden Werte:

    • Add/Update (Bei Produkten können Sie alle Felder außer SKU durch Import aktualisieren.)
    • Replace
    • Delete

  2. Wählen Sie eine der folgenden Optionen aus, um festzustellen, was beim Datenimport passiert, wenn ein Fehler auftritt:

    • Stop on Error
    • Skip error entries

  3. Geben Sie für "Allowed Errors Count"die Anzahl der Fehler an, die auftreten können, bevor der Import abgebrochen wird.

    Der Standardwert ist 10.

  4. Akzeptieren Sie den Standardwert eines Kommas (,) für Field separator.

  5. Akzeptieren Sie den Standardwert eines Kommas (,) für Multiple value separator.

    In einer CSV-Datei ist ein Komma das Standardtrennzeichen. Um ein anderes Zeichen zu verwenden, stellen Sie sicher, dass die Daten in der CSV-Datei mit dem von Ihnen angegebenen Zeichen übereinstimmen.

  6. Den Standardwert _EMPTY_VALUE_ für Empty attribute value constant akzeptieren.

  7. Wenn Sie Sonderzeichen einschließen möchten, die möglicherweise in den Daten als Escape-Sequenz enthalten sind, aktivieren Sie das Kontrollkästchen Fields Enclosure .

Schritt 3: Importdatei identifizieren

Datei für den Datenimport

  1. Klicken Sie auf Choose File , um die zu importierende Datei auszuwählen.

  2. Suchen Sie die CSV-Datei, die Sie für den Import vorbereitet haben, und klicken Sie auf Open.

  3. Geben Sie für "Images File Directory"den relativen Pfad zum Speicherort auf dem Commerce-Server ein, auf dem hochgeladene Bilder gespeichert werden.

    Beispiel: product_images.

    note note
    NOTE
    Ab der Adobe Commerce- und Magento Open Source 2.3.2-Version verkettet der in Images File Directory ​angegebene Pfad den Import in das Basisverzeichnis der Bilder: <Magento-root-folder>/var/import/images. Platzieren Sie beispielsweise die Dateien "product_images"im Ordner "<Magento-root-directory>/var/import/images/product_images". Der Basisordner für Importbilder kann in der Datei \Magento\ImportExport\etc\config.xml konfiguriert werden. Wenn das Remote-Speichermodul aktiviert ist, importieren Sie Dateien in den Ordner "<remote-storage-root-directory>/var/import/images/product_images".

    Weitere Informationen zum Importieren von Produktbildern finden Sie unter Importieren von Produktbildern.

Schritt 4: Überprüfen der Importdaten

  1. Klicken Sie in der oberen rechten Ecke auf Check Data.

  2. Warten Sie kurz, bis der Validierungsprozess abgeschlossen ist.

    Wenn die Importdaten gültig sind, wird die folgende Meldung angezeigt:

    Erfolgsmeldung - Datei ist gültig {width="600"}

  3. Wenn die Datei gültig ist, klicken Sie auf Import.

    Korrigieren Sie andernfalls jedes Problem mit den in der Nachricht aufgelisteten Daten und versuchen Sie erneut, die Datei zu importieren.

  4. Der Importvorgang läuft bis zum Ende der Daten, es sei denn, es wird ein Fehler festgestellt.

    Wenn in den Überprüfungsergebnissen eine Fehlermeldung angezeigt wird, korrigieren Sie das Problem in den Daten und importieren Sie die Datei erneut.

    Fehlermeldung - URL-Schlüssel ist bereits vorhanden {width="600"}

    Nach Abschluss des Imports wird eine Meldung angezeigt.

Importverlauf

Commerce führt einen Datensatz mit in Ihren Store importierten Daten, einschließlich Startzeit, Benutzer, Ausführungszeit und Link zur importierten Datei. Die Ausführungszeit ist die Dauer des Importvorgangs.

Anzeigen des Importverlaufs:

Wechseln Sie in der Seitenleiste Admin zu System > Data Transfer>Import History.

Datenimport-Verlauf

NOTE
Standardmäßig befinden sich die Importverlauf-Dateien im Ordner "<Magento-root-directory>/var/import_history". Wenn das Remote-Speichermodul aktiviert ist, befinden sich die Importverlauf-Dateien im Ordner "<remote-storage-root-directory>/import_export/import_history".
Feld
Beschreibung
ID
Interne Nummer, die zur Bezeichnung einer Übertragung verwendet wird.
Start Date & Time
Datum und Uhrzeit der Übertragung.
User
Der Kunde, der den Transfer vorgenommen hat.
Imported file
Link zum Herunterladen der importierten Datei.
Error file
Die entsprechende Fehlerdatei.
Execution Time
Zeitintervall des Importvorgangs.
Summary
Die Anzahl der erstellten, aktualisierten und gelöschten Elemente oder die Fehlermeldung.

Um die Datei Importiert/Fehler herunterzuladen, klicken Sie auf Download.

recommendation-more-help
d3c62084-5181-43fb-bba6-1feb2fcc3ec1