Kurse hochladen

Aus MoodleDocs
Wechseln zu:Navigation, Suche

Baustelle.png Diese Seite muss überarbeitet werden, weil sie neue Funktionalitäten enthält. Greif zu!
Wenn du dich um diesen Artikel kümmern willst, dann kennzeichne das, indem du die Vorlage {{ÜberarbeitenNeu}} durch die Vorlage {{ÜberarbeitenVergeben}} ersetzt.
Wenn du mit deiner Arbeit fertig bist, dann entferne die Vorlage aus dem Artikel.
Danke für deine Mitarbeit!


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 in der Kursnavigation (oder im Block Einstellungen > Kurs-Administration) angezeigt werden sollen, 0 - sonst.
showreports
Berichte anzeigen: 1 - wenn die Berichte in der Kursnavigation (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.