Gruppen importieren: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
 
(8 dazwischenliegende Versionen von 4 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.
*Klicken Sie auf das Zahnrad-Symbol [[Image:settings.svg|16px|baseline]] rechts oben > ''Mehr …'' (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:
* Zwischen den Trennkomma und dem Text darf keine Leerstelle sein.
* Die erste Zeile enthält die kommagetrennte Liste der Felder - diese bestimmt das Format des Rests der Datei.
* Kommas in den Daten müssen mit dem Code &#44 angegeben werden.
* 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).
* Für boolesche Variable verwenden Sie 0 für falsch und 1 für wahr.
*Kommas in den Daten müssen mit dem Code &#44 angegeben werden.
* 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.
*Für boolesche Variable verwenden Sie 0 für falsch und 1 für wahr.
* Mit ''coursename'' ist der Kurzname des Kurses gemeint, in den die Gruppen importiert werden sollen.
*Zur Identifizierung des Kurses genügt es, eines der Standardfelder ''idnumber'' oder ''coursename'' zu verwenden. Wenn Sie beide Werte angeben (und dieses passen nicht zusammen), dann wird ''idnumber'' verwendet. Ist keins von beiden angegeben, werden die Gruppen in den aktuellen Kurs importiert.
*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.
*Mit ''coursename'' ist die Kurzbezeichnung des Kurses gemeint, in den die Gruppen importiert werden sollen.
* Die Datei muss in der ANSI-Codierung, zumindest ''nicht'' in UTF-8-Codierung, abgespeichert werden.
{{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.
* Es dürfen keine Umlaute (z.B. ü, ä) enthalten sein.
   
   
'''Hinweis''': Trainer/innen dürfen nur in die Kurse Gruppen importieren, in denne 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''':


<pre>
<pre>
groupname, description, enrolmentkey
groupname,description,enrolmentkey
Team 1, Gruppenzuordnung Team 1, blau
Team 1,Gruppenzuordnung Team 1,blau
Team 2, Gruppenzuordnung Team 2, rot
Team 2,Gruppenzuordnung Team 2,rot
Team 3, Gruppenzuordnung Team 3, grün
Team 3,Gruppenzuordnung Team 3,gruen
</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 2. Juli 2019, 18:20 Uhr

gruppenimportieren.png

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

  • Klicken Sie auf das Zahnrad-Symbol settings.svg rechts oben > Mehr … (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.