LearningSuite icon

LearningSuite

Interact with LearningSuite API (powered by agentur-systeme.de)

Overview

This node integrates with the LearningSuite API to create a new lesson within a specified course module section. It is useful for automating course content management workflows, such as adding lessons programmatically during course creation or updates.

Typical use cases include:

  • Automatically adding lessons to an online course after content preparation.
  • Inserting video lessons with thumbnails and formatted HTML content into a course structure.
  • Publishing courses immediately after lesson creation to make new content live without manual intervention.

For example, an educator could use this node to add a video lesson with a description and thumbnail to a specific module section of their course, optionally publishing the course right away.

Properties

Name Meaning
Course Name or ID Select or specify the ID of the course where the lesson will be created. The list can be filtered by available courses or set via expression.
Module Name or ID Select or specify the ID of the module within the course where the lesson will be added. The list depends on the selected course.
Section Name or ID Select or specify the ID of the section within the module where the lesson will be inserted. The list depends on the selected module.
Lesson Name The name/title of the new lesson to be created.
Lesson Sort Position Choose whether the new lesson should be placed at the beginning ("First") or end ("Last") of the section.
Immediately Publish Course Boolean flag indicating if the course should be published immediately after creating the lesson and its page. Warning: This publishes all changes since the last release, so ensure content is final before enabling.
Additional Options (collection) A set of optional parameters to customize the lesson content:
HTML Content: Formatted text and images parsed into LearningSuite content, inserted after any video.
Lesson Description: Text description.
Thumbnail Timestamp (Sec): Time in seconds to capture a thumbnail from the video.
Thumbnail URL: Direct image URL for lesson/video thumbnail.
Video URL: Direct video URL inserted as the first element on the lesson page; used for thumbnail if no explicit thumbnail is set.

Output

The node outputs JSON data representing the newly created lesson and related entities as returned by the LearningSuite API. This typically includes identifiers, metadata, and status information about the lesson.

If video URLs or thumbnails are provided, the output reflects these media attachments associated with the lesson.

No binary data output is indicated.

Dependencies

  • Requires a valid API key credential for authenticating with the LearningSuite API.
  • The node depends on the LearningSuite service being accessible via the configured base URL.
  • Proper permissions on the API key to create lessons and publish courses are necessary.
  • The node uses dynamic loading methods to populate options for courses, modules, and sections based on user selections.

Troubleshooting

  • Common Issues:

    • Missing or invalid course/module/section IDs may cause errors when creating lessons.
    • Attempting to publish a course immediately without finalizing all changes can lead to unintended content going live.
    • Providing invalid or inaccessible video or thumbnail URLs may result in media not displaying correctly.
  • Error Messages:

    • "No handler for resource "course" and operation "createLesson": Indicates a misconfiguration or unsupported operation; verify resource and operation names.
    • API errors related to authentication or permissions: Ensure the API key credential is valid and has sufficient rights.
    • Validation errors for required fields like lesson name or IDs: Confirm all mandatory properties are set correctly.
  • Resolution Tips:

    • Double-check IDs using the dropdowns or expressions.
    • Review the course content state before enabling immediate publishing.
    • Validate URLs for media resources to ensure they are direct-downloadable and publicly accessible.

Links and References

Discussion