node-red-contrib-aula-education

Node-Red Node for collecting data from aula the danish educational platform.

Still under development. Not all aspects are tested yet

This node is based on the home assistant unoffical (hacs) addon to get Aula data made by scaarup https://github.com/scaarup/aula. But converted to javascript and put into a node-red node.

A lot of data is returned form API. Some examples on how to parse the incoming data is added.

Login

You will need to create a Unilogin from here https://www.aula.dk/portal/#/login choose to create a username and then a password. As aula knows a lot of personal stuff about both parents and thier kids(names, address and more) dont take security lightly and preferably use a password generator and to make a long password as you dont need to remember it by heart. Node-red will store it encrypted.

Usage

How to import: Menu top right -> Import -> Examples -> node-red-contrib-nibeuplink -> basic

The node

Example of what is returned in home assistant as state info in the daily overview. The same and more info is returned by this node.

location: null
sleepIntervals:
  - id: 61297321
    startTime: '12:00:00'
    endTime: '13:00:00'
checkInTime: '07:38'
checkOutTime: '15:34'
activityType: 0
entryTime: '07:30'
exitTime: '16:00'
exitWith: {Person name}
comment: null
spareTimeActivity: null
selfDeciderStartTime: null
selfDeciderEndTime: null
profilePicture: >-
  https://media-prod.aula.dk/12345/13456/1mk23j1_400x400.jpg?response-content-disposition=attachment%3Bfilename%3D%21315sa3fa4_400x400.jpg%22&Expires=1692734400&Signature=asdaasdaULlo2-5ksfsd79XTfdsix4lr-2IsfsdfF7~G7VEsdfsdSclbCxJV~hoSu2n0AZTQQWYL3R0-QhIgz-UoBSCtpnM6A7qPuPBcf6qBz-XeJsdfsdKsZCwA5fsdfcTsqWMI1nVsP5YN7h6SuRZgOVxC3kCyykozW4UYXks~3yJbN3jkD6tlsyPYDw2aeYQ6vPE0KnRwPJJZTb3QncPG2NC9kJnX8W4dfhfdhsadpyGTCKXwQ~5r8P3p-~w0H62ig42dy-VKNZUDH4IsVimPasdghrhd345n55R0TiflCf5MsFfnb2g__&Key-Pair-Id=asdaKAILBPEasdasd1234IBROXQ
icon: mdi:account-school
friendly_name: {Institusion name} {First name}

Support of API calls

The origianl python addon made by scaarup for home assistant does support more then what I converted and tested here. PRs are welcomed. What is converted and what is not:

| Function | Convered to JS | |---|:---:| | Get daily overview | Yes | | Get unread messages | Yes | | (Untested)Get calendar | Yes | | "Ugeplaner" | No | | "Huskelisten" | No |

Extra functions not found in python version: Get posts, notifications and mark messages as read.