Zum Inhalt springen

OmniSeller:CSV-Datei: Unterschied zwischen den Versionen

Aus HTK Wiki
Die Seite wurde neu angelegt: „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. Hier ist eine Erklärung dazu: - 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 Sem…“
 
Gestrafft und an tatsächliche Vorprüfung angepasst: harte Fehler vs. Warnungen, ANSI/BOM-Kodierung, 31-Zeichen-Artikelnummern-Check; Excel-Grundkurs gekürzt
 
(5 dazwischenliegende Versionen desselben Benutzers werden 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. Hier ist eine Erklärung dazu:
== 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 ===


  1. Trennzeichen: Das Trennzeichen, das die einzelnen Datenfelder voneinander trennt, sollte konsistent verwendet werden. In unseren Fällen ist dies ein Semikolon.
* '''Trennzeichen:''' Semikolon (<code>;</code>). 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 (<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.
* '''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.


  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".
=== Speichern aus Excel ===


  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.
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.


- 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.
== Vorprüfung beim Import ==


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.
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.

Aktuelle Version vom 24. August 2026, 12:12 Uhr

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.