CSV-Dateiimport
Wenn Sie Pakete an eine grosse Anzahl von Empfängern senden möchten, können Sie die Datei-Import-Funktion nutzen.
Profil erstellen
Vor dem Import müssen Sie ein Importprofil erstellen.
- Gehen Sie zu Profile → Adressen oder Sendungen → drücken Sie +
- Wählen Sie Importtyp → Adressen oder Sendungen
- Geben Sie einen Profilnamen ein (z. B. Adressbuch)
- Wählen Sie Importdateityp → CSV
Der Rest bleibt standardmässig.
- Drücken Sie Weiter
- Drücken Sie Datei hochladen
- Drücken Sie Datei verarbeiten
- Weisen Sie die Feldnamen entsprechend den Kopfzeilennamen in Ihrer CSV-Datei zu
Wenn Sie eine CSV-Datei ohne Kopfzeile haben, besteht die Dropdown-Liste aus Position 0, 1, 2 usw. Die erste Spalte (A) des Tabellenblatts entspricht Position 0.
Die Spalte Funktion kann unverändert bleiben.
Falls erforderlich, fügen Sie eine Transformation hinzu — diese wird erstellt und verwendet, wenn Daten aus der CSV-Datei für den Import angepasst werden müssen. Zum Beispiel wenn der Ländername in Ihrer Datei "Schweiz" lautet, unser System es aber im Format ISO 3166-1 alpha-2 ("CH") benötigt.
Sobald alle Pflicht- (und optionalen) Feldnamen eingegeben sind, drücken Sie Speichern.
CSV-Datei hochladen
- Gehen Sie zu Datei-Importe
- Drücken Sie Datei importieren oben rechts
- Wählen Sie das Profil (der Name, den Sie in Schritt 1 eingegeben haben)
- Laden Sie die CSV-Datei hoch und drücken Sie Importieren
- Drücken Sie Aktualisieren
Die importierten Informationen erscheinen in Ihrem Adressbuch oder Ihren Sendungen.
Technische Anforderungen für CSV-Dateien
Das System unterstützt flexible CSV-Formate mit automatischer Kopfzeilenerkennung und mehreren Kodierungs- und Trennzeichenoptionen.
Zeichenkodierung
Wählen Sie eine der unterstützten Kodierungen:
| Kodierung | Anwendungsfall | Hinweise |
|---|---|---|
| UTF-8 | Empfohlen für alle Dateien | Universelle Unterstützung, alle Sonderzeichen |
| ISO-8859-1 | Westeuropäische Sprachen | Deutsche Umlaute (ä, ö, ü), französische Akzente |
| Windows-1251 | Kyrillische Zeichen | Ukrainisch, Bulgarisch |
Speichern Sie Ihre CSV-Datei als UTF-8 in Excel: Datei → Speichern unter → CSV UTF-8 (durch Komma getrennt)
Feldtrennzeichen
| Trennzeichen | Symbol | Excel-Export (Region) | Wann verwenden |
|---|---|---|---|
| Semikolon | ; | Europäisches Excel (DE/FR/IT) | Empfohlen für europäische Regionen |
| Komma | , | US/UK Excel | Daten enthalten keine Kommas |
| Tabulator | \t | Manueller Export | Daten enthalten viele Sonderzeichen |
| Pipe | | | Datenbankexporte | Technische Integrationen |
Ihre Daten dürfen das Trennzeichen nicht enthalten oder müssen korrekt in Anführungszeichen gesetzt sein.
CSV-Kopfzeilenformat
Kopfzeilen müssen mit einem Buchstaben (A–Z, a–z) oder einem Unterstrich (_) beginnen.
Erlaubte Zeichen in Kopfzeilen (nach dem ersten Zeichen):
| Zeichen | Beispiele |
|---|---|
| Buchstaben | A–Z, a–z |
| Zahlen | 0–9 |
| Unterstrich | _ |
| Bindestrich | - |
| Punkt | . |
| Leerzeichen | |
| Klammern | ( ) |
| Schrägstrich | / |
| Doppelpunkt | : |
| Kaufmännisches Und | & |
| Komma | , |
Nicht erlaubt als erstes Zeichen: Zahlen, Sonderzeichen ($, #, @, ! usw.)
Gültige Kopfzeilen-Beispiele:
Name;Adresse1;PLZ;Land
DokStatus;DokDat.;Bestell_Nr;Gewicht.KG
Kundenname;Strasse & Hausnummer;Datum/Zeit;Status (Aktiv)
empfaenger_name;empfaenger_adresse;sendungsnummer
Ungültige Kopfzeilen-Beispiele:
123;456;789 (beginnt mit Zahl)
$Betrag;#ID;@Email (Sonderzeichen: $, #, @)
;Name;Adresse (erste Spalte leer)
Automatische Kopfzeilenerkennung
Das System erkennt automatisch, ob die erste Zeile eine Kopfzeile ist:
- Kopfzeilen-Eigenschaften: enthält mindestens einen Buchstaben, nicht rein numerisch, entspricht dem erlaubten Zeichenmuster
- Dateneigenschaften: zweite Zeile enthält Zahlen, E-Mails oder deutlich anderen Text; Längenunterschied > 3 Zeichen zur Kopfzeile
| Erste Zeile | Zweite Zeile | Erkennungsergebnis |
|---|---|---|
Name;Adresse;Gewicht | Max Mustermann;Hauptstr. 1;2.5 | Kopfzeile erkannt |
Kunde;Auftrag;Gesamt | ACME GmbH;12345;99.99 | Kopfzeile erkannt |
123;456;789 | 111;222;333 | Keine Kopfzeile (alle numerisch) |
Aktiv;Ausstehend;Fertig | Aktiv;Fertig;Ausstehend | Mehrdeutig (ähnliche Textlängen) |
CSV-Konfigurationsparameter
| Parameter | Typ | Beschreibung | Beispielwerte |
|---|---|---|---|
columnDelimiter | Zeichenkette | Zeichen zur Feldseparierung | ; , \t | |
decimalSeparator | Zeichenkette | Dezimaltrennzeichen für Zahlen | . (US) oder , (EU) |
multiValueDelimiter | Zeichenkette | Trennzeichen für Mehrfachwertfelder | | ; , |
containsHeader | Boolean | Ob erste Zeile eine Kopfzeile ist | true / false |
Dezimaltrennzeichen-Beispiele:
Europäisches Format (Komma als Dezimaltrennzeichen):
Name;Gewicht;Preis
Produkt A;2,5;19,99
Produkt B;1,8;15,50
US-Format (Punkt als Dezimaltrennzeichen):
Name,Gewicht,Preis
Produkt A,2.5,19.99
Produkt B,1.8,15.50
CSV-Dateien aus Excel erstellen
-
Daten vorbereiten:
- Erste Zeile = Kopfzeilen
- Keine leeren Zeilen oben
- Konsistente Spaltenanzahl
-
Als CSV speichern:
- Europäisch (Semikolon): Datei → Speichern unter → CSV (Semikolon getrennt) *.csv
- UTF-8: Datei → Speichern unter → CSV UTF-8 (durch Komma getrennt) *.csv
- US (Komma): Datei → Speichern unter → CSV (durch Komma getrennt) *.csv
-
Kodierung prüfen:
- Datei in Notepad oder TextEdit öffnen
- Prüfen, ob Sonderzeichen (ä, ö, ü, é) korrekt angezeigt werden
Häufige Probleme & Lösungen
Sonderzeichen werden falsch angezeigt
Problem: Müller erscheint als Müller
Lösung: Datei als UTF-8 speichern. In Excel das Format "CSV UTF-8" verwenden, nicht normales CSV. Im Texteditor prüfen, ob Sonderzeichen korrekt aussehen.
Zahlen werden nicht erkannt
Problem: 2,5 wird als Text statt als Zahl behandelt
Lösung: decimalSeparator entsprechend Ihrem Dateiformat setzen.
- Europäisch:
"decimalSeparator": "," - US/International:
"decimalSeparator": "."
Falsches Trennzeichen
Problem: Alle Daten erscheinen in der ersten Spalte
Lösung: Tatsächliches Trennzeichen in der Datei prüfen. Europäisches Excel verwendet ;, US-Excel verwendet ,. Richtiges columnDelimiter setzen.
Kopfzeile nicht erkannt
Problem: Das System behandelt die Kopfzeile als Daten
Lösung: Sicherstellen, dass Kopfzeilen mit Buchstaben beginnen (nicht mit Zahlen). "containsHeader": true explizit setzen. Prüfen, ob Datenzeilen sich von Kopfzeilen unterscheiden.
Leere Zeilen oder zusätzliche Spalten
Problem: Import schlägt fehl oder hat unerwartete Spalten
Lösung: Leere Zeilen am Anfang der Datei entfernen. Sicherstellen, dass alle Zeilen die gleiche Anzahl Spalten haben. Abschliessende Trennzeichen entfernen.
Checkliste vor dem Import
Vor dem Import überprüfen:
- Dateikodierung ist UTF-8 (oder für Ihre Sprache geeignet)
- Trennzeichen entspricht der Konfiguration (Semikolon für Europa, Komma für USA)
- Kopfzeilen beginnen mit Buchstaben (falls Kopfzeilen verwendet werden)
- Keine leeren Zeilen oben
- Konsistente Spaltenanzahl in allen Zeilen
- Dezimaltrennzeichen entspricht Ihrem Zahlenformat
- Sonderzeichen (ä, ö, ü, é) werden im Texteditor korrekt angezeigt
- Keine abschliessenden Leerzeichen oder Trennzeichen
- Dateigrösse ist angemessen (< 25 MB empfohlen)