Skip to main content

CSV Import

Spezifikation CSV-Aufbau für Personenimport


Header Am einfachsten gelangt man zu einer CSV-Vorlage, indem man sie hier (import_vorlage.csv) herunterlädt, oder eine bereits bestehende Person exportiert. Das durch den Export erhaltene CSV-File kann anschliessend angepasst und dann als Import-CSV verwendet werden.

Grundsätzlich muss der Header des CSV-Files wie folgt aussehen: 

image.png


Die Reihenfolge ist zwingend, wird eine Spalte verschoben, gelöscht, oder hinzugefügt ist der Import nicht mehr möglich. 
Feld / Spalte
Erklärung
date Pflichtfeld Zeigt an, wann die Datei exportiert wurde. Ist für den Import nicht relevant.
language Pflichtfeld Ist ein Pflichtfeld und muss befüllt werden, Möglichkeiten "de", "fr", "en", "it". Die erfasste Sprache definiert in welcher Sprache die Merkmale (OE/Tätigkeit) im System gegengeprüft oder importiert werden.
encoding Pflichtfeld Definiert die Zeichenkodierung (erlaubt die eindeutige Zuordnung von Schriftzeichen - sollte nicht geändert werden)
person_id

Optional

System-ID des Benutzer.

  • Import von neuen Personen:
    Feld wird leer gelassen, ID wird vom System beim Import automatisch vergeben 

  • Import/Aktualisierung von vorhandenen Personen: Vorhandene ID wird beim Aktualisieren einer Person als Identifikation verwendet, darf nicht verändert werden.
status Pflichtfeld
  • enabled = aktiviert
  • archived = archiviert
  • disabled = deaktiviert
name Pflichtfeld Pflichtfeld
prename Pflichtfeld Pflichtfeld
username Pflichtfeld Pflichtfeld
password Optional Import von neuen Personen:
  • Wird hier ein Passwort gesetzt kann sich der User damit einloggen.
  • Wird hier kein Passwort definiert (empfohlen) muss der Benutzer im Loginprozess ein neues Passwort  mittels der "Passwort vergessen"-Funktion erstellen.
Import/Aktualisierung von vorhandenen Personen:
  • Wird hier ein Passwort gesetzt, wird das bereits bestehende Passwort der Benutzer überschrieben
  • Wird hier kein Passwort definiert, bleibt das bestehende Passwort der Benutzer unberührt
email Pflichtfeld Pflichtfeld, es wird geprüft ob es sich beim Eintrag um eine formal gültige Emailadresse handelt.
personal-id Optional
  • Interne Personalnummer, nicht zu verwechseln mit "person-id".
  • Dieses Feld ist optional
  • Es gibt keine Mindestlänge, Maximallänge ist 255 Zeichen
  • Muss nicht eindeutig sein
role

Pflichtfeld

Es handelt sich um ein Pflichtfeld

Es gibt folgende Möglichkeiten, 


  • learner
  • default-subadministrator
  • administrator
Niedrige Rollen können keine höheren Rollen importieren oder ändern!
language Pflichtfeld Es handelt sich um ein Pflichtfeld. Vorhandene Sprachen (de, en, fr, it).
orgunit, jobdescription Optional (orgunits/jobdescription) for Admin
  • OE/Tätigkeit können beim Import leer sein. (Vorsicht: nach leeren OE/Tätigkeiten kann nicht gesucht werden)
  • Ist eine OE/Tätigkeit in der Liste, aber noch nicht im System vorhanden, dann wird diese neu angelegt.
  • Ist eine neue OE/Tätigkeit in der Liste, im System ist jedoch eine andere hinterlegt, wird die alte entfernt und die neue hinzugefügt, die OE/Tätigkeit wird durch den Import ausgetauscht.
  • Möchte man eine zweite OE/Tätigkeit im System ergänzen muss auch die alte OE/Tätigkeit in der Liste vorhanden sein. Die Erfassung von mehreren muss mit dem Zeichen " | " getrennt werden.
  • Möchte man eine Pfad einer OE/Tätigkeit im System erfassen, muss dies mit dem Zeichen " / " erfolgen.
is_deletable Pflichtfeld Definiert ob die angelegte Person mit der Einstellung "löschbar ja/nein" erstellt wird.
  • 0 = Nein (Person ist nicht löschbar)
  • 1 = ja (Person ist löschbar)
change_password Pflichtfeld Definiert ob die angelegte Person mit der Einstellung "PW-ändern ja/nein" erstellt wird.
Es handelt sich um ein Pflichtfeld, und folgende Einstellungen sind möglich:
  • 0 = Nein (Person muss beim nächsten Login das PW nicht ändern)
  • 1 = ja (Person muss beim nächsten Login das PW ändern)
  • leer = keine Änderung

Bei einem Export sind die Felder in "change_password" leer.

Vorhandene Person ändern:
Mit der person_id wird die Person eindeutig identifiziert. Ist die ID bereits im System vorhanden, werden die vorhanden Personendaten mit den neuen Daten aus der Liste überschrieben. Ist die ID noch nicht im System oder das Feld leer, kann die Person über drei weitere Felder identifiziert werden.

Identifizierungsmöglichkeiten werden in folgender Priorität geprüft:
1. person_id
2. personal_id
3. email
4. username

 
Speicherung unter OSX

Speicherung von Listen unter OSX in Excel: "Windows Comma Separated" wählen.