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
 
(3 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 ===


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

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.