Kurse hochladen: Unterschied zwischen den Versionen

Aktuelle Version vom 21. Februar 2020, 09:58 Uhr

Hinweis: Auf dieser Seite geht es darum, Kurse mittels einer Textdatei (.csv) zu erstellen. Wenn Sie ein Kurs-Backup im Format .mbz oder .tgz hochladen möchten, gehen Sie bitte zu Kurswiederherstellung.

Administrator/innen können Kurse mittels einer Datei hochladen.

Kurse hochladen

Mit dieser Methode können Sie Kurse neu anlegen oder bestehende Kurse aktualisieren bzw. löschen, Kurseinschreibungen aktualisieren oder Inhalte aus anderen Kursen importieren.

Datei hochladen

Die Datei wird auf der Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Kurse > Kurse hochladen hochgeladen. Ziehen Sie die Datei per Drag&Drop in den entsprechenden Bereich oder klicken Sie auf den Button Datei wählen.

Nutzen Sie den Button Vorschau, um zu prüfen, ob Fehler in der Datei sind.

Hinweis: Sie können auch von Kommandozeile aus das Skript admin/tool/uploadcourse/cli/uploadcourse.php aufrufen, um Kurse hochzuladen.

Beispiel an einer kleinen Datei

uploadcourse.csv:

Hinweis: shortname, fullname und category sind erforderlich.

Das Feld category nimmt die ID der Kurskategorie ein, wobei die Standardkategorie 'Miscellaneous' die ID 1 hat. Kurskategorien müssen bereits existieren. Wenn Sie eine Kurskategorie-ID eingeben, die nicht existiert, erhalten Sie während der Upload-Vorschau einen Fehler "Could not resolve category by ID", und Kurse in dieser Kurskategorie werden nicht erstellt.

shortname,fullname,category,summary,enrolment_1,enrolment_1_role,enrolment_1_enrolperiod,role_student courserestored,Course restored,1,a summary,manual,student,1 month, courserestored2,Course restored 2,1,a summary,,,, courserestored3,Course restored 3,1,a summary,,,,padawan courserestored4,Course restored 4,1,"a summary, with comma",manual,student,1 month,padawan Beachten Sie, dass es keine Leerzeichen zwischen den Elementen gibt.

Datei erstellen

Die Datei muss eine .csv Datei sein. In der obersten Zeile stehen verschiedene Datenfelder: zum einen Datenfelder zur Kursinformation, zum anderen Datenfelder zu Kursaktionen. Jede weitere Zeile enthält einen Datensatz für einen Kurs.

Datenfelder zur Kursinformation

Die meisten Datenfelder entsprechen Optionen, die Sie auf der Kurseinstellungsseite konfigurieren, siehe Kurseinstellungen für detaillierte Informationen.

shortname: Kursname (kurz) - Kurzbezeichnung des Kurses
fullname: Kursname - der vollständige Name des Kurses
idnumber: Kurs-ID
category: ID des Kursbereichs, zu dem der Kurs gehört. Diese Einstellung überschreibt gegebenenfalls die Daten der Felder category_idnumber und category_path.
category_idnumber: ID-Nummer des Kursbereichs, zu dem der Kurs gehört. Diese Einstellung überschreibt gegebenenfalls die Daten des Feldes category_path.
category_path: Pfad des Kursbereichs, zu dem der Kurs gehört. Wenn Sie z.B. einen Kurs im Bereich "Physik" anlegen wollen und dieser Kursbereich ist ein Unterbereich vom Kursbereich "Naturwissenschaften", dann tragen Sie in der Datei ein: Naturwissenschaften / Physik. Wichtig: Die Trennung erfolgt mit {Leerzeichen}/{Leerzeichen}. Der angegebene Kursbereich MUSS bereits in Ihrem Moodle-System vorhanden sein, er wird nicht neu angelegt.
visible: 1 - wenn der Kurs sichtbar sein soll, 0 - wenn er verborgen ist.
startdate: Datum, an dem der Kurs startet. Der Wert wird an die PHP-Funktion strtotime übergeben, die einen Zeitstempel generiert.
enddate: Datum, an dem der Kurs endet. Der Wert wird an die PHP-Funktion strtotime übergeben, die einen Zeitstempel generiert. Beispiel: 01.12.2014
summary: Kursbeschreibung
format: Kursformat, z.B. weeks oder topics - Pluginname eines Kursformats.
theme: Kurs-Design
lang: Kurs-Sprache
newsitems: Anzahl neuer Nachrichten
showgrades: Bewertungen anzeigen: 1 - wenn die Bewertungen über das Zahnrad-Symbol rechts oben (oder im Block Einstellungen > Kurs-Administration) angezeigt werden sollen, 0 - sonst.
showreports: Berichte anzeigen: 1 - wenn die Berichte über das Zahnrad-Symbol rechts oben (oder im Block Einstellungen > Kurs-Administration) angezeigt werden sollen, 0 - sonst.
legacyfiles: Legacy-Kursdateien: 1 - wenn dieser Dateibereich aktiviert werden soll, 0 - sonst.
maxbytes: Maximale Dateigröße (wählen Sie den Wert 0, wenn Sie die Standardeinstellung der Moodle-Site verwenden wollen).
groupmode: Gruppenmodus: 0 für Keine Gruppen, 1 für Getrennte Gruppen und 2 für Sichtbare Gruppen.
groupmodeforce: 1 für Gruppenmodus erzwingen, 0 - sonst.
enablecompletion: Abschlussverfolgung: 1 - aktivieren, 0 - sonst.

Datenfelder für die Kurseinschreibung

Einige Datenfelder können verwendet werden, um die Einschreibung in Kurse zu konfigurieren. Die Felder heißen enrolment_[number] für den Namen der Einschreibemethode und enrolment_[number]_property für die zugehörigen Eigenschaften. [number] ist eine hochzuzählende Zahl. Es können also mehrere Einschreibemethoden mit Ihren Eigenschaften angelegt werden, z.B. eine Selbsteinschreibung für Teilnehmer*innen und eine für Trainer*innen.

enrolment_[number]: Name der Einschreibemethode
enrolment_[number]_delete: Löschen: 1 - löscht die Einschreibemethode im Kurs; in diesem Fall werden alle weiteren Einstellungen für diese Einschreibemethode ignoriert.
enrolment_[number]_disable: Deaktivieren: 1 - deaktiviert die Einschreibemethode im Kurs; in diesem Fall werden alle weiteren Einstellungen für diese Einschreibemethode ignoriert.
enrolment_[number]_startdate: Einschreibebeginn: Der Wert wird an die PHP-Funktion strtotime() übergeben.
enrolment_[number]_enddate: Einschreibeende: Der Wert wird an die PHP-Funktion strtotime() übergeben.
enrolment_[number]_enrolperiod: Teilnahmedauer: Angabe in Sekunden oder ein Wert, der von der PHP-Funktion strtotime() verarbeitet werden kann, z.B. "4 days".
enrolment_[number]_role: Kurzbezeichnung der Rolle, die bei der Einschreibung vergeben wird.
enrolment_[number]_password: der Einschreibschlüssel
enrolment_[number]_[property]: property muss eine Eigenschaft der zugehörigen Einschreibemethode sein.

Beispiel

enrolment_1: manual
enrolment_1_role: student
enrolment_1_enrolperiod: 1 month

enrolment_2: self
enrolment_2_startdate: 2013-01-30

Rollenumbenennung

Wenn Sie Rollen in einem Kurs umbenennen wollen, verwenden Sie folgendes Muster:

role_[shortname]: Neue Bezeichnung der Rolle [shortname].

Beispiel

role_student: Lehrling
role_teacher: Meister
role_mycustomrole: Jedi

Datenfelder zu Kursaktionen

Diese Einstellungen überschreiben gegebenenfalls die Einstellungen für den Kursprozess.

delete: Löschen: 1 - wenn der Kurs gelöscht werden soll.
rename: neue Kurzbezeichnung für den Kurs, der umbenannt werden soll.
backupfile: Absolutpfad zu einer Kurssicherungsdatei (.mbz), die in den Kurs importiert werden soll
templatecourse: Kurzbezeichnung des Kurses aus dem Inhalte importiert werden sollen.
reset: Löschen: 1 - wenn der Kurs zurückgesetzt werden soll.

Pflichtfelder

shortname: Dieses Datenfeld ist Pflichtfeld für jede Kursaktion, außer beim Anlegen eines neuen Kurses (siehe dazu die Einstellung Vorlage zum Erzeugen eines Kursnamens im Abschnitt Kurs-Prozess).
fullname: Pflichtfeld beim Anlegen eines neuen Kurses
category, category_idnumber, category_path: Einer dieser Werte muss beim Anlegen eines neuen Kurses angegeben sein.

Importoptionen

Mit diesen Einstellungen geben Sie an, wofür Sie das Tool bzw. die Datei nutzen wollen:

Modus beim Hochladen: Hier geben Sie an, ob die Kurse in der Datei angelegt und/oder aktualisiert werden sollen.
Aktualisierungsmodus: Wenn Sie beim Modus beim Hochladen das Aktualisieren von Kursen zugelassen haben, dann wählen Sie mir dieser Option, wie die Daten in der Datei für die Aktualisierung verwendet werden sollen.
Löschung erlauben: Mit dieser Einstellung legen Sie fest, ob das Datenfeld delete akzeptiert wird oder nicht.
Umbenennung erlauben: Mit dieser Einstellung legen Sie fest, ob das Datenfeld rename akzeptiert wird oder nicht.
Zurücksetzen erlauben: Mit dieser Einstellung legen Sie fest, ob das Datenfeld reset akzeptiert wird oder nicht.

Kurs-Prozess

Hiermit legen Sie fest, welche Aktionen mit jedem einzelnen Kurs in der Datei ausgeführt werden.

Vorlage zum Erzeugen eines Kursnamens: Wenn ein Kurs neu angelegt werden soll, aber in der Datei keine Angabe für shortname enthalten ist, können Sie hier eine Vorlage angeben, aus der die Kurzbezeichnung des Kurses automatisch erzeugt wird. Sie können in der Syntax folgende Platzhalter verwenden: %i für die ID-Nummer, %f für die Kursbeschreibung.
Aus dieser Datei nach dem Upload wiederherstellen: Kurssicherungsdatei (.mbz), aus der Inhalte importiert werden, nachdem der Kurs neu angelegt oder aktualisiert wurde.
Wiederherstellen dieses Kurses nach dem Upload: Kurzbezeichnung des Kurses, aus dem Inhalte importiert werden, nachdem der Kurs neu angelegt oder aktualisiert wurde.
Kurs nach dem Hochladen zurücksetzen: Hier geben Sie an, ob der Kurs nach dem Anlegen bzw. Aktualisieren zurückgesetzt werden soll.

Standardmäßige Kurseinstellungen

Hier legen Sie die Standardeinstellungen für alle Datenfelder fest, die nicht in der .csv Datei enthalten sind. Diese Einstellungen werden beim Anlegen eines neuen Kurses verwendet. Bei der Aktualisierung von bereits bestehenden Kursen werden diese Werte nur verwendet, wenn der Update-Modus entsprechend gewählt wurde (siehe oben).

Geschwindigkeit erhöhen

Bei Importieren von Kursinhalten aus einer Kurssicherung oder aus einem anderen Kurs wird empfohlen, die Einstellung keeptempdirectoriesonbackup zu aktivieren. Dadurch wird der Upload-Prozess signifikant beschleunigt, wenn Sie mehrfach aus derselben Quelle importieren.

@@ Zeile 1: / Zeile 1: @@
 {{Kurse}}
-{{Neu}}
+{{Hinweis|Auf dieser Seite geht es darum, Kurse mittels einer Textdatei (.csv) zu erstellen. Wenn Sie ein Kurs-Backup im Format .mbz oder .tgz hochladen möchten, gehen Sie bitte zu [[Kurswiederherstellung]].}}
 Administrator/innen können Kurse mittels einer Datei hochladen.
+{{MediaPlayer | url = https://youtu.be/gagxI4YzKgg | desc = Kurse hochladen}}
 Mit dieser Methode können Sie Kurse neu anlegen oder bestehende Kurse aktualisieren bzw. löschen, Kurseinschreibungen aktualisieren oder Inhalte aus anderen Kursen importieren.
 ==Datei hochladen==
-Die Datei wird auf der Seite ''[[Einstellungen-Block|Einstellungen]] > Website-Administration > Kurse > Kurse hochladen'' hochgeladen. Ziehen Sie die Datei per Drag&Drop in den entprechenden oder klicken Sie auf den Button ''Datei wählen''.
+Die Datei wird auf der Seite ''Website-Administration'' (oder im Block ''[[Einstellungen-Block|Einstellungen]] > Website-Administration'')'' > Kurse > Kurse hochladen'' hochgeladen. Ziehen Sie die Datei per Drag&Drop in den entsprechenden Bereich oder klicken Sie auf den Button ''Datei wählen''.
 Nutzen Sie den Button ''Vorschau'', um zu prüfen, ob Fehler in der Datei sind.
 '''Hinweis''': Sie können auch von Kommandozeile aus das Skript ''admin/tool/uploadcourse/cli/uploadcourse.php'' aufrufen, um Kurse hochzuladen.
+=== Beispiel an einer kleinen Datei ===
+uploadcourse.csv:
+Hinweis: shortname, fullname und category sind erforderlich.
+Das Feld category nimmt die ID der Kurskategorie ein, wobei die Standardkategorie 'Miscellaneous' die ID 1 hat. Kurskategorien müssen bereits existieren. Wenn Sie eine Kurskategorie-ID eingeben, die nicht existiert, erhalten Sie während der Upload-Vorschau einen Fehler "Could not resolve category by ID", und Kurse in dieser Kurskategorie werden nicht erstellt.
+<code bash>
+shortname,fullname,category,summary,enrolment_1,enrolment_1_role,enrolment_1_enrolperiod,role_student
+courserestored,Course restored,1,a summary,manual,student,1 month,
+courserestored2,Course restored 2,1,a summary,,,,
+courserestored3,Course restored 3,1,a summary,,,,padawan
+courserestored4,Course restored 4,1,"a summary, with comma",manual,student,1 month,padawan
+</code>
+Beachten Sie, dass es keine Leerzeichen zwischen den Elementen gibt.
 ==Datei erstellen==
@@ Zeile 29: / Zeile 47: @@
 : ID-Nummer des Kursbereichs, zu dem der Kurs gehört. Diese Einstellung überschreibt gegebenenfalls die Daten des Feldes '''category_path'''.
 ;'''category_path'''
-: Pfad des Kursbereichs, zu dem der Kurs gehört. Wenn Sie z.B. einen Kurs im Bereich "Physik" anlegen wollen und dieser Kursbereich ist ein Unterbereich vom Kursbereich "Naturwissenschaften", dann tragen Sie in der Datei ein: <code>Naturwissenschaften > Physik</code>. Der angegebene Kursbereich MUSS bereits in Ihrem Moodle-System vorhanden sein, er wird nicht neu angelegt.
+: Pfad des Kursbereichs, zu dem der Kurs gehört. Wenn Sie z.B. einen Kurs im Bereich "Physik" anlegen wollen und dieser Kursbereich ist ein Unterbereich vom Kursbereich "Naturwissenschaften", dann tragen Sie in der Datei ein: <code>Naturwissenschaften / Physik</code>. Wichtig: Die Trennung erfolgt mit <code>{Leerzeichen}/{Leerzeichen}</code>. Der angegebene Kursbereich MUSS bereits in Ihrem Moodle-System vorhanden sein, er wird nicht neu angelegt.
 ;'''visible'''
 : 1 - wenn der Kurs sichtbar sein soll, 0 - wenn er verborgen ist.
 ;'''startdate'''
 : Datum, an dem der Kurs startet. Der Wert wird an die PHP-Funktion [http://php.net/manual/en/function.strtotime.php strtotime] übergeben, die einen Zeitstempel generiert.
+;'''enddate'''
+:Datum, an dem der Kurs endet. Der Wert wird an die PHP-Funktion [http://php.net/manual/en/function.strtotime.php strtotime] übergeben, die einen Zeitstempel generiert. Beispiel: 01.12.2014
 ;'''summary'''
 : Kursbeschreibung
@@ Zeile 45: / Zeile 65: @@
 : Anzahl neuer Nachrichten
 ;'''showgrades'''
-: Bewertungen anzeigen: 1 - wenn die Bewertungen im Bereich ''[[Einstellungen-Block|Einstellungen]] > Kurs-Administration'' angezeigt werden sollen, 0 - sonst.
+: Bewertungen anzeigen: 1 - wenn die Bewertungen über das Zahnrad-Symbol [[Image:settings.svg|16px|baseline]] rechts oben (oder im Block ''[[Einstellungen-Block|Einstellungen]] > Kurs-Administration'')'' angezeigt werden sollen, 0 - sonst.
 ;'''showreports'''
-: Berichte anzeigen: 1 - wenn die Berichte im Bereich ''[[Einstellungen-Block|Einstellungen]] > Kurs-Administration'' angezeigt werden sollen, 0 - sonst.
+: Berichte anzeigen: 1 - wenn die Berichte über das Zahnrad-Symbol [[Image:settings.svg|16px|baseline]] rechts oben (oder im Block ''[[Einstellungen-Block|Einstellungen]] > Kurs-Administration'')'' angezeigt werden sollen, 0 - sonst.
 ;'''legacyfiles'''
 : [[Legacy-Kursdateien]]: 1 - wenn dieser Dateibereich aktiviert werden soll, 0 - sonst.
@@ Zeile 61: / Zeile 81: @@
 ====Datenfelder für die Kurseinschreibung====
 Einige Datenfelder können verwendet werden, um die Einschreibung in Kurse zu konfigurieren. Die Felder heißen ''enrolment_[number]'' für den Namen der Einschreibemethode und ''enrolment_[number]_property'' für die zugehörigen Eigenschaften.
+[number] ist eine hochzuzählende Zahl. Es können also mehrere Einschreibemethoden mit Ihren Eigenschaften angelegt werden, z.B. eine Selbsteinschreibung für Teilnehmer*innen und eine für Trainer*innen.
 ;'''enrolment_[number]'''
@@ Zeile 75: / Zeile 96: @@
 :Teilnahmedauer: Angabe in Sekunden oder ein Wert, der von der PHP-Funktion strtotime() verarbeitet werden kann, z.B. "4 days".
 ;'''enrolment_[number]_role'''
-: Kurzbezeichnung der Rolle, die bei der Einscheibung vergeben wird.
+: Kurzbezeichnung der Rolle, die bei der Einschreibung vergeben wird.
-:enrolment_[number]_[property]
+;'''enrolment_[number]_password'''
-; '''property''' muss eine Eigenschaft der zugehörigen Einschreibemethodei sein.
+:der Einschreibschlüssel
+;'''enrolment_[number]_[property]'''
+:property muss eine Eigenschaft der zugehörigen Einschreibemethode sein.
 '''Beispiel'''
@@ Zeile 117: / Zeile 140: @@
 ;'''shortname'''
-: Dieses Datenfeld ist Pflichtfeld für jede Kursation, außer beim Anlegen eines neuen Kurses (siehe dazu die Einstellung '''Vorlage zum Erzeugen eines Kursnamens''' im Abschnitt [[#Kurs-Prozess|Kurs-Prozess]]).
+: Dieses Datenfeld ist Pflichtfeld für jede Kursaktion, außer beim Anlegen eines neuen Kurses (siehe dazu die Einstellung '''Vorlage zum Erzeugen eines Kursnamens''' im Abschnitt [[#Kurs-Prozess|Kurs-Prozess]]).
 ;'''fullname'''
 : Pflichtfeld beim Anlegen eines neuen Kurses
@@ Zeile 128: / Zeile 151: @@
 ;'''Modus beim Hochladen'''
 : Hier geben Sie an, ob die Kurse in der Datei angelegt und/oder aktualisiert werden sollen.
-;'''Update mode'''
+;'''Aktualisierungsmodus'''
-: Wenn Sie beim '''Modus beim Hochladen''' das Aktualisieren von Kursen zugelassen haben, wie die Daten in der Datei verwendet werden sollen.
+: Wenn Sie beim '''Modus beim Hochladen''' das Aktualisieren von Kursen zugelassen haben, dann wählen Sie mir dieser Option, wie die Daten in der Datei für die Aktualisierung verwendet werden sollen.
 ;'''Löschung erlauben'''
 : Mit dieser Einstellung legen Sie fest, ob das Datenfeld '''delete''' akzeptiert wird oder nicht.
@@ Zeile 142: / Zeile 165: @@
 ;'''Vorlage zum Erzeugen eines Kursnamens'''
 : Wenn ein Kurs neu angelegt werden soll, aber in der Datei keine Angabe für '''shortname''' enthalten ist, können Sie hier eine Vorlage angeben, aus der die Kurzbezeichnung des Kurses automatisch erzeugt wird. Sie können in der Syntax folgende Platzhalter verwenden: %i für die ID-Nummer, %f für die Kursbeschreibung.
-;Restore file
+;Aus dieser Datei nach dem Upload wiederherstellen
 : Kurssicherungsdatei (.mbz), aus der Inhalte importiert werden, nachdem der Kurs neu angelegt oder aktualisiert wurde.
-;Restore from course
+;Wiederherstellen dieses Kurses nach dem Upload
 : Kurzbezeichnung des Kurses, aus dem Inhalte importiert werden, nachdem der Kurs neu angelegt oder aktualisiert wurde.
 ;Kurs nach dem Hochladen zurücksetzen
 : Hier geben Sie an, ob der Kurs nach dem Anlegen bzw. Aktualisieren zurückgesetzt werden soll.
-===Standardeinstellungen===
+===Standardmäßige Kurseinstellungen===
 Hier legen Sie die Standardeinstellungen für alle Datenfelder fest, die nicht in der .csv Datei enthalten sind. Diese Einstellungen werden beim Anlegen eines neuen Kurses verwendet. Bei der Aktualisierung von bereits bestehenden Kursen werden diese Werte nur verwendet, wenn der Update-Modus entsprechend gewählt wurde (siehe [[Kurse hochladen#Importoptionen|oben]]).
@@ Zeile 156: / Zeile 179: @@
 [[en:Upload courses]]
+[[es:Subir cursos]]
+[[fr:Modifier des cours en lots]]
+[[ja:コースをアップロードする]]

Documentation