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 in educational environments for managing school-related data such as messages, homework, absences, calendars, and grades. The node allows users to perform various operations on different resources within Librus.

Specifically, for the Absence resource with the List Receivers operation, the node retrieves a list of message receivers from the inbox system, filtered by a user group (e.g., teachers). This can be useful in scenarios where you want to programmatically obtain contact lists or recipients for messaging purposes within the school environment.

Practical examples include:

  • Automatically fetching all teacher contacts to send announcements.
  • Integrating absence notifications with other systems by retrieving relevant recipients.
  • Building custom workflows that require knowledge of who can receive messages in the Librus system.

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 operation.

Note: For the List Receivers operation, the node internally calls a method to list inbox receivers filtered by a user group, which defaults to "nauczyciel" (teacher).

Output

The output is an array of JSON objects representing the list of message receivers retrieved from the Librus inbox system. Each object corresponds to a receiver's details as returned by the API.

If the operation returns multiple items, each item is output as a separate JSON object in the array.

No binary data is produced for this operation.

Dependencies

  • Requires valid credentials for the Librus API, specifically a login and password.
  • Uses an internal client wrapper (LibrusClientWrapper) to communicate with the Librus API.
  • Supports an optional "custom method name" property to override the default API method called.
  • Date filtering utilities are available but not applied for this specific operation.

Troubleshooting

  • Error: No supported method found for resource "Absence" on librus-api client.
    This error indicates that the node could not find a matching API method for the requested resource-operation combination. Ensure that the resource and operation names are correct and supported by the node.

  • Authentication failures:
    Make sure the provided Librus API credentials (login and password) are correct and have sufficient permissions.

  • Empty or unexpected results:
    Verify the user group parameter (defaults to "nauczyciel") is appropriate for your use case. Changing it may affect the list of receivers returned.

  • Custom method name usage:
    If specifying a custom method name, ensure it exists and is callable on the underlying API client; otherwise, the node will throw an error listing available methods.

Links and References

Discussion