Grundlagen
Wochennummern, und warum die des Kalenders die falschen sind
Jede Hochschule nummeriert ihre Lehrwochen, fast keine so wie der Kalender, und in dieser Lücke steckt überraschend viel Verwirrung.
Zwei verschiedene Zahlen mit demselben Namen
Fragen Sie den Kalender, welche Woche es ist, erhalten Sie die ISO-Kalenderwoche: Woche 1 ist die Woche, die den ersten Donnerstag im Januar enthält, und zu Beginn eines akademischen Jahres auf der Nordhalbkugel befinden Sie sich etwa in Woche 36 bis 40.
Stellen Sie einem Stundenplanbüro dieselbe Frage, erhalten Sie eine völlig andere Zahl. Woche 1 ist die erste Lehrwoche des Jahres, wo im Kalender sie auch liegen mag, und von dort aus wird alles gezählt. Es ist die auf dem Stundenplan gedruckte Zahl, die Zahl im Raumbuchungsformular und die Zahl, die zwei Kolleginnen verwenden, wenn sie sich für Woche 9 verabreden.
Die beiden sind nie gleich, es sei denn, das Lehrjahr einer Hochschule beginnt zufällig in der ersten Januarwoche, das heißt: nie. Und weil beide die Wochennummer heißen, liefert Software, die stillschweigend die falsche erzeugt, etwas, das völlig plausibel aussieht.
Wie es aussieht, wenn es schiefgeht
Es sieht nicht wie ein Fehler aus. Es sieht aus wie eine Seite mit einer Zahl am oberen Rand, und die Zahl ist an jeder Hochschule um einen anderen Betrag falsch — weil jede ihr Jahr an einem anderen Datum beginnt.
Das macht es teuer. Ein Absturz wird innerhalb einer Stunde gemeldet. Eine Überschrift mit Woche 36, obwohl alle im Haus Woche 2 sagen, wird Wochen später gemeldet, von jemandem, der annahm, er habe das System missverstanden und nicht das System ihn — und in der Zwischenzeit sind Leute aufgrund dessen zu Räumen erschienen.
Die Regel, die es vermeidet, ist kurz: Eine Wochennummer wird gelesen, nie berechnet. Die Hochschule entscheidet, wo Woche 1 liegt; die Aufgabe der Software ist es, wiederzugeben, was die Hochschule entschieden hat, und nicht, aus einem Datum eine eigene Zahl abzuleiten.
Woche 1 ist nicht immer die erste vorhandene Woche
Hochschulen benötigen routinemäßig Daten vor ihrem Lehrjahr: eine Einführungszeit von zwei Wochen, einen Wiederholungsprüfungszeitraum, eine Sommerschule, die zum gerade endenden Jahr gehört. Statt alles neu zu nummerieren — was stillschweigend die Bedeutung jedes Stundenplans, jeder Buchung und jeder Nachricht ändern würde, die jemals über Woche 9 verschickt wurde —, besteht der vernünftige Weg darin, den Kalender rückwärts zu verlängern, in die Null und in negative Zahlen.
Es wirkt beim ersten Mal seltsam und beim zweiten Mal genau richtig: Woche 1 behält die Bedeutung, die sie immer hatte, und die zwei Wochen davor sind Woche −1 und Woche −2. Wir haben Hochschulen, deren Wochentabelle weit in den negativen Bereich und weit über das Ende des Lehrjahres hinausreicht, und alles dazwischen bezieht sich auf ein reales Datum.
Alles, was einen Stundenplan programmatisch liest, sollte damit rechnen. Eine Wochennummer ist eine vorzeichenbehaftete ganze Zahl, kein Zähler, der bei eins beginnt.
Und manche Hochschulen verwenden überhaupt keine Zahlen
Oxford und Cambridge benennen ihre Wochen nach dem Term, statt sie über das Jahr zu zählen: Ein Datum liegt in der Michaelmas fourth week, und eine Zahl würde niemandem im Raum etwas sagen. Andere Hochschulen bezeichnen einen Zeitraum von zwei Wochen als Revision, Induction oder Assessment period und erwarten, dass der Stundenplan das ausweist.
Eine Lehrwoche trägt also zwei Dinge, nicht eines: die Zahl, unter der die Software sie anspricht, und den eigenen Namen der Hochschule dafür, den eine Leserin oder ein Leser oben auf der Seite tatsächlich sehen möchte. Wo ein Name existiert, sollte er anstelle der Zahl gedruckt werden, und zwar vollständig — die Termkonvention von jemandem zu kürzen, um acht Pixel zu sparen, ist die Art von Hilfsbereitschaft, um die niemand gebeten hat.
Wo kein Name existiert, und für die meisten Hochschulen gibt es keinen, ist die Zahl der Name, und das ist völlig in Ordnung.
Vier Dinge, die man in jedem Stundenplansystem prüfen sollte
Keines davon ist exotisch. Alle sind irgendwo stillschweigend falsch.
| Frage | Wie eine gute Antwort aussieht |
|---|---|
| Wo beginnt Woche 1? | Bei einem Datum, das Ihre Hochschule festgelegt hat, einmal gespeichert und überall verwendet. Nicht aus dem Kalender abgeleitet und nicht pro Bildschirm konfigurierbar. |
| Kann der Kalender vor Woche 1 zurückreichen? | Ja, in die Null und in negative Zahlen, ohne etwas Bestehendes neu zu nummerieren. |
| Kann eine Woche einen Namen tragen? | Ja, und der Name wird anstelle der Zahl gedruckt, vollständig. |
| Woher bezieht eine Studierenden-App die Zahl? | Aus dem Stundenplan, in derselben Antwort wie die Veranstaltungen. Ein Client, der selbst rechnet, liegt falsch, und an jeder Hochschule anders falsch. |
Warum dies auch eine Integrationsfrage ist
Ein Portal, eine App oder ein Informationsbildschirm, die eine Wochenüberschrift anzeigen, müssen diese irgendwoher beziehen, und die einzige Quelle, die richtig sein kann, ist der Stundenplan selbst. In Wise Timetable enthält die Stundenplanantwort die Wochennummern und Wochennamen für den abgedeckten Zeitraum, sodass ein Client nie einen Grund hat, selbst eine zu berechnen — und GET /v2/weeks beantwortet dieselbe Frage allein für einen Bildschirm, der ein ganzes Semester auf einmal beschriften muss.
Das REST-API-Handbuch dokumentiert beides, einschließlich des negativen Falls, und es wird vollständig und ohne Registrierung veröffentlicht, sodass eine Entwicklerin die Form der Antwort prüfen kann, bevor jemand etwas unterschreibt.
Möchten Sie sehen, wie das funktioniert?
Buchen Sie eine 45-minütige Online-Präsentation, in der wir es anhand des Planungsproblems Ihrer eigenen Hochschule durchgehen.