EcoleDirecte Smart-Home-Integration, kostenlos und Open Source

Noten, Hausaufgaben, Stundenplan, Fehlzeiten und Nachrichten von EcoleDirecte.

• Veröffentlicht von prohand
• Geräte
• Version 1.0.1
• Erfordert Gladys >=5.1.0
• ★ 0

Auf GitHub ansehenAlle Integrationen

Diese Integration verbindet Gladys mit EcoleDirecte, der Online-Schulplattform vieler französischer weiterführender Schulen. Für jedes Kind, dem das Konto folgt, liest sie Noten und Durchschnitte, Hausaufgaben, den Stundenplan, Fehlzeiten und Verspätungen sowie das Postfach.

Sie arbeitet über das Internet (Badge Cloud): In deinem Netzwerk muss nichts installiert werden.

Konfiguration

1. Öffne den Reiter Konfiguration der Integration.
2. Gib den Benutzernamen und das Passwort ein, die du auf ecoledirecte.com verwendest. Ein Elternkonto liefert alle Kinder, ein Schülerkonto den Schüler selbst.
3. Optionale Einstellungen:
   • Aktualisierungsintervall: standardmäßig alle 30 Minuten (mindestens 10 Minuten);
   • Zeitzone der Schule: standardmäßig Europe/Paris. Nur für eine Schule außerhalb des französischen Festlands ändern (America/Martinique, Indian/Reunion…);
   • Sprache der Gerätenamen: die Sprache der Namen, die beim Anlegen der Geräte geschrieben werden.
4. Speichere und klicke dann auf Verbindung testen.

Die Sicherheitsfrage

Beim ersten Mal verlangt EcoleDirecte oft, das Gerät mit einer Frage zu bestätigen (zum Beispiel „Was ist dein Geburtsjahr?“). Der Status der Integration zeigt das an. Dann:

1. klicke auf Sicherheitsfrage abrufen: Die Frage und die nummerierten möglichen Antworten erscheinen unter der Schaltfläche;
2. gib innerhalb von 10 Minuten die Nummer der richtigen Antwort (oder ihren Text) unter Sicherheitsfrage beantworten ein.

Die Integration speichert die Antwort: Die Frage wird bei den nächsten Starts nicht mehr gestellt. Falls EcoleDirecte sie eines Tages erneut stellt, wiederhole diese beiden Schritte.

Geräte

Jedes Kind erscheint im Reiter Erkennung; füge es hinzu. Seine Funktionen:

Funktion	Inhalt
Gesamtdurchschnitt	Durchschnitt des laufenden Zeitraums (von 20)
Letzte Note (/20)	Zuletzt eingetragene Note, auf 20 umgerechnet
Letzte Note	Als Text: „MATHEMATIQUES : 15/20 (Contrôle chap. 3)“
Hausaufgaben für morgen	Nicht erledigte Hausaufgaben für morgen
Offene Hausaufgaben	Nicht erledigte, noch anstehende Hausaufgaben
Nächste Stunde	„08:00 MATHEMATIQUES (S12)“, mit dem Tag, wenn nicht heute
Fehlzeiten / Verspätungen	Anzahl im Schuljahr
Ungelesene Nachrichten	Ungelesene Nachrichten im Postfach des Kontos

Wenn die Schule ein Modul abschaltet (zum Beispiel die Noten), bleibt die entsprechende Funktion leer. Veröffentlicht die Schule keinen Gesamtdurchschnitt, berechnet ihn die Integration aus den Noten: Durchschnitt jedes Fachs (mit den Koeffizienten), dann Durchschnitt der Fächer.

Szenen (Gladys 5.1 oder neuer)

Auslöser

• Neue Note: Variablen subject, assignment, grade, out_of, grade_20, date, student_name.
• Neue Hausaufgabe: subject, due_date, is_test.
• Neue Fehlzeit oder Verspätung: Filter nach Art; kind, date, label, justified.
• Stunde entfällt: eine kommende Stunde wurde gestrichen; subject, date, start, end, teacher.
• Neue Nachricht: from, subject, date.

Jeder Auslöser kann nach einem Schüler gefiltert werden. Beim ersten Start erfasst die Integration das bereits Vorhandene, ohne etwas auszulösen.

Aktionen

• EcoleDirecte aktualisieren: liest EcoleDirecte sofort.
• Hausaufgaben abrufen (heute, morgen, nächster Schultag): count, tests, subjects, summary (der Inhalt der Hausaufgaben, bereit zum Versenden).
• Stundenplan abrufen: has_lessons, first_start, first_subject, last_end, lesson_count, cancelled_count — genug, um den Wecker auf die erste Stunde zu stellen.

Beispiel: jeden Abend um 19 Uhr „Hausaufgaben abrufen“ für morgen, dann summary per Telegram senden, wenn count größer als 0 ist.

Widgets (Gladys 5.1 oder neuer)

• Schulübersicht: Durchschnitt, letzte Note, Hausaufgaben für morgen und ungelesene Nachrichten live, nächste Stunde, Fehlzeiten und Verspätungen.
• Hausaufgaben: die offenen Hausaufgaben mit ihrem Inhalt.
• Stundenplan: die Stunden eines Tages, entfallene markiert.

Wähle den Schüler in den Widget-Einstellungen.

Fehlerbehebung

• „EcoleDirecte hat den Benutzernamen oder das Passwort abgelehnt“: Prüfe sie auf ecoledirecte.com.
• „Die Schule ist nicht verfügbar“: EcoleDirecte sperrt den Zugang oft in den Ferien; die Integration versucht es von selbst erneut.
• „EcoleDirecte hat die API-Version abgelehnt“: Aktualisiere die Integration.
• Die Logs der Integration zeigen nie das Passwort.

Konfigurationseinstellungen

Diese Einstellungen fragt EcoleDirecte in seinem Konfigurationsbildschirm in Gladys ab.

Einstellung	Typ	Pflichtfeld	Beschreibung
Erste Schritte	section	Nein	Verwende den Benutzernamen und das Passwort, die du auf ecoledirecte.com eingibst (Eltern- oder Schülerkonto). Beim ersten Mal kann EcoleDirecte eine Sicherheitsfrage stellen: Beantworte sie mit den beiden Schaltflächen unter dem Formular. Jedes Kind erscheint dann im Reiter „Erkennung“.
Benutzername	string	Ja	Dein EcoleDirecte-Benutzername.
Passwort	secret	Ja	Dein EcoleDirecte-Passwort. Es wird nur an EcoleDirecte gesendet und nie protokolliert.
Aktualisierungsintervall (Min.)	number	Nein	Wie oft EcoleDirecte gelesen wird, in Minuten (10 bis 720).
Zeitzone der Schule	string	Nein	Wird für „heute“, „morgen“ und die Unterrichtszeiten verwendet. Nur für eine Schule außerhalb des französischen Festlands ändern, z. B. America/Martinique.
Sprache der Gerätenamen	select	Nein	Sprache der Funktionsnamen, die beim Anlegen des Geräts eines Schülers geschrieben werden.

So installierst du EcoleDirecte in Gladys

1. Öffne in Gladys Integrationen: EcoleDirecte erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/prohand/gladys-ecoledirect:1.0.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/prohand/gladys-ecoledirecte.

EcoleDirecte 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

EcoleDirecte 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

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂