Hinweis: Sie sind auf den Seiten der Moodle 2.8 Dokumentation. Die Dokumentation der aktuellsten Moodle-Version finden Sie hier: Nutzerliste hochladen.

Nutzerliste hochladen: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
 
(32 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Nutzerverwaltung}}
{{Nutzerverwaltung}}


{{Zum Übersetzen}}
Administrator/innen können mehrere Nutzerkonten auf einmal anlegen.
Zu finden unter: Website-Administration > Nutzer/innen > Nutzerkonten > Nutzer/innen hochladen


Es gibt verschiedene Möglichkeiten, um Nutzerinformationen hochzuladen: Sie können nicht nur neue Nutzerkonten anlegen, sondern auch Nutzer/innen mit bestimmten Rollen in Kurse einschreiben, Nutzer/innen in Gruppen eintragen, Nutzerprofile aktualisieren oder Nutzer/innen löschen. 


Die Seite "Nutzer/innen hochladen" bietet dem Administrator eine einfache und dennoch leistungsfähige Möglichkeit Nutzerdaten in Moodle zu importieren. Moodle legt für jeden Nutzer aus der Textdatei ein Benutzerkonto an und - falls erwünscht - können so auch Nutzer in Kurse eingeschrieben und Gruppen zugeordnet werden.  
Anstatt eine Textdatei mit den Nutzerdaten hochzuladen, können Sie die Datei per Drag&Drop direkt von Ihrem Desktop in den Upload-Bereich ziehen (siehe [http://youtu.be/6E-TQXTkZB0 Screencast] von Mary Cooch).
'''Tipp''': Das Hochladen einer Nutzerliste ist eine Form der [[Manuelle Authentifizierung|manuellen Verwaltung von Nutzerkonten]]. Manuelle Nutzerverwaltung ist stets mit einem gewissen Aufwand verbunden. Prüfen Sie daher sorgfältig, ob in Ihrem Moodle-System alternative Möglichkeiten der [[Authentifizierung|Authentifizierung]] in Frage kommen, z.B. die [[E-Mail-basierte Selbstregistrierung]] oder die Nutzung einer [[Externe Datenbank|externen Datenbank]].


*'''Hinweis''': Gerade in den letzten Moodle Versionen sind eine Vielzahl von Authentifizierungsmethoden hinzugekommen, um den manuellen Administrationsaufwand bei Kurseinschreibungen möglichst gering zu halten (s.a. [[Nutzer hochladen#Siehe auch|Linkliste]] am Ende des Artikels)


== Aufbau der Import-Textdatei ==


[[Bild:Nutzer-Import-Hochladen-de.jpg|thumb|Nutzerkonten: Nutzer/innen hochladen]]
==Der Uploadprozess==
Über eine einfache Textdatei können Nutzer/innen importiert, in Kurse eingeschrieben und Gruppen zugeordnet werden.  
Die einzelnen Schritte beim Hochladen einer Nutzerliste sind folgende:
#Legen Sie eine Datei mit den Nutzerdaten an. Detaillierte Informationen zur Formatierung der Datei finden Sie weiter unten.
#Gehen Sie auf die Seite ''[[Einstellungen-Block|Einstellungen]] > Website-Administration > Nutzer/innen > Nutzerkonten > Nutzerliste hochladen''.
#Fügen Sie eine Datei im Upload-Bereich hinzu. Wählen Sie außerdem das passende ''CSV Trennzeichen''.
#Auf der folgenden Vorschauseite prüfen Sie, ob alle Nutzerdaten korrekt sind. Wenn das nicht der Fall ist, ändern Sie die Datei und laden Sie diese erneut hoch.
#Wenn die Nutzerdaten korrekt sind, klicken Sie auf den Button ''Nutzerliste hochladen''.
#Auf der Ergebnisseite werden die Nutzer/innen angezeigt, die erfolgreich hochgeladen wurden.
#Klicken Sie auf den Button ''Weiter''.


Wenn Sie Benutzerkonten mittels eines Textdatei-Imports anlegen wollen, so muss die Textdatei folgende Kriterien erfüllen:
==Einstellungen auf der Vorschauseite==
Es gibt verschiedene Einstellungen auf der Vorschauseite, die Sie vornehmen, bevor die Daten aus der Nutzerliste hochgeladen werden. Mit diesen Einstellungen steuern Sie, was mit den Daten  beim Anlegen oder Aktualisieren von Nutzerkonten in Moodle passiert.
 
[[Image:nutzeruploadvorschau.jpg|800px]]
 
===Bestehende Nutzerkonten aktualisieren===
Standardmäßig prüft Moodle den Eintrag im Feld <code>username</code> der Datei und legt ein neues Nutzerkonto an, wenn es kein/e Nutzer/in mit diesem Anmeldenamen gibt. Falls der Anmeldename im System bereits existiert, wird die entsprechende Zeile in der Datei übersprungen. Diese Vorgehendweise entspricht der Option ''Neue hinzufügen, vorhandene überspringen'' bei der Einstellung ''Upload Typ'' auf der Vorschauseite. Wenn Sie stattdessen die Option ''Neue anlegen, vorhandene aktualisieren'' wählen, dann werden die Daten eines bereits bestehenden Nutzerkontos aktualisiert. Weitere Optionen sind:
* ''Alle hinzufügen, bei Bedarf einen Zähler im Anmeldenamen anhängen'' - dann wird für jeden Datensatz in der Datei ein neues Nutzerkonto angelegt oder
*''Nur vorhandene aktualisieren'' - dann werden keine neuen Nutzerkonten angelegt, sondern nur bestehende Nutzerkonten aktualisiert.
 
Außerdem können Sie auf der Vorschauseite konfigurieren, ob Nutzer/innen ihr Kennwort beim ersten Login ändern müssen, ob ein Umbenennen oder Löschen von bestehenden Nutzerkonten erlaubt ist, wie doppelte E-Mail-Adressen behandelt werden, ob Anmeldename standardisiert werden sollen (also nach einem einheitlichen Muster gebildet werden sollen) und welche Nutzer/innen für den [[Nutzerverwaltung (Bulk)|Bulkprozess]]  ausgewählt werden sollen.
 
'''Achtung''': Fehlerhafte Einstellungen für die Aktualisierung von Nutzerkonten können schlimme Auswirkungen auf Ihre Nutzer/innen haben. Treffen Sie diese Einstellungen also mit Sorgfalt!
 
===Standardwerte===
In diesem Bereich auf der Vorschauseite legen Sie fest, welche Standardeinstellungen beim Anlegen eines neuen Nutzerkontos im Nutzerprofil getroffen werden sollen, falls die zugehörigen Datenfelder in der Datei fehlen.
 
==Ergebnisseite nach dem Hochladen==
Wenn Sie alle Einstellungen auf der Vorschauseite getroffen und die Datei mit den Nutzerdaten erfolgreich hochgeladen haben, erscheint eine Ergebnisseite mit allen Änderungen, die beim Hochladen, Anlegen und Aktualisieren der Nutzerkonten vorgenommen wurden.
 
Außerdem sehen Sie eine Zusammenfassung, wie viele Nutzerkonten neu angelegt oder aktualisiert wurden, wie viele Nutzer/innen ein schwaches Kennwort haben und wie viele Fehler beim Hochladen der Datei aufgetreten sind.
 
==Dateiformatierung==
Wenn Sie eine Nutzerliste hochladen wollen, so muss die Textdatei folgende Kriterien erfüllen:


* Jede Zeile der Datei enthält einen Datensatz.
* Jede Zeile der Datei enthält einen Datensatz.
Zeile 20: Zeile 50:
* Die erste Zeile der Datei muss die Feldnamen enthalten. Die Zuordnung der Datenfelder in den folgenden Zeilen erfolgt entsprechend dieser Abfolge von Feldnamen.  
* Die erste Zeile der Datei muss die Feldnamen enthalten. Die Zuordnung der Datenfelder in den folgenden Zeilen erfolgt entsprechend dieser Abfolge von Feldnamen.  


'''Tipps''':
*Wenn Sie kein Experte sind, vermeiden Sie Sonderzeichen, wie z.B. Kommas oder Anführungszeichen in den Nutzerdaten. Testen Sie das Hochladen mit einer Datei, die zunächst nur einen Datensatz enthält. 
*Sie können ein Tabellenkalkulationsprogramm verweden, um die Datei zu erstellen. Speichern Sie die Datei im CSV-Format (kommaseparierte Liste). Öffnen Sie die Datei in einem einfachen Text-Editor, um die Syntax zu prüfen, bevor Sie sie in Moodle hochladen.
*Nutzen Sie alternative [[Authentifizierung|Authentifizierungsmethoden]].
===Beispieldatei zum Testen===
Hier ist ein Beispiel für eine korrekt formatierte Datei:
<code>username, password, firstname, lastname, email, course1, group1, cohort1<br />
jonest, verysecret, Tom, Jones, jonest@someplace.edu, Math102, Sektion 1, Jahr 3<br />
meyer, geheim, Hans, Meyer, meyer@irgendwo.de, Math102, Sektion 2, Jahr 4</code>
===Datenfelder===
'''Tipp''': Wir empfehlen Ihnen, Ihre Datei mit allen gewünschten Datenfeldern und '''einem''' Nutzerdatensatz zu erstellen und das Hochladen dieser Datei auf http://demo.moodle.org zu testen, bevor Sie die vollständige Nutzerliste in Ihrem eigenen Moodle-System hochladen.
====Pflichtfelder====
Diese Felder müssen in der Liste der Felder im ersten Datensatz aufgeführt sein und für jede/n Nutzer/in definiert werden:


[[Bild:Nutzer-Import-Feldtyp-Pflicht.jpg|thumb|Pflichtfelder: Datentypen/-größen]]
<code>username, firstname, lastname, email</code>
:'''Pflichtfelder''': Diese Felder müssen in der Liste der Felder im ersten Datensatz aufgeführt sein und für jeden Nutzer definiert werden:
:<p><code>username, password, firstname, lastname, email</code></p>
:<p>'''Hinweis''': Für die Felder ''username'', ''password'', and ''email'' wird eine Gültigkeitsprüfung durchgeführt. So darf ''username'' nur alphanumerische Zeichen und keinen Unterstrich enthalten. Ein Punkt im Namen ist zulässig. Der Inhalt des Feldes ''password'' sollte die im Wiki-Artikel [[Website-Rechte#Kennwortregeln|Kennwortregeln]] festgelegten Anforderungen erfüllen. E-Mail Adressen müssen eine gültige E-Mail Adressstruktur aufweisen.</p>  


Für folgende Felder wird eine Gültigkeitsprüfung durchgeführt:
#<code>username</code> darf nur Kleinbuchstaben, Ziffern, das Minuszeichen '-', einen Unterstrich '_', einen Punkt '.' oder das '@'-Zeichen enthalten.
#<code>email</code> die E-Mail-Adressen müssen eine gültige E-Mail-Adressstruktur aufweisen, z.B. ''name@beispiel.com''.


====Kennwortfeld====
Das Kennwortfeld <code>password</code> ist optional, wenn Sie auf der Vorschauseite bei der Einstellung ''Neues Kennwort'' die Option ''Kennwort anlegen, falls erforderlich'' wählen.
*Wenn Sie stattdessen das Kennwort in der Nutzerdatei eintragen, dann achten Sie darauf, dass die [[Website-Rechte|Kennwortregeln]], die Sie systemweit festgelegt haben, eingehalten werden. Wenn Sie wollen, dass die Nutzer/innen beim ersten Login ihr Kennwort selbst setzen, dann wählen tragen Sie in der Datei als Kennwort <code>changeme</code> ein.
*Wenn Sie das Datenfeld <code>password</code> nicht in der Datei verwenden, dann generiert Moodle automatisch ein Kennwort (beim nächsten Durchlauf des [[Cron-Job]]s) und schickt eine entsprechende Benachrichtigungs-E-Mail an die Nutzer/innen.


[[Bild:Nutzer-Import-Feldtyp-Opt.jpg|thumb|Optionale Felder: Datentypen/-größen]]
====Optionale Felder====
Diese Felder kann man auch weglassen, dann gelten die allgemeinen Voreinstellungen. Zu den optionalen Feldern gehören u.a.
<code>institution, department, city, country, lang, auth, ajax, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe</code>


:'''Optionale Felder''': Diese Felder kann man auch weglassen, dann gelten die allgemeinen Voreinstellungen.
Beachten Sie:
:<p><code>institution, department, city, country, lang, auth, timezone</code></p>
*<code>country</code> - für dieses Feld müssen Sie den zweibuchstbigen Ländercode verwenden, z.B. ''DE'' für Deutschland oder ''CH'' für die Schweiz. Die Verwendung von kleinen Buchstaben würde zu einer Fehlermeldung führen. Die richtigen Bezeichnungen für die Ländercodes finden Sie in der Moodle-Quellcodedatei [http://cvs.moodle.org/moodle/lang/en_utf8/countries.php?view=markup&pathrev=MOODLE_19_STABLE ''countries.php''].
*Einige Datenfelder akzeptieren nur eine begrenzte Zeichenkettenlänge, z.B. darf der Datensatz für <code>institution</code> nicht länger als 40 Zeichen sein. Typischerweise wird Moodle Ihnen die Vorschauseite anzeigen, aber bei zu langen Datensätzen den Upload-Prozess abbrechen. Schalten Sie den Debug-Modus ein (''[[Einstellungen-Block|Einstellungen]] > Website-Administration > Entwicklung > Debugging''), um zu sehen, welchen Datensätze zu lang sind.
*Die Datenfelder <code>maildisplay, htmleditor, autosubscribe</code> können weggelassen und stattdessen über die entsprechenden Einstellungen ''Forenbeiträge zusammenfassen'', ''Texte bearbeiten'' und ''Forum abonnieren'' auf der Vorschauseite konfiguriert werden.


====Zusätzliche Profilfelder====
Wenn Sie in Ihrem Moodle eigene [[Profilfelder]] angelegt haben, können Sie die entsprechenden Daten auch in der Nutzerdatei hinterlegen. Wenn das Profilfeld <code>xxx</code> ('''Achtung''': nur Kleinbuchstaben zulässig!) heißt, dann heißt das zugehörige Datenfeld in der Nutzerdatei <code>profile_field_xxx</code>.


'''Beispiel''': Angenommen, Sie haben ein Profilfeld <code>personalnummer</code>, dann tragen Sie in der Kopfzeile der Nutzerdatei das zugehörige Datenfeld <code>profile_field_personalnummer</code> ein.


'''Hinweis''': Die zusätzlichen Profilfelder müssen im System angelegt sein, bevor Sie Nutzerdateien hochladen.


[[Bild:Nutzer-Import-Feldtyp-Zusatz.jpg|thumb|Ergänzende Felder: Datentypen/-größen]]
====Spezielle Felder====
Sie können folgende spezielle Felder verwenden:
*<code>oldusername</code> - um Anmeldenamen in bestehenden Nutzerkonten zu ändern
*<code>deleted</code> - um bestehende Nutzerkonten zu löschen


:'''Ergänzende Felder'''. Die Kursnamen sind die Kurzbezeichnungen der Kurse in die - wenn sie existieren - die Nutzer/innen als Studenten eingeschrieben werden. Der Spracheintrag für Deutsch lautet 'de'. Der Kursname 'course' ist die Kurzbezeichnung für den Kurs. Wird dieser angegeben, wird der/die Nutzer/in automatisch in den Kurs eingetragen. Die Nummerierung der Gruppen entspricht der Nummerierung der Kurse, also course1 zugeordnet group1.
====Felder für die Einschreibung====
:<p><code>idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe), course1, course2, course3, course4, course5, group1, group2, group3, group4, group5, role1, role2, role3, role4, role5</code></p>
Die folgenden Felder können verwendet werden, um die Einschreibung in Kurse oder Gruppen und die Zuweisung von Rollen zu ermöglichen: <code>course1, type1, role1, group1, enrolperiod1/enrolstatus1, course2, type2, role2, group2, enrolperiod2/enrolstatus2</code> etc.  
*<code>course</code> ist die Kurzbezeichnung des Kurses, in den eine Person eingeschrieben wird
*<code>type</code> bezeichnet die Rolle, die der Person im Kurs zugewisen wird: 1 - Standard-Kursrolle, 2 - Legacy-Trainer-Rolle (mit Bearbeitungsrecht), 3 - Legacy-Trainer-Rolle (ohne Bearbeitungsrecht)
*Alternativ können Sie die Rolle im Kurs direkt angeben, und zwar mit Hilfe des Datenfelds <code>role</code>; verwenden Sie die Kurzbezeichnungen der Rolle oder die Rollen-ID.
*Nutzer/innen können im Kurs in Gruppen eingetragen werden; das Datenfeld <code>group1</code> gehört dabei zu <code>course1</code>, <code>group2</code> gehört zu <code>course2</code> usw.
*Eine Gruppe wird über ihren Namen oder die Gruppen-ID referenziert.
*Sie können für jeden Kurs die Teilnahmedauer in Tagen angeben; <code>enrolperiod1</code> gehört dabei zu <code>course1</code>, <code>enrolperiod2</code> gehört zu <code>course2</code> usw.
*Sie können Nutzer/innen von einem Kurs ausschließen, indem Sie das Feld <code>enrolstatus</code> verwenden und dessen Wert auf <code>1</code> setzen. Wenn das Feld im Datensatz leer bleibt, ist die entsprechende Person weiterhin im Kurs eingeschrieben.
Diese Felder sind optional.


====Globale Gruppen====
Das Feld <code>cohort1</code> ist ein optionales Feld, das Sie für die automatische Einschreibung in [[Globale Gruppen|globalen Gruppen]] verwenden können. In den Datensätzen der Nutzerdatei müssen Sie die IDs der globalen Gruppen verwenden (nicht die Gruppennnamen!)


{{Moodle 1.8}}:'''Nutzerspezifische Felder''' (user profile field): Ab der Moodle Version 1.8 besteht die Möglichkeit, zusätzliche nutzerspezifische Felder anzulegen (s.a. [[:en:User profile fields|User profile fields]]). Auch diese können über die Importfunktionalität geladen werden. In der Feldnamensliste in der ersten Datenzeile darf man hierbei allerdings nicht den Feldnamen des nutzerspezifischen Feldes angeben, sondern man muss ein '''''profile_field_''''' vor den Feldnamen setzen, damit dieser beim Import richtig verarbeitet wird.
====MNet-Nutzer/innen====
Nutzer/innen, die über ein [[Moodle-Netzwerk]] angemeldet sind, können ebenfalls verwaltet werden. Das enstprechende Feld heißt <code>mnethostid</code>. In der Datei verwenden Sie folgende Kombinationen der Felder:
*<code>username + mnethostid + course</code>: wenn Sie MNet-Nutzer/innen in einen Kurs einschreiben wollen
*<code>username + mnethostid + course + group</code>: wenn Sie MNet-Nutzer/innen in eine Gruppe in einem Kurs eintragen wollen
*<code>username + mnethostid + cohort</code>: wenn Sie MNet-Nutzer/innen in eine globale Gruppe eintragen wollen
*<code>username + mnethostid + suspended</code>: wenn Sie Konten von MNet-Nutzer/innen sperren oder wieder freigeben wollen
Alle anderen Aktionen werden ignoriert: Sie können keine neuen MNet-Nutzerkonten anlegen bzw. bestehende MNet-Nutzerkonten löschen oder aktualisieren.


:'''Bsp''': Zusätzliches Nutzerfeld sei ''gelbwurst'', dann müßte der Feldname in der ersten Datenzeile ''profile_field_gelbwurst'' lauten.
====Vollständige Liste der Datenfelder====
Hier finden Sie eine vollständige Liste der möglichen Datenfelder, die Sie in der Nutzerdatei verwenden dürfen:


<code>firstname, lastname, username, email, city, country, lang, timezone, mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe ,institution, department, idnumber, skype , msn, aim, yahoo, icq, phone1, phone2, address, url, description, descriptionformat, password, auth, oldusername, deleted, course1, course2, course3, course4 </code>


=== Erläuterungen zur Verwendung der Felder ===
Hinzu kommen die [[Profilfelder]], die Sie zusätzlich in Ihrem Moodle-System angelegt haben.
* Kommas in den Daten sollten als &#44 codiert werden, das Skript wandelt sie wieder in Kommas um.
* Für Boolesche Felder wird eine 0 für Falsch und eine 1 für Wahr verwendet.
* ''Types'' wurde bei älteren Moodle-Versionen verwendet, um Moodle mitzuteilen, ob der Nutzer als ''student'' oder ''teacher'', etc. in einen bestimmten Kurs eingeschrieben werden soll.  Z.B. ist ''type2'' ''course2'' zugeordnet. 1 = Student, 2 = Editing Teacher, und 3 = Non-editing Teacher. Wenn ''type'' kein Wert zugewiesen wird, oder kein Kurs zugeordnet werden kann, wird der Nutzer standardmäßig als ''student'' angelegt. Seit der Einführung von Rollen in Moodle 1.7 gibt es mit ''role'' einen neuen (besseren) Feldbezeichner für Rollenzuweisungen. Als Werte für ''role'' können die Rollen-ID oder die Kurzbezeichnungen der Rolle (z.B. student, trainer, etc.) verwendet werden.
* Änderung des Passworts erzwingen: Wenn Sie den Nutzer dazu veranlassen möchten, dass er sein Initialpasswort verändern muss, so setzen Sie das Passwortfeld des Nutzers auf '''changeme'''.
* E-Mails deaktivieren: Dazu muss der Parameter '''emailstop'''  auf 1 gesetzt werden. Wird der Parameter auf 0 gesetzt, ist die E-Mailadresse aktiv. Wird der Parameter nicht spezifiziert, so gilt als Standardeinstellung, dass alle E-Mail-Adressen eingeschaltet sind. (Hintergrund: Bei Verwendung von Pseudo E-Mail Adressen ist es sinnvoll, den Parameter ''emailstop'' zu setzen, um Fehlermeldungen zu vermeiden.)
* Kurse werden durch ihre Kurzbezeichnung zugeordnet.
* ''Anmerkung'': Wenn ein Nutzer bereits in der Moodle-Nutzerdatenbank registriert ist, wird er für die neu angegebenen Kurse als Teilnehmer eingetragen, OHNE dass die anderen Daten aktualisiert werden.


==Beispiele für Import-Dateien==
===Weitere Hinweise zur Formatierung===
===Beispiel 1===
*Wenn in den Datensätzen Kommas vorkommen, müssen diese als <code>&#44</code> hinterlegt werden.
<code>username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1<br />
*Bei Booleschen Datenfeldern verwenden Sie die Werte <code>0</code> für '''falsch''' und <code>1</code> für '''wahr'''.
jonest, verysecret, Tom, Jones, jonest@someplace.edu, en, 3663737, 1, Intro101, Section 1, 1<br />
*Um zu steuern, wie Nutzer/innen E-Mails aus ihren Kursen oder abonnierten Foren erhalten, verwenden Sie das Datenfeld <code>maildigest</code>. Mögliche Optionen sind: <code>0</code> - keine Zusammenfassung, <code>1</code> - vollständige Mails, <code>2</code> - nur Betreffs.
meyer, geheim, Hans, Meyer, meyer@irgendwo.de, de, 6736733, 0, Fortgeschrittene202, Abteilung 3, 3</code>


Wie oben beschrieben, werden im ersten Datensatz die Namen der Felder aufgeführt, denen in den folgenden Datensätzen - hier sind es zwei - die Werte zugewiesen werden.
==Weitere Optionen==
(Nach [http://moodle.org/help.php?file=uploadusers.html Upload users help file].)
===Vorlagen===


===Beispiel 2===
Folgende Sonderzeichen und Kodierungen können in der Datei verwendet werden:
[[Bild:Nutzer-Import-Vorschau-de.jpg|thumb|Beispiel 2: Vorschau Nutzer-Upload]]
<code>username; password; firstname; lastname; country; email; emailstop; course1; role1; course2; group2; role2<br />
test1; geheim; tim; test1; DE; tim@email.de; 1; test_080208; student; SVW-Kollegium; Testgruppe; teacher<br />
test2; changeme; tom; test2; NL; tom@email.nl; 0; test_080208; teacher; SVW-Kollegium; Testgruppe 2; student</code>


Bei diesem Beispiel werden Möglichkeiten ausgenützt, die spätestens ab Moodle 1.9 implementiert sind. Nach dem Hochladen der Datei würde Moodle folgende Bestätigung zurückmelden:
* %l - wird ersetzt durch den Nachnamen
:Nutzer test1: Eingetragen in "test_080208" als "student", eingetragen in "SVW-Kollegium" als "teacher", zur Gruppe Testgruppe hinzugefügt
* %f - wird ersetzt durch den Vornamen
:Nutzer test2: Eingetragen in "test_080208" als "teacher", eingetragen in "SVW-Kollegium" als "student", zur Gruppe Testgruppe 2 hinzugefügt
* %u - wird ersetzt durch den Anmeldenamen
* %% - wird ersetzt durch %


Beim ersten Nutzer test1 wird durch Setzen von <code>emailstop</code> auf 1 (=WAHR), die E-Mail Adresse deaktiviert.
Zwischen dem Prozentzeichen % und den Buchstaben l, f oder u sind folgende Zeichen erlaubt
Beim zweiten Nutzer test2 ist die E-Mail Adresse dagegen aktiviert (emailstop=0). Bei test2 wurde der Wert des Felds <code>password
* (-) Minuszeichen - die Information, die durch den Buchstaben kodiert ist, wird in Kleinbuchstaben umgewandelt
</code> auf "changeme" gesetzt. Dieser Wert hat eine besondere Bedeutung, er hat zur Folge, dass nach dem ersten Anmeldevorgang von test2, dieser zunächst als Passwort <code>changeme</code> eingeben muss, dann aber zur unmittelbaren Änderung des Passworts aufgefordert wird.
* (+) Pluszeichen - die Information, die durch den Buchstaben kodiert ist, wird in Großbuchstaben umgewandelt
* (~) Tilde - die Information, die durch den Buchstaben kodiert ist, wird in Title Case umgewandelt
* Dezimalzahl x - die Information, die durch den Buchstaben kodiert ist, wird nach x Buchstaben abgeschnitten


'''Hinweis''': Bitte beachten Sie, dass beim zweiten Beispiel das Semikolon als Trennzeichen verwendet wurde und Sie die Zeilenumbrüche aus dem obigen Beispiel übernommen haben (zuletzt getestet für Version 1.9.4).
'''Beispiel''': Der Vorname sei '''Johann''', der Nachname sei  '''Meier''', der Anmeldename sei '''jmeier'''. Dann gelten folgende Ersetzungen:


==Aktualisierung existierender Nutzerkonten==
    %l%f = MeierJohann
    %l%1f = MeierJ
    %-l%+f = meierJOHANN
    %-f_%-l = johann_meier
    <nowiki>http://www.example.com/~%u/</nowiki> = <nowiki>http://www.example.com/~jmeier/</nowiki>


Standardmäßig geht Moodle davon aus, dass der Administrator beim Hochladen einer Importdatei mit Nutzer-Datensätzen, neue Nutzerkonten anlegen will. Datensätze der Importdatei, die Übereinstimmungen zu existierenden Nutzerkonten zeigen, werden deshalb beim Import übersprungen.  
Bei der Erstellung von Anmeldenamen werden alle Buchstaben in Kleinbuchstaben umgewandelt. Wenn in den [[Website-Rechte]]n die Verwendung von Sonderzeichen in Anmeldenamen deaktiviert ist, werden alle vorkommenden Sonderzeichen entfernt. Z.B. wird aus dem Vornamen '''Dr. Johann''' und dem Nachnamen '''Meier''' und der Anmeldenamekodierung <code>%-f_%-l</code> der Anmeldename '''dr. johann_meier''', wenn Sonderzeichen (in diesem Fall Leerzeichen) erlaubt sind, und dr.johann_meier, wenn Sonderzeichen deaktiviert sind.


Man kann aber diese Voreinstellung so abändern, dass bestehende Nutzerkonten mit den Importdaten aktualisiert werden. In Moodle 1.9-Versionen erscheint eine Seite mit diversen Einstellungsmöglichkeiten, ''nachdem'' man die Importdatei ausgewählt und hochgeladen hat. Unter Einstellungen> Upload Typ gibt es folgende Auswahlmöglichkeiten:
Sie können das Anlegen von neuen Nutzer/innen so konfigurieren, das bei doppelt vorhandenen Anmeldenamen ein Zähler angehängt wird. Wenn z.B. in der Liste die Nutzer/innen Johann Meier, Jens Meier und Jan Meier vorkommen und die Vorlage für den Anmeldenamen <code>%f1%l</code> ist, dann lauten die Anmeldenamen für:
# Neue hinzufügen, vorhandene Nutzer/innen überspringen (Voreinstellung)
    Johann Meier = jmeier
# Alle hinzufügen, bei Bedarf einen Zähler beim Nutzernamen anhängen
    Jens Meier = jmeier2
# Neue hinzufügen, vorhandene Nutzer/innen aktualisieren
    Jan Meier = jmeier3
# Nur vorhandene Nutzer/innen aktualisieren


Beim Aktualisieren können auch die Nutzernamen geändert werden. Dazu muss <code>Umbenennen zulassen</code> auf "Ja" gesetzt werden und in den Datensätzen muss ein Feld <code>oldusername</code> enthalten sein.
===Nutzerkonten löschen===


'''Achtung''': Alle Fehler beim Aktualisierungsprozess können für die Nutzer schwerwiegende Folgen haben. Bei einem Aktualisierungs-Update ist größte Sorgfalt geboten!
Wenn Sie in die Nutzerdatei ein Datenfeld <code>deleted</code> einfügen, dann werden Nutzer/innen, bei denen dieses Feld den Wert 1 hat, im System gelöscht. In diesem Fall können Sie alle anderen Datenfelder für diese Person weglassen, außer dem Eintrag für das Datenfeld <code>username</code>. Nach dem Hochladen der Datei müssen Sie die Einstellung ''Upload Typ'' auf ''Nur vorhandene aktualisieren'' umstellen und die Einstellung ''Löschen erlauben'' auf ''Ja'' setzen.


==Zeichenkodierung==
Das Anlegen und Löschen von Nutzerkonten kann auch mit einer einzigen CSV-Datei realisiert werden.


In Moodle 1.7 und 1.8 mußte die Zeichenkodierung beim Import UTF-8 sein.  
'''Beispiel''': Das Nutzerkonto von '''jmeier''' wird angelegt, das Konto von '''fschulz''' wird gelöscht.


{{Moodle 1.9}}Ab der Moodle Version 1.9 kann die Zeichenkodierung über ein Dropdown-Menüfeld komfortabel aus einer großen Auswahlliste ausgewählt werden.
    username, firstname, lastname, deleted
    jmeier, Johann, Meier, 0
    fschulz, , , 1


==Tipps==
==Zeichenkodierung==


===Tabellenkalkulation===
Auf der Vorschauseite im Upload-Prozess können Sie die Zeichenkodierung (Einstellung ''Encoding'') auswählen.


Wird zur Erstellung der Importdatei ein Tabellenkalkulationprogramm, wie z.B. Excel, verwendet, sollte die [[Nutzer hochladen#Glossar|.csv-Datei]] vor dem Hochladen mit einem [[Nutzer hochladen#Glossar|Texteditor]] geladen und kontrolliert werden. Vergleichen Sie die Textdatei mit den Beispielen auf dieser Hilfeseite. Zeichenkodierung und Trennzeichen (Komma, Semikolon oder Tab) sollten dem Muster der Beispiele entsprechen.
==Sonstige Tipps==
===Spreadsheet===
Wenn Sie ein Tabellenkalkulationsprogramm wie Excel verwenden, um Ihre .csv Datei zu erstellen, prüfen Sie den Inhalt und die Formatierung der Datei vor dem Hochladen in einem einfachen Text-Editor (z.B. Wordpad). Es könnte z.B. passieren, dass die Excel-Datei überflüssige Kommas am Ende jeder Zeile enthält, wenn Sie zuvor in der Excel-Datei Spalten gelöscht oder hinzugefügt haben. Prüfen Sie auch die Zeichenkodierung. Eine *.csv Datei ist eine einfache Textdatei (ASCII oder Unicode).  


===Land===
Excel ersetzt Kennwörter, die mit - (Minuszeichen) oder + (Pluszeichen) beginnen durch Null. Das passiert selbst dann, wenn Sie die Datei als .csv Datei speichern und verlangen, dass due Formatierung erhalten bleiben soll. Prüfen Sie also Ihre Datei vor dem Upload auf Korrektheit.
Das Land muss als Zweibuchstaben-Code in Großbuchstaben angegeben werden, z.B. DE für Deutschland, oder CH für die Schweiz. Die Verwendung von kleinen Buchstaben würde zu einer Fehlermeldung resultieren.  
:Tipp: Falls Sie sich über den Ländercode unsicher sind, können Sie dies in der Moodle-Quellcodedatei [http://cvs.moodle.org/moodle/lang/en_utf8/countries.php?view=markup&pathrev=MOODLE_19_STABLE ''countries.php''] nachschauen.


===Fantasie-E-Mailadressen===
Wenn Sie in Excel eine Formel verwenden, um einen Zelleneintrag zu erzeugen, dann prüfen Sie Ihre Datei vor dem Upload ebenfalls auf Korrektheit und stellen Sie sicher, dass alle Zellen korrekte Werte enthalten.
Nicht selten erstellt ein Administrator eine Import-Datei zum Hochladen von Nutzern mit Hilfe von Datensätzen einer Institution, die keine E-Mail-Adressen enthalten. Die Angabe einer E-Mail Adresse ist aber bei Moodle obligatorisch.


Hier kann man sich behelfen, indem man künstliche E-Mail Adressen generiert, z.B. durch die Zeichenketten-Verkettungsfunktion eines Tabellenkalkulationsprogramms. Diese E-Mail Adressen sollten nach Möglichkeit kein zweites Mal in der Moodle-Datenbank vorkommen und sie sollten den für E-Mail Adressen typischen Aufbau folgen, z.B. xxx@yyy.de .
===Land===
Für die Bezeichnung des Landes im Nutzerkonto verwenden Sie die zweibuchstabige Länderkodierung, z.B. DE für Deutschland, AT für Österreich oder CH für Schweiz. Beachten Sie die Großschreibweise, '''de''' würde zu einer Fehlermeldung führen.


Eine Fantasie-E-Mail Adresse hat natürlich den großen Nachteil, dass jeder Versuch eine E-Mail an diese Adresse zu schicken, zu einer Fehlermeldung führt oder bei einem falschen Empfänger landet. Aus diesem Grund sollten Fantasie-E-Mail Adressen immer mit <code>emailstop</code> deaktiviert werden. (s.a. Beispiel 2 oben)
Tipp: Wenn Sie unsicher sind, welches der richtige Ländercode ist, dann schauen Sie im Moodle-Code in der Datei ''/moodle/lang/en_utf8/countries.php'' [http://cvs.moodle.org/moodle/lang/en_utf8/countries.php?view=markup&pathrev=MOODLE_19_STABLE] nach. Diese Liste ist auch auf der [http://www.iso.org/iso/country_names_and_code_elements ISO Website] verfügbar.


==Glossar==
===Feldgröße===
Eine '''.csv-Datei''' (comma/character separated values) ist eine einfache Textdatei (ASCII oder Unicode), in der die Daten meistens durch Kommas getrennt sind.  
Einige Datenfelder haben eine begrenzte Zeichenlänge. Typischerweise zeigt der Upload-Prozess die Liste in der Vorschau, bricht danach jedoch ab. Schalten Sie in diesem Fall das [[Debugging]] ein, um zu sehen, welche Daten zu lang sind. Typischerweise treten Felder bein den Datenfeldern <code>institution</code> (max. 40 Zeichen) und <code>city</code> auf.


Ein '''Texteditor''' ist ein Programm zur Erstellung von unformatiertem Text, nicht zu verwechseln mit einer Textverarbeitung, wie z.B. Microsoft Word. Einfache Texteditoren werden bei den meisten Betriebssystemen kostenlos mitgeliefert. Unter Windows können sie das Programm ''Editor'' im Programmordner ''Zubehör'' als Texteditor verwenden.
===Liste aller Datenfelder===
    firstname, lastname, username, email, city, country, lang, timezone,
    mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe,
    institution, department, idnumber, skype , msn, aim, yahoo, icq,
    phone1, phone2, address, url, description, descriptionformat, password,
    auth, oldusername , deleted, course1, course2, course3, course4


==Siehe auch==
==Siehe auch==
*[[Interne Einschreibung]]
*[[Einschreibung über CSV-Datei]]
*[[Einschreibung über externe Datenbank]]
*[[Profilfelder]] für detaillierte Informationen, wie zusätzliche Datenfelder in die Nutzerdatei eingefügt werden
*[[Module für die Authentifizierung verwalten]]
*[[:en:Flat file|Flat file]]


Diskussionsbeiträge im Moodle Forum:
Diskussionsbeiträge im Moodle Forum:
Zeile 133: Zeile 214:
*[http://moodle.org/mod/forum/discuss.php?d=58215 Making Email Optional]
*[http://moodle.org/mod/forum/discuss.php?d=58215 Making Email Optional]
*[http://moodle.org/mod/forum/discuss.php?d=97903 Uploading users to custom roles]
*[http://moodle.org/mod/forum/discuss.php?d=97903 Uploading users to custom roles]
*[http://moodle.org/mod/forum/discuss.php?d=181259 User upload option: standardise usernames]


{{Credits}} [https://docs.moodle.org/19/de/Nutzer_hochladen]


[[en:Upload users]]
[[en:Upload users]]

Aktuelle Version vom 28. April 2014, 11:49 Uhr


Administrator/innen können mehrere Nutzerkonten auf einmal anlegen.

Es gibt verschiedene Möglichkeiten, um Nutzerinformationen hochzuladen: Sie können nicht nur neue Nutzerkonten anlegen, sondern auch Nutzer/innen mit bestimmten Rollen in Kurse einschreiben, Nutzer/innen in Gruppen eintragen, Nutzerprofile aktualisieren oder Nutzer/innen löschen.

Anstatt eine Textdatei mit den Nutzerdaten hochzuladen, können Sie die Datei per Drag&Drop direkt von Ihrem Desktop in den Upload-Bereich ziehen (siehe Screencast von Mary Cooch).

Tipp: Das Hochladen einer Nutzerliste ist eine Form der manuellen Verwaltung von Nutzerkonten. Manuelle Nutzerverwaltung ist stets mit einem gewissen Aufwand verbunden. Prüfen Sie daher sorgfältig, ob in Ihrem Moodle-System alternative Möglichkeiten der Authentifizierung in Frage kommen, z.B. die E-Mail-basierte Selbstregistrierung oder die Nutzung einer externen Datenbank.


Der Uploadprozess

Die einzelnen Schritte beim Hochladen einer Nutzerliste sind folgende:

  1. Legen Sie eine Datei mit den Nutzerdaten an. Detaillierte Informationen zur Formatierung der Datei finden Sie weiter unten.
  2. Gehen Sie auf die Seite Einstellungen > Website-Administration > Nutzer/innen > Nutzerkonten > Nutzerliste hochladen.
  3. Fügen Sie eine Datei im Upload-Bereich hinzu. Wählen Sie außerdem das passende CSV Trennzeichen.
  4. Auf der folgenden Vorschauseite prüfen Sie, ob alle Nutzerdaten korrekt sind. Wenn das nicht der Fall ist, ändern Sie die Datei und laden Sie diese erneut hoch.
  5. Wenn die Nutzerdaten korrekt sind, klicken Sie auf den Button Nutzerliste hochladen.
  6. Auf der Ergebnisseite werden die Nutzer/innen angezeigt, die erfolgreich hochgeladen wurden.
  7. Klicken Sie auf den Button Weiter.

Einstellungen auf der Vorschauseite

Es gibt verschiedene Einstellungen auf der Vorschauseite, die Sie vornehmen, bevor die Daten aus der Nutzerliste hochgeladen werden. Mit diesen Einstellungen steuern Sie, was mit den Daten beim Anlegen oder Aktualisieren von Nutzerkonten in Moodle passiert.

nutzeruploadvorschau.jpg

Bestehende Nutzerkonten aktualisieren

Standardmäßig prüft Moodle den Eintrag im Feld username der Datei und legt ein neues Nutzerkonto an, wenn es kein/e Nutzer/in mit diesem Anmeldenamen gibt. Falls der Anmeldename im System bereits existiert, wird die entsprechende Zeile in der Datei übersprungen. Diese Vorgehendweise entspricht der Option Neue hinzufügen, vorhandene überspringen bei der Einstellung Upload Typ auf der Vorschauseite. Wenn Sie stattdessen die Option Neue anlegen, vorhandene aktualisieren wählen, dann werden die Daten eines bereits bestehenden Nutzerkontos aktualisiert. Weitere Optionen sind:

  • Alle hinzufügen, bei Bedarf einen Zähler im Anmeldenamen anhängen - dann wird für jeden Datensatz in der Datei ein neues Nutzerkonto angelegt oder
  • Nur vorhandene aktualisieren - dann werden keine neuen Nutzerkonten angelegt, sondern nur bestehende Nutzerkonten aktualisiert.

Außerdem können Sie auf der Vorschauseite konfigurieren, ob Nutzer/innen ihr Kennwort beim ersten Login ändern müssen, ob ein Umbenennen oder Löschen von bestehenden Nutzerkonten erlaubt ist, wie doppelte E-Mail-Adressen behandelt werden, ob Anmeldename standardisiert werden sollen (also nach einem einheitlichen Muster gebildet werden sollen) und welche Nutzer/innen für den Bulkprozess ausgewählt werden sollen.

Achtung: Fehlerhafte Einstellungen für die Aktualisierung von Nutzerkonten können schlimme Auswirkungen auf Ihre Nutzer/innen haben. Treffen Sie diese Einstellungen also mit Sorgfalt!

Standardwerte

In diesem Bereich auf der Vorschauseite legen Sie fest, welche Standardeinstellungen beim Anlegen eines neuen Nutzerkontos im Nutzerprofil getroffen werden sollen, falls die zugehörigen Datenfelder in der Datei fehlen.

Ergebnisseite nach dem Hochladen

Wenn Sie alle Einstellungen auf der Vorschauseite getroffen und die Datei mit den Nutzerdaten erfolgreich hochgeladen haben, erscheint eine Ergebnisseite mit allen Änderungen, die beim Hochladen, Anlegen und Aktualisieren der Nutzerkonten vorgenommen wurden.

Außerdem sehen Sie eine Zusammenfassung, wie viele Nutzerkonten neu angelegt oder aktualisiert wurden, wie viele Nutzer/innen ein schwaches Kennwort haben und wie viele Fehler beim Hochladen der Datei aufgetreten sind.

Dateiformatierung

Wenn Sie eine Nutzerliste hochladen wollen, so muss die Textdatei folgende Kriterien erfüllen:

  • Jede Zeile der Datei enthält einen Datensatz.
  • Jeder Datensatz ist eine Aneinanderreihung von Datenfeldern, die durch ein Trennzeichen (Komma, Semikolon, Doppelpunkt oder Tab) getrennt sind.
  • Die erste Zeile der Datei muss die Feldnamen enthalten. Die Zuordnung der Datenfelder in den folgenden Zeilen erfolgt entsprechend dieser Abfolge von Feldnamen.

Tipps:

  • Wenn Sie kein Experte sind, vermeiden Sie Sonderzeichen, wie z.B. Kommas oder Anführungszeichen in den Nutzerdaten. Testen Sie das Hochladen mit einer Datei, die zunächst nur einen Datensatz enthält.
  • Sie können ein Tabellenkalkulationsprogramm verweden, um die Datei zu erstellen. Speichern Sie die Datei im CSV-Format (kommaseparierte Liste). Öffnen Sie die Datei in einem einfachen Text-Editor, um die Syntax zu prüfen, bevor Sie sie in Moodle hochladen.
  • Nutzen Sie alternative Authentifizierungsmethoden.

Beispieldatei zum Testen

Hier ist ein Beispiel für eine korrekt formatierte Datei:

username, password, firstname, lastname, email, course1, group1, cohort1
jonest, verysecret, Tom, Jones, jonest@someplace.edu, Math102, Sektion 1, Jahr 3
meyer, geheim, Hans, Meyer, meyer@irgendwo.de, Math102, Sektion 2, Jahr 4

Datenfelder

Tipp: Wir empfehlen Ihnen, Ihre Datei mit allen gewünschten Datenfeldern und einem Nutzerdatensatz zu erstellen und das Hochladen dieser Datei auf http://demo.moodle.org zu testen, bevor Sie die vollständige Nutzerliste in Ihrem eigenen Moodle-System hochladen.

Pflichtfelder

Diese Felder müssen in der Liste der Felder im ersten Datensatz aufgeführt sein und für jede/n Nutzer/in definiert werden:

username, firstname, lastname, email

Für folgende Felder wird eine Gültigkeitsprüfung durchgeführt:

  1. username darf nur Kleinbuchstaben, Ziffern, das Minuszeichen '-', einen Unterstrich '_', einen Punkt '.' oder das '@'-Zeichen enthalten.
  2. email die E-Mail-Adressen müssen eine gültige E-Mail-Adressstruktur aufweisen, z.B. name@beispiel.com.

Kennwortfeld

Das Kennwortfeld password ist optional, wenn Sie auf der Vorschauseite bei der Einstellung Neues Kennwort die Option Kennwort anlegen, falls erforderlich wählen.

  • Wenn Sie stattdessen das Kennwort in der Nutzerdatei eintragen, dann achten Sie darauf, dass die Kennwortregeln, die Sie systemweit festgelegt haben, eingehalten werden. Wenn Sie wollen, dass die Nutzer/innen beim ersten Login ihr Kennwort selbst setzen, dann wählen tragen Sie in der Datei als Kennwort changeme ein.
  • Wenn Sie das Datenfeld password nicht in der Datei verwenden, dann generiert Moodle automatisch ein Kennwort (beim nächsten Durchlauf des Cron-Jobs) und schickt eine entsprechende Benachrichtigungs-E-Mail an die Nutzer/innen.

Optionale Felder

Diese Felder kann man auch weglassen, dann gelten die allgemeinen Voreinstellungen. Zu den optionalen Feldern gehören u.a. institution, department, city, country, lang, auth, ajax, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe

Beachten Sie:

  • country - für dieses Feld müssen Sie den zweibuchstbigen Ländercode verwenden, z.B. DE für Deutschland oder CH für die Schweiz. Die Verwendung von kleinen Buchstaben würde zu einer Fehlermeldung führen. Die richtigen Bezeichnungen für die Ländercodes finden Sie in der Moodle-Quellcodedatei countries.php.
  • Einige Datenfelder akzeptieren nur eine begrenzte Zeichenkettenlänge, z.B. darf der Datensatz für institution nicht länger als 40 Zeichen sein. Typischerweise wird Moodle Ihnen die Vorschauseite anzeigen, aber bei zu langen Datensätzen den Upload-Prozess abbrechen. Schalten Sie den Debug-Modus ein (Einstellungen > Website-Administration > Entwicklung > Debugging), um zu sehen, welchen Datensätze zu lang sind.
  • Die Datenfelder maildisplay, htmleditor, autosubscribe können weggelassen und stattdessen über die entsprechenden Einstellungen Forenbeiträge zusammenfassen, Texte bearbeiten und Forum abonnieren auf der Vorschauseite konfiguriert werden.

Zusätzliche Profilfelder

Wenn Sie in Ihrem Moodle eigene Profilfelder angelegt haben, können Sie die entsprechenden Daten auch in der Nutzerdatei hinterlegen. Wenn das Profilfeld xxx (Achtung: nur Kleinbuchstaben zulässig!) heißt, dann heißt das zugehörige Datenfeld in der Nutzerdatei profile_field_xxx.

Beispiel: Angenommen, Sie haben ein Profilfeld personalnummer, dann tragen Sie in der Kopfzeile der Nutzerdatei das zugehörige Datenfeld profile_field_personalnummer ein.

Hinweis: Die zusätzlichen Profilfelder müssen im System angelegt sein, bevor Sie Nutzerdateien hochladen.

Spezielle Felder

Sie können folgende spezielle Felder verwenden:

  • oldusername - um Anmeldenamen in bestehenden Nutzerkonten zu ändern
  • deleted - um bestehende Nutzerkonten zu löschen

Felder für die Einschreibung

Die folgenden Felder können verwendet werden, um die Einschreibung in Kurse oder Gruppen und die Zuweisung von Rollen zu ermöglichen: course1, type1, role1, group1, enrolperiod1/enrolstatus1, course2, type2, role2, group2, enrolperiod2/enrolstatus2 etc.

  • course ist die Kurzbezeichnung des Kurses, in den eine Person eingeschrieben wird
  • type bezeichnet die Rolle, die der Person im Kurs zugewisen wird: 1 - Standard-Kursrolle, 2 - Legacy-Trainer-Rolle (mit Bearbeitungsrecht), 3 - Legacy-Trainer-Rolle (ohne Bearbeitungsrecht)
  • Alternativ können Sie die Rolle im Kurs direkt angeben, und zwar mit Hilfe des Datenfelds role; verwenden Sie die Kurzbezeichnungen der Rolle oder die Rollen-ID.
  • Nutzer/innen können im Kurs in Gruppen eingetragen werden; das Datenfeld group1 gehört dabei zu course1, group2 gehört zu course2 usw.
  • Eine Gruppe wird über ihren Namen oder die Gruppen-ID referenziert.
  • Sie können für jeden Kurs die Teilnahmedauer in Tagen angeben; enrolperiod1 gehört dabei zu course1, enrolperiod2 gehört zu course2 usw.
  • Sie können Nutzer/innen von einem Kurs ausschließen, indem Sie das Feld enrolstatus verwenden und dessen Wert auf 1 setzen. Wenn das Feld im Datensatz leer bleibt, ist die entsprechende Person weiterhin im Kurs eingeschrieben.

Diese Felder sind optional.

Globale Gruppen

Das Feld cohort1 ist ein optionales Feld, das Sie für die automatische Einschreibung in globalen Gruppen verwenden können. In den Datensätzen der Nutzerdatei müssen Sie die IDs der globalen Gruppen verwenden (nicht die Gruppennnamen!)

MNet-Nutzer/innen

Nutzer/innen, die über ein Moodle-Netzwerk angemeldet sind, können ebenfalls verwaltet werden. Das enstprechende Feld heißt mnethostid. In der Datei verwenden Sie folgende Kombinationen der Felder:

  • username + mnethostid + course: wenn Sie MNet-Nutzer/innen in einen Kurs einschreiben wollen
  • username + mnethostid + course + group: wenn Sie MNet-Nutzer/innen in eine Gruppe in einem Kurs eintragen wollen
  • username + mnethostid + cohort: wenn Sie MNet-Nutzer/innen in eine globale Gruppe eintragen wollen
  • username + mnethostid + suspended: wenn Sie Konten von MNet-Nutzer/innen sperren oder wieder freigeben wollen

Alle anderen Aktionen werden ignoriert: Sie können keine neuen MNet-Nutzerkonten anlegen bzw. bestehende MNet-Nutzerkonten löschen oder aktualisieren.

Vollständige Liste der Datenfelder

Hier finden Sie eine vollständige Liste der möglichen Datenfelder, die Sie in der Nutzerdatei verwenden dürfen:

firstname, lastname, username, email, city, country, lang, timezone, mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe ,institution, department, idnumber, skype , msn, aim, yahoo, icq, phone1, phone2, address, url, description, descriptionformat, password, auth, oldusername, deleted, course1, course2, course3, course4

Hinzu kommen die Profilfelder, die Sie zusätzlich in Ihrem Moodle-System angelegt haben.

Weitere Hinweise zur Formatierung

  • Wenn in den Datensätzen Kommas vorkommen, müssen diese als &#44 hinterlegt werden.
  • Bei Booleschen Datenfeldern verwenden Sie die Werte 0 für falsch und 1 für wahr.
  • Um zu steuern, wie Nutzer/innen E-Mails aus ihren Kursen oder abonnierten Foren erhalten, verwenden Sie das Datenfeld maildigest. Mögliche Optionen sind: 0 - keine Zusammenfassung, 1 - vollständige Mails, 2 - nur Betreffs.

Weitere Optionen

Vorlagen

Folgende Sonderzeichen und Kodierungen können in der Datei verwendet werden:

  • %l - wird ersetzt durch den Nachnamen
  • %f - wird ersetzt durch den Vornamen
  • %u - wird ersetzt durch den Anmeldenamen
  • %% - wird ersetzt durch %

Zwischen dem Prozentzeichen % und den Buchstaben l, f oder u sind folgende Zeichen erlaubt

  • (-) Minuszeichen - die Information, die durch den Buchstaben kodiert ist, wird in Kleinbuchstaben umgewandelt
  • (+) Pluszeichen - die Information, die durch den Buchstaben kodiert ist, wird in Großbuchstaben umgewandelt
  • (~) Tilde - die Information, die durch den Buchstaben kodiert ist, wird in Title Case umgewandelt
  • Dezimalzahl x - die Information, die durch den Buchstaben kodiert ist, wird nach x Buchstaben abgeschnitten

Beispiel: Der Vorname sei Johann, der Nachname sei Meier, der Anmeldename sei jmeier. Dann gelten folgende Ersetzungen:

   %l%f = MeierJohann
   %l%1f = MeierJ
   %-l%+f = meierJOHANN
   %-f_%-l = johann_meier
   http://www.example.com/~%u/ = http://www.example.com/~jmeier/

Bei der Erstellung von Anmeldenamen werden alle Buchstaben in Kleinbuchstaben umgewandelt. Wenn in den Website-Rechten die Verwendung von Sonderzeichen in Anmeldenamen deaktiviert ist, werden alle vorkommenden Sonderzeichen entfernt. Z.B. wird aus dem Vornamen Dr. Johann und dem Nachnamen Meier und der Anmeldenamekodierung %-f_%-l der Anmeldename dr. johann_meier, wenn Sonderzeichen (in diesem Fall Leerzeichen) erlaubt sind, und dr.johann_meier, wenn Sonderzeichen deaktiviert sind.

Sie können das Anlegen von neuen Nutzer/innen so konfigurieren, das bei doppelt vorhandenen Anmeldenamen ein Zähler angehängt wird. Wenn z.B. in der Liste die Nutzer/innen Johann Meier, Jens Meier und Jan Meier vorkommen und die Vorlage für den Anmeldenamen %f1%l ist, dann lauten die Anmeldenamen für:

   Johann Meier = jmeier
   Jens Meier = jmeier2
   Jan Meier = jmeier3

Nutzerkonten löschen

Wenn Sie in die Nutzerdatei ein Datenfeld deleted einfügen, dann werden Nutzer/innen, bei denen dieses Feld den Wert 1 hat, im System gelöscht. In diesem Fall können Sie alle anderen Datenfelder für diese Person weglassen, außer dem Eintrag für das Datenfeld username. Nach dem Hochladen der Datei müssen Sie die Einstellung Upload Typ auf Nur vorhandene aktualisieren umstellen und die Einstellung Löschen erlauben auf Ja setzen.

Das Anlegen und Löschen von Nutzerkonten kann auch mit einer einzigen CSV-Datei realisiert werden.

Beispiel: Das Nutzerkonto von jmeier wird angelegt, das Konto von fschulz wird gelöscht.

   username, firstname, lastname, deleted
   jmeier, Johann, Meier, 0
   fschulz, , , 1

Zeichenkodierung

Auf der Vorschauseite im Upload-Prozess können Sie die Zeichenkodierung (Einstellung Encoding) auswählen.

Sonstige Tipps

Spreadsheet

Wenn Sie ein Tabellenkalkulationsprogramm wie Excel verwenden, um Ihre .csv Datei zu erstellen, prüfen Sie den Inhalt und die Formatierung der Datei vor dem Hochladen in einem einfachen Text-Editor (z.B. Wordpad). Es könnte z.B. passieren, dass die Excel-Datei überflüssige Kommas am Ende jeder Zeile enthält, wenn Sie zuvor in der Excel-Datei Spalten gelöscht oder hinzugefügt haben. Prüfen Sie auch die Zeichenkodierung. Eine *.csv Datei ist eine einfache Textdatei (ASCII oder Unicode).

Excel ersetzt Kennwörter, die mit - (Minuszeichen) oder + (Pluszeichen) beginnen durch Null. Das passiert selbst dann, wenn Sie die Datei als .csv Datei speichern und verlangen, dass due Formatierung erhalten bleiben soll. Prüfen Sie also Ihre Datei vor dem Upload auf Korrektheit.

Wenn Sie in Excel eine Formel verwenden, um einen Zelleneintrag zu erzeugen, dann prüfen Sie Ihre Datei vor dem Upload ebenfalls auf Korrektheit und stellen Sie sicher, dass alle Zellen korrekte Werte enthalten.

Land

Für die Bezeichnung des Landes im Nutzerkonto verwenden Sie die zweibuchstabige Länderkodierung, z.B. DE für Deutschland, AT für Österreich oder CH für Schweiz. Beachten Sie die Großschreibweise, de würde zu einer Fehlermeldung führen.

Tipp: Wenn Sie unsicher sind, welches der richtige Ländercode ist, dann schauen Sie im Moodle-Code in der Datei /moodle/lang/en_utf8/countries.php [1] nach. Diese Liste ist auch auf der ISO Website verfügbar.

Feldgröße

Einige Datenfelder haben eine begrenzte Zeichenlänge. Typischerweise zeigt der Upload-Prozess die Liste in der Vorschau, bricht danach jedoch ab. Schalten Sie in diesem Fall das Debugging ein, um zu sehen, welche Daten zu lang sind. Typischerweise treten Felder bein den Datenfeldern institution (max. 40 Zeichen) und city auf.

Liste aller Datenfelder

   firstname, lastname, username, email, city, country, lang, timezone, 
   mailformat, maildisplay, maildigest, htmleditor, ajax, autosubscribe,
   institution, department, idnumber, skype , msn, aim, yahoo, icq, 
   phone1, phone2, address, url, description, descriptionformat, password, 
   auth, oldusername , deleted, course1, course2, course3, course4

Siehe auch

Diskussionsbeiträge im Moodle Forum: