Timeplan-widgeter (Zermelo & Untis)
I GoBright Se det er mulig å hente informasjon fra ulike planleggings-/ruteplanverktøy som Zermelo og Untis. Denne informasjonen kan brukes til å vise tidsplanendringer på skiltskjermer i en bygning. Endringene kan filtreres i henhold til dine behov.
| Zermelo | Untis | |
| Filtrer klasser | V | V |
| Filtrer lærere | V | V |
| Filtrer emner | V | V |
| Vis avlyste avtaler | V | V |
| Skjerm endret lærer | V | V |
| Vis endret plassering | V | V |
| Skjerm endret tid | V | V |
| Visning endret emne | V | V |
| Vis kun endringer som er gjort i dag | V | V |
| Vis hele timeplanen for i dag* | X | X |
* Widgetene er bygget for kun å vise endringer i en tidsplan. Å vise hele timeplanen vil føre til en overbelastning av informasjon på skiltskjermen.
Konfigurerer tidsplanleverandør
Det er noen krav som må settes opp først. Fortsett å følge trinnene for din situasjon.
Zermelo-konfigurasjon
Krav
- Navnet på organisasjonen i Zermelo
- En Zermelo administratorkonto
- Et API-token
- En eller flere koder for plasseringen(e)
- Zermelo-widgeten
Opprett API-tokenet
Sammendrag av Zermelo-artikkelen
Det første vi krever er navnet på organisasjonen i Zermelo. Dette er det samme navnet i URL-en du bruker for å logge på Zermelo:
https://[Schoolname].zportal.nl
Logg på Zermelo med en administratorkonto og noter skolenavnet i URL-en, vi trenger det senere. Følg disse trinnene i Zermelo for å lage et nytt API-token:
Trinn 1 Legg til brukeren
Den eksterne klienten må legges til portalen som bruker.
1. Gå til Beheer > Brukere
2. Velg ved Filter: “ Ingen filter ”
3. Click on the button <Toevoegen>
4. Fyll inn " Brukerscode " navnet på brukeren
5. Slett haken på “ Mag de brukere inloggen “
6. Legg til haken på «Tillegg som ansatt»
6. Click on the button <Toevoegen>
Trinn 2 Legg til bruker til "Roosterproject"
Brukeren som nettopp ble opprettet, må legges til i "Roosterproject".
1. Gå til Personeel>Oversikt>Tabblad Contracten
2. Velg riktig " roosterproject "
S. Click on the butoon <Toevoegen>
4. Skriv inn brukeren ved brukerkoden
5. Click on the button <Volgende>
6. Endre « funksjonskategorien » til OOP
7. Click on the button <Klaar>
Flere prosjekter i én portal?
Kanskje er det flere «roosterprojecten» for inneværende skoleår i portalen. Det betyr at for brukeren med flere "roosterprojecten" må flere kontrakter tildeles denne brukeren.
Trinn 3: Konfigurering av rettighetene
Nå er det på tide å gi brukeren rettighetene. Viktig er å ikke gi brukeren flere rettigheter enn det er nødvendig!
Advarsel: En ekstern part får rett til å gjøre lesing og skriving. Hvis det ikke er riktig konfigurert, må du dobbeltsjekke rettighetene som blir konfigurert for denne brukeren.
1. Gå til Beheer > Skolefunksjoner > tabblad Tilkeningen skolefunksjoner (detaljer)
2. Velg "roosterprosjektet"
3. Velg brukeren
4. Click on the button <Toevoegen>
5. Velg rettigheten du vil legge til
6. Velg nivået "Prosjekt"
7. Velg rettighetene (lezen/bewerken)
8. Click on the button <Toevoegen>
Rettigheter for narrowcasting
Eksterne parter som vil vise "roosterwijzgingen" vil trenge følgende rettigheter for å vise informasjonen på skjermene:
– Lezen: Roosters en afspraken (prosjekt)
– Lezen: Afwezigheden (prosjekt)
Trinn 4: Opprette API-tokenet
Nå er brukeren lagt til og har fått rettigheter til å lese "roosterwijzigingen". Nå må du lage API-tokenet. Dette tokenet vil bli brukt for den eksterne parten.
1. Gå til Beheer > Admin-panel > tabblad API-tokens
2. Click on the button <Toevoegen>
3. Velg brukeren
4. Velg utløpsdatoen
5. Legg til en kommentar for å gjøre det lettere å finne den tilbake
6. Click on the button <Opslaan>
7. Click on the button <OK>
Du kan opprette tokenet for et maksimumsbeløp på 5 år. Du kan også velge å opprette et nytt token hvert år. Husk å notere disse dataene i agendaen din.
Noter ned API-tokenet.
Få koden fra stedet(e)
Zermelo-widgeten vil kun vise informasjon fra ett bestemt sted. Det er mulig å legge til flere widgeter med forskjellige plasseringer, men for hver plassering kreves en kode. Denne koden kan bli funnet under steder i Zermelo eller ved å følge trinnene nedenfor:
- https://[Schoolname].zportal.nl/static/swagger/
- Kopier det opprettede API-tokenet til access_token -feltet øverst til høyre
- Trykk på reload -knappen
- Rull ned til grener, velg den og trykk på prøv det ut knapp
- Når det er gjort riktig, skal det være en liste med alle navnene på steder og deres koder vist 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 ned feltet ved siden av koden, dette er informasjonen vi trenger i widgeten.
Bare elementer (avtaler) som har en "endret" tilstand vises i widgeten. Hvis du kopierer et element i Zermelo kan det merkes som en "original" avtale, uten "endret" tilstand og vil derfor ikke vises i widgeten.
Konfigurasjon av enheter
Krav
- Eksporten fra Untis (en GPU014.txt-fil)
- En OneDrive- eller FTP-plassering for å publisere GPU014.txt-filen (denne plasseringen må være tilgjengelig for GoBright Portal og View-enhet(er)
- Untis-widgeten
Vær oppmerksom på at for at enheter skal fungere med OneDrive, er tillatelsene som kreves (applikasjon i stedet for Delegater) i Azure:
Application Files.Read.All
Applikasjonsbruker.Les.Alle
OneDrive
For å konfigurere OneDrive og Graph API, vær oppmerksom på at for enheter som skal fungere med OneDrive, er tillatelsene som kreves (Applikasjon i stedet for Delegate) i Azure:
Application Files.Read.All
Applikasjonsbruker.Les.Alle
Følg trinnene i denne artikkelen .
GoBright Vis widgetkonfigurasjon
Gå nå over til GoBright Vis for å fullføre følgende trinn.
Zermelo Widget-konfigurasjon
- Plasser widgeten i en mal eller et lysbilde.
- Fyll ut API-token, skolenavn (https:// [skolenavn] .zportal.nl), skoleår (startåret for inneværende skoleår – for eksempel 2024 for dette skoleåret) og lokasjonskode i Zermelo-widgeten. Dette skal vise alle endringene basert på gjeldende lokasjon.
- Definer timeplanen / timetidene
- Still inn filterparametrene til ditt behov (valgfritt)
Untis widget-konfigurasjon
- Plasser widgeten i en mal eller et lysbilde
- Velg kilden (OneDrive eller URL)
- OneDrive:
Fyll inn klient-ID , klienthemmelighet , leietaker-ID , bruker-e-post , mappenavn (filplassering) og filnavn - URL
Fyll inn hele URL-en til GPU014.txt-filen
- OneDrive:
- Definer timeplan / timetid (se nedenfor)
- Still inn filterparametrene til ditt behov (valgfritt) (se nedenfor)
Widget-parametere
Rutetabell
For å vise bare de gjeldende endringene, må vi legge til i tidene som leksjonene finner sted. Tiden her representerer slutttiden for leksjonene. Disse tidene er obligatoriske for at widgeten skal fungere korrekt.
Filteralternativer
Det er tre felt som tillater filtreringsalternativer klasse, rom og lærere . Filtre kan brukes til å inkludere og/eller ekskludere. For å bruke disse, kan en vare legges inn for å filtrere på den spesifikke varen. For eksempel, hvis V5E angis i feltet class_include, vil det bare vise tidsplaninformasjon for klasse V5E . Det er mulig å bruke flere elementer (atskilt med et rør: ' | ') eller å bruke mer avanserte filtreringsalternativer. Dette gjøres ved hjelp av regex.
Noen eksempler:
| Filter | Brukes i | Forklaring |
| a4b1|a4b2|a4b3 | classes_include | Viser bare klassene 'a4b1', 'a4b2' eller 'a4b3' |
| aula | locations_exclude | Skjuler aula |
| pp|tvdg | lærere_ekskluderer | Skjuler pp og tvdg |
| INV | emne_ekskluder | Skjuler alle emner som inneholder 'INV' |
I de fleste tilfeller vil disse eksemplene være tilstrekkelige.
Mer avansert filtrering
Når mer avansert filtrering er nødvendig er det greit å vite at alt dette er basert på regulære uttrykk (regex). Vær forsiktig siden det er lett å skjule alle resultater. Deretter vil widgeten vise en "det er ingen endringer"-melding.
Prøv å holde filtrene så enkle som mulig. Ikke bruk en ekskluderingsregex i et inkludere-felt eller omvendt for å forhindre "doble negativer".
Regex
^ = Starter med tegn etter dette tegnet
$ = Slutter med tegn før dette tegnet
| = Skilletegn mellom hvert element
(?!) = Alt som ikke er lik disse tegnene
| ^r2 | Filtrer på rom som starter med 'r2' ( dette skiller mellom store og små bokstaver ) |
| ^r2|^r3 | Filtrer på rom som starter med "r2" eller "r3" |
| 4A$ | Filtrer på klasser som slutter med '4A' |
| (?!a4b1) | Filtrer på alt unntatt klasse 'a4b1' |
| (?!a4b1)|(?!a4b2)|(?!a4b3) | Filtrer på alt unntatt klassene 'a4b1', 'a4b2' eller 'a4b3' |
| ^(?!a4b) | Filtrer på alt unntatt klasser som starter med 'a4b ' |
| 4. | Filtrer på alt som inneholder "4." (skråstreken bak er nøkkelen) |
Andre alternativer
Det er et par andre alternativer som brukes til:
- sortere informasjonen etter spesifikke typer eller datoer
- endre rekkefølgen på kolonnene
- vis eller skjul tidligere timeplandata (for eksempel: klasserom1 > klasserom2)
- vise data fra gjeldende dag og/eller neste dag
- bruke styling