Page tree
Skip to end of metadata
Go to start of metadata

De koppeling maakt het mogelijk dat leerlingen hun rooster bekijken in Somtoday, en zich daar ook inschrijven voor keuzelessen. De gemaakte keuzes worden direct in Zermelo verwerkt.

Pilot

Op dit moment is de koppeling in pilot, en alleen beschikbaar voor een beperkt aantal scholen.

Dit inschrijfproces kan alleen via de website van Somtoday ELO en niet via de leerling-app van Somtoday. Daarnaast worden de afspraken in de Somtoday-Core applicatie pas zichtbaar na een (handmatige) start van de Zermelo import. Nadat een leerling een keuze heeft gemaakt, is deze wel meteen zichtbaar in de ELO maar nog niet in de Somtoday Core applicatie totdat de afspraken ook daar (opnieuw) zijn geïmporteerd.

Het instellen van deze koppeling gaat in verschillende stappen:


1. Zorgen dat leerlingen zich kunnen inschrijven

Allereerst moet het inschrijfproces bij Zermelo op orde zijn. Dit gaat als volgt:

  1. U geeft leerlingen rechten om het rooster te bekijken via Schoolfuncties.
  2. U geeft leerlingen de mogelijkheid zich in te schrijven De inschrijfmodule.
  3. U controleert de instellingen door via "Inloggen als..." (Beheer > Gebruikers > Gebruikers) de WebApp te openen als een leerling, en te kijken of deze inderdaad zich kan inschrijven. Hoe dit gaat ziet u op WebApp: inschrijven voor keuzelessen.

Het is niet nodig dat leerlingen kunnen inloggen bij Zermelo. Leerlingen hoeven dus geen wachtwoord te hebben en er hoeft geen single-sign-on ingesteld te zijn.

2. Instellingen in Zermelo

Nu gaan we een gebruiker aanmaken voor Somtoday met voldoende rechten.

  • Log in als applicatiebeheerder (admin)
  • Zorg dat er een somtoday gebruiker is aangemaakt, zoals beschreven bij Webservice koppeling op de pagina Roosters naar Somtoday (portal)
  • Ga naar Beheer > Gebruikers > Gebruikers
  • Zoek naar de gebruiker "somtoday"
  • Klik rechts op een kolomkop, en zet het vinkje aan bij Kolommen > Soort gebruiker:
  • Pas voor de gebruiker het Soort gebruiker aan naar Somtoday:
  • Het ziet er uiteindelijk zo uit:
  • De somtoday gebruiker heeft nu rechten om namens alle gebruikers (leerlingen/ouders/docenten/etc) roosters op te vragen en keuzes te maken, mits de gebruikers dat zelf ook mogen.

3. Somtoday API-token opnieuw aanmaken

De bestaande API-token voor Somtoday moet opnieuw worden aangemaakt. Daarna moet deze in Somtoday worden opgenomen.

  • Log  in als applicatiebeheerder (admin)
  • Ga naar Beheer > Admin-paneel
  • Klik op tabblad API tokens
  • Verwijder de bestaande API token van Somtoday
  • Voeg een nieuwe API token toe met gebruiker Somtoday
  • Kopieer de Token
  • Log in als applicatiebeheerder in Somtoday
  • Ga naar Beheer > Instelling > Features
  • Klik op het potloodje bij Zermelo Koppeling
  • Plak de gekopieerde API-token over de bestaande API-token en klik op Opslaan

4. Koppeling activeren in Somtoday

Keuzelessen/KWT

Let op dat de terminologie wat kan verschillen. Somtoday heeft het soms over keuzewerktijd (KWT), terwijl Zermelo spreekt over keuzelessen. In deze handleiding gebruiken we zoveel mogelijk de terminologie van Zermelo.

We gaan nu de koppeling instellen in Somtoday.

  • Login als applicatiebeheerder op je testomgeving van Somtoday
  • Ga naar Beheer > Instelling > Features
  • Klik op het potloodje bij Zermelo koppeling


Je krijgt dan het onderstaande scherm.

  • Het vinkje ‘actief’ moet aan staan voor je Zermelo omgeving
  • Koppel vervolgens per Somtoday vestiging je Zermelo omgeving bij Zermelo live-koppeling
  • Nadat je dit hebt gekoppeld is de Zermelo-live-koppeling actief en kan je testen

5. Testen

  • Zorg ervoor dat er keuzelessen zijn gepubliceerd in het portaal van Zermelo. Somtoday maakt deze zichtbaar in de ELO van de leerling. 
  • Log in als leerling op de ELO (Beheer > Instelling > Inloggen als; de gebruikersnaam van een leerling vind je bij die leerling bij Overig > Accounts) en klik een keuzeles aan.
  • Schrijf je in voor een keuzeles. De keuze wordt rechtstreeks naar Zermelo gestuurd. De leerling krijgt nu een blauwe keuzeles in zijn rooster.
  • Open in Zermelo het maatwerkscherm: de keuzes zijn hier zichtbaar: