Adapter to get data from WebUntis
Dieser Adapter bezieht Daten aus Webuntis. Es ist ein Fork von https://github.com/Newan/ioBroker.webuntis - dort befindet sich auch eine Anleitung zur Einstellung.
Diese spezielle Variante ist vermutlich nur bei unserer Schule erforderlich und daher in erster Linie von persönlichen Interesse. Darum macht es wohl wenig Sinn, dies in den offziellen Adapter einfliessen zu lassen.
Leider ist es bei unserer Schule erforderlich, die Daten per anonymen Login und persönlichen Login abzuholen und diese Daten dann zu kombinieren.
Bei der Datenabfrage mit Login erhält man seinen persönlichen Stundenplan, allerdings fehlen sämtliche Informationen zu evtl. Vertretungen - nicht mal der Lehrer wird übertragen.
Bei der anonymen Abfrage bekommt man die Daten zum Ausfall, Vertretung oder Raumwechsel. Dabei werden auch der ursprüngliche Raum bzw. Lehrer mit übertragen.
Allerdings werden alle möglichen Unterrichtsfächer an dem jeweiligen Tag übertragen, also auch Kurse, die gleichzeit stattfinden und nicht vom Schüler gewählt wurden.
Das ist naturlich sehr unübersichtlich.
Aus diesen Gründen wurden jetzt beide Loginverfahren kombiniert. Erst wird eine persönliche Abfrage durchgeführt und alle Daten erzeugt. Dabei werden die Unterrichtsfächer zwischengespeichert. Dann erfolgt mit kurzer Verzögerung eine anonyme Abfrage. Dabei werden alle Unterrichtsfächer, die zuvor nicht gelesen wurden, übersprungen.
So erhält man komplette Information über den eigenen Stundenplan.
Die Schüler melden sich bei unserer Schule über IServ bei Webuntis an. D.h. es gibt keine Logindaten in der Form Username/Passwort.
In Webuntis kann man die einen QR anzeigen lassen und dort kann man auch ein Secret erhalten. Es gibt jetzt die Möglichkeit bei den Adaptereinstellungen mit Username/Secret anstelle Username/Passwort anzumelden.
Unsere Schule überträgt bei Lehrer- oder Raumwechsel den Ursprungsleherer bzw. Raum. Diese werden jetzt in zusätzlichen Datenpunkten gespeichert. Weiterhin wird auch der Unterrichtsname in Langform gespeichert.
Zur Darstellung in Vis habe ich ein Script erstellt, dass die Datenpunkte in einer Tabelle zusammen stellt. Die Daten werden als JSON erzeugt und können direkt mit der JSON Tabelle aus den Material Design Widget verwendet werden. Da ich zwei schulpflichtige Kinder habe, werden zwei Instanzen von webuntis ausgewertet (kann aber im Script leicht konfiguriert werden) zum Script...
Im Tabelle Widget muss nur die Spaltenanzahl auf 5 gesetzt werden, entsprechende Überschriften eingetragen werden und die Spaltenabstände auf 0 setzt werden (damit der Hintergrund vernünftig aussieht).
Das Script ist ansonsten recht einfach aufgebaut und funktioniert auch mit den Standardadapter. Es kann aber auch leicht als Vorlage für eigene Anpassungen benutzt werden.
Diese Version muss über die "Katze" installiert werden und ersetzt den Standardadapter, falls installiert.
- (inbux) login two times - anonymous and using a password/secret to get all needed data
- (inbux) added login using username & secret
- (inbux) added some more states
- change log-level for error messages
- Add errorhandling for timetable
- Add errorhandling for inbox & mesage center
- Bug fixes in timetable
- Add Inbox peview data
- Add anonymous login
- Add nextDay
- Add code element
- (Newan) initial release
MIT License
Copyright (c) 2024 Inbux inbux.development@gmail.com
Copyright (c) 2022 Newan info@newan.de
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.