Zum Hauptinhalt springen

iNoé Espace Famille Smart-Home-Integration, kostenlos und Open Source

iNoé Espace Famille-Integration für Gladys Assistant

Rechnungen, Buchungen und Neuigkeiten Ihres iNoé-Familienportals (Kantine, Hort, Krippe).

Diese Integration verbindet Gladys mit Ihrem iNoé Espace Famille (dem Familienportal von AIGA, das viele französische Gemeinden und Einrichtungen nutzen: Schulkantine, Hort, Freizeitzentrum, Krippe). Sie liest, wie Sie es im Portal tun würden:

  • den offenen Betrag und die anstehenden Rechnungen;
  • die Buchungen jedes Kindes (heute, morgen, die folgenden Tage);
  • die Neuigkeiten der Einrichtung;
  • die Anzahl der Dokumente, auf die die Einrichtung wartet.

Die Integration liest nur: Sie bucht, storniert oder bezahlt nie etwas. Zahlungen und Buchungen bleiben im Portal.

Es ist eine Cloud-Integration: Sie läuft über die Server von AIGA im Internet. Gladys braucht also Internetzugang.

Gladys 5.3 oder neuer ist erforderlich.

Konfiguration​

Öffnen Sie in Gladys Integrationen, installieren Sie iNoé Espace Famille und füllen Sie den Konfigurationsbildschirm aus:

FeldWas einzutragen ist
PortaladresseDie Adresse der Anmeldeseite des Portals, unverändert kopiert: https://espacefamille.aiga.fr/index.html?dossier=1626256#connexion… oder https://espacefamille.aiga.fr/11578177. Die Nummer allein (1626256) geht auch.
E-MailDie E-Mail, mit der Sie sich im Portal anmelden.
PasswortDas Passwort des Portals. Es wird nur an den Anmeldeserver von AIGA gesendet und nie in die Protokolle geschrieben.
Aktualisierungsintervall (min)Wie oft das Portal gelesen wird, in Minuten (standardmäßig 60, von 15 bis 1440).
Rechnungserinnerung (Tage)Wie viele Tage vor der Fälligkeit der Auslöser „Eine Rechnung wird bald fällig“ ausgelöst wird (standardmäßig 3).
Vorausgelesene Planung (Tage)Wie viele Tage der Planung jedes Kindes gelesen werden, heute eingeschlossen (standardmäßig 7).
ZeitzoneWas „heute“ und „morgen“ bestimmt: standardmäßig Europe/Paris, Indian/Reunion, America/Martinique… für die Überseegebiete.

Klicken Sie auf Verbindung testen: Die Antwort nennt die Einrichtung, den offenen Betrag und für jedes Kind die gebuchten Tage und die nächste Buchung.

Öffnen Sie dann den Reiter Erkennung der Integration und legen Sie die Geräte an.

Wo steht die Portaladresse? In der E-Mail zur Kontoerstellung Ihrer Einrichtung, oder in der Adresszeile Ihres Browsers im Portal: Es ist die Zahl nach dossier= (oder nach espacefamille.aiga.fr/).

Geräte​

Die Familie​

Ein Gerät mit dem Namen der Einrichtung (und Ihrer Familie):

FunktionWert
Amount dueNoch zu zahlender Betrag, in Euro
Unpaid invoicesAnzahl der zu zahlenden Rechnungen
Next due dateFälligkeitsdatum der nächsten Rechnung (JJJJ-MM-TT)
Documents expectedAnzahl der Dokumente, auf die die Einrichtung wartet
Latest newsTitel der letzten Neuigkeit der Einrichtung

Jedes Kind​

Ein Gerät pro Kind („Léa – iNoé“):

FunktionWert
Booked today1, wenn das Kind heute mindestens eine Buchung hat, sonst 0
Booked tomorrow1, wenn das Kind morgen mindestens eine Buchung hat, sonst 0
TodayDie heute gebuchten Aktivitäten („Accueil de loisirs : Matin, Repas, Après-midi“)
TomorrowDie morgen gebuchten Aktivitäten
Days booked aheadAnzahl der gebuchten Tage im gelesenen Zeitraum

Eine Abwesenheit oder ein Wartelistenplatz zählt nicht als Buchung.

Jedes Gerät zeigt das Abzeichen Cloud; es wechselt zu nicht erreichbar, wenn das Portal nicht antwortet.

Szenen-Auslöser​

Wählen Sie in einer Szene den Auslöser Integrationen → iNoé Espace Famille:

SchlüsselWannVariablen
new_invoiceEine neue zu zahlende Rechnung erscheintnumber, label, structure, amount, due_date
invoice_due_soonEine Rechnung wird bald fällig (einmal pro Rechnung)dieselben + days_left
booking_changedEine Aktivität wird in der Planung eines Kindes gebucht oder storniertchild_name, date, activity, change (booked/cancelled)
new_messageDie Einrichtung veröffentlicht eine neue Nachrichttitle, date

booking_changed lässt sich nach Kind und Art der Änderung filtern. In den folgenden Aktionen verwenden Sie zum Beispiel {{triggerEvent.data.amount}}.

Beim allerersten Lesen eines Kontos wird nichts gemeldet (sonst wäre jede vorhandene Rechnung „neu“) — außer einer Rechnung, die bereits bald fällig ist.

Szenen-Aktionen​

SchlüsselWas sie tutErgebnisse
refreshLiest das Portal sofort, ohne auf das Intervall zu wartenamount_due, unpaid_invoices
check_bookingSagt, ob ein Kind heute oder morgen gebucht ist, und für welche Aktivitätenbooked, activities

Beispiel: jeden Abend um 20 Uhr check_booking für Léa, morgen; wenn booked wahr ist, „Morgen: {{…activities}}“ über Telegram senden.

Dashboard-Widget​

Das Widget Familienbereich (family_space) zeigt den offenen Betrag (live), die nächste Rechnung (orange, wenn die Fälligkeit naht, rot, wenn sie überschritten ist), den Tag jedes Kindes heute und morgen sowie die erwarteten Dokumente. Die Schaltfläche Aktualisieren liest das Portal erneut; Portal öffnen öffnet Ihr Espace Famille.

Das Widget Nächste Buchungen (upcoming_bookings) listet die gebuchten Tage der kommenden Tage auf (Einstellung Vorausgelesene Planung (Tage)), eine Karte pro Tag, höchstens 8: die gebuchten Kinder und ihre Zeitfenster, „Heute“ und „Morgen“ farbig. Tippen Sie auf eine Karte, um die Aktivitäten jedes Kindes vollständig zu sehen. Es hat dieselben Schaltflächen Aktualisieren und Portal öffnen.

Fehlerbehebung​

MeldungWas tun
„Diese Portaladresse ist iNoé unbekannt“Kopieren Sie die Adresse erneut aus der E-Mail Ihrer Einrichtung.
„Das Portal hat die E-Mail oder das Passwort abgelehnt“Melden Sie sich im Portal selbst an; hat sich das Passwort geändert, aktualisieren Sie es in Gladys.
„Das iNoé-Portal wird gewartet“Nichts zu tun: Neuer Versuch bei der nächsten Aktualisierung.
Ein Kind zeigt „Planung nicht lesbar“Die Einrichtung hat vielleicht eine Aktivität geschlossen. Die übrigen Angaben bleiben aktuell.

Das Portal hat keine öffentliche API: Die Integration nutzt dieselben Abläufe wie die Website. Ändert AIGA seine Website, kann ein Update der Integration nötig sein.

Datenschutz​

  • Das Passwort wird nur an ism.aiga.fr (den Anmeldeserver von AIGA) gesendet.
  • Es wird nichts anderswohin gesendet als an die Server von AIGA und an Ihr Gladys.
  • Nur ein kleines Gedächtnis (Rechnungs- und Nachrichtennummern, bereits gesehene Buchungen) wird im Volume /data der Integration gespeichert, damit nichts doppelt gemeldet wird.

Konfigurationseinstellungen​

Diese Einstellungen fragt iNoé Espace Famille in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Erste SchrittesectionNeinVerwenden Sie dieselbe Adresse, E-Mail und dasselbe Passwort wie im iNoé-Familienportal Ihrer Gemeinde oder Einrichtung. Die Integration liest nur: Sie bucht, storniert oder bezahlt nie etwas. Sie spricht über das Internet mit den Servern von AIGA (Cloud).
PortaladressestringJaFügen Sie die Adresse der Anmeldeseite des Portals ein, z. B. https://espacefamille.aiga.fr/index.html?dossier=1626256 oder https://espacefamille.aiga.fr/11578177 — oder nur diese Nummer.
E-MailstringJaDie E-Mail, mit der Sie sich im Portal anmelden.
PasswortsecretJaDas Passwort des Portals. Es wird nur an den Anmeldeserver von AIGA gesendet und nie in die Protokolle geschrieben.
Aktualisierungsintervall (min)numberNeinWie oft das Portal gelesen wird, in Minuten (15 bis 1440).
Rechnungserinnerung (Tage)numberNeinDer Auslöser „Rechnung bald fällig“ wird einmal pro Rechnung so viele Tage vor der Fälligkeit ausgelöst (0 = am selben Tag).
Vorausgelesene Planung (Tage)numberNeinWie viele Tage der Planung jedes Kindes gelesen werden, heute eingeschlossen (1 bis 31).
ZeitzonestringNeinDie Zeitzone der Familie, die bestimmt, was „heute“ und „morgen“ ist. Ein IANA-Name wie Europe/Paris oder Indian/Reunion.

So installierst du iNoé Espace Famille in Gladys​

  1. Öffne in Gladys Integrationen: iNoé Espace Famille 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-inoeespacefamille: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-inoeespacefamille.

iNoé Espace Famille benötigt Gladys >=5.3.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​

iNoé Espace Famille 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.

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 🙂