Widget per orari (Zermelo e Untis)
In GoBright View è possibile recuperare informazioni da vari strumenti di pianificazione e orario come Zermelo e Untis. Queste informazioni possono essere utilizzate per visualizzare le modifiche agli orari sui display della segnaletica all'interno dell'edificio. Le modifiche possono essere filtrate in base alle proprie esigenze.
| Zermelo | Untis | |
| Classi di filtro | V | V |
| Filtrare gli insegnanti | V | V |
| Filtrare i soggetti | V | V |
| Visualizzare gli appuntamenti cancellati | V | V |
| Display cambiato insegnante | V | V |
| Visualizzazione della posizione modificata | V | V |
| Visualizzazione dell'ora modificata | V | V |
| Il display ha cambiato soggetto | V | V |
| Visualizza solo le modifiche apportate oggi | V | V |
| Visualizzare l'intero programma di oggi* | X | X |
* I widget sono costruiti per mostrare solo le modifiche di un orario. La visualizzazione dell'intero orario causerebbe un sovraccarico di informazioni sul display della segnaletica.
Configurazione del fornitore di programmi previsionali
Prima è necessario impostare alcuni requisiti. Continuate a seguire i passaggi relativi alla vostra situazione.
Requisiti
- Il nome dell'organizzazione all'interno di Zermelo
- Un account di amministrazione Zermelo
- Un token API
- Uno o più codici del luogo (o dei luoghi)
- Il widget Zermelo
Creare il token API
Consultare questo articolo (in olandese) del supporto Zermelo: https://support.zermelo.nl/guides/applicatiebeheerder/koppelingen/overige-koppelingen/toegang-voor-overige-externe-partijen#toegang-voor-overige-externe-partijen_stap-3-aanmaken-van-een-api-token.
Sintesi dell'articolo di Zermelo
La prima cosa che ci serve è il nome dell'organizzazione all'interno di Zermelo. Si tratta dello stesso nome presente nell'URL che si utilizza per accedere a Zermelo:
https://[Schoolname].zportal.nl
Accedere a Zermelo con un account di amministrazione e annotare il nome della scuola all'interno dell'URL, che ci servirà in seguito. Seguire questi passaggi all'interno di Zermelo per creare un nuovo token API:
- Creare un nuovo utente 'GoBrightView'all'interno di Zermelo
- Creare un ruolo per questo utente, che deve avere permessi di lettura su tutte le pianificazioni visualizzate in GoBright View.
- Assegnare questo ruolo all'utente GoBrightView
- Creare un token API
- Andare su Beheer > Pannello di amministrazione > Token API
- Creare un nuovo token API premendo Toevoegen
- Assegnare il token all'utente creato
Annotare il token API.
Ottenere il codice dalla/e posizione/i
Il widget Zermelo mostrerà solo le informazioni di una località specifica. È possibile aggiungere più widget con diverse località, ma per ogni località è necessario un codice. Questo codice si trova sotto le località all'interno di Zermelo o seguendo i passaggi indicati di seguito:
- https://[Schoolname].zportal.nl/static/swagger/
- Copiare il token API creato nel campo access_token in alto a destra.
- Premere il pulsante di ricarica
- Scorrere fino a rami selezionarlo e premere il tasto provalo pulsante
- Se l'operazione è stata eseguita correttamente, dovrebbe apparire un elenco con tutti i nomi delle località e i relativi codici:
{ "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" },
Annotate i campi accanto al codice: sono le informazioni di cui avremo bisogno nel widget.
Nel widget vengono visualizzati solo gli elementi (appuntamenti) che hanno uno stato "modificato". Se si copia un elemento in Zermelo, questo può essere contrassegnato come un appuntamento "originale", senza stato "modificato" e quindi non verrà visualizzato nel widget.
Requisiti
- L'esportazione da Zermelo (un file GPU014.txt)
- Una posizione OneDrive o FTP per pubblicare il file GPU014.txt (questa posizione deve essere accessibile dal portale GoBright e dai dispositivi View).
- Il widget Untis
OneDrive
Per configurare OneDrive e l'API Graph, seguite la procedura descritta in questo articolo.
GoBright Visualizza la configurazione del widget
Ora andate su GoBright View per completare i passaggi seguenti.
- Posizionare il widget in un modello o in una diapositiva.
- Inserire il token API, il nome della scuola e il codice della località nel widget Zermelo. Questo dovrebbe visualizzare tutte le modifiche in base alla posizione corrente.
- Definire l'orario / gli orari delle lezioni
- Impostare i parametri del filtro in base alle proprie esigenze (opzionale)
- Posizionare il widget in un modello o in una diapositiva
- Scegliere l'origine (OneDrive o URL)
- OneDrive:
Compilare l' ID cliente, il Segreto cliente, l' ID inquilino, l'e-mail dell'utente, il nome della cartella (posizione del file) e il nome del file. - URL
Compilare l'intero URL del file GPU014.txt
- OneDrive:
- Definire l'orario / gli orari delle lezioni (vedi sotto)
- Impostare i parametri del filtro in base alle proprie esigenze (opzionale) (vedere sotto)
Parametri del widget
Orario
Per mostrare solo le modifiche attuali, è necessario aggiungere gli orari in cui si svolgono le lezioni. L'ora rappresenta l'ora di fine delle lezioni. Questi orari sono obbligatori per il corretto funzionamento del widget.
Opzioni di filtro
Ci sono tre campi che consentono di filtrare le opzioni classe, stanza e insegnante. I filtri possono essere utilizzati per includere e/o escludere. Per utilizzarli, è necessario inserire un elemento per filtrare su quell'elemento specifico. Ad esempio, se si inserisce V5E nel campo classe_include , verranno visualizzate solo le informazioni relative alla classe V5E. È possibile utilizzare più voci (separate da una pipe: '|') o utilizzare opzioni di filtraggio più avanzate. Questo viene fatto utilizzando una regex.
Alcuni esempi:
| Filtro | Utilizzato in | Spiegazione |
| a4b1|a4b2|a4b3 | classi_incluse | Mostra solo le classi 'a4b1', 'a4b2' o 'a4b3'. |
| aula | luoghi_esclusi | Nasconde l'aula |
| pp|tvdg | insegnanti_escludere | Nasconde pp e tvdg |
| INV | soggetto_escluso | Nasconde tutti gli argomenti contenenti "INV". |
Nella maggior parte dei casi questi esempi sono sufficienti.
Filtraggio più avanzato
Quando è necessario un filtraggio più avanzato, è bene sapere che tutto ciò si basa su espressioni regolari (regex). Fare attenzione perché è facile nascondere tutti i risultati. In tal caso, il widget mostrerà un messaggio "non ci sono modifiche".
Cercate di mantenere i filtri il più semplici possibile. Non utilizzare una regex di esclusione all'interno di un campo di inclusione o viceversa per evitare "doppie negazioni".
Regex
^ = Inizia con i caratteri dopo questo segno
$ = Termina con i caratteri prima di questo segno
| = Carattere di separazione tra ogni elemento
(?!) = Tutto ciò che non è uguale a questi caratteri
| ^r2 | Filtro sulle stanze che iniziano con 'r2'(è sensibile alle maiuscole e alle minuscole) |
| ^r2|^r3 | Filtrare sulle stanze che iniziano con 'r2' o 'r3 |
| 4A$ | Filtrare sulle classi che terminano con '4A' |
| (?!a4b1) | Filtro su tutto tranne che su classe 'a4b1' |
| (?!a4b1)|(?!a4b2)|(?!a4b3) | Filtrare su tutto tranne che sulle classi 'a4b1', 'a4b2' o 'a4b3'. |
| ^(?!a4b) | Filtrare su tutto tranne le classi che iniziano con 'a4b' |
| 4. | Filtrare su tutto ciò che contiene "4". (la barra posteriore è fondamentale) |
Altre opzioni
Ci sono un paio di altre opzioni che vengono utilizzate:
- ordinare le informazioni per tipi o date specifiche
- cambiare l'ordine delle colonne
- mostrare o nascondere i dati dei programmi precedenti (ad esempio: aula1 > aula2)
- mostra i dati del giorno corrente e/o del giorno successivo
- applicare lo styling