Librus icon

Librus

Read data from Librus Synergia (unofficial)

Overview

This node integrates with the Librus API, a platform commonly used in educational environments for managing school-related data. Specifically, the "Calendar" resource with the "Get Absences" operation retrieves absence records from the user's calendar. This is useful for educators, students, or administrators who want to programmatically access absence information within a specified date range.

Practical examples include:

  • Automatically generating reports of student absences over a period.
  • Triggering notifications or workflows when new absences are recorded.
  • Synchronizing absence data with other school management systems.

Properties

Name Meaning
Custom method name (Optional) Overrides the default API method called to fetch absences. Example: "getMarks".

Note: The node supports a single input property named "Custom method name" which allows advanced users to specify a different underlying API method if needed.

Output

The output is an array of JSON objects representing absence records retrieved from the Librus calendar. Each object corresponds to one absence entry and contains details as provided by the Librus API.

If multiple items are returned, each item is output as a separate JSON object in the node's output array.

No binary data output is associated with this operation.

Dependencies

  • Requires valid credentials for the Librus API, specifically a login and password.
  • Uses an internal client wrapper to communicate with the Librus API.
  • The node expects the user to configure these credentials securely within n8n.

Troubleshooting

  • No supported method found error: If the custom method name is incorrect or does not exist in the API client, the node will throw an error listing available methods. Ensure the custom method name matches a valid API method.
  • Empty or no data returned: Verify that the date range ("from" and "to") parameters are set correctly and that there are absences recorded in that period.
  • Authentication errors: Confirm that the provided credentials are correct and have sufficient permissions to access absence data.
  • Unexpected data structure: The node attempts to flatten nested arrays in some cases; if the output seems malformed, check the API response format or update the node accordingly.

Links and References

  • Librus Official Website (for general platform info)
  • No direct public API documentation was included in the source code; consult your Librus API provider or administrator for detailed API references.

Discussion