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 student information such as homework, grades, messages, absences, and calendars. The "Homework - Get Grade" operation specifically retrieves detailed grade information related to homework or other assessments.

Typical use cases include:

  • Automatically fetching a student's grade for a specific homework assignment.
  • Integrating grade data into custom dashboards or reports.
  • Triggering workflows based on grade retrieval, such as notifications or analytics.

For example, a teacher could use this node to pull a particular student's grade for an assignment and then send a summary message or update a database.

Properties

Name Meaning
From Optional start date filter in YYYY-MM-DD format to limit the data retrieval period.
To Optional end date filter in YYYY-MM-DD format to limit the data retrieval period.
Custom method name Advanced option to override the default API method called (e.g., specify a different Librus API method like getMarks).

Note: The "From" and "To" properties are used to filter results by date range when applicable.

Output

The node outputs JSON data representing the grade information retrieved from the Librus API. The structure depends on the specific API response for the "Get Grade" operation but generally includes details such as:

  • Grade value
  • Subject or homework identifier
  • Date of the grade
  • Additional metadata related to the grade

If multiple items are returned, the output is an array of JSON objects, each representing a grade record.

The node does not output binary data for this operation.

Dependencies

  • Requires valid credentials for the Librus API (an API login and password).
  • Uses an internal client wrapper to communicate with the Librus API.
  • No additional external dependencies beyond the configured API credentials.

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) corresponds to a valid API method.
  • Authentication errors: Ensure that the provided API credentials (login and password) are correct and have sufficient permissions.
  • Date filtering issues: If using the "From" and "To" properties, ensure dates are in the correct YYYY-MM-DD format; otherwise, filtering may fail or return unexpected results.
  • Empty or unexpected responses: Confirm that the requested grade exists and that the parameters (such as grade ID or date range) are accurate.

Links and References

Discussion