Katalog-CSV prüfen, bevor Sie Tausende Zeilen importieren

Bevor Sie eine Katalog-CSV prüfen, klären Sie, was der Import verändern wird. Danach folgen die Spalten, die Bezeichner und die Werte. Eine Tabelle, die sich ohne Warnungen öffnet, kann zwei Produkte mit derselben SKU oder eine Größe ohne Wert enthalten. Eine akzeptierte Datei kann auch das falsche Produkt aktualisieren.

Der folgende Test dient dazu, diese Fehler zu erkennen. Es handelt sich um zehn erfundene Zeilen mit nachprüfbaren Ergebnissen. Es ist weder eine Stichprobe eines echten Shops noch eine für Shopify oder Frihet vorbereitete Datei: dieses Schema wurde für die Übung erstellt, das Sie durch das des Zielsystems ersetzen müssen.

Beginnen Sie mit dem Ziel, nicht mit der Lieferantendatei

Laden Sie eine aktuelle Vorlage herunter oder exportieren Sie ein repräsentatives Produkt aus dem Tool, das die Daten empfangen wird. Notieren Sie, ob Sie erstellen, aktualisieren oder beide Operationen kombinieren werden; was einen Datensatz identifiziert; welche Felder erforderlich sind; und was es bedeutet, eine Zelle leer zu lassen. Bewahren Sie diese Definition zusammen mit der Arbeitsdatei auf.

In Shopify basiert das Überschreiben beispielsweise auf dem URL-Bezeichner, genannt handle. Die Dokumentation verlangt auch, die Abhängigkeiten zwischen Variantenfeldern und Optionen zu überprüfen. Unsere SKU-Regel beschreibt nicht, wie dieses Importprogramm Produkte identifiziert. Produktformat von Shopify.

Wenn Sie Daten zwischen Systemen verschieben, trennen Sie diese Überprüfung von der Verbindung zwischen Shop und Verwaltung (auf Englisch). Ein verfügbarer Konnektor beweist nicht, dass er die Spalten Ihres Lieferanten akzeptiert.

Definieren Sie überprüfbare Regeln

In dieser Übung steht jede Zeile für einen verkaufbaren Artikel. product_key gruppiert ihre Varianten; sku muss vorhanden sein und darf nur einmal vorkommen. name ist obligatorisch. Eine Variante benötigt option_name und option_value; beide leer bedeuten, dass wir keine Option deklarieren. Wenn sie vollständig sind, darf ihre Kombination mit product_key nicht wiederholt werden.

Die Datei verwendet UTF-8, Kommas zwischen den Feldern und acht Spalten in der gezeigten Reihenfolge. price erlaubt nicht-negative Zahlen mit Punkt und zwei Dezimalstellen, ohne Tausendertrennzeichen. In currency verlangen wir EUR für diesen Test. Dies sind für diesen Test gewählte Bedingungen, keine universellen Regeln oder kommerziellen Preise. Es gibt keine Währungsumrechnung oder Steuerberechnung.

Die SKUs werden als Text beibehalten: 001 wird nicht in 1 umgewandelt. Microsoft erklärt, wie man automatische Konvertierungen beim Laden von Bezeichnern in Excel vermeidet. Definieren Sie den Spaltentyp, bevor Sie die Daten transformieren; eine spätere Änderung des Erscheinungsbilds stellt das Original nicht wieder her. Führende Nullen in Excel beibehalten.

Zehn Zeilen, darunter eine, die korrekt aussieht

Kopieren Sie den Block als Text zur Prüfung. Die letzte Zeile hat absichtlich eine Spalte weniger. row_id ist der Bezeichner des Tests; R01 befindet sich in der zweiten Zeile der Datei, da die erste die Kopfzeilen enthält. Die spanischen Produktnamen sind feste Beispieldaten und bleiben in allen Sprachfassungen gleich, damit die Ergebnisse reproduzierbar sind.

row_id,product_key,sku,name,option_name,option_value,price,currency
R01,P01,001,Taza,Color,Natural,19.90,EUR
R02,P01,002,Taza,Color,Ink,19.90,EUR
R03,P02,001,Bolsa,,,29.00,EUR
R04,P03,,Cuaderno,,,8.50,EUR
R05,P04,005,Café,,,6.00,EUR
R06,P05,006,Vaso,,,"12,50",EUR
R07,P06,007,Camiseta,Size,,24.00,EUR
R08,P01,008,Taza,Color,Natural,19.90,EUR
R09,P07,009,,,,15.00,EUR
R10,P08,010,Bandeja,,,25.00

Das Ergebnis: acht gesperrte Zeilen, eine zur weiteren Prüfung und eine, die alle Übungsregeln erfüllt. Dies sind Zeilenzustände, nicht acht unabhängige Fehler: R01 hat zwei Konflikte. Sie können jedes Ergebnis überprüfen, indem Sie die Schlüssel zwischen den Zeilen und die Felder mit den oben genannten Regeln vergleichen.

Ein Duplikat wird nicht durch Auswahl der ersten Zeile gelöst

R01 scheint vollständig, wenn sie allein gelesen wird. Der Konflikt tritt auf, wenn das gesamte Set durchlaufen wird: Sie teilt die SKU mit einer Tasche und die Variantenkombination mit einer anderen Tasse. Daher muss die Überprüfung alle Mitglieder der Gruppe markieren, statt die erste Zeile freizugeben und erst die letzte abzulehnen.

Bitten Sie den Katalogverwalter, zu bestätigen, ob eine falsche Referenz, ein wiederholtes Produkt oder eine schlecht beschriebene Variante vorliegt. Speichern Sie die Entscheidung mit dem alten Wert, dem neuen Wert und dem Grund. Löschen Sie R08 nicht nur, weil ihr Name übereinstimmt; ein echter Katalog kann Material, Größe oder andere Optionen unterscheiden, die dieses vereinfachte Blatt nicht enthält.

Vergleichen Sie bei Ihrem tatsächlichen Import auch mit den Artikelkennungen, die bereits im Ziel vorhanden sind. Eine innerhalb der CSV nur einmal vorkommende SKU kann immer noch mit einem anderen Produkt außerhalb der Datei übereinstimmen. Definieren Sie außerdem, wie Leerzeichen und Groß-/Kleinschreibungsunterschiede vor der Normalisierung behandelt werden sollen: Das Bereinigen eines Bezeichners kann Referenzen zusammenführen, die getrennt bleiben sollten.

Trennen Sie Format, Text und Bedeutung

R06 enthält "12,50": die Anführungszeichen halten den Preis in einer einzigen Zelle. Manuelles Zählen von Kommas würde zu einer falschen Diagnose führen; verwenden Sie einen CSV-Leser. Der RFC 4180 beschreibt diese Anführungszeichenkonvention, definiert aber nicht, welche Spalten ein Katalog benötigt oder wie ein Preis zu interpretieren ist. Die CSV-Syntax von R06 ist gültig; der Preiswert verletzt jedoch die festgelegte Feldregel.

Führen Sie keine globale Ersetzung von Kommas durch Punkte durch: Sie würden sowohl Trennzeichen als auch Inhalte ändern. Identifizieren Sie zuerst das Feld, bestätigen Sie das Ursprungsformat und konvertieren Sie seinen Wert kontrolliert. Ein leeres Feld ist ebenfalls nicht gleich null; einen Preis von null zu registrieren wäre eine geschäftliche Entscheidung, die niemand bestätigt hat.

R05 erfordert eine weitere Überprüfung. Der Text Café ist als gültige UTF-8-Bytefolge gespeichert; das beweist nicht, dass der Name korrekt ist. Die Warnung dieser Übung ist für diesen spezifischen Wert vorbereitet, sie ist kein universeller Kodierungsdetektor. Vergleichen Sie den Namen mit der Quelle und überprüfen Sie, in welchem Schritt er verformt wurde. Das erneute Speichern von bereits beschädigtem Text als UTF-8 stellt seine Zeichen nicht automatisch wieder her.

Vor dem Update prüfen, was erhalten bleibt

Eine fehlende Spalte und eine leere Zelle können unterschiedliche Änderungen hervorrufen. Shopify dokumentiert, dass beim Überschreiben ein leeres optionales Feld das bestehende leeren kann; das Weglassen der Spalte kann es beibehalten. Es wird auch darauf hingewiesen, dass ein begonnener Import nicht abgebrochen werden kann und eine vorherige Sicherungskopie empfohlen wird. Importbedingungen von Shopify.

Die Identität einer Variante kann sich ebenfalls ändern: Shopify warnt, dass das Ändern von Optionswerten deren frühere Bezeichner entfernt und neue erstellt. Überprüfen Sie die davon abhängigen Verbindungen, bevor Sie eine Option per CSV korrigieren. Optionen und Variantenbezeichner.

Erstellen Sie einen Vergleich zwischen vorherigem Zustand, geplanter Änderung und beobachtetem Ergebnis. Fügen Sie die Felder hinzu, die gleich bleiben sollen. Testen Sie in einer verfügbaren Testumgebung und bewahren Sie die zusammengehörigen Zeilen eines Produkts zusammen auf; zehn aufeinanderfolgende Zeilen repräsentieren nicht immer zehn vollständige Produkte.

In einem realen Betrieb würden Sie verschiedene Fälle wählen: einfaches Produkt, mehrere Optionen, akzentuierte Zeichen, leerer Preis und Aktualisierung einer bestehenden Referenz. Diese Stichprobe testet den Ablauf. Danach wenden Sie die Regeln auf die gesamte Datei an: Duplikate können durch Tausende von Zeilen getrennt sein. Nutzen Sie die Integrationen, um die Tools Ihres Workflows zu identifizieren, und prüfen Sie die Datenvorgaben jeder einzelnen Schnittstelle.

Halten Sie die Entscheidung nachvollziehbar fest

Notieren Sie vor dem Hochladen die Dateiversion, das Ziel, den Verantwortlichen, die angewendeten Regeln, die gelösten Probleme und den Vergleich des Tests. Fehlt eine Bestätigung, lassen Sie den Import ausstehen; eine Meldung „Importiert“ ersetzt diese Überprüfung nicht.

Frihet unterstützt den CSV-Import von Produkten im Rahmen seiner Verwaltungsfunktionen. Das Schema und die manuellen Prüfungen in diesem Artikel sind unabhängig: Sie testen weder die von Frihet unterstützten Felder noch automatische Validierungen. Verwenden Sie die Vorlage Ihres Importprogramms und klären Sie zuerst die Zeilen, deren Ergebnis Sie noch nicht erklären können.