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
Keine Bearbeitungszusammenfassung
Zeile 18: Zeile 18:


==Einstellungen auf der Vorschauseite==
==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==
==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==
==Dateiformatierung==
[[Bild:Nutzer-Import-Hochladen-de.jpg|thumb|Nutzerkonten: Nutzer/innen hochladen]]
[[Bild:Nutzer-Import-Hochladen-de.jpg|thumb|Nutzerkonten: Nutzer/innen hochladen]]
Über eine einfache Textdatei können Nutzer/innen importiert, in Kurse eingeschrieben und Gruppen zugeordnet werden.


Wenn Sie Benutzerkonten mittels eines Textdatei-Imports anlegen wollen, so muss die Textdatei folgende Kriterien erfüllen:
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 31: Zeile 48:
* 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]].


[[Bild:Nutzer-Import-Feldtyp-Pflicht.jpg|thumb|Pflichtfelder: Datentypen/-größen]]
===Beispieldatei zum Testen===
:'''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>
 
 
 
[[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.
:<p><code>institution, department, city, country, lang, auth, timezone</code></p>
 
 
 


[[Bild:Nutzer-Import-Feldtyp-Zusatz.jpg|thumb|Ergänzende Felder: Datentypen/-größen]]
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>


:'''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.
===Datenfelder===
:<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>
'''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:


{{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.
<code>username, firstname, lastname, email</code>


:'''Bsp''': Zusätzliches Nutzerfeld sei ''gelbwurst'', dann müßte der Feldname in der ersten Datenzeile ''profile_field_gelbwurst'' lauten.
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.


=== Erläuterungen zur Verwendung der Felder ===
====Optionale Felder====
* Kommas in den Daten sollten als &#44 codiert werden, das Skript wandelt sie wieder in Kommas um.
Diese Felder kann man auch weglassen, dann gelten die allgemeinen Voreinstellungen. Zu den optionalen Feldern gehören u.a.
* Für Boolesche Felder wird eine 0 für Falsch und eine 1 für Wahr verwendet.
<code>institution, department, city, country, lang, auth, ajax, timezone, idnumber, icq, phone1, phone2, address, url, description, mailformat, maildisplay, htmleditor, autosubscribe</code>
* ''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==
Beachten Sie:
===Beispiel 1===
*<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''].
<code>username, password, firstname, lastname, email, lang, idnumber, maildisplay, course1, group1, type1<br />
*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.
jonest, verysecret, Tom, Jones, jonest@someplace.edu, en, 3663737, 1, Intro101, Section 1, 1<br />
*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.
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.  
====Zusätzliche Profilfelder====
(Nach [http://moodle.org/help.php?file=uploadusers.html Upload users help file].)
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 2===
'''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.
[[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:
'''Hinweis''': Die zusätzlichen Profilfelder müssen im System angelegt sein, bevor Sie Nutzerdateien hochladen.
:Nutzer test1: Eingetragen in "test_080208" als "student", eingetragen in "SVW-Kollegium" als "teacher", zur Gruppe Testgruppe hinzugefügt
:Nutzer test2: Eingetragen in "test_080208" als "teacher", eingetragen in "SVW-Kollegium" als "student", zur Gruppe Testgruppe 2 hinzugefügt


Beim ersten Nutzer test1 wird durch Setzen von <code>emailstop</code> auf 1 (=WAHR), die E-Mail Adresse deaktiviert.
====Spezielle Felder====
Beim zweiten Nutzer test2 ist die E-Mail Adresse dagegen aktiviert (emailstop=0). Bei test2 wurde der Wert des Felds <code>password
Sie können folgende spezielle Felder verwenden:
</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.
*<code>oldusername</code> - um Anmeldenamen in bestehenden Nutzerkonten zu ändern
*<code>deleted</code> - um bestehende Nutzerkonten zu löschen


'''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).
====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: <code>course1, type1, role1, group1, enrolperiod1, course2, type2, role2, group2, enrolperiod2</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.
Diese Felder sind optional.


==Aktualisierung existierender Nutzerkonten==
====Datenfeld <code>cohort</code>====
Dieses Feld ist optional. Sie können es verwenden, wenn Sie eine Person in eine [[Globale Gruppen|globale Gruppe]] eintragen wollen. Verwenden Sie die ID der globalen Gruppe (nicht den Namen!).


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.
====Vollständige Liste der Datenfelder====
Hier finden Sie eine vollständige Liste der möglichen Datenfelder, die Sie in der Nutzerdatei verwenden dürfen:


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:
<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>
# Neue hinzufügen, vorhandene Nutzer/innen überspringen (Voreinstellung)
# Alle hinzufügen, bei Bedarf einen Zähler beim Nutzernamen anhängen
# Neue hinzufügen, vorhandene Nutzer/innen aktualisieren
# 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.
Hinzu kommen die [[Profilfelder]], die Sie zusätzlich in Ihrem Moodle-System angelegt haben.
 
'''Achtung''': Alle Fehler beim Aktualisierungsprozess können für die Nutzer schwerwiegende Folgen haben. Bei einem Aktualisierungs-Update ist größte Sorgfalt geboten!


==Zeichenkodierung==
==Zeichenkodierung==


In Moodle 1.7 und 1.8 mußte die Zeichenkodierung beim Import UTF-8 sein.
Auf der Vorschauseite im Upload-Prozess können Sie die Zeichenkodierung (Einstellung ''Encoding'') auswählen.
 
{{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.
 
==Tipps==
 
===Tabellenkalkulation===
 
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.
 
===Land===
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===
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  .
 
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)
 
==Glossar==
Eine '''.csv-Datei''' (comma/character separated values) ist eine einfache Textdatei (ASCII oder Unicode), in der die Daten meistens durch Kommas getrennt sind.
 
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.


==Siehe auch==
==Siehe auch==

Version vom 26. März 2012, 11:11 Uhr


Baustelle.png Diese Seite ist noch nicht vollständig übersetzt.

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.

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 > Nutzerkonten > Nutzerkonten > Nutzerliste hochladen.
  3. Klicken Sie auf den Button Datei wählen und laden Sie die Datei mit den Nutzerdaten hoch oder wählen Sie eine bereits hochgeladene Datei mit den Nutzerdaten aus einem Repository aus. Wählen Sie das passende CSV Trennzeichen, das Sie in der Datei verwenden und klicken Sie auf den Button Nutzerliste hochladen.
  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 - 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

Datei:Nutzer-Import-Hochladen-de.jpg
Nutzerkonten: Nutzer/innen hochladen

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, course2, type2, role2, group2, enrolperiod2 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.

Diese Felder sind optional.

Datenfeld cohort

Dieses Feld ist optional. Sie können es verwenden, wenn Sie eine Person in eine globale Gruppe eintragen wollen. Verwenden Sie die ID der globalen Gruppe (nicht den Namen!).

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.

Zeichenkodierung

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

Siehe auch

Diskussionsbeiträge im Moodle Forum:

Vorlage:Credits [1]