Zermelo
Zermelo integratie en configuratie voor EduDisplay.
Onderwerpen die voor alle roosterbronnen gelden staan in het overzicht roosterkoppelingen:
- 🔑 Licentie en modules
- 📺 Schermprofiel
- 🌐 Netwerk en IP
🔗 API koppeling
Om roostergegevens uit Zermelo te kunnen ophalen, heeft EduDisplay een API-token nodig.
Deze token kan alleen door een Zermelo-beheerder worden aangemaakt in het Zermelo portaal.
In de Zermelo-configuratie kiest u standaard Legacy API-sleutel. De Partner-koppeling volgt eind 2026.
Wat heeft u nodig?
Legacy API-sleutel
Van de Zermelo-beheerder:
- API-token
- Schoolnaam/ID (schoolnaam.zportal.nl)
- Roosterproject naam
📋 Handleiding API-sleutel
Volg onze handleiding om een Zermelo API-sleutel aan te maken:
📖 Handleiding - Zermelo API-sleutelPartner-koppeling
In ontwikkelingVan de Zermelo-beheerder:
- Schoolnaam (schoolnaam.zportal.nl)
- Eenmalige activatiecode
- Roosterproject (kan na inwisselen worden gekozen)
Partner-documentatie: Authenticatie · Migratie
Van de school (voor elke methode):
- Publiek(e) IP-adres(sen)
- Volledig schooladres
- Gebruikernamen en UID's van de tokens/badges van de gebruikers
⚙️ Configuratie
Volg deze stappen om Zermelo correct te configureren in EduDisplay:
Basis configuratie
Zermelo configuratie:
- Kies standaard Legacy API-sleutel of Partner-koppeling
- Voer de API-token of activatiecode in
- Stel de schoolnaam in
- Selecteer het juiste roosterproject
Instellingen: beveiliging met IP-adressen:
- Voeg de school IP-adressen toe
- Test de toegang en verbinding
Locatie en ontwerp
Instellingen: locatie en kleuren
- Voer het volledige schooladres in
- Controleer de locatie op de kaart
- Verifieer postcode en huisnummer
- Stel de primaire kleur in
- Stel de secundaire kleur
Instellingen: Achtergrond en logo
- Upload een achtergrondafbeelding
- Upload het schoollogo
👥 Gebruikersbeheer en tokens
Voor de persoonlijke roosterweergave van studenten (en eventueel medewerkers) zijn er UID-nummers van de tokens/badges nodig.
De gebruikersnamen moeten exact overeenkomen met de gebruikersnamen in Zermelo.
EduDisplay biedt twee manieren om de gebruikersnamen en UID's in te lezen en te beheren.
📄 CSV Import
Upload een CSV-bestand met gebruikersgegevens voor bulk import.
- Download het CSV-sjabloon
- Vul de gebruikersnamen en UID's in
- Upload het bestand op de gebruikersbeheerpagina van EduDisplay
gebruikersnaam,UID-waarde,type
16234,1C8CA56,student
mpietersen,7C89A012,teacher
🔗 Microsoft Gebruikers Sync
Automatische synchronisatie met Microsoft (via de Graph API) voor gebruikersbeheer.
- Configureer tenant instellingen
- Kies specifieke groepen
- Map de UID velden (UID van de pas/badge)
- Stel de automatische synchronisatie in
✅ Aanbevolen voor grote scholen
🔍 Problemen oplossen
Veelvoorkomende problemen en oplossingen bij de Zermelo integratie:
🔌 API Verbindingsproblemen
API-token ongeldig
- Controleer of het API-token correct is ingevoerd
- Verifieer dat het token nog geldig is in Zermelo (de standaardverloopdatum is 1 jaar)
- Vraag Zermelo beheerder om token te vernieuwen
Partner-token verlopen of ongeldig
- Wissel een nieuwe activatiecode in via de partner-koppeling
- Controleer of de schoolnaam overeenkomt met schoolnaam.zportal.nl
- Raadpleeg de partner-documentatie bij migratie van legacy
Geen roosterdata"
- Controleer of het juiste roosterproject is geselecteerd
- Verifieer dat er roosterdata beschikbaar is voor de gekozen periode
- Test de API verbinding op diagnostische beheerpagina van EduDisplay
👤 Gebruikerstoken problemen
Gebruiker niet gevonden
- Controleer of de UID correct is ingevoerd
- Verifieer dat de gebruiker bestaat in het systeem
- Controleer of het juiste type (leerling/docent) is ingesteld
Geen rooster beschikbaar
- Verifieer dat de gebruiker een rooster heeft in Zermelo
- Controleer de datum - mogelijk is deze buiten deroosterperiode
- Controleer of de juiste gebruikersnaam wordt gebruikt
⚡ Laadtijd problemen
Symptoom: "Langzaam laden van roosters"
- Controleer de netwerk en internetverbinding in de schoolomgeving