LearningSuite icon

LearningSuite

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

Actions56

Overview

This node interacts with the LearningSuite API to manage community badges assigned to members. Specifically, the "Remove Community Badges From Member" operation allows users to revoke one or more badges from a specified community member. This is useful in scenarios where badge assignments need to be updated or corrected, such as removing outdated recognitions or correcting erroneous badge assignments.

Practical examples include:

  • Removing achievement badges from a user who no longer meets the criteria.
  • Revoking event participation badges after an event ends.
  • Managing membership status by adjusting badges accordingly.

Properties

Name Meaning
Badge Group ID Optional filter to limit badge selection to a specific badge group. If set, only badges from this group are considered.
Member Name or ID The target community member from whom badges will be removed. Can be selected from a list or specified via expression. Required.
Badge Names or IDs One or more badges to remove from the member. Can be selected from a list filtered optionally by Badge Group ID or specified via expression. Required.
Notice Informational message indicating that multiple badges can be selected and that the badge selector can be filtered by Badge Group ID.

Output

The node outputs a JSON array containing the results of the badge removal operation for each input item. Each element typically represents the response from the API confirming the badges have been removed from the specified member.

If the operation fails for any item and "Continue On Fail" is enabled, the output will include an error object with the error message and the original input data for that item.

No binary data output is involved in this operation.

Dependencies

  • Requires a valid API key credential for the LearningSuite API.
  • The node depends on the LearningSuite API endpoint configured in the credentials (base URL).
  • The node uses internal methods to load options dynamically for members and badges, which require proper API access permissions.

Troubleshooting

  • Common Issues:

    • Invalid or missing member ID: Ensure the member exists and the ID or name is correctly specified.
    • Badge IDs not found or not belonging to the specified badge group: Verify badge selections and optional badge group filtering.
    • API authentication errors: Confirm that the API key credential is valid and has necessary permissions.
    • Network or connectivity issues with the LearningSuite API endpoint.

  • Error Messages:

    • "No handler for resource "community" and operation "removeBadgesFromUser": Indicates a misconfiguration or unsupported operation; verify the resource and operation names.
    • API error messages returned from the LearningSuite service will be passed through; check the message for details.
    • If "Continue On Fail" is disabled, the node execution stops at the first error; enabling it allows processing all items with error reporting per item.

Links and References

Discussion