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 educational data. It allows users to retrieve various types of information such as calendar events, grades, messages, homework, absences, and timetable details. Specifically, the "Calendar" resource with the "Get Point Grade" operation fetches detailed point grade information related to a specific grade ID.

Typical use cases include:

  • Automating retrieval of student grades or point grades for reporting or analysis.
  • Fetching calendar events or timetable data to synchronize with other scheduling tools.
  • Managing school communications by accessing inbox messages or announcements.
  • Accessing homework assignments and absence records programmatically.

For example, a school administrator could use this node to automatically pull point grade details for students and integrate them into a custom dashboard or notification system.

Properties

Name Meaning
Custom method name Advanced: override the underlying Librus API method to call (e.g., getMarks). If set, this custom method name is called instead of the default mapped methods.

Note: The node also internally uses many other parameters depending on the resource and operation, such as gradeId for fetching specific grades, but only the above property was provided explicitly.

Output

The output is an array of JSON objects representing the data returned from the Librus API based on the selected resource and operation.

  • For the "Get Point Grade" operation under the "Calendar" resource, the output JSON contains detailed information about the specified point grade identified by a grade ID.
  • If the operation returns multiple items, each item is output as a separate JSON object in the array.
  • The node can also output binary data when retrieving files (e.g., message attachments), encoded in base64 with MIME type and filename metadata.

Dependencies

  • Requires valid credentials for the Librus API, specifically a 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 credentials within n8n to authenticate API requests.

Troubleshooting

  • No supported method found error: This occurs if the requested resource-operation combination does not map to any available method in the Librus API client. Verify that the resource and operation names are correct and supported.
  • Authentication failures: Ensure that the provided login and password credentials are valid and have sufficient permissions.
  • Empty or unexpected results: Check date range filters (from, to) and IDs passed to the node to ensure they correspond to existing data.
  • Binary data handling: When retrieving files, ensure the binary property name is correctly set to avoid missing or malformed attachments.

Links and References

Discussion