CSV-Import
Der Import-Assistent führt Sie in vier Schritten durch den Import einer CSV-Datei. Bestehende Datensätze werden anhand eines Duplikatschlüssels erkannt und automatisch aktualisiert (Upsert-Logik).
UnterstĂĽtzte Formate
| Eigenschaft | Wert |
|---|---|
| Dateiformat | .csv (Textdatei) |
| Zeichencodierung | UTF-8 |
| Maximale Dateigröße | 50 MB |
| Trennzeichen | Automatische Erkennung: Semikolon (;), Komma (,), Tab, Pipe (|) |
Tipp: Speichern Sie Excel-Dateien vor dem Import als CSV UTF-8 (durch Trennzeichen getrennt) ab. So vermeiden Sie Umlaute-Probleme.
Schritt 1: Datei und Zieltabelle
- Klicken Sie auf Datei auswählen und wählen Sie Ihre CSV-Datei aus.
- Das System erkennt das Trennzeichen automatisch. Bei Bedarf können Sie es manuell anpassen.
- Wählen Sie die Zieltabelle, in die importiert werden soll:
| Zieltabelle | DuplikatschlĂĽssel |
|---|---|
Artikel (products) | sku |
Lieferanten (suppliers) | name |
Lagerplätze (storage_locations) | name |
Bestände (stock) | product_id |
Lieferanten-Artikel (supplier_products) | product_id |
Der DuplikatschlĂĽssel bestimmt, ob ein Datensatz als neu (Insert) oder bereits vorhanden (Update) erkannt wird.
Schritt 2: Spaltenzuordnung
Nach dem Hochladen wird jede Spalte Ihrer CSV-Datei einem Feld der Zieltabelle zugeordnet. Der Assistent versucht, Spalten automatisch anhand von Synonymen zuzuordnen.
Status-Farben
| Farbe | Bedeutung | Ăśbereinstimmung |
|---|---|---|
| GrĂĽn | Automatisch zugeordnet | >= 90 % |
| Gelb | Vorschlag vorhanden | 50 — 90 % |
| Rot | Nicht zugeordnet | < 50 % |
- Grüne Spalten sind bereits korrekt zugeordnet und benötigen in der Regel keine Anpassung.
- Gelbe Spalten haben einen Vorschlag, den Sie prüfen und bei Bedarf ändern sollten.
- Rote Spalten mĂĽssen manuell zugeordnet oder ĂĽbersprungen werden.
Hinweis: Die vollständige Liste aller Synonyme finden Sie in der Feldreferenz. Wenn Sie Ihre CSV-Spalten nach diesen Synonymen benennen, gelingt die automatische Zuordnung zuverlässiger.
Schritt 3: Vorschau und Dry-Run
Bevor Daten tatsächlich geschrieben werden, führt das System eine Validierung (Dry-Run) durch. Sie sehen eine Vorschau aller Zeilen mit dem geplanten Ergebnis:
Zeilen-Aktionen
| Aktion | Beschreibung |
|---|---|
| Insert | Neuer Datensatz, wird angelegt |
| Update | Bestehender Datensatz gefunden (per DuplikatschlĂĽssel), wird aktualisiert |
| Skip | Zeile wird ĂĽbersprungen (z. B. keine Ă„nderung erkannt) |
| Error | Validierungsfehler (z. B. Pflichtfeld fehlt, ungĂĽltiger Datentyp) |
Zeilenauswahl
Über Checkboxen können Sie einzelne Zeilen vom Import ausschließen. Entfernen Sie die Markierung bei Zeilen, die Sie nicht importieren möchten.
Fehlermodus
| Modus | Verhalten |
|---|---|
| Tolerant | Fehlerhafte Zeilen werden ĂĽbersprungen, alle gĂĽltigen Zeilen werden importiert |
| Strikt | Der gesamte Import wird abgebrochen, sobald ein Fehler auftritt |
Wählen Sie Tolerant, wenn Sie möglichst viele Datensätze übernehmen und Fehler nachträglich korrigieren möchten. Wählen Sie Strikt, wenn die Datenkonsistenz aller Zeilen gewährleistet sein muss.
Schritt 4: Ergebnis
Nach Abschluss des Imports sehen Sie eine Zusammenfassung:
| Kategorie | Beschreibung |
|---|---|
| Erfolgreich | Anzahl der eingefügten und aktualisierten Datensätze |
| Übersprungen | Zeilen ohne Änderung oder manuell abgewählt |
| Fehlerhaft | Zeilen mit Validierungsfehlern |
Wenn fehlerhafte Zeilen vorhanden sind, können Sie diese als CSV-Datei herunterladen. Die heruntergeladene Datei enthält die Originalzeilen ergänzt um eine Spalte mit der Fehlerbeschreibung. Korrigieren Sie die Fehler und importieren Sie die Datei erneut.
Häufige Fehler
| Fehler | Ursache | Lösung |
|---|---|---|
| Pflichtfeld fehlt | Eine Pflicht-Spalte wurde nicht zugeordnet oder ist leer | Stellen Sie sicher, dass alle Pflichtfelder in der CSV vorhanden und befĂĽllt sind |
| UngĂĽltiger Datentyp | Text in einer Zahlenspalte, fehlerhafte Dezimaltrennzeichen | PrĂĽfen Sie das Format: Dezimalzahlen mit Punkt (.), Ganzzahlen ohne Nachkommastellen |
| Duplikat nicht gefunden | Der Wert im Duplikatschlüssel stimmt mit keinem bestehenden Datensatz überein | Das ist normal bei neuen Datensätzen — sie werden als Insert angelegt |
| UUID ungültig | Eine ID-Spalte enthält keinen gültigen UUID-Wert | Verwenden Sie die vollständige UUID im Format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
| Datei zu groĂź | Die CSV-Datei ĂĽberschreitet 50 MB | Teilen Sie die Datei in kleinere Abschnitte auf |
| Zeichencodierung | Umlaute oder Sonderzeichen werden falsch dargestellt | Speichern Sie die Datei als UTF-8 |
Tipps fĂĽr fehlerfreie Importe
- Feldreferenz nutzen — Benennen Sie Ihre CSV-Spalten nach den Synonymen in der Feldreferenz, damit die automatische Zuordnung greift.
- Kleine Testdatei zuerst — Importieren Sie zunächst 5—10 Zeilen im strikten Modus, um die Zuordnung und Validierung zu prüfen.
- Vorlage speichern — Speichern Sie eine erfolgreiche Import-Konfiguration als Vorlage, um sie beim nächsten Mal wiederzuverwenden.
- Dezimaltrennzeichen beachten — Verwenden Sie den Punkt (
.) als Dezimaltrennzeichen, nicht das Komma. - Leere Zeilen vermeiden — Entfernen Sie leere Zeilen am Ende der Datei, da diese zu unnötigen Fehlern führen können.