Zum Inhalt springen

OmniSeller:CSV-Datei: Unterschied zwischen den Versionen

Aus HTK Wiki
Keine Bearbeitungszusammenfassung
Gestrafft und an tatsächliche Vorprüfung angepasst: harte Fehler vs. Warnungen, ANSI/BOM-Kodierung, 31-Zeichen-Artikelnummern-Check; Excel-Grundkurs gekürzt
 
(4 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:


Um eine Datei in Microsoft Excel als CSV-Datei mit einem Semikolon als Trennzeichen zu speichern, befolgen Sie diese Schritte:
'''Harte Fehler''' - der Import startet nicht:


1. Öffnen Sie Ihre Excel-Datei: Starten Sie Microsoft Excel und öffnen Sie die Arbeitsmappe, die Sie als CSV-Datei speichern möchten.
* 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


2. Überprüfen Sie Ihre Daten: Stellen Sie sicher, dass Ihre Daten korrekt und in der gewünschten Form in der Excel-Tabelle vorliegen.
'''Warnungen''' - der Import kann per Ja/Nein-Abfrage trotzdem gestartet werden:


3. Speichern unter: Gehen Sie zum Menü "Datei" oben links in der Excel-Oberfläche.
* 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


4. Speichern unter auswählen: Wählen Sie "Speichern unter" aus. Dies öffnet das Dialogfeld "Speichern unter".
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.
 
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.
 
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.
 
7. Speichern: Klicken Sie auf die Schaltfläche "Speichern", nachdem Sie den Dateityp ausgewählt haben.
 
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.

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.