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, absences, messages, and calendars. The node allows users to perform various operations on different resources like Absence, Homework, Messages, Calendar, and Info.

Specifically, for the Absence resource with the List Homework operation, the node fetches a list of homework assignments related to absences or general homework data from the Librus system. This can be useful for educators, students, or administrators who want to automate retrieval of homework information within specified date ranges or other filters.

Practical examples include:

  • Automatically retrieving homework assignments for a class or student over a given period.
  • Integrating homework data into other systems or dashboards.
  • Filtering homework based on custom criteria or date ranges.

Properties

Name Meaning
Custom method name Advanced: override the underlying Librus API method to call (e.g., getMarks). If set, this method is called instead of the default one for the selected operation.

Note: Although only one property was provided, the node internally supports many parameters depending on the resource and operation, such as date ranges (from, to), paging, IDs, and others. For the "List Homework" operation specifically, it uses:

  • subjectId (number): ID of the subject to filter homework.
  • from (string, optional): Start date to filter homework.
  • to (string, optional): End date to filter homework.

These are inferred from the code but not explicitly listed in your input properties.

Output

The output is an array of JSON objects representing the homework entries retrieved from the Librus API. Each object corresponds to a single homework item with its associated details as returned by the API.

If the result is a single object, it is wrapped into an array with one element.

No binary data output is expected for the "List Homework" operation.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • Uses an internal client wrapper around the Librus API to perform calls.
  • Supports filtering results by date range using helper functions.
  • No external environment variables beyond the credentials are required.

Troubleshooting

  • No supported method found error: If the node cannot find a matching API method for the selected resource-operation or custom method name, it throws an error listing available methods. To fix, verify that the resource and operation names are correct and that any custom method name matches an existing API method.
  • Authentication errors: Ensure that the provided login and password credentials are correct and have sufficient permissions.
  • Empty results: Check date range filters (from, to) and subject IDs to ensure they match existing data.
  • API changes: Since the node relies on the Librus API client, any breaking changes in the API may require updating the node or client library.

Links and References

Discussion