Wie arbeitet die SPH-LUSD-Schnittstelle? [1658]
Kurz gesagt:
- Die LUSD ist die führende Quelle. Das Schulportal (SPH) übernimmt einmal täglich automatisch Lehrkräfte, Lernende, Eltern und Lerngruppen aus der LUSD.
- Die Daten fließen derzeit nur in eine Richtung: von der LUSD ins SPH. Der Rückweg (z. B. Noten und Fehlzeiten in die LUSD) ist für eine spätere Projektphase geplant.
- Faustregel: Alles, was aus der LUSD kommt, pflegen Sie in der LUSD – nicht im Schulportal.
Was wird übertragen?
Das SPH holt sechs Datenpakete aus der LUSD:
- Lehrkräfte (Personal, inkl. Kürzel und Klassenleitungen)
- Lernende (inkl. Klasse)
- Eltern (sorgeberechtigte Personen und ihre Zuordnung zu den Kindern)
- Kursdaten – die Stammdaten der Lerngruppen (Name, Fach, Stunden …)
- Lernende-Kurs-Zuordnung – wer sitzt in welcher Lerngruppe?
- Lehrkräfte-Kurs-Zuordnung – wer unterrichtet welche Lerngruppe?
Die Lerngruppen bestehen also aus drei einzelnen Importen (4–6). Diese können unabhängig voneinander aktualisiert werden.
Der tägliche Ablauf
- Abends (ab ca. 17:30 Uhr) ruft das SPH die aktuellen Daten bei der LUSD ab.
- Die Daten werden kurz zwischengespeichert und nacheinander in einer Warteschlange verarbeitet.
- Nur geänderte Datenpakete werden verarbeitet. Ein Datenpaket ist eine der sechs Lieferungen oben (z. B. „Lernende-Kurs-Zuordnung“), und zwar immer für die ganze Schule. Das SPH vergleicht jedes Paket mit der letzten Lieferung. Ist es komplett unverändert, wird es übersprungen – in der Import-Historie erscheint dann kein Eintrag. Hat sich darin auch nur ein einzelner Eintrag geändert, wird das ganze Paket neu eingelesen und vollständig mit dem Stand der LUSD abgeglichen.
- Am nächsten Tag stehen die Änderungen im Schulportal zur Verfügung.
Das SPH erhält dabei immer die aktuell gültige Unterrichtsverteilung der LUSD.
Wie findet das SPH die richtigen Datensätze? (Matching)
- Jeder Datensatz aus der LUSD hat eine eindeutige Kennung (UUID). Kennt das SPH diese Kennung schon, wird der Datensatz einfach aktualisiert.
- Ist die Kennung noch unbekannt, sucht das SPH einen passenden vorhandenen Account (z. B. über Name, Geburtsdatum, Geschlecht und Klasse; bei Lehrkräften über Kürzel und Name).
- Treffer: Der vorhandene Account wird übernommen und zu einem „LUSD-Import“ umgewandelt – auch wenn er vorher manuell angelegt oder per Excel importiert wurde.
- Kein Treffer: Es wird ein neuer Account angelegt.
- Wer nicht mehr in der LUSD geliefert wird, wird im SPH deaktiviert und zur Löschung vorgemerkt.
- Woher ein Account stammt, sehen Sie in der Benutzerverwaltung in der Spalte Quelle („LUSD-Import“, „Import“ oder „manuell“).
Einschalten und Ausschalten
- Vorher: Führen Sie für bereits eingespielte Benutzergruppen einen aktuellen Excel-Gesamtimport mit frischen Dateien aus der LUSD durch (nicht älter als 7 Tage). So passen die Datenbestände zusammen und das Matching klappt.
- Benutzer: Benutzerverwaltung → Reiter Im-/Export → Box LUSD-Import → Import für Lehrkräfte und Lernende aktivieren.
- Lerngruppen: Modul Lerngruppen → Einstellungen → LUSD-Import aktivieren. Das geht nur, wenn der Benutzer-Import bereits aktiv ist.
- Solange der Lerngruppen-Import aktiv ist, lässt sich der Benutzer-Import nicht abschalten.
- Mit aktiver Schnittstelle ist der Excel-Import gesperrt. Sie können die Schnittstelle jederzeit wieder deaktivieren – dann steht der Excel-Import wieder zur Verfügung. Das gilt auch, wenn das SPH die Schnittstelle zentral abschaltet.
Das sollten Sie wissen
- LUSD-Accounts sind im SPH schreibgeschützt. Name, Geburtsdatum, Geschlecht, Personalnummer oder Klassenleitung ändern Sie in der LUSD.
- Klassenleitungen kommen nur noch aus der LUSD. Pro Klasse gibt es eine Klassenleitung und eine Stellvertretung; zusätzliche Klassenleitungen können im SPH nicht mehr vergeben werden.
- Schuljahreswechsel: Zum 01.08. wird in der LUSD die Planungsvariante zur aktuellen Unterrichtsverteilung – und würde sofort ins SPH übertragen. Mit der Pausierfunktion in der Benutzerverwaltung können Sie die Importe bis zu einem selbst definierten Datum anhalten. Die Pause gilt für alle Importe, auch für die Lerngruppen. Empfehlung: Pause vom 01.08. bis zum Ende der Sommerferien.
- Kandidaten (noch nicht aufgenommene Lernende) werden möglicherweise noch nicht vollständig geliefert. Die LUSD arbeitet daran. Legen Sie bei Bedarf einen manuellen Account an und achten Sie auf exakte Daten (Name, Geburtsdatum, Geschlecht, Klasse), damit er später automatisch übernommen wird.
- Eltern: Es werden nur Eltern geliefert, die in der LUSD als sorgeberechtigt markiert sind. Derzeit fehlen in der Lieferung teilweise die Eltern von Lernenden, die im laufenden Jahr 18 werden (bekannter Fehler, in Klärung mit der LUSD). Eltern-Accounts, die Sie manuell angelegt und mit Lernenden verknüpft haben, behalten diese Verknüpfung.
- Kommt eine kleine Änderung nicht an? In der Import-Historie der Lerngruppen gibt es einen Button, der beim nächsten nächtlichen Abgleich einen vollständigen Import aller drei Lerngruppen-Pakete erzwingt.