Unterstützung bei der Erstellung und Ausgabe von Rankings nach dem TUM-Standard-Verfahren.

Ausgabe von Rankings durch das Studiensekretariat

Über das Frontend unter https://app.srv.nat.tum.de/rnk/overview können die konfigurierten Rankings nach Semester gefiltert angezeigt werden (Reiter "Übersicht"). Auswahl eines Rankings zeigt die darin enthaltenen Studierenden und die konfigurierten Daten. Auf der Detailseite kann durch "Studierende importieren" ein Hintergrund-Task gestartet werden, in dem die Ranking-Daten aus TUMonline eingelesen werden. Sollten vor dem erneuten Import bereits einzelne Rankings ausgegeben worden sein, so werden die Daten dieser Studierenden nicht verändert. Durch "Ranking veröffentlichen" wird das Ranking veröffentlicht, sodass sich auch Studierende die PDF-Dateien selbst herunterladen können.

Auf dem Reiter "Studierende" nach Studierenden gesucht werden, für die Rankings ausgestellt werden können, und direkt die PDF-Datei heruntergeladen werden.

Download von Rankings durch Studierende

Über das Frontend unter https://app.srv.nat.tum.de/rnk/student können Studierende, für die ein Ranking veröffentlicht ist, selbst die PDF-Datei herunterladen.

Falls im Backend für das Studiengangsbündel, an dem das Ranking konfiguriert ist, im DSSNAT-Backend ein Zertifikat hinterlegt ist, werden die ausgegebenen PDF-Dateien damit digital signiert.

Konfiguration eines neuen Rankings

Anmeldung in der Swagger-UI-Oberfläche

Hinweise zur Anmeldung in der Swagger-UI-Oberfläche unter https://api.srv.nat.tum.de/docs/ finden Sie im Abschnitt Swagger UI.

Über den Endpunkt rnk_create_ranking wird ein neues Ranking angelegt. Hierbei können die folgenden Parameter eingestellt werden:

  • ranking/ranking_en: Bezeichnung des Rankings auf Deutsch und Englisch (sollte die Kohorte mit Fachsemester und Studiengang sowie das Semester enthalten, z.B. "Semester-Ranking für das 2. Semester im B.Sc. Physik im SS 2022"/"Student Ranking for the 2nd semester in the B.Sc. Physics in SS 2022")
  • semester_key: Schlüssel des Semesters, für das das Ranking ausgestellt werden soll (z.B. 2022s für SS 2022)
  • org_id: TUMonline-Organisation (numerische ID aus Links u.Ä.), die das Ranking verwaltet (i.d.R. der Studiengangsknoten)
  • partner_org_id: optional für gemeinsame Studiengänge mit anderen Hochschulen (z.B. LMU: 39536, HfP: 47557): TUMonline-Organisation (numerische ID aus Links u.Ä.) der Partner-Hochschule, deren Logo mit auf dem Ranking angezeigt werden soll
  • semesters/semesters_en: Beschreibung der in der Kohorte enthaltenen Fachsemester als Textbaustein (z.B. "des ersten und zweiten Fachsemesters"/"of 1st and 2nd semester")
  • cohort/cohort_en: Beschreibung der Kohorte als Absatz (z.B. "Die Kohorte bestand zum Studienbeginn im Wintersemester 2021/2 aus 486 Studierenden, die sich im ersten Studienjahr der Grundlagen- und Orientierungsprüfung (GOP) unterziehen. Allerdings waren im WS 2021/2 alle prüfungsrechtlichen Fristen aufgrund der Einschränkungen durch die COVID-19-Pandemie ausgesetzt."/"In the starting semester in 2021/2 the cohort had 486 enrolled students. These were subjected to the Fundamentals and Orientation Examinations (GOP) during the first year of studies. But due to the restrictions during the COVID-19 pandemic, all exam-related deadlines and requirements were postponed in the winter semester 2021/2.")
  • ranking_base/ranking_base_en: Beschreibung der zugrunde gelegten Module als Satz (z.B. "Als Grundlage werden ausschließlich die Pflichtmodule aus den Grundlagen- und Orientierungsprüfung herangezogen."/"The ranking is based on modules from the Fundamentals and Orientation Examinations (GOP) only.")
  • programs: eine Liste der SPO-Versionen und Fachsemester, die in das Ranking aufgenommen werden sollen (muss beim Update nicht angegeben werden, wenn unverändert, wenn beim Update angegeben, müssen alle SPO-Versionen aufgeführt werden), hierzu jeweils
    • study_id: vollständige Studiengangs-ID ohne Leerzeichen (z.B. 163017051)
    • spo_version: SPO-Version (z.B. 20171)
    • cohort_fachsemester: Fachsemester, deren Studierende im Ranking eingebunden werden sollen (Achtung! Bei Bachelorstudiengängen wird automatisch das um Eins niedrigere Fachsemester auch integriert, um Studierende, die beurlaubt waren, zu berücksichtigen)

Hieraus wird der Standard-Ranking-Text (auf Vorderseite) gebildet, wobei semesters/semesters_en die Phrase "desselben Semesters"/"" ersetzen und cohort/cohort_en den jeweiligen Block {% if start_cohort_count %}.

Text auf Ranking-Vorderseite

{{ fullname }} war im {{ ranking.semester.semester_tag }} im {{ program.degree.program_type_name or program.degree.degree_type_name }} {{ program.program_name }} im {{ fachsemester }}. Fachsemester immatrikuliert und erreichte am Ende dieses Semesters {{ credits }} Credits{% if grade_cut or (grade_node_cut and grade_node_cut<=4) %} und eine Durchschnittsnote von {{ (grade_cut or grade_node_cut)|string|replace(".",",") }}{% else %}, wobei eine Durchschnittsnote noch nicht ermittelbar war{% endif %}. Damit belegt {{ gender.sieer }} unter den {{ ranking.student_count }} Studierenden desselben Semesters{% if rankshared_count and rankshared_count>1 %} zusammen mit {{ rankshared_count }} anderen Studierenden{% elif rankshared_count %} zusammen mit einer/m anderen Studierenden{% endif %} den Rangplatz {{ rank }} und gehört zu den besten {{ percentile }}%.{% if start_cohort_count %}

Zu Beginn des Studiums im ersten Fachsemester bestand die Kohorte aus {{ ranking.start_cohort_count }} Studierenden.{% endif %}


{{ fullname }} was enrolled in the {{ program.degree.program_type_name_en or program.degree.degree_type_name }} {{ program.program_name_en }} in the {{ fachsemester }}. semester during {{ ranking.semester.semester_tag }}. At the end of the semester {{ gender.shehe }} achieved {{ credits }} credits{% if grade_cut or (grade_node_cut and grade_node_cut<=4) %} and an average grade of {{ (grade_cut or grade_node_cut)|string|replace(".",",") }}{% else %} while an average grade could not yet be determined{% endif %}. Within the {{ ranking.student_count }} students of the same semester {{ gender.shehe }} is{% if rankshared_count and rankshared_count>1 %}, together with {{ rankshared_count }} other students,{% elif rankshared_count %}, together with one other student,{% endif %} on rank {{ rank }} within the best {{ percentile }}%.{% if start_cohort_count %}

At the beginning of their studies in the first semester the cohort started with {{ ranking.start_cohort_count }} students.{% endif %}

Die Informationen zum Ranking-Verfahren (fast immer Rückseite) werden auf die Standardwerte gesetzt, wobei ranking_base/ranking_base_en hinten an des zweiten Absatz angefügt wird.

Text auf Ranking-Rückseite

Informationen zum Ranking-Verfahren

Alle Studierenden innerhalb der Kohorte werden grundsätzlich nach der bisher erreichten Note gereiht. Haben Studierende die Soll-Credits für ihr Fachsemester jedoch nicht erreicht, wird für das Ranking stattdessen eine fiktive Note verwendet, bei der die Fehl-Credits mit einer Note von 4,1 eingerechnet wurden.

Am Ende des {{ fachsemester }}. Fachsemesters sollten {{ credits_target }} Credits erreicht sein. In die Notenberechnung gehen nur die benoteten Prüfungsleistungen ein.

Für {{ fullname }} ist die so ermittelte, fiktive Ranking-Note {{ ranking_parameter|round(3)|string|replace(".",",") }}.


Information on the Ranking Method

All students within the cohort are in principle ranked according to the grade achieved to date. However, if a student has not achieved the target credits for their respective semester, instead a fictitious grade is used for the ranking, in which the missing credits were included with a grade of 4,1.

At the end of the {{ fachsemester }}. semester {{ credits_target }} credits are expected. The grade is averaged on modules that are graded according to the exam regulations only.

For {{ fullname }} this fictitious ranking-grade is {{ ranking_parameter|round(3)|string|replace(".",",") }}.

Konfiguration eines existierenden Rankings bearbeiten

neu ab 24.5.2024 (Standard-Texte grundsätzlich anpassbar)

Über den Endpunkt rnk_update_ranking kann die Konfiguration eines existierenden Rankings angepasst werden. Hierbei können die folgenden Parameter eingestellt werden (ein Parameter, der nicht mitgeschickt wird, wird nicht verändert, wird bei text/text_en/method/method_en explizit null geschickt, wird der Wert auf den Standard-Text zurückgesetzt):

  • ranking/ranking_en: Bezeichnung des Rankings auf Deutsch und Englisch (sollte die Kohorte mit Fachsemester und Studiengang sowie das Semester enthalten, z.B. "Semester-Ranking für das 2. Semester im B.Sc. Physik im SS 2022"/"Student Ranking for the 2nd semester in the B.Sc. Physics in SS 2022")
  • semester_key: Schlüssel des Semesters, für das das Ranking ausgestellt werden soll (z.B. 2022s für SS 2022)
  • org_id: TUMonline-Organisation (numerische ID aus Links u.Ä.), die das Ranking verwaltet (i.d.R. der Studiengangsknoten)
  • partner_org_id: optional für gemeinsame Studiengänge mit anderen Hochschulen (z.B. LMU: 39536, HfP: 47557): TUMonline-Organisation (numerische ID aus Links u.Ä.) der Partner-Hochschule, deren Logo mit auf dem Ranking angezeigt werden soll
  • text/text_en: Ranking-Text (auf Vorderseite) siehe oben Jinja2-Template
  • method/method_en: Informationen zum Ranking-Verfahren inklusive der Beschreibung der zugrunde gelegten Module siehe oben Jinja2-Template
  • programs: eine Liste der SPO-Versionen und Fachsemester, die in das Ranking aufgenommen werden sollen (muss beim Update nicht angegeben werden, wenn unverändert, wenn beim Update angegeben, müssen alle SPO-Versionen aufgeführt werden), hierzu jeweils
    • study_id: vollständige Studiengangs-ID ohne Leerzeichen (z.B. 163017051)
    • spo_version: SPO-Version (z.B. 20171)
    • cohort_fachsemester: Fachsemester, deren Studierende im Ranking eingebunden werden sollen (Achtung! Bei Bachelorstudiengängen wird automatisch das um Eins niedrigere Fachsemester auch integriert, um Studierende, die beurlaubt waren, zu berücksichtigen

Änderung der Standard-Texte

Änderungen an den Standard-Texten sollten nur in gut begründeten Ausnahmen vorgenommen werden. Im Standard-Text wird etwa die Note am Studiengang und die Credit-Summe am Studiengang genannt. Wenn in das Ranking nur Noten aus den Grundlagenprüfungen eingehen oder die Berechnung der Note am Studiengang wegen kaskadierender Berechnung unzuverlässig ist, kann stattdessen die Note am Ranking-Knoten verwendet werden:

  • statt {{ credits }} dann {{ credits_node }} – idealerweise zusätzlich "Credits in den ins Ranking eingehenden Modulen"/"credits in the modules included in the ranking"
  • statt {% if grade_cut or (grade_node_cut and grade_node_cut<=4) %} und eine Durchschnittsnote von {{ (grade_cut or grade_node_cut)|string|replace(".",",") }} dann {% if grade_node_cut %} und eine Durchschnittsnote in den ins Ranking eingehenden Modulen von {{ grade_node_cut|string|replace(".",",") }}
  • statt {% if grade_cut or (grade_node_cut and grade_node_cut<=4) %} and an average grade of {{ (grade_cut or grade_node_cut)|string|replace(".",",") }} dann {% if grade_node_cut %} and in the modules included in the ranking an average grade of {{ grade_node_cut|string|replace(".",",") }}
Sind bereits einzelne Rankings ausgegeben, so ist zu beachten, dass standardmäßig die PDF-Dateien nicht neu erzeugt werden. Das Neu-Erzeugen eines bereits ausgegebenen Ranking-PDFs kann über den Endpunkt rnk_ranking_student_pdf und den Parameter force_recreate erzwungen werden.

Import der Daten aus TUMonline

Anschließend kann über die  Oberfläche oder mit dem Endpunkt rnk_import_students der Import der Studierenden aus TUMonline angestoßen werden. Bei wiederholtem Import werden nur die Rangwerte derjenigen Studierenden aktualisiert, für die noch kein Ranking ausgegeben wurde.

Veröffentlichen des Rankings

Abschließend kann das Ranking über die Oberfläche oder mit rnk_publish_ranking veröffentlicht werden. Erst dann können sich Studierende ihr eigenes Ranking selbst herunterladen.

Bitte beachten: vor dem Veröffentlichen ist das Ranking vorläufig. Hierbei werden Studierende, deren Ranking bereits ausgegeben wurde, anders behandelt als Studierende, deren Ranking noch nicht ausgegeben wurde, insbesondere die Zählung der ranggleichen Studierenden kann daher unerwartete Ergebnisse liefern. Es sollte grundsätzlich vermieden werden, einzelne Rankings aus unveröffentlichten Rankings auszugeben.

Soll die Veröffentlichung im Einzelfall zurückgenommen werden, so geht dies über rnk_unpublish_ranking.

Adress-Angabe im Fuß der ersten Seite

Wenn in TUMonline an dem Studiengangsknoten oder einem darüber liegenden Studiengangsbündel eine Adresse, deren Bezeichnung "Prüfungsausschuss" oder "Examination Board" (ohne Berücksichtigung von Groß-/Kleinschreibung) enthält, so wird auf der ersten Seite mit dieser Adresse der Fuß des TUM-Briefkopfs gedruckt.

Beispiel (TUMonline-Eintrag):

Beispiel (Ranking-Fuß):
Fuß auf Ranking-Vorderseite mit Adresse

Änderungen an dem ausgegebenen PDF

Die ausgegebenen PDFs sind als nicht veränderbar gekennzeichnet. Hierfür wird ein Owner-Passwort genutzt, welches seit 24.5.2024 spezifisch für die Studiengangsbündel direkt unterhalb der Studienorganisation ist. Bitte wenden Sie sich an studium@nat.tum.de, wenn Sie das Owner-Passwort benötigen, um Änderungen an den generierten PDF-Dateien vorzunehmen.

Berechtigungen und Einrichtung

Der Zugriff auf das Ranking-Tool wird über TUMonline-Funktionen gesteuert, die als programmspezifische Funktionen an Studiengangsbündel oder dem Studiengangsknoten, auf dessen SPO-Versionen die Personen berechtigt werden sollen, vergeben werden:

  1. "Förderprogramme/Rankings - Sachbearbeitung": Einsicht in die Rankings, Download von Rankings als PDF
  2. "Förderprogramme/Rankings - Admin": zusätzlich Hinzufügen/Entfernen/Konfigurieren von neuen Rankings und Auslösen des Imports aus TUMonline

Damit das System die Ranking-Daten aus TUMonline importieren kann, muss dem System-Account TUS3OTS, RANKINGS Zugriff gewährt werden auf den generischen Export "Regelknoten Ranking Studiengang Version" in den Studiengangsknoten der Studiengänge, die in Rankings integriert werden sollen. Aktuell erfolgt dies über die Funktion "Generische Exporte (Nutzung)", die der System-Account haben muss.

  • Keine Stichwörter