Kalender-Titel (Vorlage)

SwissMentor generiert für jeden Termin automatisch einen Kalender-Titel, der im Stundenplan und im iCal-Kalenderexport angezeigt wird.

Aktueller Stand

• Die Vorlage liegt aktuell pro Kurstyp im Feld Dispose.CourseType.IcalTemplate.
• Die bisherige globale Einstellung Dispose.Calendar.ICal.SummaryTemplate ist nicht mehr die Laufzeitquelle fuer den Kalender-Titel.
• Aktuell gibt es keine GUI, um den Kalender-Titel pro Termin manuell zu setzen.

Vorlage pro Kurstyp

Die Vorlage ist ein freier Text mit Platzhaltern. SwissMentor ersetzt die Platzhalter zur Laufzeit durch die jeweiligen Daten des Termins.

Verfügbare Platzhalter

Platzhalter	Beschreibung
LESSONNAME	Name des Termins selbst
COURSENAMEONSCREEN	Kursname (bevorzugt das Feld «Name auf Bildschirmen», sonst der reguläre Kursname)
SUBJECTCLASS	Name der Klasse, die dem Termin zugeordnet ist
SUBJECT	Name des Fachkurses; bei mehreren Fachkursen durch « / » getrennt
TIMEPERIODCOURSNAMES	Namen der Zeitraum-Kurse; bei mehreren durch « / » getrennt
EVENTSCHEDULETYPE	Kürzel des Lektionstyps (Geplante Lektion); wird aktuell nur ausgegeben, wenn das Kürzel «BA» lautet
HYBRID	«Stream» wenn die Geplante Lektion auf «Ad-hoc Remote» eingestellt ist, «Online» bei «Immer Remote»; sonst leer

Platzhalter werden nicht zwischen Gross- und Kleinschreibung unterschieden: LESSONNAME, lessonname und LessonName sind gleichwertig.

Beispiele

Vorlage	Ergebnis (Beispiel)
LESSONNAME	«Mathematik»
SUBJECTCLASS - COURSENAMEONSCREEN	«2A - Mathematik Grundlagen»
TIMEPERIODCOURSNAMES / SUBJECTCLASS	«HS25 / 2A»
SUBJECTCLASS - SUBJECT - LESSONNAME	«2A - Mathematik - Lektion 12»
EVENTSCHEDULETYPE - SUBJECTCLASS - LESSONNAME	«BA - 2A - Einführung»
SUBJECTCLASS - LESSONNAME - HYBRID	«2A - Einführung - Stream»

Fallback

Ist auf dem Kurstyp keine Vorlage gesetzt oder ist das Ergebnis nach dem Ersetzen aller Platzhalter leer, verwendet SwissMentor LESSONNAME als Fallback.

Wirkungsbereich

Die berechnete Bezeichnung wirkt auf zwei Bereiche:

• Stundenplan-Ansicht: Der berechnete Titel wird in Terminlisten und in der Termin-Detailansicht angezeigt, wenn ein Benutzer nur das Profil TEACHER oder STUDENT hat.
• iCal-Kalenderexport: Derselbe Titel wird als Terminbezeichnung in exportierten Kalenderdateien (.ics) verwendet.

Automatische Aktualisierung

Wenn sich relevante Daten ändern (Kursname, Klassenname, Lektionsname, geplante Lektion), berechnet SwissMentor die betroffenen Kalender-Titel automatisch im Hintergrund neu. Es ist kein manueller Eingriff nötig.

Hinweise

• Ist ein Platzhalter im Termin nicht belegt (z. B. kein Kursname hinterlegt), bleibt die entsprechende Stelle im Titel leer.
• Bei fehlenden Werten bereinigt SwissMentor fuehrende und abschliessende Trennzeichen sowie ueberfluessige Leerzeichen automatisch.
• Nach einer Vorlagenaenderung auf dem Kurstyp werden bestehende Termine nicht zwingend sofort neu berechnet. Bei Bedarf kann eine Neuberechnung angestossen werden.

Kundenspezifische Initialisierung ZBW (PBI 40979)

Fuer ZBW wurde eine Changelog-Initialisierung bereitgestellt, welche die neuen Platzhalter ans Ende bestehender IcalTemplate-Vorlagen anhaengt:

• - EVENTSCHEDULETYPE
• - HYBRID

Die Initialisierung ist idempotent und fuegt Platzhalter nur hinzu, wenn sie noch nicht vorhanden sind.