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

Specifically, for the Absence resource and the Get Event operation, the node retrieves detailed information about calendar events, which can include absences or other scheduled items. This is useful for educators, administrators, or students who want to programmatically access event details from their school calendar.

Practical examples:

  • Automatically fetching absence events for a student over a date range.
  • Integrating school calendar events into external scheduling or notification systems.
  • Generating reports based on attendance events.

Properties

Name Meaning
Custom method name (Optional) Override the default underlying API method to call. For example, specify a custom method like getMarks instead of the standard one.

Note: Although only the "Custom method name" property is explicitly provided, the node internally supports many other parameters depending on the resource and operation, such as eventId, eventIsAbsence, from, to, etc., but these are not exposed here.

Output

The output is an array of JSON objects representing the retrieved event(s). Each object contains the details of a calendar event fetched from the Librus API. If multiple input items are processed, the output will be an array of event objects corresponding to each input.

The structure of each event object depends on the Librus API response but typically includes fields such as event ID, title, date/time, description, and whether the event is marked as an absence.

No binary data output 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.
  • The node expects the user to configure these credentials securely in n8n before execution.

Troubleshooting

  • Error: No supported method found for resource "Absence" on librus-api client.
    This indicates that the requested operation or custom method name does not match any available API methods. Verify the operation name and ensure the custom method name (if used) is correct.

  • Authentication failures:
    Ensure that the provided login and password credentials are correct and have sufficient permissions to access the requested data.

  • Empty or unexpected results:
    Check if the event IDs or date ranges specified actually correspond to existing events in the Librus system.

  • Handling multiple inputs:
    When providing multiple event IDs, the node fetches each event individually and returns an array of results. Make sure input data is correctly structured.

Links and References

Discussion