Somtoday

Somtoday koppelen voor losse afspraken naast uw hoofdrooster in EduDisplay.

🚧 Koppeling en documentatie is nog in ontwikkeling.

📋 Overzicht

Somtoday levert vooral losse of handmatige afspraken via de Somtoday-API. In EduDisplay is deze bron bedoeld als aanvulling op een hoofdrooster (bijvoorbeeld Zermelo), zodat mededelingen en afspraken uit Somtoday op dezelfde schermen kunnen verschijnen waar dat in het schermprofiel is ingericht.

De configuratie staat onder Instellingen → Roosterkoppelingen → Somtoday. Autorisatie verloopt via OAuth met uw Somtoday-omgeving. Daarna bepaalt u welke vestigingen (locaties) EduDisplay mag uitlezen.

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 moeten Rooster Sync en Rooster Koppeling Somtoday staan. Zonder die module zijn de Somtoday-instellingen en het bijbehorende roosterpakket niet beschikbaar.

U heeft portaalrechten nodig op de Somtoday-setup. Licenties beheert u via Beheer.

🔗 OAuth en vestigingen

  1. Open Somtoday-instellingen.
  2. Klik op Somtoday autoriseren. Meld u aan in het Somtoday-scherm dat verschijnt en keer terug naar EduDisplay na succes.
  3. Schakel per vestiging in of uit of EduDisplay die locatie mag gebruiken, en sla op.
  4. Om de koppeling te beëindigen: Koppeling verwijderen op dezelfde pagina.

Zorg dat het Somtoday-account dat u voor OAuth gebruikt voldoende rechten heeft om de gewenste afspraken te tonen. Bij twijfel: vraag uw Somtoday-beheerder.

➕ Combinatie met Zermelo (of andere bron)

Wanneer u Somtoday naast Zermelo gebruikt, moeten beide modules op de betreffende licentie(s) actief zijn als beide soorten gegevens op displays nodig zijn. In het schermprofiel kiest u één primair roosterpakket voor het standaardrooster; Somtoday-data wordt waar ondersteund naast of binnen de gekozen opzet getoond — exacte schermtypes hangen af van uw narrowcasting-sjablonen.

Voor alleen het hoofdrooster blijft Zermelo (of WebUntis/Xedule) leidend; Somtoday vult typisch de “extra afspraken”-laag aan.

📺 Schermprofiel

Kies in Schermprofielen het roosterpakket dat bij uw situatie past. Als Somtoday als losse bron is ingericht, verschijnt die in de lijst wanneer de koppeling en licentie kloppen.

Meer algemene stappen staan bij schermprofiel en roosterpakket.

🖥️ API voor schermclients

Clients gebruiken onder meer deze endpoints (met display-authenticatie):

  • /api/somtoday/appointments — reguliere afspraken
  • /api/somtoday/manual-appointments — handmatige afspraken waar van toepassing

Zelfde IP-allowlist-regels als bij andere rooster-API’s; zie netwerk en IP.

🔍 Problemen oplossen

OAuth faalt of verloopt

  • Controleer of pop-ups of SSO-stromen door de browser worden geblokkeerd.
  • Autoriseer opnieuw na wachtwoord- of rechtenwijzigingen in Somtoday.

Geen Somtoday-data op scherm

  • Controleer of de betreffende vestiging aan staat in de Somtoday-instellingen.
  • Controleer licentiemodules en het gekozen roosterpakket in het profiel.
📧 support@edudisplay.nl