In menu S3.2.3 Analyseren rooster vergelijken we het rooster in Zermelo met de planning in menu S3.1.3 in Foleta.
We kunnen in Foleta gegevens van Zermelo ophalen, maar daarvoor moet Foleta toegang hebben tot uw Z-Portal.
Als eerste stap moet er een gebruiker in Zermelo worden aangemaakt. Het advies is om de naam van Foleta te gebruiken. Deze gebruiker hoeft NIET te kunnen inloggen en heeft geen wachtwoord nodig.
Aan deze gebruiker moeten de juiste toegangsrechten worden toegekend.
Er kan voor gekozen worden om de gebruiker Foleta simpelweg een schoolfunctie, zoals bijvoorbeeld admin, te geven. Als dit voldoet kan het aanmaken van een rol overgeslagen worden.
Een voordeel van rechten toekennen met behulp van een rol is dat Foleta niet "als persoon" hoeft deel te nemen aan het project.
Rol aanmaken
Het toevoegen van een rol gaat als volgt:
> Ga naar Beheer > Gebruikers >Rollen
> Klik op de knop <Toevoegen>
> Geef de rol een naam
> Klik op <Enter>
>Geef de rol rechten
Als er in de tabel op een rol wordt geklikt, verschijnt in het rechter paneel de lijst met alle rechten die deze rol heeft. De rechten zijn gegroepeerd in verschillende categorieën: Roosters, Mededelingen, Persoonsgegevens, Gebruikersrechten, Modules, Programma's. Het merendeel behelst het bekijken van bepaalde gegevens of het bewerken ervan.
Rol toekennen
De rol moet aan de eerder aangemaakte gebruiker toegekend worden.
> Ga naar Beheer > Gebruikers > Gebruikers
> Filter op Alle gebruikers
> Selecteer de gebruiker
> Klik op de knop <Rollen toekennen>
> Selecteer de rol en klik op <Opslaan>
Vervolgens moet voor de zojuist aangemaakte gebruiker een token worden aangemaakt:
Aanmaken van een API token
> Ga naar Beheer > Admin-paneel > API tokens
> Kies voor <Toevoegen>
> Maak een token aan voor de gebruiker die u voor de externe partij heeft aangemaakt met een houdbaarheidsdatum (bijvoorbeeld voor 1 jaar):
> Klik daarna op <Opslaan>
De token wordt hierna getoond. U kunt het token en uw portaladres doorgeven aan de externe partij.
"Create an access-token in the portal". Daaronder staat een toelichting over hoe je de token (een code) die wij nodig hebben moet genereren.
Vervolgens moeten deze gegevens kenbaar worden gemaakt in Foleta:
> Ga naar scherm S1.2.3
> Voer bij Instellingen in welke roosterkoppeling u gebruikt.
> Voer in tab Rooster de benodigde gegevens in.
Hierin staan 2 velden:
- Zermelo Api Url
- Zermelo Api Token.
In het veld 'Zermelo Api Url' vult u het adres in waar uw z-portal zich bevindt:
https://<school>.zportal.nl
Waar <school> vervangen moet worden met de naam van uw school.
Om te controleren of dit adres klopt, kunt u zelf dit adres in de browser opgeven en er zal een inlogscherm tevoorschijn komen.
In het veld 'Zermelo Api Token' plaatst u het token wat zojuist is aangemaakt in z-portal.
Let op, deze configuratie is per school (en schooljaar). Bestaat uw scholengroep uit meer scholen, dan moet voor elke school deze 2 velden worden ingevuld in scherm S2.2.1, tabblad configuraties. Waarschijnlijk kunt u voor elke school dezelfde url en Api-token gebruiken.
Nu is bijna alles ingesteld om de koppeling te gebruiken.
> Ga naar scherm S3.2.3.
Als de gegevens nog niet correct zijn ingevuld, of er gaat iets mis bij het ophalen van de data, dan krijgt u deze melding te zien in scherm S3.2.3.
Als u voor het eerst in scherm S3.2.3 komt, zal er een melding worden gegeven dat de Foleta-school nog niet is gekoppeld aan de Zermelo-school.
Deze koppeling kan worden vastgelegd in scherm S3.2.3, tabblad 'Koppel scholen'.
Als deze koppeling is gemaakt, dan gaat u terug naar tabblad 'Vakken'.