Intégration externe - Pronote

Développement
1

Bonjour à tous,

Je vous présente une nouvelle intégration externe pour Gladys : PRONOTE.

Elle affiche dans Gladys les notes, devoirs, emploi du temps, absences et messages non lus de vos enfants (ou de votre propre compte élève). Ça permet par exemple :

  • d’être prévenu quand une nouvelle note tombe ;
  • d’annoncer chaque matin les devoirs du jour ;
  • de savoir la veille qu’un cours est annulé.

:backhand_index_pointing_right: Code source : GitHub - prohand/gladys-pronote: Gladys external integration to connect pronote in Gladys · GitHub

Ce que fait l’intégration

Appareils

  • Un appareil par élève :
    • moyenne générale ;
    • devoirs à faire ;
    • devoirs pour le prochain jour de cours ;
    • absences et retards de la période ;
    • prochain cours ;
    • heure du premier cours du prochain jour de cours ;
    • dernière note.
  • Un appareil pour le compte : nombre de messages non lus.
  • Un compte parent crée un appareil par enfant.

Déclencheurs de scènes

  • Une nouvelle note est publiée
  • Un nouveau devoir est donné
  • Un cours est annulé
  • Une absence ou un retard est saisi

Chaque déclencheur peut être limité à un enfant, et fournit des variables (matière, note, date, etc.).

Actions de scènes

  • Lire PRONOTE maintenant
  • Obtenir la journée d’un élève (aujourd’hui, demain ou prochain jour de cours) : nombre de cours, heure du premier cours, matières annulées, liste des devoirs prête à être lue à voix haute.

Widgets

  • Élève PRONOTE : moyenne, devoirs, absences, prochain cours, dernière note, messages non lus.
  • Emploi du temps PRONOTE : les cours de la journée, avec les cours annulés et les contrôles signalés.

Installation

  1. Gladys 5.1 minimum.
  2. Installez PRONOTE depuis le store des intégrations de Gladys.
  3. Dans la configuration, renseignez :
    • l’adresse de votre espace PRONOTE (ex. https://0123456a.index-education.net/pronote/) ;
    • le type de compte (élève ou parent) ;
    • votre identifiant et votre mot de passe.
  4. Cliquez sur Tester la connexion, puis créez les appareils.

Vous passez par un ENT ?

Si vous vous connectez à PRONOTE via un ENT, vous n’avez pas de mot de passe PRONOTE. Utilisez le bouton Se connecter avec un QR code :

  1. Dans PRONOTE sur ordinateur, ouvrez le menu à côté de votre nom, puis QR code pour l’application mobile.
  2. Choisissez un code à 4 chiffres.
  3. Scannez le QR code avec l’appareil photo du téléphone et copiez le texte affiché (il commence par {"jeton").
  4. Collez ce texte dans Gladys avec le code à 4 chiffres.

Le QR code n’est valable que quelques minutes.

La doc complète (FR / EN / DE / ES) : gladys-pronote/docs/fr.md at main · prohand/gladys-pronote · GitHub

Exemple de scène

Chaque jour de semaine à 07h00 → Obtenir la journée d’un élève (prochain jour de cours) → Dire : « Premier cours à {{first_lesson}}. Devoirs : {{homework_text}} »

Ou plus simple :

Une nouvelle note est publiée (enfant : Léa) → Envoyer un message : « Nouvelle note en {{triggerEvent.data.subject}} : {{triggerEvent.data.grade_label}} »

Sécurité et données

  • Le mot de passe reste dans la configuration secrète de Gladys et n’est jamais écrit dans les journaux.
  • Après la première connexion, l’intégration utilise un jeton de session, comme l’application mobile PRONOTE.
  • Les données restent chez vous : rien n’est envoyé ailleurs que vers votre Gladys.
  • PRONOTE est lu toutes les 15 minutes par défaut (réglable), pour ne pas surcharger le serveur de l’établissement.
  • Si PRONOTE refuse le mot de passe, l’intégration arrête d’essayer, pour éviter que l’adresse IP soit bloquée.

Limites connues

  • Compte parent avec plusieurs enfants : l’emploi du temps est correct pour chaque enfant. Pour les notes, devoirs et absences, PRONOTE peut renvoyer les données de l’enfant sélectionné par défaut. Si deux enfants affichent les mêmes notes, dites-le-moi : utiliser le compte élève de chaque enfant contourne le problème.
  • Les comptes enseignants ne sont pas pris en charge.
  • PRONOTE n’envoie pas de notifications : une nouvelle note apparaît dans Gladys au maximum après l’intervalle de rafraîchissement.

Vos retours

C’est une première version. Chaque établissement configure PRONOTE un peu différemment, donc vos retours sont précieux :

  • type de compte (élève / parent, ENT ou non) ;
  • ce qui marche, ce qui ne marche pas ;
  • les messages affichés par Tester la connexion.

Pour les bugs, vous pouvez ouvrir une issue sur GitHub ou répondre ici. Pensez à retirer les noms et informations personnelles des captures et des journaux.

Cette intégration n’est pas affiliée à Index Éducation. Elle s’appuie sur la librairie libre pawnote.

Merci d’avance pour vos tests ! :slightly_smiling_face: