Librus icon

Librus

Read data from Librus Synergia (unofficial)
Join our community

Actions105

Overview

This node integrates with the Librus API, a platform commonly used by schools for managing educational data such as homework, messages, absences, and calendars. Specifically, the Homework - Get Timetable operation retrieves the timetable data from the calendar resource within a specified date range.

Typical use cases include:

  • Fetching a student's or class's timetable for a given period.
  • Automating schedule retrieval to integrate with other systems like personal calendars or notification services.
  • Monitoring changes in the timetable over time.

For example, a teacher could use this node to automatically pull their weekly timetable and send reminders or updates to students.

Properties

Name Meaning
From Optional start date (format: YYYY-MM-DD) to filter timetable entries from this date.
To Optional end date (format: YYYY-MM-DD) to filter timetable entries up to this date.
Custom method name Advanced option to override the default API method called (e.g., specify a different method name).

Output

The output is an array of JSON objects representing timetable entries retrieved from the Librus calendar. Each object corresponds to a scheduled event or lesson within the specified date range.

The exact structure depends on the Librus API response but typically includes details such as:

  • Date and time of the lesson or event.
  • Subject or activity name.
  • Location or classroom.
  • Teacher or instructor information.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • The node uses an internal client wrapper to communicate with the Librus API.
  • No additional external dependencies beyond the configured API credentials.

Troubleshooting

  • No supported method found error: If the node throws an error indicating no supported method was found for the resource-operation combination, verify that the "Resource" is set to "Homework" and "Operation" to "Get Timetable". Also, ensure the custom method name property is either empty or correctly matches a valid API method.
  • Authentication errors: Ensure the provided API credentials are correct and have sufficient permissions.
  • Empty results: If no timetable entries are returned, check the date range ("From" and "To") parameters; they may be filtering out all data.
  • Date format issues: Dates must be in YYYY-MM-DD format. Incorrect formats may cause unexpected behavior or errors.

Links and References

Discussion