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. It allows users to retrieve various types of information such as messages, homework, absences, calendar events, and grades from a Librus account.

Specifically, the Absence - Get Homework operation fetches detailed information about a particular homework assignment identified by its ID. This can be useful for educators or students who want to programmatically access homework details within automated workflows, such as syncing assignments with other tools, generating reports, or sending reminders.

Practical examples:

  • Automatically retrieving homework details for a specific assignment to include in a weekly summary email.
  • Integrating homework data into a personal planner or task management system.
  • Monitoring homework updates and triggering notifications when new homework is assigned.

Properties

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

Note: The node also internally uses other parameters depending on the resource and operation, but only the above property was provided explicitly.

Output

The output is an array of JSON objects representing the data returned by the Librus API for the requested operation.

For the Absence - Get Homework operation, the output JSON contains the detailed information about the specified homework assignment. The exact structure depends on the Librus API response but typically includes fields such as homework description, due date, subject, and any related metadata.

If multiple input items are processed, the node returns an array of homework objects corresponding to each input item.

No binary data output is produced for this operation.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • 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:
    This error occurs if the node cannot find a matching method in the Librus API client for the selected resource and operation. To resolve, verify that the resource and operation names are correct and supported by the node. Using the "Custom method name" property incorrectly may also cause this issue.

  • Authentication errors:
    Ensure that the provided Librus API credentials (login and password) are correct and have sufficient permissions.

  • Empty or unexpected results:
    Check the input parameters such as homework ID to ensure they correspond to existing data in the Librus account. Also, verify date filters if used.

  • Handling multiple inputs:
    When processing multiple absence IDs or homework IDs, the node calls the API for each item individually and aggregates results. Large batches may lead to rate limiting or timeouts.

Links and References

Discussion