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 calendars, absences, homework, messages, and grades. Specifically, the Get Calendar operation under the Absence resource retrieves calendar data from the Librus system.

Typical use cases include:

  • Fetching school calendar events for a given month and year.
  • Integrating absence-related calendar events into other workflows or dashboards.
  • Automating attendance tracking or notifications based on calendar data.

For example, a school administrator could use this node to automatically pull monthly calendar events related to absences and feed them into an attendance monitoring system.

Properties

Name Meaning
Custom method name (Optional) Override the default underlying API method to call. For example, specify "getMarks" to call that method instead of the default one for the operation.

Note: The node also internally uses parameters like month and year to specify which calendar data to retrieve, but these are not exposed in the provided input properties JSON snippet.

Output

The output is a JSON array where each item represents a calendar event object retrieved from the Librus API. Each event typically contains details such as dates, descriptions, and possibly absence-related flags.

If multiple calendar events are returned, they are flattened into a single array of objects.

No binary data output is produced for this operation.

Dependencies

  • Requires valid credentials with login and password for the Librus API.
  • Depends on the external librus-api client library wrapped inside the node.
  • The node expects date range filtering helpers available internally to filter results by date if specified.

Troubleshooting

  • No supported method found error: If the custom method name or operation does not match any available API method, the node will throw an error listing available methods. Ensure the operation and custom method names are correct.
  • Authentication errors: Invalid or missing credentials will prevent API access. Verify that the correct login and password are configured.
  • Empty or unexpected results: If the specified month/year or date range does not contain any calendar events, the output will be empty. Double-check input parameters.
  • Flattening errors: The node attempts to flatten nested arrays in the calendar response; if the response structure changes unexpectedly, it might cause issues. Updating the node or checking API changes may help.

Links and References

Discussion