Librus icon

Librus

Read data from Librus Synergia (unofficial)

Overview

This node interacts with the Librus API to manage and retrieve various types of messages and announcements within an educational context. Specifically, the "List Announcements" operation under the "Messages" resource fetches a list of announcements from the user's inbox. This is useful for educators, students, or administrators who want to programmatically access school announcements over a specified date range.

Practical examples include:

  • Automatically retrieving recent school announcements to display on a custom dashboard.
  • Filtering announcements by date to generate reports or notifications.
  • Integrating announcements into other communication tools or workflows.

Properties

Name Meaning
From Optional start date (YYYY-MM-DD) to filter announcements from this date onwards.
To Optional end date (YYYY-MM-DD) to filter announcements up to this date.
Custom method name Advanced option to override the default API method called (e.g., specify a different Librus API method).

Output

The output is an array of JSON objects, each representing an announcement message retrieved from the Librus system. Each object contains the announcement's details such as title, content, date, sender, and other metadata provided by the API.

If binary data were involved (not in this operation), it would be returned as base64-encoded content with MIME type information, but for listing announcements, only JSON data is returned.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • Uses an internal client wrapper to communicate with the Librus API.
  • The node expects the environment to have network access to the Librus service.

Troubleshooting

  • No supported method found error: If the node throws an error about no supported method found for the resource-operation combination, ensure that the operation name is correct and supported by the current version of the underlying API client.
  • Authentication errors: Verify that the provided API credentials are correct and have sufficient permissions.
  • Date filtering issues: Ensure that the "From" and "To" dates are in the correct YYYY-MM-DD format; otherwise, filtering may not work as expected.
  • Empty results: If no announcements are returned, check if there are any announcements in the specified date range or try removing the date filters.

Links and References

Discussion