Widgets för schema/tidtabell (Zermelo & Untis)
I GoBright View är det möjligt att hämta information från olika schemaläggnings-/tidtabellsverktyg som Zermelo och Untis. Denna information kan användas för att visa schemaändringar på skyltar i en byggnad. Ändringarna kan filtreras enligt dina behov.
| Zermelo | Untis | |
| Filtrera klasser | V | V |
| Filtrera lärare | V | V |
| Filtrera ämnen | V | V |
| Visa avbokade möten | V | V |
| Display bytte lärare | V | V |
| Visa ändrad plats | V | V |
| Visning av ändrad tid | V | V |
| Display bytte ämne | V | V |
| Visa endast ändringar som gjorts idag | V | V |
| Visa hela schemat för idag* | X | X |
* Widgetarna är byggda för att endast visa ändringar i ett schema. Att visa hela schemat skulle orsaka en överbelastning av information på skyltdisplayen.
Konfigurera schemaläggare
Det finns några krav som måste ställas upp först. Fortsätt att följa de steg som gäller för din situation.
Zermelo konfiguration
Krav och önskemål
- Namnet på organisationen inom Zermelo
- Ett Zermelo-administratörskonto
- En API-token
- En eller flera koder för platsen/platserna
- Zermelo-widgeten
Skapa API-token
Sammanfattning av Zermelo-artikeln
Det första vi behöver är namnet på organisationen inom Zermelo. Detta är samma namn som finns i den URL du använder för att logga in i Zermelo:
https://[Schoolname].zportal.nl
Logga in på Zermelo med ett adminkonto och notera skolnamnet i webbadressen, vi behöver det senare. Följ dessa steg i Zermelo för att skapa en ny API-token:
Steg 1 Lägg till användaren
Den externa klienten måste läggas till som användare i portalen.
1. Gå till Beheer > Gebruikers
2. Välj vid Filter: "Inget filter"
3. Click on the button <Toevoegen>
4. Fyll ianvändarensnamn i "Gebruikerscode" (användarkod)
5. Ta bort markeringen för "Mag de gebruikers inloggen"
6. Lägg till kontroll av "Toevoegen als werknemer"
6. Click on the button <Toevoegen>
Steg 2 Lägg till användare i "Roosterproject"
Den användare som just skapades måste läggas till i "Roosterproject".
1. Gå till Personeel>Översikt>Tabblad Contracten
2. Välj rätt "roosterproject"
S. Click on the butoon <Toevoegen>
4. Skriv in användaren på Gebruikerscode
5. Click on the button <Volgende>
6. Ändra "functiecategorie" till OOP
7. Click on the button <Klaar>
Fler projekt i en portal?
Kanske finns det fler "roosterprojecten" för det aktuella läsåret i portalen. Det innebär att för den användare som har flera "roosterprojecten" måste fler kontrakt tilldelas den här användaren.
Steg 3: Konfigurera rättigheter
Nu är det dags att ge användaren rättigheter. Viktigt är att inte ge användaren fler rättigheter än vad som är nödvändigt!
Varning för detta: En extern part får rätt att utföra läsning och skrivning. Om den inte är korrekt konfigurerad bör du dubbelkolla vilka rättigheter som konfigureras för den här användaren.
1. Gå till Beheer > Schoolfuncties > tabblad Toekeningen schoolfuncties (detaljer)
2. Välj "roosterproject"
3. Välj användare
4. Click on the button <Toevoegen>
5. Välj den rättighet som du vill lägga till
6. Välj nivån "Projekt"
7. Välj rättigheter (lezen/bewerken)
8. Click on the button <Toevoegen>
Rättigheter för narrowcasting
Externa parter som kommer att visa "roosterwijzgingen" behöver följande rättigheter för att visa informationen på skärmarna:
- Lezen: Roosters en afspraken (projekt)
- Lezen: Afwezigheden (projekt)
Steg 4: Skapa API-token
Nu har användaren lagts till och har fått rättigheter att läsa "roosterwijzigingen". Nu måste du skapa API-token. Denna token kommer att användas för den externa parten.
1. Gå till Beheer > Admin-panel>tabblad API-tokens
2. Click on the button <Toevoegen>
3. Välj användare
4. Välj utgångsdatum
5. Lägg till en kommentar för att göra det lättare att hitta tillbaka
6. Click on the button <Opslaan>
7. Click on the button <OK>
Du kan skapa en token för maximalt 5 år. Du kan också välja att skapa en ny token varje år. Se till att notera dessa uppgifter i din agenda.
Skriv ner API-token.
Hämta koden från platsen/platserna
Zermelo-widgeten visar bara information från en specifik plats. Det är möjligt att lägga till flera widgetar med olika platser, men för varje plats krävs en kod. Denna kod hittar du under platserna i Zermelo eller genom att följa stegen nedan:
- https://[Schoolname].zportal.nl/static/swagger/
- Kopiera den skapade API-token till fältet access_token längst upp till höger
- Tryck på omladdningsknappen
- Bläddra ner till grenarvälj det och tryck på knappen prova det knapp
- Om detta görs på rätt sätt bör det finnas en lista med alla namn på platser och deras koder som visas nedan:
{ "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" }
Notera fältet bredvid kod, det är den information vi behöver i widgeten.
Endast objekt (möten) som har ett "ändrat" tillstånd visas i widgeten. Om du kopierar ett objekt i Zermelo kan det markeras som ett "original"-möte, utan "ändrat" tillstånd, och kommer därför inte att visas i widgeten.
Konfiguration av enheter
Krav och önskemål
- Exporten från Untis (en GPU014.txt-fil)
- En OneDrive- eller FTP-plats för att publicera filen GPU014.txt (den här platsen måste vara tillgänglig för GoBright Portal och View-enheten/-enheterna)
- Untis Widget
Observera att för att enheterna ska fungera med OneDrive krävs behörigheter (Application istället för Delegate) i Azure:
Applikationsfiler.läs.alla
Applikation Användare.Läs.Alla
OneDrive
För att konfigurera OneDrive och Graph API bör du vara medveten om att behörigheterna som krävs för att enheter ska fungera med OneDrive är (Application istället för Delegate) i Azure:
Applikationsfiler.läs.alla
Applikation Användare.Läs.Alla
Följ anvisningarna i den här artikeln.
Konfiguration av GoBright View Widget
Gå nu över till GoBright View för att slutföra följande steg.
Konfiguration av Zermelo Widget
- Placera widgeten i en mall eller bild.
- Fyll i API Token, skolans namn (https://[Schoolname].zportal.nl), skolår ( startåret för det aktuella skolåret - t.ex. 2024 för det här läsåret) och platskod i Zermelo-widgeten. Detta bör visa alla ändringar baserat på den aktuella platsen.
- Definiera schemat/lektionstiderna
- Ställ in filterparametrarna efter dina behov (tillval)
Konfiguration av Untis widget
- Placera widgeten i en mall eller bild
- Välj källa (OneDrive eller URL)
- OneDrive:
Fyll i Client ID, Client Secret, Tenant ID, User Email, Folder Name (filplats) och File Name (filnamn) - URL
Fyll i hela URL:en till filen GPU014.txt
- OneDrive:
- Definiera schemat/lektionstiderna (se nedan)
- Ställ in filterparametrarna efter dina behov (tillval) (se nedan)
Parametrar för widget
Tidtabell
För att bara visa de aktuella ändringarna måste vi lägga till de tider då lektionerna äger rum. Tiden här representerar sluttiden för lektionerna. Dessa tider är obligatoriska för att widgeten ska fungera korrekt.
Filteralternativ
Det finns tre fält som tillåter filtrering av alternativen klass, rum och lärare. Filter kan användas för att inkludera och/eller exkludera. För att använda dessa kan ett objekt anges för att filtrera på det specifika objektet. Om du till exempel anger V5E i fältet class_include visas endast schemainformation för klass V5E. Det är möjligt att använda flera objekt (separerade med ett rör: '|') eller att använda mer avancerade filtreringsalternativ. Detta görs med hjälp av regex.
Några exempel:
| Filter | Används i | Förklaring |
| a4b1|a4b2|a4b3 | klasser_inkludera | Visar endast klasserna 'a4b1', 'a4b2' eller 'a4b3' |
| aula | platser_exkludera | Döljer aula |
| pp|tvdg | lärare_exkludera | Döljer pp och tvdg |
| INV | ämne_utesluta | Döljer alla ämnen som innehåller "INV |
I de flesta fall räcker det med dessa exempel.
Mer avancerad filtrering
När det behövs mer avancerad filtrering är det bra att veta att allt detta baseras på reguljära uttryck (regex). Var försiktig eftersom det är lätt att dölja alla resultat. Då kommer widgeten att visa ett "det finns inga ändringar"-meddelande.
Försök att hålla filtren så enkla som möjligt. Använd inte en exkluderande regex i ett inkluderande fält eller vice versa för att förhindra "dubbla negationer".
Regex
^ = Börjar med tecken efter detta tecken
$ = Slutar med tecken före detta tecken
| = Separeringstecken mellan varje objekt
(?!) = Allt som inte är lika med dessa tecken
| ^r2 | Filtrera på rum som börjar med 'r2'(detta är skiftlägeskänsligt) |
| ^r2|^r3 | Filtrera på rum som börjar med "r2" eller "r3 |
| 4A$ | Filtrera på klasser som slutar med '4A' |
| (?!a4b1) | Filter på allt utom klass 'a4b1' |
| (?!a4b1)|(?!a4b2)|(?!a4b3) | Filtrera på allt utom klasserna 'a4b1', 'a4b2' eller 'a4b3' |
| ^(?!a4b) | Filtrera på allt utom klasser som börjar med 'a4b' |
| 4. | Filtrera på allt som innehåller "4." (det bakre snedstrecket är nyckeln) |
Andra alternativ
Det finns ett par andra alternativ som är vanliga:
- sortera informationen efter specifika typer eller datum
- ändra ordningen på kolumnerna
- visa eller dölja tidigare schemadata (t.ex.: klassrum1 > klassrum2)
- visa data från den aktuella dagen och/eller nästa dag
- tillämpa styling