Kurse hochladen
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.
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.
