Widgets til skemaer/tidsplaner (Zermelo & Untis)
I GoBright View er det muligt at hente oplysninger fra forskellige planlægnings-/tidsplanlægningsværktøjer som Zermelo og Untis. Disse oplysninger kan bruges til at vise skemaændringer på skilte i en bygning. Ændringerne kan filtreres efter dine behov.
| Zermelo | Untis | |
| Filtrer klasser | V | V |
| Filtrer lærere | V | V |
| Filtrer emner | V | V |
| Vis aflyste aftaler | V | V |
| Displayet skiftede lærer | V | V |
| Vis ændret placering | V | V |
| Visning af ændret tid | V | V |
| Displayet skiftede emne | V | V |
| Vis kun ændringer foretaget i dag | V | V |
| Vis hele tidsplanen for i dag*. | X | X |
* Widgets er bygget til kun at vise ændringer i en tidsplan. At vise hele tidsplanen ville forårsage en overbelastning af information på skilteskærmen.
Konfiguration af skemaudbyder
Der er nogle få krav, der skal opfyldes først. Fortsæt med at følge de trin, der passer til din situation.
Zermelo-konfiguration
Kravene
- Navnet på organisationen i Zermelo
- En Zermelo-administratorkonto
- Et API-token
- En eller flere koder for stedet/stederne
- Zermelo-widget'en
Opret API-tokenet
Resumé af Zermelo-artiklen
Det første, vi har brug for, er navnet på organisationen i Zermelo. Det er det samme navn i den URL, du bruger til at logge ind på Zermelo:
https://[Schoolname].zportal.nl
Log ind på Zermelo med en administratorkonto, og noter skolens navn i URL'en, det får vi brug for senere. Følg disse trin i Zermelo for at oprette et nyt API-token:
Trin 1 Tilføj brugeren
Den eksterne klient skal tilføjes til portalen som bruger.
1. Gå til Beheer > Gebruikers
2. Vælg under Filter: "Intet filter"
3. Click on the button <Toevoegen>
4. Udfyld "Gebruikerscode" med brugerens navn
5. Slet fluebenet i "Mag de gebruikers inloggen"
6. Sæt flueben ved "Toevoegen als werknemer"
6. Click on the button <Toevoegen>
Trin 2 Tilføj bruger til "Roosterproject"
Den bruger, der lige er blevet oprettet, skal tilføjes til "Roosterproject".
1. Gå til Personeel>Overblik>Tabblad Kontrakter
2. Vælg det rigtige "roosterproject"
S. Click on the butoon <Toevoegen>
4. Indtast brugeren ved Gebruikerscode
5. Click on the button <Volgende>
6. Skift "functiecategore" til OOP
7. Click on the button <Klaar>
Flere projekter i én portal?
Måske er der flere "roosterprojecten" for det aktuelle skoleår i portalen. Det betyder, at brugeren med flere "roosterprojecten" skal have tildelt flere kontrakter.
Trin 3: Konfiguration af rettigheder
Nu er det tid til at give brugeren rettigheder. Det er vigtigt ikke at give brugeren flere rettigheder end nødvendigt!
Advarsel: En ekstern part får ret til at læse og skrive. Hvis det ikke er konfigureret korrekt, skal du dobbelttjekke de rettigheder, der er konfigureret for denne bruger.
1. Gå til Beheer > Schoolfuncties > tabblad Toekeningen schoolfuncties (detaljer)
2. Vælg "roosterproject"
3. Vælg brugeren
4. Click on the button <Toevoegen>
5. Vælg den højre, du vil tilføje
6. Vælg niveauet "Projekt"
7. Vælg rettigheder (lezen/bewerken)
8. Click on the button <Toevoegen>
Rettigheder til narrowcasting
Eksterne parter, der vil vise "roosterwijzgingen", skal have følgende rettigheder for at vise oplysningerne på skærmene:
- Lezen: Roosters en afspraken (projekt)
- Lezen: Afwezigheden (projekt)
Trin 4: Oprettelse af API-token
Nu er brugeren blevet tilføjet og har fået rettigheder til at læse "roosterwijzigingen". Nu skal du oprette API-tokenet. Dette token vil blive brugt til den eksterne part.
1. Gå til Beheer > Admin-panel>tabblad API-tokens
2. Click on the button <Toevoegen>
3. Vælg brugeren
4. Vælg udløbsdatoen
5. Tilføj en kommentar for at gøre det lettere at finde den igen
6. Click on the button <Opslaan>
7. Click on the button <OK>
Du kan oprette tokenet i maksimalt 5 år. Du kan også vælge at oprette et nyt token hvert år. Sørg for at notere disse data i din dagsorden.
Skriv API-tokenet ned.
Hent koden fra lokationen(erne)
Zermelo-widgeten viser kun oplysninger fra én bestemt placering. Det er muligt at tilføje flere widgets med forskellige placeringer, men der kræves en kode for hver placering. Denne kode kan findes under steder i Zermelo eller ved at følge nedenstående trin:
- https://[Schoolname].zportal.nl/static/swagger/
- Kopier det oprettede API-token til feltet access_token øverst til højre
- Tryk på genindlæsningsknappen
- Rul ned til Afdelingervælg den, og tryk på Prøv det af knap
- Når det er gjort korrekt, bør der være en liste med alle navne på steder og deres koder, som vises nedenfor:
{ "response": { "status": 200, "message": "", "details": "", "eventId": 0, "startRow": 0, "endRow": 4, "totalRows": 4, "data": [ { "code": "a", "name": "Apeldoorn", "somCode": "01rl00" }, { "code": "u", "name": "Uddel", "somCode": "01rl02" }
Noter feltet ved siden af koden, det er de oplysninger, vi skal bruge i widgetten.
Kun elementer (aftaler), der har en "ændret" tilstand, vises i widgetten. Hvis du kopierer et element i Zermelo, kan det blive markeret som en "original" aftale uden "ændret" tilstand og vil derfor ikke blive vist i widgetten.
Konfiguration af enheder
Kravene
- Eksporten fra Untis (en GPU014.txt-fil)
- En OneDrive- eller FTP-placering til udgivelse af GPU014.txt-filen (denne placering skal være tilgængelig for GoBright Portal og View-enhed(er)).
- Untis-widget'en
Vær opmærksom på, at de tilladelser, der kræves, for at enhederne kan arbejde med OneDrive, er (Application i stedet for Delegate) i Azure:
Applikationsfiler.læs.alle
Applikationsbruger.læs.alle
OneDrive
For at opsætte OneDrive og Graph API skal du være opmærksom på, at de tilladelser, der kræves, for at enhederne kan arbejde med OneDrive, er (Application i stedet for Delegate) i Azure:
Applikationsfiler.læs.alle
Applikationsbruger.læs.alle
Følg trinnene i denne artikel.
Konfiguration af GoBright View Widget
Gå nu over til GoBright View for at gennemføre følgende trin.
Konfiguration af Zermelo Widget
- Placer widgetten i en skabelon eller et slide.
- Udfyld API-token, skolenavn, skoleår (startåret for det aktuelle skoleår - f.eks. 2024 for dette skoleår) og placeringskode i Zermelo-widgeten. Dette bør vise alle ændringer baseret på den aktuelle placering.
- Definér skemaet/undervisningstiderne
- Indstil filterparametrene efter dine behov (valgfrit)
Konfiguration af Untis-widget
- Placer widgetten i en skabelon eller et slide
- Vælg kilden (OneDrive eller URL)
- OneDrive:
Udfyld klient-id, klienthemmelighed, lejer-id, bruger-e-mail, mappenavn (filplacering) og filnavn - URL
Udfyld hele URL'en til filen GPU014.txt
- OneDrive:
- Definér skemaet/undervisningstiderne (se nedenfor)
- Indstil filterparametrene efter dine behov (valgfrit) (se nedenfor)
Widget-parametre
Tidsplan
For kun at vise de aktuelle ændringer skal vi tilføje de tidspunkter, hvor lektionerne finder sted. Tiden her repræsenterer sluttidspunktet for lektionerne. Disse tidspunkter er obligatoriske, hvis widgetten skal fungere korrekt.
Filtreringsmuligheder
Der er tre felter, som giver mulighed for at filtrere klasse, lokaler og lærere. Filtre kan bruges til at inkludere og/eller ekskludere. For at bruge disse kan man indtaste et element for at filtrere på det specifikke element. Hvis V5E f.eks. indtastes i feltet class_include , vil det kun vise skemaoplysninger for klasse V5E. Det er muligt at bruge flere elementer (adskilt af et rør: '|') eller at bruge mere avancerede filtreringsmuligheder. Dette gøres ved hjælp af regex.
Nogle eksempler:
| Filter | Brugt i | Forklaring |
| a4b1|a4b2|a4b3 | klasser_inkluderer | Viser kun klasserne 'a4b1', 'a4b2' eller 'a4b3'. |
| aula | placeringer_ekskluderer | Skjuler aula |
| pp|tvdg | lærere_ekskluderer | Skjuler pp og tvdg |
| INV | emne_ekskludering | Skjuler alle emner, der indeholder 'INV' |
I de fleste tilfælde vil disse eksempler være tilstrækkelige.
Mere avanceret filtrering
Når der er brug for mere avanceret filtrering, er det godt at vide, at alt dette er baseret på regulære udtryk (regex). Vær forsigtig, da det er nemt at skjule alle resultater. Så vil widgetten vise en "der er ingen ændringer"-meddelelse.
Prøv at holde filtrene så enkle som muligt. Brug ikke en exclusion regex i et include-felt eller omvendt for at undgå "dobbeltnegativer".
Regex
^ = Starter med tegn efter dette tegn
$ = Slutter med tegn før dette tegn
| = Adskillelsestegn mellem hvert element
(?!) = Alt, hvad der ikke er lig med disse tegn
| ^r2 | Filtrer på rum, der starter med 'r2' (der skelnesmellem store og små bogstaver) |
| ^r2|^r3 | Filtrer på værelser, der starter med 'r2' eller 'r3' |
| 4A$ | Filtrer på klasser, der slutter med '4A' |
| (?!a4b1) | Filter på alt undtagen klasse 'a4b1' |
| (?!a4b1)|(?!a4b2)|(?!a4b3) | Filtrer på alt undtagen klasserne 'a4b1', 'a4b2' eller 'a4b3'. |
| ^(?!a4b) | Filtrer på alt undtagen klasser, der starter med 'a4b' |
| 4. | Filtrer på alt, der indeholder "4". (den bagerste skråstreg er nøglen) |
Andre muligheder
Der er et par andre muligheder, som man er vant til:
- sortere oplysningerne efter bestemte typer eller datoer
- ændre rækkefølgen af kolonnerne
- vis eller skjul tidligere skemadata (for eksempel: klasseværelse1 > klasseværelse2)
- vis data fra den aktuelle dag og/eller den næste dag
- Anvend styling