WebUntis

WebUntis koppelen aan EduDisplay: server, school, account en schermprofiel.

🚧 Koppeling en documentatie is nog in ontwikkeling.

📋 Overzicht

Met WebUntis kunt u leerling- en lesroosters op EduDisplay-schermen tonen, vergelijkbaar met Zermelo of Xedule. EduDisplay praat namens uw school met de WebUntis-API; daarvoor is eenmalige autorisatie met een schoolaccount nodig.

Instellingen vindt u onder Instellingen → Roosterkoppelingen → WebUntis. Daarna kiest u in het schermprofiel het roosterpakket WebUntis.

Onderwerpen die voor alle roosterbronnen gelden staan in het overzicht roosterkoppelingen:

  • 🔑 Licentie en modules
  • 📺 Schermprofiel
  • 🌐 Netwerk en IP

🔑 Licentie en rechten

Activeer op de Display API Key Rooster Sync en Rooster Koppeling WebUntis. Zonder deze module zijn de instellingenpagina en het roosterpakket WebUntis niet beschikbaar.

U heeft rechten op de WebUntis-setup in het portaal. Licenties: Beheer of support.

🔗 Server, school en autorisatie

Open WebUntis-instellingen en vul in:

  1. Server — het WebUntis-domein van uw school, bijvoorbeeld uw-school.webuntis.com (exact zoals WebUntis die vermeldt).
  2. School — de juiste school binnen dat domein als u meerdere heeft.
  3. Account — gebruikersnaam en wachtwoord van een WebUntis-gebruiker met voldoende rechten om roosters (bijvoorbeeld leerlingroosters) uit te lezen.
  4. Klik op Authoriseren. Bij succes wordt de sessie/token door EduDisplay bewaard volgens de portaalinstellingen.
  5. Koppeling verbreken: Verwijderen op dezelfde pagina.

Gebruik bij voorkeur een functioneel account (geen persoonlijke docent-login die vaak wisselt). Beperk rechten in WebUntis tot wat nodig is volgens uw schoolbeleid.

📺 Schermprofiel

Ga naar Schermprofielen, open het profiel van uw scherm of zuil en stel Roosterpakket in op WebUntis zodra de koppeling actief is.

Sommige narrowcasting-items zijn Zermelo-specifiek; controleer uw opmaak als u volledig overstapt. Zie schermprofiel in het overzicht.

🖥️ Schermclients en API

Displays halen data via onder meer: 

/api/webuntis/appointments

Authenticatie verloopt met de gebruikelijke display-headers. Als een school-IP toegangslijst is ingesteld in Zermelo-instellingen (school-IP’s), moeten uitgaande verbindingen vanaf toegestane publieke IP’s lopen — zie netwerk en IP.

🔍 Problemen oplossen

Authorisatie mislukt

  • Controleer serverdomein en schoolkeuze (typfouten in het domein zijn veelvoorkomend).
  • Controleer of het account niet is vergrendeld of het wachtwoord is verlopen in WebUntis.

403 / IP niet toegestaan

  • Vergelijk het publieke IP van de internetlijn van het scherm met de toegangslijst in schoolinstellingen.
  • Laat de lijst leeg om tijdelijk alle IP’s toe te staan (alleen als uw beleid dat toestaat).
📧 support@edudisplay.nl