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 settings for managing school-related data such as homework, messages, absences, calendar events, and grades. Specifically, the "Homework" resource with the "Get Event" operation allows users to retrieve detailed information about specific calendar events, which may include homework deadlines, school events, or absences.

Typical use cases include:

  • Automatically fetching event details for homework assignments or school events within a specified date range.
  • Integrating school calendar events into other systems like personal calendars or notification services.
  • Monitoring absence events linked to the calendar.

For example, a teacher could use this node to pull upcoming homework events and send reminders to students, or a student could sync their homework deadlines with their personal calendar app.

Properties

Name Meaning
From Optional start date filter (format: YYYY-MM-DD). Limits events to those on or after this date.
To Optional end date filter (format: YYYY-MM-DD). Limits events to those on or before this date.
Custom method name Advanced option to override the default API method called. For example, specifying a different underlying API call instead of the default "getEvent".

Output

The node outputs an array of JSON objects representing the retrieved event(s). Each object contains detailed information about a calendar event, such as its ID, title, date, description, and whether it is marked as an absence event.

If multiple input items are provided, the node fetches each event individually and returns an array of event objects corresponding to each input.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Librus API, including login and password.
  • The node depends on the librus-api client wrapper internally to communicate with the Librus service.
  • No additional environment variables or external services are required beyond the API credentials.

Troubleshooting

  • No supported method found error: This occurs if the specified resource-operation combination does not match any available API methods. Ensure that the Resource is set to "Homework" and Operation to "Get Event", or specify a valid custom method name.
  • Authentication failures: Verify that the provided Librus API credentials (login and password) are correct and have sufficient permissions.
  • Empty results: If no events are returned, check the date filters ("From" and "To") to ensure they cover the expected event dates.
  • Invalid date format: Dates must be in the YYYY-MM-DD format; otherwise, the API call might fail or return unexpected results.

Links and References

Discussion