Indlæsning af skoleelever er en on-premise Windows-service, der indlæser elever i OS2sofd. For hver institution læser den medlemmerne af en bestemt AD-sikkerhedsgruppe (typisk vedligeholdt via STIL/OS2skoledata), udtrækker elevens navn og CPR-nummer, og sender eleverne til OS2sofd. Dette dokument beskriver installation og konfiguration.
| Komponent | Servicenavn | Download | Ændringslog |
|---|---|---|---|
| Indlæsning af skoleelever | OS2sofd student dispatcher | Download | Ændringslog |
Forudsætninger#
Windows Server#
Servicen skal installeres på en Windows maskine med:
- Netværksmæssig adgang til kommunens AD (læseadgang)
- Netværksmæssig adgang til SOFD Core i skyen via HTTPS
Servicen medbringer sin egen .NET-runtime (.NET 10 fra version 2.0.0), så der skal ikke installeres .NET særskilt på serveren.
AD-sikkerhedsgrupper pr. institution#
For hver institution skal der findes en AD-sikkerhedsgruppe, hvis medlemmer er institutionens elever. Disse grupper vedligeholdes typisk af STIL/OS2skoledata-integrationen. Servicen læser medlemmerne af grupperne og indlæser dem som elever i OS2sofd.
API-nøgle til SOFD Core backend#
Der skal bruges en API-nøgle til OS2sofd backend (udleveres af Digital Identity), så eleverne kan sendes til OS2sofd.
Afklaring af attributter#
Det skal afklares, hvilke AD-attributter der indeholder elevens fulde navn og CPR-nummer (typisk displayName og employeeNumber).
Installation af Windows Service#
Servicen installeres på en server med netværksmæssig adgang til kommunens AD samt til SOFD Core i skyen via HTTPS.
Download service#
Hent installeren via download-linket øverst på siden eller fra den samlede Download-oversigt.
Konfiguration af service#
Konfigurationen foretages i filen appsettings.json i roden af installationsmappen, som standard C:\Program Files (x86)\Digital Identity\OS2sofd student dispatcher. Installationsmappen indeholder kun appsettings.json og version.txt. Selve programmet og dets runtime ligger i undermappen bin og skal ikke røres.
Ved opgradering bevares den eksisterende appsettings.json. Installeren lægger en frisk kopi af standardkonfigurationen ved siden af som appsettings.json.original, så nye indstillinger kan sammenlignes.
| Indstilling | Eksempel | Kommentar |
|---|---|---|
JobSettings.FullSyncCron | 0 30 7 ? * * * | Cron-udtryk for hvornår der synkroniseres. Bør ligge efter, at data er opdateret fra STIL. |
BackendSettings.BackendApiKey | (udleveres) | API-nøgle til OS2sofd backend. |
ActiveDirectorySettings.InstitutionStudentGroupMap | { "131313": "CN=131313_institution_elever,OU=os2skoledata,DC=kommune,DC=dk" } | Kort fra institutionsnummer til den AD-sikkerhedsgruppe, hvis medlemmer er institutionens elever. Der kan angives flere institutioner. |
ActiveDirectorySettings.FullNameField | displayName | AD-attributten, der indeholder elevens fulde navn. |
ActiveDirectorySettings.ClassNameField | AD-attributten, der indeholder elevens klassenavn. | |
ActiveDirectorySettings.CprField | employeeNumber | AD-attributten, der indeholder elevens CPR-nummer. |
Serilog | Opsætning af logning (sti, niveau med videre). |
Start af service#
Efter konfiguration startes servicen via Windows Services eller tilsvarende kommandolinjeværktøjer. Servicen hedder OS2sofd student dispatcher.
Ændringslog#
Ændringslog for Indlæsning af skoleelever. Nyeste version øverst.
| Version | Dato | Ændring |
|---|---|---|
| 2.0.0 | 28.10.2026 | • agenten kører nu på .NET 10 i stedet for .NET 6 • installationsmappen indeholder nu kun appsettings.json og version.txt, mens programmet og dets runtime ligger i undermappen bin • ved opgradering fjerner installeren de gamle programfiler i installationsmappen og bevarer appsettings.json. Servicenavnet, logon-konto, starttype og recovery bevares |
| 1.2.0 | 16.10.2026 | klassenavn kan nu indlæses for elever |
| 1.1.0 | 01.07.2026 | Ændringsloggen vedligeholdes nu i onlinedokumentationen, og den installerede version skrives til version.txt i installationsmappen |
| 1.0.0 | 29.04.2024 | Første udgave |