LibrusInstall

Overview

This node interacts with the Librus API to retrieve or manipulate various types of data related to school management, such as messages, homework, absences, calendar events, and grades. Specifically, for the Messages resource with the Get Point Grade operation, it fetches detailed information about a specific point grade identified by a grade ID.

Common scenarios where this node is beneficial include:

• Retrieving detailed grading information for a student’s specific assignment or test.
• Integrating school grading data into automated workflows, such as notifications or reports.
• Combining grade data with other student information for comprehensive analytics.

Example use case: Automatically fetching a student's point grade after an exam and sending a notification email if the grade falls below a threshold.

Properties

Note: For the Get Point Grade operation, the key input parameter used internally is a grade identifier (gradeId), which is not listed here but is required to specify which point grade to retrieve.

Output

The output is a JSON object representing the detailed information of the requested point grade. The structure depends on the Librus API response for a point grade and typically includes fields such as the grade value, subject, date, description, and possibly teacher comments.

If multiple items are returned (not typical for this operation), they are output as an array of JSON objects, each representing one grade.

No binary data output is produced 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 endpoints.
• Date filtering utilities are applied when applicable.
• No additional external services beyond the Librus API are needed.

Troubleshooting

• Error: No supported method found for resource "messages" on librus-api client.
  This indicates that the specified operation or custom method name does not match any available API methods. Verify the operation name and ensure the custom method name (if used) is correct.

• Authentication errors:
  Ensure that the provided login and password credentials are correct and have sufficient permissions.

• Empty or unexpected results:
  Check that the gradeId parameter is correctly set and corresponds to an existing point grade.

• Date filters not working as expected:
  Confirm that the From and To dates are in the correct YYYY-MM-DD format.

Links and References

• Librus API Documentation (official API docs, if publicly available)
• n8n documentation on creating custom nodes
• General info on date filtering best practices