Xedule

Xedule koppelen aan EduDisplay: MyX API of Xedule Connect, schermprofiel en schermclients.

🚧 Koppeling en documentatie is nog in ontwikkeling.

📋 Overzicht

Met Xedule kunt u roostergegevens op narrowcasting-schermen en zuilen tonen. EduDisplay ondersteunt twee technische routes: de MyX API (bearer token per omgeving) en de Xedule Connect API (afhankelijk van uw Xedule-installatie).

Alle instellingen staan onder Instellingen → Roosterkoppelingen → Xedule, dezelfde plek als andere roosterbronnen. Na een geslaagde autorisatie kiest u in het schermprofiel welk roosterpakket (bron) een display gebruikt.

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

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

🔑 Licentie en rechten

Op de Display API Key (licentie) moeten minimaal Rooster Sync en de module Rooster Koppeling Xedule actief zijn. Zonder die module zijn de Xedule-instellingen en het roosterpakket “Xedule” niet beschikbaar.

In het portaal heeft u rechten nodig op de Xedule-setup (zijbalk: roosterkoppeling Xedule). Licenties en modules beheert u via Beheer of vraag EduDisplay-support om hulp.

🔗 Koppeling in het portaal

Open de pagina Xedule-instellingen en volg één van onderstaande paden — niet beide tegelijk nodig tenzij uw organisatie dat expliciet vraagt.

A

MyX API

  1. Vraag bij uw Xedule-beheerder de MyX API key (bearer token) en de juiste omgeving (bijvoorbeeld live, acceptatie of test).
  2. Vul school of stichting en overige verplichte velden in zoals op het scherm aangegeven.
  3. Klik op MyX autoriseren. Bij succes wordt de koppeling opgeslagen en kunt u desgewenst de testfunctie gebruiken.
  4. Om los te koppelen: Verwijderen op het MyX-paneel; daarna kunt u in schermprofielen een ander roosterpakket kiezen.
B

Xedule Connect API

Voor scholen die Connect gebruiken in plaats van (of naast) MyX: volg de velden en stappen op hetzelfde instellingenscherm. De exacte velden kunnen per Xedule-versie verschillen; gebruik de tooltips en validatiemeldingen op de pagina.

  1. Vul de gevraagde Connect-gegevens in en voltooi de autorisatiestap.
  2. Test de verbinding indien beschikbaar.
  3. Koppeling verwijderen kan via Verwijderen op het Connect-paneel.

📺 Schermprofiel en roosterpakket

  1. Ga naar Schermprofielen.
  2. Open of maak een profiel en koppel waar nodig de juiste Display API Key.
  3. Zet Roosterpakket op Xedule (zichtbaar als de licentie en koppeling kloppen).

Sommige narrowcasting-onderdelen zijn nog gekoppeld aan Zermelo-specifieke data. Controleer uw lay-out als u volledig op Xedule overstapt. Meer uitleg staat bij schermprofiel in het rooster-overzicht.

🖥️ Schermclients en API

Android- en andere clients halen afspraken via de EduDisplay-proxy, bijvoorbeeld: 

/api/xedule/appointments

Requests gebruiken de gebruikelijke display-headers (zoals X-API-Key en hostnaam) zoals bij andere rooster-API’s. Als op de licentie een school-IP allowlist staat, moet het publieke uitgaande IP van het scherm overeenkomen met een ingevoerd adres — zie netwerk en IP.

🔍 Problemen oplossen

Autorisatie mislukt

  • Controleer of de MyX-key nog geldig is en bij de juiste omgeving hoort.
  • Voor Connect: controleer server-URL, certificaat en firewallregels richting Xedule.

Geen rooster op het scherm

  • Controleer of het schermprofiel op Xedule staat en de display-key de juiste modules heeft.
  • Test of de Xedule-koppeling in het portaal nog “actief” is; zo niet, opnieuw autoriseren.

Blijft het probleem? Neem contact op met EduDisplay-support en vermeld school, tijdstip en eventuele foutcode op het scherm.

📧 support@edudisplay.nl