Gruppen importieren: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
 
(7 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Gruppen}}
{{Gruppen}}
[[Image:gruppenimportieren.png|thumb]]
Die Funktion [[Gruppen importieren]] ist eine einfache Möglichkeit, Gruppen über eine CSV-Datei anzulegen.


Die Funktion [[Gruppen importieren]] ist eine einfache Möglichkeit, Gruppen über eine Excel-Datei anzulegen.
*Trainer/innen können die Rechte einzelner Teilnehmer/innen im Kurs prüfen: Klicken Sie dazu in der Kursnavigation ''Teilnehmer/innen'' und wählen Sie im Pulldown-Menu ''Gruppen'' (oder im Block ''[[Einstellungen-Block|Einstellungen]] > Kurs-Administration > Nutzer/innen > Gruppen)'' und dann auf den Button ''Gruppen importieren''.
 
*Klicken Sie im Block ''[[Einstellungen-Block|Einstellungen]] > Kurs-Administration > Nutzer/innen > Gruppen'' und dann auf den Button ''Gruppen importieren''.
* Laden Sie eine CSV-Datei [[Datei hochladen|hoch]] (Informationen zum CSV-Dateiformat siehe nächster Abschnitt) oder ziehen Sie diese per Drag&Drop direkt von Ihrem Desktop in den Dateibereich..
* Laden Sie eine CSV-Datei [[Datei hochladen|hoch]] (Informationen zum CSV-Dateiformat siehe nächster Abschnitt) oder ziehen Sie diese per Drag&Drop direkt von Ihrem Desktop in den Dateibereich..
*Klicken Sie auf den Button ''Gruppen importieren''.
*Klicken Sie auf den Button ''Gruppen importieren''.


==CSV-Dateiformat==
==CSV-Dateiformat==
Die CSV-Datei muss bestimmte Felder enthalten:
Die CSV-Datei muss nur das Pflichtfeld ('''groupname''') enthalten, es kann jedoch auch weitere Standardfelder und/oder optionale Felder enthalten.
*Pflichtfelder: ''groupname'' (für den Gruppennamen)
*Jede Zeile in der Datei muss einen Datensatz enthalten.
*Standardfelder: diese sind optional und werden - falls nicht in der Datei angegeben - aus den aktuellen Einstellungen im Moodle-Kurs berechnet; dazu gehören ''idnumber'' (Kurs-ID), ''coursename'' (Kursname), ''lang'' (Sprache)
*Jeder Datensatz besteht aus Daten, die mit Kommas getrennt sind.
*optionale Felder: ''description'' (Gruppenbeschreibung), ''enrolmentkey'' (Gruppenschlüssel), ''picture'' (Bild - boolesche Variable), ''hidepicture'' (Bild verbergen - boolesche Variable)
*Die erste Zeile ist speziell, sind enthält die Liste der Feldnamen. Dadurch wird das Format des Rests der Datei festgelegt.
 
'''Pflichtfelder''': Diese Felder müssen in der ersten Zeile vorkommen und jede folgende Zeile muss entsprechende Daten enthalten.
groupname
 
'''Standardfelder''': Diese sind optional; Sie können eine Kurs-ID und einen Kurznamen des Kurses angeben.
idnumber,coursename
 
'''Optionale Felder''':
groupidnumber,description,enrolmentkey
 
''Hinweis'': Die Felder ''picture'' und ''hidepicture'' führen beim Hochladen der Datei zu einer Fehlermeldung: "not a valid field name").
 
Wenn der Name der Gruppierung eingetragen wird, dann werden hochgeladene Gruppen dieser Gruppierung zugeordnet. Die Gruppierungen werden angelegt, falls sie noch nicht existieren.
groupingname


Weiter gelten folgende Regeln:
* Die erste Zeile enthält die kommagetrennte Liste der Felder - diese bestimmt das Format des Rests der Datei.
* Jede weitere Zeile enthält den Datensatz einer Gruppe - die Daten sind in der Reihenfolge der zugehörigen Felder in der ersten Zeile einzugeben und durch Kommas zu trennen).
* Zwischen den Trennkomma und dem Text darf keine Leerstelle sein.
* Zwischen den Trennkomma und dem Text darf keine Leerstelle sein.
* Es dürfen keine Umlaute (z.B. ü, ä) enthalten sein.
* Kommas in den Daten müssen mit dem Code &#44 angegeben werden.
* Kommas in den Daten müssen mit dem Code &#44 angegeben werden.
* Für boolesche Variable verwenden Sie 0 für falsch und 1 für wahr.
* Für boolesche Variable verwenden Sie 0 für falsch und 1 für wahr.
* Zur Identifizierung des Kurses genügt es, eines der Standardfelder ''idnumber'' oder ''coursename'' zu verwenden. Wenn Sie beide Werte angeben (und diese passen nicht zusammen), dann wird ''idnumber'' verwendet. Ist keins von beiden angegeben, werden die Gruppen in den aktuellen Kurs importiert.
* Zur Identifizierung des Kurses genügt es, eines der Standardfelder ''idnumber'' oder ''coursename'' zu verwenden. Wenn Sie beide Werte angeben (und diese passen nicht zusammen), dann wird ''idnumber'' verwendet. Ist keins von beiden angegeben, werden die Gruppen in den aktuellen Kurs importiert.
* Mit ''coursename'' ist die Kurzbezeichnung des Kurses gemeint, in den die Gruppen importiert werden sollen.
* Mit ''coursename'' ist der Kurzname des Kurses gemeint, in den die Gruppen importiert werden sollen.
{{Neu}}*Gruppen-IDs können verwendet werden, um die Gruppe gegenüber externen Systemen zu identifizieren. Innerhalb eines Kurses müssen die Gruppen-IDs eindeutig sein.
*Gruppen-IDs können verwendet werden, um die Gruppe gegenüber externen Systemen zu identifizieren. Innerhalb eines Kurses müssen die Gruppen-IDs eindeutig sein.
* Die Datei muss in der ANSI-Codierung, zumindest ''nicht'' in UTF-8-Codierung, abgespeichert werden.
* Die Datei muss in der ANSI-Codierung, zumindest ''nicht'' in UTF-8-Codierung, abgespeichert werden.
* Es dürfen keine Umlaute (z.B. ü, ä) enthalten sein.
   
   
'''Hinweis''': Trainer/innen dürfen nur in die Kurse Gruppen importieren, in denen sie Bearbeitungsrechte haben.
''Hinweis'': Wenn eine Gruppe bereits im Kurs existiert, dann liefert das Skript den Gruppennamen zurück. Trainer/innen dürfen nur in die Kurse Gruppen importieren, in denen sie Bearbeitungsrechte haben.


'''Beispieldatei''':
'''Beispieldatei''':
Zeile 36: Zeile 47:
</pre>
</pre>


'''Hinweis''': das Importieren von Gruppen hat nichts mit [[Gruppierungen]] zu tun.
==Siehe auch==
Wenn Sie Nutzer/innen zu Gruppen hinzufügen möchten, dann können Sie das als Administrator/in unter dem Menüpunkt ''Website-Administration'' (oder im Block [[Einstellungen-Block|Einstellungen]] > Website-Administration'')'' > Nutzer/innen > Nutzerkonten > Nutzerliste hochladen''. Siehe [[Nutzerliste hochladen]]. Wenn die angegebenen Gruppen noch nicht existieren, werden sie angelegt.


[[en:Import groups]]
[[en:Import groups]]
[[es:Importar grupos]]
[[fr:Importer des Groupes]]

Aktuelle Version vom 29. März 2022, 13:15 Uhr

gruppenimportieren.png

Die Funktion Gruppen importieren ist eine einfache Möglichkeit, Gruppen über eine CSV-Datei anzulegen.

  • Trainer/innen können die Rechte einzelner Teilnehmer/innen im Kurs prüfen: Klicken Sie dazu in der Kursnavigation Teilnehmer/innen und wählen Sie im Pulldown-Menu Gruppen (oder im Block Einstellungen > Kurs-Administration > Nutzer/innen > Gruppen) und dann auf den Button Gruppen importieren.
  • Laden Sie eine CSV-Datei hoch (Informationen zum CSV-Dateiformat siehe nächster Abschnitt) oder ziehen Sie diese per Drag&Drop direkt von Ihrem Desktop in den Dateibereich..
  • Klicken Sie auf den Button Gruppen importieren.

CSV-Dateiformat

Die CSV-Datei muss nur das Pflichtfeld (groupname) enthalten, es kann jedoch auch weitere Standardfelder und/oder optionale Felder enthalten.

  • Jede Zeile in der Datei muss einen Datensatz enthalten.
  • Jeder Datensatz besteht aus Daten, die mit Kommas getrennt sind.
  • Die erste Zeile ist speziell, sind enthält die Liste der Feldnamen. Dadurch wird das Format des Rests der Datei festgelegt.

Pflichtfelder: Diese Felder müssen in der ersten Zeile vorkommen und jede folgende Zeile muss entsprechende Daten enthalten.

groupname

Standardfelder: Diese sind optional; Sie können eine Kurs-ID und einen Kurznamen des Kurses angeben.

idnumber,coursename

Optionale Felder:

groupidnumber,description,enrolmentkey

Hinweis: Die Felder picture und hidepicture führen beim Hochladen der Datei zu einer Fehlermeldung: "not a valid field name").

Wenn der Name der Gruppierung eingetragen wird, dann werden hochgeladene Gruppen dieser Gruppierung zugeordnet. Die Gruppierungen werden angelegt, falls sie noch nicht existieren.

groupingname
  • Zwischen den Trennkomma und dem Text darf keine Leerstelle sein.
  • Kommas in den Daten müssen mit dem Code &#44 angegeben werden.
  • Für boolesche Variable verwenden Sie 0 für falsch und 1 für wahr.
  • Zur Identifizierung des Kurses genügt es, eines der Standardfelder idnumber oder coursename zu verwenden. Wenn Sie beide Werte angeben (und diese passen nicht zusammen), dann wird idnumber verwendet. Ist keins von beiden angegeben, werden die Gruppen in den aktuellen Kurs importiert.
  • Mit coursename ist der Kurzname des Kurses gemeint, in den die Gruppen importiert werden sollen.
  • Gruppen-IDs können verwendet werden, um die Gruppe gegenüber externen Systemen zu identifizieren. Innerhalb eines Kurses müssen die Gruppen-IDs eindeutig sein.
  • Die Datei muss in der ANSI-Codierung, zumindest nicht in UTF-8-Codierung, abgespeichert werden.
  • Es dürfen keine Umlaute (z.B. ü, ä) enthalten sein.

Hinweis: Wenn eine Gruppe bereits im Kurs existiert, dann liefert das Skript den Gruppennamen zurück. Trainer/innen dürfen nur in die Kurse Gruppen importieren, in denen sie Bearbeitungsrechte haben.

Beispieldatei:

groupname,description,enrolmentkey
Team 1,Gruppenzuordnung Team 1,blau
Team 2,Gruppenzuordnung Team 2,rot
Team 3,Gruppenzuordnung Team 3,gruen

Siehe auch

Wenn Sie Nutzer/innen zu Gruppen hinzufügen möchten, dann können Sie das als Administrator/in unter dem Menüpunkt Website-Administration (oder im Block Einstellungen > Website-Administration) > Nutzer/innen > Nutzerkonten > Nutzerliste hochladen. Siehe Nutzerliste hochladen. Wenn die angegebenen Gruppen noch nicht existieren, werden sie angelegt.