LibrusInstall

Overview

This node integrates with the Librus API, a platform commonly used by schools for managing educational data. Specifically, the "Calendar" resource with the "Get Grades" operation retrieves grade information related to a student or user account from the Librus system.

Typical use cases include:

• Automatically fetching and processing students' grades for reporting or analysis.
• Integrating grade data into other educational tools or dashboards.
• Monitoring academic performance over time without manual data entry.

For example, a school administrator could use this node to pull all current grades for a student and then trigger notifications or generate reports based on that data.

Properties

Note: The node also internally uses parameters like resource, operation, date ranges, IDs, etc., but for the "Calendar - Get Grades" operation, only the custom method name is exposed as an input property here.

Output

The output is a JSON array of objects representing the grades retrieved from the Librus API. Each object corresponds to a grade record with details such as subject, value, date, and possibly additional metadata depending on the API response.

No binary data output is produced for this operation.

Example output structure (simplified):

[
  {
    "subject": "Mathematics",
    "grade": "5",
    "date": "2024-05-10",
    "description": "Midterm exam"
  },
  {
    "subject": "History",
    "grade": "4+",
    "date": "2024-05-12",
    "description": "Project work"
  }
]

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 API itself.
• The node expects proper configuration of these credentials within n8n.

Troubleshooting

• No supported method found error: This occurs if the specified operation or custom method name does not match any callable method in the Librus API client. To fix, verify the operation name and optionally the custom method name are correct and supported.
• Authentication failures: Ensure the provided login and password credentials are valid and have access rights to retrieve grades.
• Empty or unexpected results: Check date range filters or other parameters; some operations support filtering by date which may limit returned data.
• API changes: Since the node relies on the Librus API, any breaking changes or downtime on their side can cause errors or missing data.

Links and References

• Librus Official Website — For general information about the platform.
• Librus API Documentation — (If publicly available) for detailed API methods and usage.
• n8n Documentation on Creating Custom Nodes — For understanding how nodes interact with APIs.

This summary focuses on the "Calendar" resource and "Get Grades" operation as requested, describing its purpose, inputs, outputs, dependencies, and common troubleshooting points.