PRONOTE Smart-Home-Integration, kostenlos und Open Source
Noten, Hausaufgaben, Stundenplan und Fehlzeiten aus PRONOTE, mit Szenenauslösern und Widgets.
Veröffentlicht von prohand
- Geräte
- Version 0.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Diese Integration bringt PRONOTE, die Schulverwaltungssoftware der meisten französischen Schulen, in Gladys: Noten, Hausaufgaben, Stundenplan, Fehlzeiten und ungelesene Nachrichten eines Schülers — oder jedes Kindes eines Elternkontos.
Sie liest PRONOTE so wie die PRONOTE-App, alle paar Minuten, und veröffentlicht das Gefundene als Gladys-Geräte, Szenenauslöser und Dashboard-Widgets.
PRONOTE und Index Éducation sind an dieser Integration nicht beteiligt. Sie nutzt die freie Bibliothek pawnote, um mit PRONOTE zu kommunizieren.
Voraussetzungen
- Gladys 5.1 oder neuer.
- Ein PRONOTE-Konto als Schüler oder Eltern (Lehrkräftekonten werden nicht unterstützt).
- Die Adresse deines PRONOTE-Bereichs, wie dein Browser sie anzeigt, z. B.
https://0123456a.index-education.net/pronote/.
Konfiguration
Öffne in Gladys Integrationen → PRONOTE → Konfiguration.
| Feld | Was eintragen |
|---|---|
| PRONOTE-Adresse | Die Adresse des PRONOTE-Bereichs. Das Ende (eleve.html, parent.html) wird nicht benötigt. |
| Kontoart | Schüler für ein Schülerkonto, Eltern für ein Elternkonto (ein Gerät pro Kind). |
| Benutzername / Passwort | Dein PRONOTE-Benutzername und -Passwort. |
| Aktualisierungsintervall (min) | Wie oft PRONOTE abgerufen wird. 15 Minuten reichen; der Server wird von der ganzen Schule geteilt. |
| Hausaufgaben-Zeitraum | Wie viele Tage im Voraus offene Hausaufgaben gezählt und aufgelistet werden (Standard 7). |
| Zeitzone der Schule | Standard Europe/Paris. Überseegebiete: Indian/Reunion, America/Martinique, Pacific/Noumea… |
| Detaillierte Protokolle | Zum Untersuchen eines Problems einschalten, danach wieder aus. |
Speichere und drücke dann Verbindung testen: Es zeigt, wer angemeldet ist und was für jeden Schüler gefunden wurde.
Nach der ersten Anmeldung gibt PRONOTE der Integration ein Sitzungstoken, das für die nächsten Anmeldungen das Passwort ersetzt, wie bei der PRONOTE-App. Es wird im eigenen Speicher der Integration aufbewahrt.
Konten mit Anmeldung über ein ENT
Wenn du PRONOTE über das ENT deiner Region erreichst (Mon Bureau Numérique, ENT77, Skolengo…), hast du kein PRONOTE-Passwort. Nutze stattdessen einen QR-Code:
- Öffne in PRONOTE am Computer das Menü neben deinem Namen und wähle QR-Code für die mobile App. Wähle einen 4-stelligen Code.
- Scanne den QR-Code mit der Handykamera (nicht mit der PRONOTE-App): Das Handy
zeigt einen Text, der mit
{"jeton"beginnt. Kopiere ihn. - Drücke in Gladys Mit QR-Code anmelden, füge den Text ein und gib den 4-stelligen Code ein. Sei schnell: Der QR-Code ist nur wenige Minuten gültig.
Lass die Felder Adresse, Benutzername und Passwort leer oder trage nur die Adresse ein. Die Sitzung wird dann wie nach einer Anmeldung mit Passwort aufbewahrt.
Geräte
Drücke Entdecken (oder warte auf den ersten Abruf), um die Geräte zu sehen, und lege sie an.
Ein Gerät pro Schüler:
| Funktion | Wert |
|---|---|
| Overall average | Der Gesamtdurchschnitt des laufenden Zeitraums, von 20 (wenn die Schule ihn anzeigt). |
| Homework to do | Die noch nicht erledigten Hausaufgaben im Hausaufgaben-Zeitraum. |
| Homework for the next school day | Die noch nicht erledigten Hausaufgaben für den nächsten Schultag. |
| Absences (period) | Die Fehlzeiten des laufenden Zeitraums. |
| Delays (period) | Die Verspätungen des laufenden Zeitraums. |
| Next lesson | Text, z. B. 14:00 MATHEMATIQUES (B12) (mit Datum, wenn nicht heute). |
| Next school day start | Text, z. B. 08:00: die erste stattfindende Stunde des nächsten Schultags. |
| Last grade | Text, z. B. MATHEMATIQUES 15/20 (12/10). |
Die Funktionsnamen sind beim Anlegen englisch; du kannst sie in Gladys umbenennen.
Ein Gerät für das Konto: die Anzahl der ungelesenen Nachrichten.
Die Geräte sind schreibgeschützt: In PRONOTE wird nichts geändert.
Szenen
Auslöser
| Auslöser | Wann | Variablen |
|---|---|---|
| Eine neue Note wird veröffentlicht | Seit dem letzten Abruf ist eine Note erschienen. | Name des Schülers, Fach, Note, von, Note von 20, Note wie geschrieben, Gewichtung, Klassendurchschnitt, Kommentar, Datum |
| Neue Hausaufgaben werden aufgegeben | Hausaufgaben sind erschienen oder wurden geändert. | Name des Schülers, Fach, Beschreibung, fällig am |
| Eine Stunde fällt aus | Eine Stunde der nächsten Tage fällt jetzt aus. | Name des Schülers, Fach, Datum, Beginn, Ende, PRONOTE-Status |
| Eine Fehlzeit oder Verspätung wird erfasst | Die Schule hat eine Fehlzeit oder Verspätung erfasst. | Name des Schülers, Art (absence / delay), Datum, entschuldigt (yes / no), Minuten Verspätung, Grund |
Jeder Auslöser kann auf einen Schüler beschränkt werden. Der erste Abruf nach der Installation merkt sich nur, was schon da ist: Für die Noten der vergangenen Wochen wird nichts gemeldet.
Aktionen
- PRONOTE jetzt abrufen: aktualisiert Geräte und Widgets sofort. Gefundene Neuigkeiten werden beim nächsten planmäßigen Abruf von den Auslösern gemeldet.
- Tag eines Schülers abrufen: für heute, morgen oder den nächsten Schultag die Anzahl der Stunden, den Beginn der ersten, das Ende der letzten, die ausfallenden Fächer und die offenen Hausaufgaben als vorlesbare Liste.
Beispiel: jeden Wochentag um 07:00 → Tag eines Schülers abrufen (nächster Schultag) → Sagen „Erste Stunde um {{first_lesson}}. Hausaufgaben: {{homework_text}}“.
Widgets
- PRONOTE-Schüler: Durchschnitt, offene Hausaufgaben, Fehlzeiten, nächste Stunde, nächster Schultag, letzte Note, ungelesene Nachrichten und die Hausaufgabenliste. Eine Schaltfläche Aktualisieren ruft PRONOTE sofort ab.
- PRONOTE-Stundenplan: die Stunden von heute, morgen oder dem nächsten Schultag, mit Ausfällen und Tests markiert.
Beide zeigen den letzten Abruf: Das Öffnen eines Dashboards fragt PRONOTE nie ab.
Schaltflächen der Konfiguration
- Verbindung testen: ruft PRONOTE ab und sagt, was gefunden wurde, oder warum nicht.
- Mit QR-Code anmelden: siehe oben.
- Gespeicherte Sitzung vergessen: löscht das gespeicherte Sitzungstoken (zum Kontowechsel oder nach einer Passwortänderung anderswo).
Fehlerbehebung
| Meldung | Was tun |
|---|---|
| PRONOTE hat Benutzername oder Passwort abgelehnt | Prüfe sie auf der PRONOTE-Website. Der Abruf pausiert, bis du die Konfiguration speicherst oder die Verbindung testest. |
| PRONOTE verlangt die Einrichtung der Kontosicherheit | Melde dich einmal in der PRONOTE-App oder -Website an, um sie abzuschließen (neues Passwort, PIN), und nutze dann den QR-Code. |
| Die IP-Adresse wurde gesperrt | Zu viele fehlgeschlagene Anmeldungen: Warte (meist eine Stunde), bevor du es erneut versuchst. |
| Der Server ist nicht erreichbar | Prüfe die Adresse. Ein ausgelasteter Server wird beim nächsten Abruf erneut versucht. |
Schalte Detaillierte Protokolle ein, um jeden Schritt in den Protokollen der Integration zu sehen. Passwörter und Tokens werden nie protokolliert.
Bekannte Einschränkungen
- Elternkonten mit mehreren Kindern: Der Stundenplan wird für jedes Kind gelesen, aber für Noten, Hausaufgaben und Fehlzeiten kann PRONOTE für das standardmäßig ausgewählte Kind antworten. Zeigen zwei Kinder dieselben Noten, nutze besser das Schülerkonto jedes Kindes.
- Lehrkräftekonten werden nicht unterstützt.
- PRONOTE hat keine Benachrichtigungen: Neuigkeiten werden bei jedem Abruf gefunden, eine neue Note erscheint also innerhalb des Aktualisierungsintervalls.
Deine Daten
Das Passwort bleibt in der geheimen Konfiguration von Gladys. Das Sitzungstoken liegt im privaten Speicher der Integration; Noten, Hausaufgaben und Stundenplan werden nur im Arbeitsspeicher gehalten und an dein Gladys übermittelt. Nichts wird anderswohin gesendet.
Konfigurationseinstellungen
Diese Einstellungen fragt PRONOTE in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Erste Schritte | section | Nein | Die Integration liest deinen PRONOTE-Bereich auf dem Server der Schule, so wie die PRONOTE-App: Noten, Hausaufgaben, Stundenplan, Fehlzeiten und ungelesene Nachrichten. Gib die Adresse des PRONOTE-Bereichs ein (die du im Browser öffnest), die Kontoart, deinen Benutzernamen und dein Passwort, und speichere. Wenn du dich über ein ENT anmeldest (kein PRONOTE-Passwort), lass das Passwort leer und nutze unten die Schaltfläche „Mit QR-Code anmelden“. |
| PRONOTE-Adresse | string | Nein | Die Adresse des PRONOTE-Bereichs, wie der Browser sie anzeigt, z. B. https://0123456a.index-education.net/pronote/. Das Ende der Adresse (eleve.html, parent.html) wird nicht benötigt. |
| Kontoart | select | Nein | Schüler: ein Schüler. Eltern: jedes Kind des Kontos, je ein Gerät. |
| Benutzername | string | Nein | |
| Passwort | secret | Nein | Wird nur verwendet, wenn keine Sitzung gespeichert ist: Nach der ersten Anmeldung gibt PRONOTE ein Sitzungstoken, das es ersetzt und im eigenen Speicher der Integration bleibt. |
| Aktualisierungsintervall (min) | number | Nein | Wie oft PRONOTE abgerufen wird, in Minuten. Der Server wird von der ganzen Schule geteilt: 15 Minuten reichen für Noten und Hausaufgaben völlig aus. |
| Hausaufgaben-Zeitraum (Tage) | number | Nein | Wie viele Tage im Voraus die offenen Hausaufgaben gezählt und aufgelistet werden. |
| Zeitzone der Schule | string | Nein | PRONOTE liefert Uhrzeiten ohne Zeitzone: Sie werden in dieser gelesen. Ein IANA-Name, z. B. Europe/Paris, Indian/Reunion, America/Martinique. |
| Detaillierte Protokolle (Debug) | boolean | Nein | Protokolliert jeden Schritt der PRONOTE-Abrufe. Passwörter und Tokens werden nie protokolliert. |
So installierst du PRONOTE in Gladys
- Öffne in Gladys Integrationen: PRONOTE erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-pronote:0.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-pronote.
PRONOTE benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
PRONOTE ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von prohand veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation