|
|
| (Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt) |
| Zeile 1: |
Zeile 1: |
| Eine "Excel-kompatible CSV" ist eine spezielle Art von CSV-Datei, die so formatiert ist, dass sie problemlos in Microsoft Excel geöffnet und bearbeitet werden kann.
| | == CSV-Dateien für den OmniSeller-Import == |
|
| |
|
| - CSV (Comma-Separated Values): CSV ist ein Dateiformat, das zur Speicherung von Tabellendaten verwendet wird. In einer CSV-Datei sind die Daten in Textform gespeichert und durch Trennzeichen voneinander getrennt. In den meisten Fällen ist das Trennzeichen Semikolon (bitte nur dies für den OmniSeller Import verwenden). | | Die Importe im OmniSeller PIM erwarten '''Semikolon-getrennte CSV-Dateien mit Spaltenüberschriften in der ersten Zeile''' („Excel-kompatibles CSV"). Die Spalten werden in den Import-Fenstern anhand der Überschriften zugeordnet - jede Spalte braucht deshalb einen eindeutigen, nicht leeren Namen. |
|
| |
|
| - Excel-Kompatibilität: Excel ist eine weit verbreitete Tabellenkalkulationssoftware von Microsoft. Um sicherzustellen, dass eine CSV-Datei in Excel reibungslos funktioniert, müssen bestimmte Regeln befolgt werden:
| | === Anforderungen === |
|
| |
|
|
| | * '''Trennzeichen:''' Semikolon (<code>;</code>). Kommagetrennte Dateien werden nicht akzeptiert. |
| 1. Trennzeichen: Das Trennzeichen, das die einzelnen Datenfelder voneinander trennt, sollte konsistent verwendet werden. In unseren Fällen ist dies ein Semikolon.
| | * '''Kopfzeile:''' erste Zeile enthält die Spaltennamen, keine leeren Überschriften. |
|
| | * '''Textqualifizierer:''' Werte, die selbst ein Semikolon oder Zeilenumbrüche enthalten, müssen in Anführungszeichen stehen (<code>"Wert; mit Semikolon"</code>). Excel erledigt das beim Speichern automatisch - beim Bearbeiten im Texteditor ist das die häufigste Fehlerquelle: ein unmaskiertes Semikolon verschiebt alle folgenden Spalten der Zeile. |
| 2. Textqualifier: Wenn Ihre Daten Textfelder enthalten, die selbst das Trennzeichen enthalten könnten, ist es üblich, Textqualifikationszeichen zu verwenden. Dies sind normalerweise Anführungszeichen. Zum Beispiel: "Dies ist ein Beispiel",Wert1,"Noch ein Beispiel".
| | * '''Kodierung:''' Die Dateien werden mit der Windows-Standardkodierung (ANSI) gelesen; UTF-8 wird nur erkannt, wenn die Datei mit BOM gespeichert wurde. Das übliche „CSV (Trennzeichen-getrennt)" aus Excel passt. |
|
| |
| 3. Zeilenendezeichen: Am Ende jeder Zeile sollte ein korrektes Zeilenendezeichen stehen. Dies kann ein Zeilenumbruch (CR/LF) oder ein anderes Zeichen sein, das von Excel erkannt wird.
| |
| - Import in Excel: Um eine Excel-kompatible CSV-Datei in Microsoft Excel zu öffnen, öffnen Sie Excel, gehen Sie zu "Datei" und wählen Sie "Öffnen". Wählen Sie dann die CSV-Datei aus, und Excel sollte die Daten in einer Tabelle anzeigen.
| |
|
| |
|
| Die Verwendung einer Excel-kompatiblen CSV-Datei ermöglicht es, Daten aus externen Quellen in Excel zu importieren und sie in Tabellenform darzustellen, was in vielen geschäftlichen Anwendungen nützlich ist.
| | === Speichern aus Excel === |
|
| |
|
| '''Um eine Datei in Microsoft Excel als CSV-Datei mit einem Semikolon als Trennzeichen zu speichern, befolgen Sie diese Schritte:''' | | In Excel '''Datei → Speichern unter → Dateityp „CSV (Trennzeichen-getrennt)"''' wählen. Ob Excel Semikolon oder Komma schreibt, richtet sich nach dem Listentrennzeichen der Windows-Regionseinstellungen - bei deutschen Einstellungen ist das Semikolon der Standard. Nach dem Speichern die Datei im Zweifel kurz im Texteditor öffnen und prüfen, dass Semikolons als Trenner verwendet werden. |
|
| |
|
| 1. Öffnen Sie Ihre Excel-Datei: Starten Sie Microsoft Excel und öffnen Sie die Arbeitsmappe, die Sie als CSV-Datei speichern möchten.
| | == Vorprüfung beim Import == |
|
| |
|
| 2. Überprüfen Sie Ihre Daten: Stellen Sie sicher, dass Ihre Daten korrekt und in der gewünschten Form in der Excel-Tabelle vorliegen.
| | Vor jedem CSV-Import prüft OmniSeller die Datei. Es gibt zwei Stufen: |
|
| |
|
| 3. Speichern unter: Gehen Sie zum Menü "Datei" oben links in der Excel-Oberfläche.
| | '''Harte Fehler''' - der Import startet nicht: |
|
| |
|
| 4. Speichern unter auswählen: Wählen Sie "Speichern unter" aus. Dies öffnet das Dialogfeld "Speichern unter".
| | * falsches Trennzeichen bzw. Datei ist kein lesbares CSV |
| | * uneinheitliche Spaltenanzahl über die Zeilen (typisch: unmaskiertes Semikolon in einem Wert) |
| | * Werte in der Artikelnummernspalte länger als 31 Zeichen (deutet auf eine verrutschte Spaltenzuordnung hin) |
| | * Datei größer als 1 GB |
|
| |
|
| 5. Dateityp auswählen: Im Dialogfeld "Speichern unter" können Sie den Speicherort und den Dateinamen auswählen. Darunter finden Sie ein Dropdown-Menü mit dem Namen "Dateityp". Klicken Sie darauf, um die verfügbaren Dateitypen anzuzeigen.
| | '''Warnungen''' - der Import kann per Ja/Nein-Abfrage trotzdem gestartet werden: |
|
| |
|
| 6. CSV auswählen: Wählen Sie "CSV (Trennzeichen getrennt)" aus der Liste der Dateitypen. Beachten Sie, dass Excel automatisch das Trennzeichen verwendet, das in Ihren Windows-Systemeinstellungen festgelegt ist. Wenn Ihre Systemeinstellungen Semikolon verwenden, wird Excel die CSV-Datei ebenfalls mit Semikolon als Trennzeichen speichern.
| | * leere Felder in Datenzeilen |
| | * doppelte Zeilen |
| | * auffällige Werte in nicht zugeordneten Spalten (die Meldung nennt Wert, Spalte und Zeile) |
| | * einzelne Felder länger als 8.000 Zeichen |
|
| |
|
| 7. Speichern: Klicken Sie auf die Schaltfläche "Speichern", nachdem Sie den Dateityp ausgewählt haben.
| | Die Warnungen sind Hinweise auf mögliche Formatprobleme - wer seine Datei kennt, kann sie übergehen. Bei harten Fehlern die Datei in Excel öffnen, korrigieren und neu als Semikolon-CSV speichern. |
| | |
| 8. Trennzeichen wählen (falls erforderlich): Je nach Ihren Systemeinstellungen kann Excel ein anderes Trennzeichen verwenden. Wenn Sie Semikolon verwenden möchten und Excel ein anderes Zeichen verwendet hat, wird ein Dialogfeld angezeigt, in dem Sie das Trennzeichen auswählen können. Wählen Sie "Semikolon" aus.
| |
| | |
| 9. Fertigstellen: Klicken Sie auf "Fertigstellen" oder "OK", um die CSV-Datei zu speichern.
| |
| | |
| Ihre Excel-Datei wird jetzt als CSV-Datei mit Semikolon als Trennzeichen gespeichert. Beachten Sie, dass diese Schritte je nach Ihrer Excel-Version und den Windows-Einstellungen geringfügig variieren können, sollten jedoch in den meisten Versionen von Excel ähnlich sein.<br><br>
| |
| === Hinweis zur Vorprüfung von CSV-Dateien im OmniSeller<br> ===
| |
| <p>Beim Import von CSV-Dateien in unser System können verschiedene Fehler auftreten, insbesondere wenn CSV-Dateien manuell bearbeitet oder in unterschiedlichen Formaten gespeichert wurden. Ein häufiges Problem sind leere Spaltennamen im Header der CSV-Datei. Dieser Beitrag beschreibt, warum das Fehlen von Spaltennamen problematisch sein kann und welche Prüfungen im System implementiert sind, um solche und ähnliche Fehler frühzeitig zu erkennen.</p>
| |
| === Fehlende Spaltennamen im Header ===
| |
| <p>Das System erwartet, dass jede Spalte im Header der CSV-Datei einen Namen hat. Wenn Spalten ohne Namen vorhanden sind, kann dies die Verarbeitung der Datei beeinträchtigen. Beispielsweise können bestimmte Funktionen, wie die Prüfung auf doppelte Zeilen, nicht ordnungsgemäß arbeiten, wenn keine vollständigen Spaltennamen vorliegen. Leere Spaltennamen können besonders dann entstehen, wenn CSV-Dateien manuell bearbeitet werden, z. B. in einem Texteditor anstelle eines Tabellenprogramms wie Excel.</p><p>In manchen Fällen können sogar „phantomartige“ Spalten entstehen, wenn die CSV-Struktur durch versehentliches Löschen oder Hinzufügen von Spalten verändert wurde. Solche unbeabsichtigten Änderungen können die Datenstruktur destabilisieren und unerwartete Fehler verursachen.</p>
| |
| === Warum leere Spaltennamen problematisch sind ===
| |
| <p>Die Funktion zur Erkennung doppelter Zeilen im CSV-Import prüft die gesamte Zeile und nutzt dabei die Header-Namen zur Identifizierung der Felder. Wenn jedoch leere Spaltennamen vorhanden sind, kann dies die Zuordnung der Felder durcheinanderbringen und zu unerwarteten Fehlern führen. Ein typisches Beispiel für ein solches Problem tritt auf, wenn eine CSV-Datei in einem Texteditor bearbeitet wird, ohne dass alle Werte korrekt maskiert sind. Zum Beispiel kann ein unmaskiertes Semikolon in einem Textwert die Spaltenstruktur verschieben und zu einem „Datensalat“ führen.</p>
| |
| === Prüfungen im CSV-Importprozess ===
| |
| <p>Um Probleme beim Import zu vermeiden und sicherzustellen, dass die Daten korrekt verarbeitet werden, führt das System verschiedene Vorprüfungen durch. Diese sollen sicherstellen, dass die CSV-Datei eine logische Struktur aufweist und alle Daten in den erwarteten Formaten vorliegen. Zu den wichtigsten Prüfungen gehören:</p>
| |
| #<p>'''Prüfung auf gleichmäßige Spaltenanzahl'''<br>Überprüft, ob alle Zeilen die gleiche Anzahl an Spalten enthalten. Uneinheitliche Spaltenanzahlen deuten auf Formatierungsfehler hin.</p>
| |
| #<p>'''Prüfung auf maximale Feldlänge'''<br>Prüft, ob irgendein Feld die festgelegte maximale Länge überschreitet. So wird verhindert, dass überlange Inhalte in Felder geschrieben werden, die diese Daten nicht speichern können.</p>
| |
| #<p>'''Prüfung auf doppelte Zeilen'''<br>Sucht nach doppelten Zeilen in der CSV-Datei. Dies hilft, redundante oder fehlerhafte Daten zu vermeiden.</p>
| |
| #<p>'''Prüfung auf erwartetes Datenformat'''<br>Überprüft, ob Felder das erwartete Format einhalten, zum Beispiel ob Datumsfelder korrekt formatiert sind oder Zahlenfelder tatsächlich numerische Werte enthalten.</p>
| |
| #<p>'''Prüfung auf Codierung der Datei'''<br>Die Datei wird auf die richtige Codierung (z. B. UTF-8) geprüft, um sicherzustellen, dass Sonderzeichen korrekt interpretiert werden.</p>
| |
| #<p>'''Prüfung auf erwartete Spaltenüberschriften'''<br>Überprüft, ob die CSV-Datei alle erwarteten Spaltennamen enthält. Fehlende oder leere Spaltennamen können zu Verarbeitungsfehlern führen.</p>
| |
| #<p>'''Spezielle Prüfung des Artikelnummernfelds'''<br>Das System prüft die Länge der Artikelnummer und stellt sicher, dass sie die maximale erlaubte Länge (z. B. 31 Zeichen) nicht überschreitet. Dies verhindert, dass lange Texte versehentlich im Artikelnummernfeld landen.</p>
| |
| #<p>'''Prüfung auf US-Datumsformate'''<br>Sucht nach Datumswerten im US-Format und gibt eine Warnung aus, wenn solche gefunden werden, um Formatkonflikte zu vermeiden.</p>
| |
CSV-Dateien für den OmniSeller-Import
Die Importe im OmniSeller PIM erwarten Semikolon-getrennte CSV-Dateien mit Spaltenüberschriften in der ersten Zeile („Excel-kompatibles CSV"). Die Spalten werden in den Import-Fenstern anhand der Überschriften zugeordnet - jede Spalte braucht deshalb einen eindeutigen, nicht leeren Namen.
Anforderungen
- Trennzeichen: Semikolon (
;). Kommagetrennte Dateien werden nicht akzeptiert.
- Kopfzeile: erste Zeile enthält die Spaltennamen, keine leeren Überschriften.
- Textqualifizierer: Werte, die selbst ein Semikolon oder Zeilenumbrüche enthalten, müssen in Anführungszeichen stehen (
"Wert; mit Semikolon"). Excel erledigt das beim Speichern automatisch - beim Bearbeiten im Texteditor ist das die häufigste Fehlerquelle: ein unmaskiertes Semikolon verschiebt alle folgenden Spalten der Zeile.
- Kodierung: Die Dateien werden mit der Windows-Standardkodierung (ANSI) gelesen; UTF-8 wird nur erkannt, wenn die Datei mit BOM gespeichert wurde. Das übliche „CSV (Trennzeichen-getrennt)" aus Excel passt.
Speichern aus Excel
In Excel Datei → Speichern unter → Dateityp „CSV (Trennzeichen-getrennt)" wählen. Ob Excel Semikolon oder Komma schreibt, richtet sich nach dem Listentrennzeichen der Windows-Regionseinstellungen - bei deutschen Einstellungen ist das Semikolon der Standard. Nach dem Speichern die Datei im Zweifel kurz im Texteditor öffnen und prüfen, dass Semikolons als Trenner verwendet werden.
Vorprüfung beim Import
Vor jedem CSV-Import prüft OmniSeller die Datei. Es gibt zwei Stufen:
Harte Fehler - der Import startet nicht:
- falsches Trennzeichen bzw. Datei ist kein lesbares CSV
- uneinheitliche Spaltenanzahl über die Zeilen (typisch: unmaskiertes Semikolon in einem Wert)
- Werte in der Artikelnummernspalte länger als 31 Zeichen (deutet auf eine verrutschte Spaltenzuordnung hin)
- Datei größer als 1 GB
Warnungen - der Import kann per Ja/Nein-Abfrage trotzdem gestartet werden:
- leere Felder in Datenzeilen
- doppelte Zeilen
- auffällige Werte in nicht zugeordneten Spalten (die Meldung nennt Wert, Spalte und Zeile)
- einzelne Felder länger als 8.000 Zeichen
Die Warnungen sind Hinweise auf mögliche Formatprobleme - wer seine Datei kennt, kann sie übergehen. Bei harten Fehlern die Datei in Excel öffnen, korrigieren und neu als Semikolon-CSV speichern.
