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 user info. Specifically, for the Messages - Get Grades operation, it fetches grade data from the user's account. This is useful in educational contexts where automated retrieval of student grades is needed, such as integrating grade data into dashboards, notifications, or reporting tools.

Practical examples include:

  • Automatically fetching recent grades within a date range to notify students or parents.
  • Aggregating grades over time for performance analysis.
  • Integrating grade data into school management systems or personal productivity apps.

Properties

Name Meaning
From Optional start date (YYYY-MM-DD) to filter results by date range
To Optional end date (YYYY-MM-DD) to filter results by date range
Custom method name Advanced: override the underlying Librus API method to call (e.g., getMarks)

Output

The output is an array of JSON objects representing the retrieved grades or related data depending on the operation. Each object corresponds to a single grade record or related entity fetched from the Librus API.

  • For the "Get Grades" operation, the JSON contains detailed grade information as returned by the API.
  • If binary data is requested (not typical for this operation), it would be returned as base64-encoded content with MIME type and filename metadata, but this does not apply here.

Dependencies

  • Requires an active connection to the Librus API using valid user credentials (login and password).
  • The node uses an internal client wrapper to communicate with the Librus API.
  • No additional external services are required beyond the Librus API.
  • Proper n8n credential configuration for the Librus API authentication is necessary.

Troubleshooting

  • No supported method found error: This occurs if the specified resource-operation combination or custom method name does not match any available API methods. Verify that the resource and operation names are correct and that the custom method name (if used) exists in the API.
  • Authentication errors: Ensure that the provided login and password credentials are valid and have sufficient permissions.
  • Date filtering issues: If no results appear when using the "From" and "To" date filters, check that the dates are correctly formatted (YYYY-MM-DD) and that data exists within that range.
  • Empty results: Could indicate no grades available for the specified parameters or a misconfiguration of input properties.

Links and References


If you need details on other operations or resources, feel free to ask!

Discussion