Dokumentvorlagen-Konfiguration
Mit dem Endpunkt https://api.srv.nat.tum.de/api/mhb/docs#/SPO%20Helper%20Functions/mhb_report_conf kann der Andruck im Modulhandbuch oder die Dokumentvorlagen-Konfiguration von allen Modulen/Knoten in einem Teilbaum konfiguriert werden.
Beispiel 1 (allgemeinbildende Fächer)
Im Modulhandbuch des Bachelorstudiengangs Physik (1630 17 051, SPO-Version 20201) sollen nur ausgewählte Module aus dem Katalog der allgemeinbildenden Fächer abgedruckt werden – insbesondere sollen die meisten Sprachkurse nicht abgedruckt werden.
| Parameter | Wert im Beispiel | Anmerkung |
|---|---|---|
| stpstpnr | 4917 | Studienplannummer der SPO-Version (versteckter Parameter pStpkStpvNr im SPO-Management) |
| stpk_id | 1836643 | Am besten im SPO-Management zu dem entsprechenden Knoten navigieren und dort auf die Vorschriften klicken.
Das sich daraufhin öffnende Pop-Up-Fenster hat in der URL im Query-Parameter pKnotenNr den gesuchten Wert – hier: |
| node_types | Modulknoten | Es sollen alle Modulknoten bearbeitet werden. |
| include_in_module_catalog | false | Grundsätzlich sollen bei allen Modulknoten in dem Teilbaum die Option "Beschreibung im MHB andrucken" abgeschaltet werden. |
| exclude_stpk_ids | 1837684 1834585 3176787 | Liste von Knoten-IDs (Ermitteln wie stpk_id in der Anmerkung oben!) von Modulknoten, die unverändert bleiben sollen. |
| repeat | false | Optional: true, dann wird der Task nicht nur einmalig ausgeführt, sondern jede Woche wiederholt. Dadurch wird die Konfiguration auch auf neu hinzukommende Module erweitert und man muss sich beim Einfügen der MHB-Vorlagen nicht darum kümmern. |
| Request body | {} | Aus dem Drop-Down das Beispiel "do not change report config" auswählen |
Beispiel 2 (Praktikum mit Auswahl an Einzelversuchen)
Im Fortgeschrittenenpraktikum des Masterstudiengangs Quantum Science & Technology (1630 16 090, SPO-Version 20191) gibt es ca. 30 Versuche zur Auswahl, die alle grundsätzlich die gleichen Kompetenzen anhand unterschiedlicher Experimente vermitteln. Auf dem Transcript of Records sollen die Titel der von den Studierenden absolvierten Versuche (die Namen der Leistungen) dennoch abgedruckt werden.
| Parameter | Wert im Beispiel | Anmerkung |
|---|---|---|
| stpstpnr | 4917 | Studienplannummer der SPO-Version (versteckter Parameter pStpkStpvNr im SPO-Management) |
| stpk_id | 1802386 | wie oben, diesmal aber der Modulknoten |
| node_types | Prüfungsknoten | Es sollen die Prüfungsknoten bearbeitet werden |
| include_in_module_catalog | -- | Die Option "Beschreibung im MHB andrucken" soll nicht verändert werden. |
| exclude_stpk_ids | Liste von Knoten-IDs (Ermitteln wie stpk_id in der Anmerkung oben!) von Prüfungsknoten, die unverändert bleiben sollen. | |
| repeat | false | Optional: true, dann wird der Task nicht nur einmalig ausgeführt, sondern jede Woche wiederholt. Dadurch wird die Konfiguration auch auf neu hinzukommende Module erweitert und man muss sich beim Einfügen der MHB-Vorlagen nicht darum kümmern. |
| Request body | { "ln": { "anzeige": false, "credits": false, "note": false, "semester": false, "thema": false, "titel": false }, "pltor": { "anzeige": false, "credits": false, "note": false, "semester": false, "thema": false, "titel": true }, "tor": { "anzeige": false, "credits": false, "note": false, "semester": false, "thema": false, "titel": false } } | Nur der Haken bei Titel in der Zeile PLTOR soll gesetzt sein. |
Massen-Bearbeitung von Knotenparameter
Mit dem Endpunkt mhb_spo_update_nodes können Parameter an allen Unterknoten unterhalb eines Regelknotens angepasst werden.
| Parameter | Wert im Beispiel | Anmerkung |
|---|---|---|
| stpstpnr | 4917 | Studienplannummer der SPO-Version (versteckter Parameter pStpkStpvNr im SPO-Management) |
| stpk_id | 1802386 | wie oben |
| node_types | Prüfungsknoten, Angebotsknoten | Es sollen die Blätter bearbeitet werden (alternativ zusätzlich Modulknoten) |
| exclude_stpk_ids | Liste von Knoten-IDs (Ermitteln wie stpk_id in der Anmerkung oben!) von Knoten, die unverändert bleiben sollen. | |
| semester_recommendation | 1 | Optional: Zahl der Semesterempfehlung, 0 für Löschen der Semesterempfehlung (Achtung! Gibt es nur bei Blättern) |
| subtype | Wahlfach | Optional: Wählen des Subtyps |
| valid_from | 2025w | Optional: Setzen von "Gültig von" (standardmäßig nur für Knoten, die bisher "—" gesetzt haben, siehe force_validity), Löschen durch "—" |
| valid_through | 2025w | Optional: Setzen von "Gültig bis" (standardmäßig nur für Knoten, die bisher "—" gesetzt haben, siehe force_validity), Löschen durch "—" |
| force_validity | false | Falls true, dann wird die Gültigkeit auch dann auf den neuen Wert gesetzt, wenn bereits eine Gültigkeit gesetzt ist |
Massen-Bearbeitung von Prüfungslehrveranstaltungen (virtuelle LV/FMP)
Mit dem Endpunkt mhb_mass_update_virtual_courses können Veränderungen an allen Prüfungslehrveranstaltungen (virtuelle LV oder FMP) einer Organisation in einem Semester vorgenommen werden. Optional kann über einen regulären Ausdruck nach der LV-Nummer gefiltert werden (course_code_pattern).
| Parameter | Wert | Anmerkung |
|---|---|---|
course_name/course_name_en | LV-Titel in Deutsch bzw. Englisch | Es ergibt i.d.R. keinen Sinn, dies für alle FMP einer Organisation gleich zu setzen. |
hoursperweek/credits | SWS bzw. CP | Dezimalzahl mit Punkt in Anführungszeichen |
always_new_ghk | true oder false | Setze oder entferne Haken bei "Kopien mit eigenem GHK" |
do_not_copy | true oder false | Setze oder entferne Haken bei "Nicht weiterkopieren" |
remark | Interne Anmerkung | zum Löschen, leeren String eingeben |
examiner_usernames/organizer_usernames | Liste von TUM-Kennungen | Prüfer*in/Berechtigte Person für Prüfungsplanung/Abwicklung setzen. Eventuell vorhandene andere Personen werden entfernt |
extend_examiner_usernames/extend_organizer_usernames | Liste von TUM-Kennungen | Prüfer*in/Berechtigte Person für Prüfungsplanung/Abwicklung zusätzlich zu eventuell vorhandenen Personen eintragen |
Parameter, die nicht geändert werden sollen, aus dem JSON löschen. Um z.B. bei allen FMP an der Organisation den Haken bei "Nicht weiterkopieren" zu setzen, genügt also folgendes JSON:
{
"do_not_copy": true
}
Berechtigungen in TUMonline
Der Endpunkt zur Dokumentvorlagen-Konfiguration darf von allen Personen aufgerufen werden, die Berechtigung EDIT in der Applikation STPVW an der Organisation haben, an der die entsprechende SPO bzw. Vorlage hängt. Das ist in der Regel die programmspezifische Funktion "SPO Management". Die Massen-Bearbeitung von Prüfungslehrveranstaltungen darf von allen Personen aufgerufen werden, die die Berechtigung PV_MASSENABFRAGE in der Applikation PRV an der Organisation haben. Das ist in der Regel die programmspezifische Funktion "Prüfungsmanagement - Administrator" an einer School oder einem Studiengangsbündel/-knoten.
Damit der Hintergrund-Task die Änderungen an der SPO/Vorlage ausführen kann, muss der System-Account TUS3O06, MODULSYNC (ga82yoh) entsprechende Bearbeitungsrechte (in der Regel die programmspezifische Funktion "SPO Management" bzw. "GHK-Management") erhalten. Es genügt, die Berechtigung temporär zu vergeben, außer der Task soll regelmäßg wiederholt werden (repeat=true).