Benutzer per CSV importieren

Benutzer-Import per CSV

Für das gleichzeitige Hinzufügen vieler Benutzer können Sie eine CSV-Datei importieren.

CSV-Datei vorbereiten

Format der CSV-Datei

Ihre CSV-Datei sollte folgende Spalten enthalten:

email,first_name,last_name,groups
max.mustermann@firma.de,Max,Mustermann,Vertrieb
anna.schmidt@firma.de,Anna,Schmidt,"Vertrieb,Marketing"
peter.weber@firma.de,Peter,Weber,IT

Pflicht- und optionale Felder

Feld	Pflicht	Beschreibung
email	Ja	E-Mail-Adresse des Benutzers
first_name	Optional	Vorname
last_name	Optional	Nachname
groups	Optional	Gruppen (kommagetrennt bei mehreren)

Wichtige Hinweise zum Format

• Trennzeichen: Komma (,) oder Semikolon (;)
• Kodierung: UTF-8 für Umlaute (ä, ö, ü)
• Mehrere Gruppen: In Anführungszeichen, kommagetrennt

Import durchführen

Schritt für Schritt

1. Gehen Sie zu Admin > Benutzer
2. Klicken Sie auf “Importieren” oder “CSV-Import”
3. Klicken Sie auf “Datei auswählen”
4. Wählen Sie Ihre CSV-Datei
5. Klicken Sie auf “Hochladen”

Vorschau prüfen

Nach dem Hochladen sehen Sie eine Vorschau:

• Anzahl der zu importierenden Benutzer
• Erkannte Spalten
• Eventuelle Fehler oder Warnungen

Import bestätigen

1. Prüfen Sie die Vorschau sorgfältig
2. Korrigieren Sie eventuelle Fehler in der CSV
3. Klicken Sie auf “Import starten”

Nach dem Import

Was passiert?

• Alle Benutzer erhalten eine Einladungs-E-Mail
• Benutzer werden den angegebenen Gruppen zugewiesen
• Status aller Benutzer ist zunächst “Ausstehend”

Import-Bericht

Nach Abschluss sehen Sie:

• Erfolgreich importiert: Anzahl der neuen Benutzer
• Übersprungen: Bereits existierende E-Mail-Adressen
• Fehler: Ungültige Zeilen mit Fehlerbeschreibung

Fehlerbehandlung

Häufige Fehler

Fehler	Ursache	Lösung
”Ungültige E-Mail”	E-Mail-Format falsch	E-Mail-Adresse korrigieren
”Gruppe nicht gefunden”	Gruppenname existiert nicht	Gruppe erst erstellen oder Namen prüfen
”Benutzer existiert”	E-Mail bereits registriert	Zeile entfernen oder ignorieren
”Encoding-Fehler”	Falsche Datei-Kodierung	Als UTF-8 speichern

CSV-Datei korrigieren

1. Öffnen Sie die CSV in einem Texteditor oder Excel
2. Korrigieren Sie die fehlerhaften Zeilen
3. Speichern Sie als CSV (UTF-8)
4. Führen Sie den Import erneut durch

CSV erstellen mit Excel

Aus Excel exportieren

1. Erstellen Sie die Daten in Excel
2. Gehen Sie zu Datei > Speichern unter
3. Wählen Sie “CSV UTF-8 (Kommagetrennt)”
4. Speichern Sie die Datei

Spaltenüberschriften

Achten Sie auf die exakten Spaltennamen:

• email (nicht “E-Mail” oder “Email”)
• first_name (nicht “Vorname”)
• last_name (nicht “Nachname”)
• groups (nicht “Gruppen”)

Vorlage herunterladen

Laden Sie unsere Vorlage herunter, um das richtige Format zu verwenden:

1. Gehen Sie zum Import-Dialog
2. Klicken Sie auf “Vorlage herunterladen”
3. Öffnen Sie die Vorlage in Excel
4. Füllen Sie Ihre Daten ein

Best Practices

Vor dem Import

• Gruppen erstellen: Alle referenzierten Gruppen müssen existieren
• Daten prüfen: E-Mail-Adressen auf Tippfehler kontrollieren
• Kleine Tests: Erst mit wenigen Zeilen testen

Während des Imports

• Geduld: Große Imports können einige Minuten dauern
• Nicht unterbrechen: Browser-Tab offen lassen

Nach dem Import

• Bericht prüfen: Alle Benutzer erfolgreich importiert?
• Stichproben: Einige Benutzer manuell prüfen
• Einladungen: Bestätigen Sie den Erhalt bei einigen Benutzern