Widgets d'horaire/de calendrier (Zermelo & Untis)
Dans GoBright View, il est possible d'extraire des informations de divers outils de planification/horaire comme Zermelo et Untis. Ces informations peuvent être utilisées pour afficher les changements d'horaires sur les panneaux de signalisation dans un bâtiment. Les changements peuvent être filtrés en fonction de vos besoins.
| Zermelo | Untis | |
| Classes de filtres | V | V |
| Filtrer les enseignants | V | V |
| Sujets de filtre | V | V |
| Afficher les rendez-vous annulés | V | V |
| L'affichage a changé de professeur | V | V |
| Afficher l'emplacement modifié | V | V |
| Affichage de l'heure modifiée | V | V |
| L'affichage a changé de sujet | V | V |
| Afficher uniquement les modifications apportées aujourd'hui | V | V |
| Afficher le programme complet de la journée*. | X | X |
* Les widgets sont conçus pour n'afficher que les modifications d'un horaire. L'affichage de l'ensemble du calendrier entraînerait une surcharge d'informations sur l'écran de la signalisation.
Configuration du fournisseur d'horaire
Quelques conditions doivent d'abord être remplies. Veuillez continuer à suivre les étapes correspondant à votre situation.
Configuration de Zermelo
Exigences
- Le nom de l'organisation au sein de Zermelo
- Un compte administrateur Zermelo
- Un jeton API
- Un ou plusieurs codes de l'emplacement (ou des emplacements)
- Le widget Zermelo
Créer le jeton API
Veuillez consulter cet article (en néerlandais) du support 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.
Résumé de l'article de Zermelo
La première chose dont nous avons besoin est le nom de l'organisation dans Zermelo. Il s'agit du même nom dans l'URL que vous utilisez pour vous connecter à Zermelo :
https://[Schoolname].zportal.nl
Connectez-vous à Zermelo avec un compte administrateur et notez le nom de l'école dans l'URL, nous en aurons besoin plus tard. Suivez ces étapes dans Zermelo pour créer un nouveau jeton API :
- Créez un nouvel utilisateur 'GoBrightView'dans Zermelo.
- Créez un rôle pour cet utilisateur, ce rôle doit avoir des droits de lecture sur tous les programmes qui sont affichés dans GoBright View.
- Attribuer ce rôle à l'utilisateur GoBrightView
- Créer un jeton API
- Allez dans Beheer > Panneau d'administration > Tokens API
- Créez un nouveau jeton API en appuyant sur Toevoegen
- Attribuer le jeton à l'utilisateur créé
Notez le jeton API.
Obtenez le code de l'emplacement (s)
Le widget Zermelo n'affichera que les informations d'un emplacement spécifique. Il est possible d'ajouter plusieurs widgets avec des emplacements différents, mais pour chaque emplacement, un code est nécessaire. Ce code peut être trouvé sous les emplacements dans Zermelo ou en suivant les étapes ci-dessous :
- https://[Schoolname].zportal.nl/static/swagger/
- Copiez le jeton API créé dans le champ access_token en haut à droite.
- Appuyez sur le bouton de rechargement
- Faites défiler la page jusqu'à branches sélectionnez-le et appuyez sur la touche essayez-le bouton
- Si cela est fait correctement, il devrait y avoir une liste avec tous les noms des lieux et leurs codes affichés ci-dessous :
{ "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" },
Notez les champs à côté du code: ce sont les informations dont nous aurons besoin dans le widget.
Seuls les éléments (rendez-vous) qui ont un état "modifié" sont affichés dans le widget. Si vous copiez un élément dans Zermelo, il peut être marqué comme un rendez-vous "original", sans état "modifié" et ne sera donc pas affiché dans le widget.
Configuration de l'Untis
Exigences
- L'exportation de Zermelo (un fichier GPU014.txt)
- Un emplacement OneDrive ou FTP pour publier le fichier GPU014.txt (cet emplacement doit être accessible par le portail GoBright et le(s) périphérique(s) View.
- Le widget Untis
OneDrive
Pour configurer OneDrive et l'API graphique, veuillez suivre les étapes de cet article.
GoBright Voir la configuration du widget
Rendez-vous maintenant sur le site GoBright View pour effectuer les étapes suivantes.
Configuration du widget Zermelo
- Placez le widget dans un modèle ou une diapositive.
- Remplissez le Token API, le nom de l'école et le code de localisation dans le widget Zermelo. Cela devrait afficher tous les changements basés sur l'emplacement actuel.
- Définir l'horaire / les heures de cours
- Réglez les paramètres du filtre selon vos besoins (optionnel)
Configuration du widget Untis
- Placez le Widget dans un modèle ou une diapositive
- Choisissez la source (OneDrive ou URL)
- OneDrive :
Remplissez l' ID du client, le secret du client, l' ID du locataire, l'email de l'utilisateur, le nom du dossier (emplacement du fichier) et le nom du fichier. - URL
Remplissez l'URL complète du fichier GPU014.txt.
- OneDrive :
- Définir l'horaire / les heures de cours (voir ci-dessous)
- Réglez les paramètres du filtre selon vos besoins (facultatif) (voir ci-dessous).
Paramètres du widget
Horaire
Pour ne montrer que les changements actuels, nous devons ajouter les heures auxquelles les leçons ont lieu. L'heure ici représente l'heure de fin des leçons. Ces heures sont obligatoires pour que le widget fonctionne correctement.
Options de filtrage
Trois champs permettent de filtrer les options suivantes : classe, salles et enseignants. Les filtres peuvent être utilisés pour inclure et/ou exclure. Pour les utiliser, il suffit de saisir un élément pour filtrer sur cet élément spécifique. Par exemple, si V5E est saisi dans le champ class_include , seules les informations relatives à la classe V5E seront affichées. Il est possible d'utiliser plusieurs éléments (séparés par un tuyau : '|') ou d'utiliser des options de filtrage plus avancées. Cela se fait à l'aide d'une expression rationnelle.
Quelques exemples :
| Filtre | Utilisé dans | Explication |
| a4b1|a4b2|a4b3 | classes_incluses | Affiche uniquement les classes "a4b1", "a4b2" ou "a4b3". |
| aula | locations_exclude | Cache l'aula |
| pp|tvdg | enseignants_exclure | Cache pp et tvdg |
| INV | sujet_exclu | Masque tous les sujets contenant 'INV'. |
Dans la plupart des cas, ces exemples suffiront.
Un filtrage plus avancé
Lorsqu'un filtrage plus avancé est nécessaire, il est bon de savoir que tout ceci est basé sur des expressions régulières (regex). Faites attention car il est facile de masquer tous les résultats. Le widget affichera alors un message "il n'y a pas de changement".
Essayez de garder les filtres aussi simples que possible. N'utilisez pas de regex d'exclusion dans un champ d'inclusion ou vice versa pour éviter les "doubles négations".
Regex
^ = Commence par les caractères après ce signe
$ = Se termine par les caractères avant ce signe
| = Caractère de séparation entre chaque élément
( ?!) = Tout ce qui n'est pas égal à ces caractères
| ^r2 | Filtre sur les chambres qui commencent par 'r2'(sensible à la casse). |
| ^r2|^r3 | Filtre sur les pièces qui commencent par r2' ou 'r3'. |
| 4A$ | Filtre sur les classes qui se terminent par '4A' |
| (?!a4b1) | Filtre sur tout sauf classe "a4b1 |
| (?!a4b1)|(?!a4b2)|(?!a4b3) | Filtre sur tout sauf sur les classes 'a4b1', 'a4b2' ou 'a4b3'. |
| ^(?!a4b) | Filtre sur tout sauf les classes qui commencent par a4b' |
| 4. | Filtre sur tout ce qui contient "4". (la barre oblique arrière est essentielle) |
Autres options
Il y a quelques autres options auxquelles on est habitué :
- trier les informations par types ou dates spécifiques
- changer l'ordre des colonnes
- afficher ou masquer les données de l'horaire précédent (par exemple : classe1 > classe2)
- afficher les données du jour en cours et/ou du jour suivant
- appliquer le stylisme