Lernplattformen (Sync)

[FPfotenhauer]

Das waren die Anforderungen zum Sync mit IServ:

In Münster setzen wir IServ an etwa 80 Schulen bzw. Standorten ein. Die Nutzung der Schild-NRW3-API hat uns besonders beeindruckt, da sie eine nahezu vollständige Automatisierung der Datenübertragung zu IServ ermöglicht. Aktuell nutzen wir verschiedene API-Endpunkte, um mit Python auf dem IServ eine CSV-Datei zu erstellen. Diese Datei importieren wir dann über das IServ-Backend (root-Bash) mithilfe vorhandener IServ-Befehle und eines Bash-Skripts.

Wunsch/Anforderung:
Derzeit müssen wir mehrere API-Endpunkte iterativ abfragen, was eine gewisse Herausforderung darstellt und zu Performance-Einbußen führen kann. Daher wäre es sehr hilfreich, wenn ein neuer API-Endpunkt bereitgestellt werden könnte, der alle relevanten Daten in einer einzigen Anfrage liefert. Dies würde die Arbeit für uns und andere Entwickler erheblich vereinfachen und die Datenübertragung zu IServ deutlich effizienter machen.

Aktuelle Struktur der generierten CSV-Dateien für IServ:

Schüler*innen-CSV-Datei:
Felder: id (Schild-ID), nachname, vorname, klasse, kurse, passwort (Geburtsdatum im englischen Format)

Beispiel:
6092,Mustermann,Max,06e1,"Jg07-KA-1,Jg07-MA-C-1,Jahrgang 07",20140422
6139,Schmidt Meier,Silvia,05e2,"Jg05-MC-B-1,Jg05-PPL-2,Jahrgang 05",20120915

Lehrkräfte-CSV-Datei:
Felder: id (Schild-ID), nachname, vorname, lehrerkuerzel, kurse, passwort (automatisierte Generierung in Python)

Beispiel:
213,Bramhaus,Robert,B,EF-PH-EK3,MgQHX49z8l
171,Cosby,Bill,CY,"Q2-D-EK3,Q2-SW-ZB4,Q2-SW-ZK3-Zusatz,Q2-SW-ZK3,EF-SW-GK4,Q2-SW-ZK1,EF-SW-GK1,EF-D-GK5,Q1-D-GK3,EF-SW-GK2,Q1-D-GK1,Q2-SW-ZK2,EF-D-GK4,Q2-D-GK1,Q1-SW-GK2,Q2-SW-GK1,Q1-SW-GK1,Q2-D-GK4,Q1-D-GK4,Q2-SW-GK2,Klasse 05e3,",CKU3utg5fD

Die CSV-Datei für Erziehungsberechtigte würden wir vorerst nicht berücksichtigen und zu einem späteren Zeitpunkt definieren.

Nachtrag zu Kursen, die mit einer Zahl beginnen:
Wir ergänzen den Kursnamen um den Jahrgang (Präfix: Jg), da IServ Kurse, die mit einer Zahl beginnen, nicht anlegt. Es wäre daher wünschenswert, die Möglichkeit zu schaffen, in Schild ein Präfix und/oder Suffix für solche Kursnamen zu definieren.

[FPfotenhauer]

Dieses Issue soll ausschließlich Anforderungen von Systemen sammeln, die mit dem SVWS-Server über die API die Schüler, Lehrer und später ggf Erziehungsberechtigte synchronisieren wollen.