Librus icon

Librus

Read data from Librus Synergia (unofficial)

Overview

This node interacts with the Librus API to retrieve various types of information related to messages, homework, absences, calendar events, and grades. Specifically, for the Messages - Get Grade operation, it fetches grade data from the user's account within an optional date range. This is useful for educators, students, or parents who want to programmatically access grade information over a specified period.

Practical examples include:

  • Automatically retrieving recent grades for a student between two dates.
  • Integrating grade data into other systems like dashboards or reporting tools.
  • Monitoring grade changes or updates without manual login.

Properties

Name Meaning
From Optional start date (format YYYY-MM-DD) to filter the data by the beginning of the period.
To Optional end date (format YYYY-MM-DD) to filter the data by the end of the period.
Custom method name Advanced: override the default API method called to fetch data (e.g., use a different grade retrieval method).

Output

The output is a JSON array where each item represents a grade record retrieved from the Librus API. The exact structure depends on the API response but typically includes details such as the grade value, subject, date, and possibly additional metadata.

If multiple grades are returned, each will be an individual JSON object in the output array.

No binary data output is expected for this operation.

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • Uses an internal client wrapper to communicate with the Librus API.
  • No additional external services or environment variables are explicitly required beyond the API credentials.

Troubleshooting

  • No supported method found error: If the custom method name or operation does not match any available API methods, the node will throw an error listing available methods. Ensure the operation and custom method name are correct.
  • Authentication errors: Invalid or missing credentials will prevent API access. Verify that the provided login and password are correct.
  • Date filtering issues: Incorrect date formats for "From" and "To" properties may cause unexpected results or no data returned. Use the YYYY-MM-DD format.
  • Empty results: If no grades are found within the specified date range, the output will be empty. Try expanding the date range or verifying the account has relevant data.

Links and References

Discussion