Benutzerverzeichnis: CSV-Import

Du kannst Nutzer über eine CSV-Datei importieren und synchronisieren. Nutzer, die über eine CSV-Datei importiert werden, erhalten keine automatische Willkommens-E-Mail. Du musst die Nutzer also manuell über ihre Konten und Login-Informationen informieren.

Das Importieren von Nutzern aus dem CSV-Benutzerverzeichnis fügt neue Nutzer hinzu und synchronisiert bestehende Nutzer. Wenn ein Nutzer zuvor über eine CSV-Datei erstellt wurde, aber nicht mehr in einer später hochgeladenen Datei enthalten ist, wird das System sie basierend auf den Einstellungen Synchronisation > Verwaiste Benutzer behandeln. Wenn die Einstellungen nicht auf Ignorieren gesetzt sind, werden die verwaisten Nutzer entweder deaktiviert oder gelöscht, abhängig von der ausgewählten Option.

Während das direkte Synchronisieren von Profilfeld-Informationen der Nutzer über den CSV-Import nicht möglich ist, kannst Du effektiv Profilfeld-Informationen für Deine Nutzer mithilfe der Haiilo-API hinzufügen. Erfahre mehr unter API: Aktualisieren von Nutzerprofilinformationen.

Struktur einer CSV-Datei

Um Deine Nutzer zu importieren, benötigst Du eine Datei im CSV-Format. Die Datei sollte für jeden Eintrag Folgendes enthalten:

Feld Typ
Eindeutiger Identifikator Erforderlich
Vorname Erforderlich
Nachname Erforderlich
Loginname Erforderlich
E-Mail Optional
Gruppe(n) Optional
Initiales Passwort Optional

Die Daten müssen in der oben genannten Reihenfolge in den Spalten der CSV-Datei stehen. Zusätzlich sollten auch folgende Anforderungen beachtet werden:

  • Die Datei sollte keine Kopfzeilen enthalten
  • Die Felder eines Eintrags sollten durch Kommas getrennt sein. Optionale Felder sollten auch durch Kommas getrennt sein, auch wenn sie keine Werte enthalten.
  • Einträge sollten durch einen Zeilenumbruch getrennt sein.
  • Jede Zelle sollte als Text formatiert sein.
  • Wenn ein Nutzer zu mehreren Gruppen gehört, sollten die Gruppennamen durch einen senkrechten Strich (|) getrennt sein.
  • Ein Passwort darf kein Anführungszeichen " enthalten, da es als Formatierungsoption fungiert. 
    • Hinweis: Wenn kein initiales Passwort angegeben ist, muss der Nutzer ein Passwort über die Funktion Passwort vergessen? anfordern. Das Passwort wird nicht überschrieben, wenn der Nutzer in zukünftigen CSV-Uploads aktualisiert wird.
  • Das Format sollte UTF-8 ohne BOM sein

So könnte eine CSV-Datei aussehen:

CSV-Datei.png

Wir haben eine Beispieldatei im CSV-Format am Ende dieses Artikels angehängt.

Nutzer aus einer CSV-Datei synchronisieren

Du benötigst die Berechtigung "Verwaltung der Benutzerverzeichnisse", um ein CSV-Benutzerverzeichnis zu erstellen.

  1. Gehe zu Administration > Benutzerverzeichnisse
  2. Wähle Verzeichnis anlegen, um ein neues Benutzerverzeichnis hinzuzufügen
  3. Gib einen Namen ein
  4. Wähle einen Typ: CSV
  5. Aktiviere Aktiv, wenn dieses neue Benutzerverzeichnis direkt aktiviert werden soll
  6. Wähle die CSV-Datei von deinem Computer
  7. Unter dem Tab Synchronisation kannst Du:
    • Aktivierung: Wähle aus, um neue und wiederhergestellte Nutzer automatisch zu aktivieren, die in der Datei gefunden wurden
    • Verwaiste Benutzer: Wähle aus, was mit verwaisten Nutzern geschehen soll, d.h. Nutzer, die in einer früheren Importdatei enthalten waren, aber nicht in späteren Importdateien. Diese können entweder ignoriert, deaktiviert oder gelöscht werden.
    • Benutzer wiederherstellen: Wähle aus, ob gelöschte oder deaktivierte Nutzer wiederhergestellt werden sollen, wenn sie bei einem erneuten CSV-Import auftauchen.
  8. Wähle Speichern, um mit der Synchronisierung der Nutzer zu beginnen. Wenn die Datei einen Fehler enthält, wird eine Fehlermeldung angezeigt, die anzeigt, in welcher Spalte sich der Fehler befindet. Stelle sicher, dass deine Datei den oben beschriebenen Anforderungen entspricht.

Nach dem ersten Import, wenn Du eine neue CSV-Datei hochladen möchtest, um Deine Nutzer zu aktualisieren, musst Du das bestehende CSV-Benutzerverzeichnis in der Liste der Benutzerverzeichnisse bearbeiten. Du kannst kein neues CSV-Benutzerverzeichnis erstellen.

Beispiel einer CSV-Datei

War dieser Beitrag hilfreich?