Librus icon

Librus

Read data from Librus Synergia (unofficial)

Overview

This node integrates with the Librus API, a platform commonly used by schools for managing educational data such as messages, absences, homework, calendar events, and grades. The node allows users to perform various operations on different resources within the Librus system.

Specifically, for the Absence resource with the Get Message operation, the node retrieves detailed information about a particular absence message or multiple absence records. This can be useful for educators, administrators, or parents who want to programmatically access absence details from the Librus platform.

Practical examples include:

  • Automatically fetching absence records for a student over a date range.
  • Retrieving details of a specific absence message by its ID.
  • Integrating absence data into other school management or reporting systems.

Properties

Name Meaning
Custom method name (Advanced) Override the default underlying API method to call (e.g., getMarks). If left empty, the node uses the standard method mapped to the operation.

Note: Although only one property is explicitly provided, the node internally supports many parameters depending on the resource and operation, such as absenceId, from, to, etc. For the Absence resource and Get Message operation, the key input is typically the absenceId to specify which absence record to retrieve.

Output

The output is a JSON object or an array of JSON objects representing the data returned from the Librus API for the requested absence message(s). The structure depends on the API response but generally includes fields describing the absence details.

If multiple absence IDs are provided as input, the output will be an array of absence objects.

No binary data output is associated with this operation.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • Uses an internal client wrapper to communicate with the Librus API.
  • Supports optional filtering of results by date range (from and to parameters).
  • No additional external dependencies beyond the configured API credentials.

Troubleshooting

  • Error: No supported method found for resource "Absence" on librus-api client.
    This indicates that the node could not find a matching API method for the given resource-operation combination or custom method override.
    Resolution: Verify that the resource and operation names are correct and that any custom method name provided matches an existing API method.

  • Authentication errors:
    Ensure that the provided login and password credentials are correct and have sufficient permissions in the Librus system.

  • Empty or unexpected output:
    Check if the specified absence ID(s) exist and that any date filters are correctly set. Also verify network connectivity to the Librus API.

Links and References

  • Librus Official Website (for general platform info)
  • Documentation for the Librus API is not publicly available; consult your organization's Librus administrator for API details.

Discussion