Zermelo
Zermelo integratie en configuratie voor EduDisplay.
🔗 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.
📋 Handleiding API-sleutel
Volg onze handleiding om een Zermelo API-sleutel aan te maken:
📖 Handleiding - Zermelo API-sleutelWat heeft u nodig?
Van de Zermelo beheerder:
- API-token
- Schoolnaam/ID (schoolnaam.zportal.nl)
- Roosterproject naam
Van de school:
- 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:
- Voer de API-token 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
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