Librus icon

Librus

Read data from Librus Synergia (unofficial)
Join our community

Actions105

Overview

This node interacts with the Librus API to retrieve various types of information related to a user's school account. Specifically, for the Info resource and Get Point Grade operation, it fetches detailed point grade data associated with a specified grade ID. This can be useful for educators, students, or parents who want to programmatically access detailed grading information from the Librus system.

Practical examples include:

  • Automatically retrieving a student's point grade details for reporting or analysis.
  • Integrating Librus grading data into custom dashboards or notification systems.
  • Using the node in workflows that trigger actions based on specific grade thresholds or updates.

Properties

Name Meaning
Custom method name Advanced: override the underlying Librus API method to call (e.g., getMarks). If set, this method is called instead of the default one for the operation.
Grade ID The numeric identifier of the grade whose point grade details you want to retrieve. Required for this operation.

Output

The node outputs an array of JSON objects representing the point grade data retrieved from the Librus API for the specified grade ID. Each object contains detailed information about the point grade, such as scores, descriptions, dates, or other relevant metadata as provided by the API.

If multiple items are returned, each will be output as a separate item in the workflow. There is no binary data output for this operation.

Example output structure (simplified):

{
  "gradeId": 123,
  "points": 85,
  "description": "Midterm exam",
  "date": "2024-05-10",
  ...
}

Dependencies

  • Requires valid credentials for the Librus API (login and password).
  • The node uses an internal client wrapper to communicate with the Librus API.
  • No additional external services or environment variables are required beyond the API credentials.

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 API credentials have sufficient permissions.
  • Invalid Grade ID: Ensure the Grade ID provided is correct and exists in the Librus system; otherwise, the API may return empty or error responses.
  • Authentication failures: Check that the API credentials (login and password) are valid and not expired.
  • Empty or unexpected output: Confirm that the grade ID corresponds to a point grade entry and that the Librus API is accessible at the time of execution.

Links and References

Discussion