LibrusInstall

Overview

This node integrates with the Librus API, a platform commonly used by schools for managing educational data. It allows users to retrieve various types of information such as calendar events, grades, messages, homework, absences, and notifications from a Librus account. The "Get Calendar" operation under the "Info" resource specifically fetches calendar data, which can include school schedules, events, or other relevant dates.

Practical scenarios where this node is beneficial include:

• Automating the retrieval of school calendar events to sync with personal calendars.
• Extracting timetable information for students or teachers.
• Gathering notifications or grades for reporting or monitoring purposes.

For example, a teacher could use this node to automatically pull their timetable or upcoming events and integrate them into their workflow tools.

Properties

Note: Although only one property is listed here for the "Info" resource and "Get Calendar" operation, the node internally supports many other parameters depending on the resource and operation selected (e.g., date ranges, IDs). However, these are not exposed in the provided input properties JSON.

Output

The output is an array of items, each containing a json field with the data returned from the Librus API call. For the "Get Calendar" operation, this typically includes calendar event objects representing scheduled events or dates.

• If multiple calendar entries are returned, they are flattened into a single array of JSON objects.
• Each JSON object corresponds to a calendar event or related data structure.
• The node does not output binary data for this operation.

Example output snippet (conceptual):

[
  {
    "json": {
      "eventId": 123,
      "title": "Math Exam",
      "date": "2024-06-15",
      "description": "Final exam for math subject"
    }
  },
  {
    "json": {
      "eventId": 124,
      "title": "Parent-Teacher Meeting",
      "date": "2024-06-20",
      "description": "Scheduled meeting with parents"
    }
  }
]

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 or environment variables are explicitly required beyond the API credentials.

Troubleshooting

• No supported method found error: This occurs if the node cannot find a matching method in the Librus API client for the selected resource and operation. Ensure that the resource and operation names are correct and supported by the node.
• Authentication failures: Invalid or missing credentials will prevent successful API calls. Verify that the login and password are correctly configured.
• Empty or unexpected results: If the calendar data is empty or malformed, check the date range parameters (if used) and ensure the account has relevant calendar data.
• Flattening errors: The node attempts to flatten nested arrays in the calendar response. If the data structure changes unexpectedly, it might cause issues. Updating the node or checking the API response format may help.

Links and References

• Librus Official Website
• Librus API Documentation (Note: Replace with actual URL if available)
• n8n documentation on Creating Custom Nodes