LibrusInstall

Overview

This node integrates with the Librus API, a platform commonly used by schools for managing student information such as grades, homework, absences, messages, and calendar events. The node allows users to retrieve various types of data from the Librus system, including grades, messages, homework assignments, absences, and calendar details.

The "Get Grades" operation under the "Info" resource specifically fetches the student's grades. This is useful for educators, students, or parents who want to automate the retrieval of academic performance data for reporting, monitoring progress, or integrating with other educational tools.

Practical examples:

• Automatically fetching and displaying a student's latest grades in a dashboard.
• Sending notifications when new grades are posted.
• Aggregating grade data for analysis or record keeping.

Properties

Note: Other parameters like date ranges (from, to), paging, IDs, and filters exist but are not relevant for this specific "Get Grades" operation based on the provided input properties.

Output

The output JSON structure contains the grades data retrieved from the Librus API. It typically returns an array of grade objects or a single grade object depending on the operation specifics.

• For "Get Grades", the output is an array of grade entries, each representing a grade record with details such as subject, value, date, and possibly additional metadata.
• If the response is a single object, it is wrapped into an array for consistent output formatting.
• The node does not output binary data for this operation.

Example output snippet (conceptual):

[
  {
    "subject": "Mathematics",
    "grade": "5",
    "date": "2024-05-10",
    "type": "written exam"
  },
  {
    "subject": "History",
    "grade": "4+",
    "date": "2024-05-08",
    "type": "oral test"
  }
]

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 are required beyond the Librus platform.
• The node expects proper configuration of these credentials within n8n.

Troubleshooting

• No supported method found error: If the node throws an error indicating no supported method was found for the resource-operation combination, verify that the operation name matches exactly and that the credentials have access rights.
• Authentication failures: Ensure the provided login and password are correct and that the Librus API service is reachable.
• Empty or unexpected results: Check if the account has any grades recorded; also verify date filters if used in other operations.
• Custom method name misuse: Using an incorrect custom method name can cause the node to fail finding the method. Use only valid method names exposed by the underlying API client.

Links and References

• Librus Official Website (for general platform info)
• Documentation for the Librus API client library (not publicly linked here, but typically available with the node source or developer resources)
• n8n documentation on creating and using credentials