Zermelo

Zermelo integratie en configuratie voor EduDisplay.

🔗 API koppeling

Om roostergegevens uit Zermelo te kunnen ophalen, heeft EduDisplay een API-token nodig. Deze kan alleen door een Zermelo-beheerder worden aangemaakt.

📋 Handleiding API-sleutel

Volg onze handleiding om een Zermelo API-sleutel aan te maken:

📖 Handleiding - Zermelo API-sleutel

Wat heeft u nodig?

Van de Zermelo beheerder:

  • API-token
  • Schoolnaam (schoolnaam.zportal.nl)
  • School ID
  • Roosterproject naam

Van school:

  • Publiek(e) IP-adres(sen)
  • Volledig schooladres
  • Gebruikernamen en UID van de tokens/badges van de gebruikers

⚙️ Configuratie

Volg deze stappen om Zermelo correct te configureren in EduDisplay:

1

Basis configuratie

Zermelo instellingen:

  • Voer de API-token in
  • Stel de schoolnaam in
  • Voer het School ID in
  • Selecteer het roosterproject

Beveiliging:

  • Voeg de school IP-adressen toe
  • Stel de authenticatiemethode in
  • Test de toegang en verbinding
2

Locatie en ontwerp

Locatie instellingen:

  • Voer het volledige schooladres in
  • Controleer de locatie op de kaart
  • Verifieer postcode en huisnummer

Huisstijl:

  • Upload het schoollogo
  • Stel de primaire kleur in
  • Kiesde secundaire kleur
  • Upload een achtergrondafbeelding
3

Authenticatie methode

Kies hoe studenten zich kunnen identificeren voor hun persoonlijke rooster, bijvoorbeeld:

📱
Badge

RFID/NFC badge

🎯
Token

Numerieke code

💳
Schoolpas

Officiële schoolpas

👥 Gebruikerstokens

Voor de persoonlijke roosterweergave van studenten (en eventueel medewerkers) zijn er UID-numemers 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
📖 Meer informatie

🔗 Microsoft-koppeling

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

📖 Meer informatie

🔍 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 (student/teacher) 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 op de school

🆘 Nog steeds problemen?

Als de bovenstaande oplossingen niet helpen, neem dan contact op met ons:

📧 support@edudisplay.nl