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 messages, homework, absences, calendar events, and grades. The node allows users to perform various operations on different resources within Librus.

Specifically, the Homework - List Announcements operation fetches announcements related to homework from the user's Librus account. It supports filtering these announcements by optional date ranges.

Practical scenarios where this node is beneficial include:

  • Automatically retrieving recent homework announcements to display or process in workflows.
  • Filtering announcements within specific date ranges to track assignments over time.
  • Integrating homework-related notifications into other systems like calendars or messaging platforms.

Properties

Name Meaning
From Optional start date (YYYY-MM-DD) to filter announcements from this date onwards.
To Optional end date (YYYY-MM-DD) to filter announcements up to this date.
Custom method name Advanced: override the default underlying API method called (e.g., to use a custom method).

Output

The output is an array of JSON objects representing the homework announcements retrieved from the Librus API. Each object corresponds to one announcement and contains its details as provided by the API.

If no announcements are found, the output will be an empty array.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • Uses an internal client wrapper to communicate with the Librus API.
  • The node expects the environment to have network access to the Librus service.

Troubleshooting

  • No supported method found error: This occurs if the specified resource-operation combination does not match any available API methods. Ensure that the Resource is set to "Homework" and Operation to "List Announcements" or provide a valid custom method name.
  • Authentication errors: If login credentials are incorrect or missing, the node will fail to authenticate. Verify the API key or login/password credentials.
  • Date format issues: The "From" and "To" properties must be in YYYY-MM-DD format. Invalid formats may cause filtering to fail or return unexpected results.
  • Empty results: If no announcements appear, check that the date filters are correct and that there are announcements in the specified range.

Links and References

Discussion