MMM-Webuntis

[thk]

@HeikoGr
Perfect!
Thank you so much for this fast feature implementation, exactly what I was looking for.

[HeikoGr]

Attention / Important

(for our school) Untis GmbH changed url and schoolname.
You may need to log in your (childrens) account(s) an edit the config.js according to the new values.

At least they didn’t switch off te old json-rpc api MMM-Webuntis is using

[AlexLin]

@schmucke, @HeikoGr
I have the same situation and i finally managed to receive the timetable for my daughter by using parents account. She did not register herself for Webuntis so no chance. I made a research on the module and the webuntis API.

By concept the function

getOwnClassTimetableForRange(rangeStart, rangeEnd);

must fail, because the parents account does not have an own timetable. So I used the function

getTimetableForRange(rangeStart, rangeEnd, id, WebUntisElementType.STUDENT);

The trick was to determine which “id” is to use. The id is meant as student’s id, in my case of my daughter. So I had to make a detour via

const studentList = await untis.getStudents();

I made a debug output of studentList to console and searched for the name of my daughter and found the id I needed for the function above. This list is very long because it showed all students of school (more than one thousand).
Afterwards I could use the function and received her timetable successfully.
It only worked by login with username & pass not by qrcode and only by hardcoded id because I did not find a filter method for the studentList, e.g. by name, etc. If available it should be possible not hardcoded but by config - Param.

[HeikoGr]

that’s great - i will look how i may use this in my module.
Thank you

[Rondejavu]

Ein guten Morgen,

ich benutze Ihr WebUntis nun schon seid geraumer Zeit.

Leider musste ich feststellen das seid ca. 2Wochen keine Verbindung mehr zu WebUntis stattfindet.
mir wird jedes mal Error code 404 angezeigt.
Was ich mir leider nicht vorstellen kann, da ich es auch über Handy nutze und dort alle Termine sowie den Stundenplan einsehen kann.

Es wäre nett wenn ich dafür etwas Hilfe bekommen könnte damit dies wieder angezeigt wird.

MfG
Krause

[HeikoGr]

@Rondejavu gerne:

Ich vermute, dass die Antwort schon hier im Forum ca. 3 Beiträge obendrüber steht. Untis hat an den Servern gearbeitet - evtl. müssen hier die Verbindungsparamter neu eingestellt werden.

[Rondejavu]

@HeikoGr Moin,

ja das ist mir klar … aber welche … da ich nur Zugang mit Benutzer und Passwort habe und keinen QR code … und auf der Website gibt es auch keinen link mehr um es iwie extern zu teilen bzw. der link funktioniert nicht in dem Modul … daher meine frage was ich jetzt machen soll …

ich danke dir schon mal im voraus

[HeikoGr]

@Rondejavu

• Bei webuntis mit dem Schüleraccount anmelden.
• Links unten auf den Account Namen klicken
• Im rechten Panel auf “Freigaben” gehen
• Dort gibt es den Link zum QR Code mit allen Paramtern für MMM-Webuntis.

eine andere Anmeldemethode (über die Elternaccounts) habe ich leider noch nicht erfolgreich implementieren können.

[Rondejavu]

@HeikoGr

Nabend …

wir haben nur einen Zugang, dann denke ich das wir nur den Elternzugang habe. Denn ich habe unten links leider keine möglichkeit irgendeinen QR-Code erstellen zu lassen.

Anbei mal ein Bild was ich zu sehen bekomme …

Danke im Voraus und falls man sich nicht liest … schöne Feiertage …

[HeikoGr]

@Rondejavu Danke, dir auch schöne Feiertage.

Ich arbeite bereits an einer massiven Überarbeitung.
Dann sollte auch ein direkter Login funktionieren.

Wenn ihr aber einen Zugang für die ganze Klasse habt (keine eigenen Benutzernamen) kann es sein, dass du mir helfen musst das lauffähig zu bekommen, da ich keine Testmöglichkeit habe Klassenaccounts zu testen.

[Rondejavu]

@HeikoGr Frohe Weihnachten

klar helfe dir gerne … meld dich einfach und dann schauen wir mal …

[HeikoGr]

Hello everyone,

version 0.5.0. of my MMM-Webuntis module is out.
Major improvement: you don’t need the student based login anymore.

Please read the detailed readme.
unfortunately I am not able to test any edge case myself.

[RobertMuc]

Hallo @heikogr.

Danke für die Arbeit und die ganzen Updates der letzten Tage …

Die haben mich leider nur rein bisschen überfordert. Was für einen displayMode muss ich denn einstellen, dass ich wieder nur die Stundenausfälle sehe - also wirklich nur eine Info, wenn eine Stunde ausfällt. Hab leider nicht allzuviel Platz für die Grid View auf meinem MM, sonst würde ich die natürlich nehmen.

DANKE!!!

Schönen Abend.
Robert

[HeikoGr]

@RobertMuc

Du hast recht, die vielen Möglichkeiten machen alles sehr unübersichtlich. Sorry. Die Schule meiner Kinder nutzt Umtis ziemlich viel - daher will ich so viel wie möglich anzeigen lassen können. Die meisten Optionen sind jedoch optional. Du kannst dich langsam heranarbeiten.

Eigentlich solltest du nichts ändern müssen. Per default sollten lessons und exams (also Ausfälle und Klassenarbeiten) angezeigt werden.

So sieht es mit Elternaccount aus. Angezeigt werden dann die ausfallenden stunden heute und morgen von allen Kinder:

        {
            module: "MMM-Webuntis",
            header: "Stundenplanänderungen ",
            position: "top_right",
            config: {
                updateInterval: 5 * 60 * 1000,

                username: 'USERNAME',
                password: 'PASSWORT',
                school: 'SCHULE',
                server: 'SCHULE.webuntis.com',

                displayMode: 'lessons',
                lessons: {
                      nextDays: 1, // widget-specific days ahead
                    },

            }
        },

Wenn du einen Schüler spezifischen qr login hast, bleibt dieser im students object stehen - wie bisher. Der eltern Block fällt dann weg.

[HeikoGr]

@RobertMuc achso, ganz vergessen zu erwähnen: ich hab auch sehr wenig Platz (oder zu viele Informationen) auf meinem display. Aus dem Grund setze ich das wundervolle Modul MMM-Carousel ein. Das Grid ist dann auf Seite 2.

[RobertMuc]

Danke Heiko für die schnelle Antwort. Ich hatte tatsächlich das lessons Objekt falsch. Danke auch nochmal für den Hinweis mit dem Carousel. Sehr gute Idee.

Gruß und Danke!!!

Robert

[RobertMuc]

Hi @Heikogr ,

wieder mal ich. Bei uns gibt es leider keinen ElternAccount. Habe aber 3 Kinder mit 3 mal den direct credentials. Funktioniert eigentlich alles, aber es bleibt halt leer… Any idea?

Hier mal ein Auszug aus dem Log.

[DEBUG] [lib] [AuthService] REST auth token obtained successfully
[DEBUG] [lib] [AuthService] Student login (direct credentials): personId=5500 = studentId (same person)
[INFO] 👤 Login PersonId: 5500
[INFO] ⚠️ No valid studentId resolved (check config)
Gruß
Robert

[RobertMuc]

BTW, ich fand MMM-Pages, da man damit besser gleiche Module auf unterschiedliche Pages verteilen kann (z.B. unterschiedliche Google Sheets, oder calendar).

Robert

[HeikoGr]

Hallo,

das ist ein Fall den ich leider so nicht nachvollziehen kann, da wir einen Eltern Account haben und unsere Kinder sich per Office365 anmelden.

das Problem ist, dass das Modul die studentId braucht, mit dem login aber erstmal nur die personId bekommt.

du hast jetzt folgende Möglichkeiten:

• die neueste Version ausprobieren (ich habe sehr viel geändert die letzten Tage) - es kann sein, dass es damit schon funktioniert
• Für jedes Kind in untis einloggen und einen qrcode erzeugen - dann kannst du diesen qrcode string in die config.js eintragen (der weg funktioniert ziemlich sicher!), oder:
• im webuntis.com die studentId rausbekommen (steht zum Beispiel in der URL bei "Mein Stundenplan) und diese in der config.js hinterlegen (könnte funktionieren), oder:
• in der Developer Ansicht im Browser (F12 drücken) im Tab Netzwerk die Response von der Resource “data” mir zur Verfügung stellen. Achtung: vorher alle sensiblen Daten entfernen. Der markierte Bereich (currentSchoolYear) ist nur ein winziger Teil der Daten)

[HeikoGr]

@RobertMuc geht mit MMM-Carousel auch, aber soweit ich weiss ist das mit Pages tatsächlich einfacher. Ich bleibe trotzdem bei Carousel 😎