Nextcloud Deck icon

Nextcloud Deck

Verwalten Sie Ihre Nextcloud Deck-Boards, Stacks, Karten und mehr

Overview

This node integrates with Nextcloud Deck, a project and task management tool, allowing users to manage boards, stacks, cards, comments, and attachments within their Nextcloud instance. Specifically, the "Stack mit Karten Abrufen" (Retrieve Stack with Cards) operation under the "Karte" (Card) resource fetches all cards contained in a specified stack on a given board.

Typical use cases include:

  • Automating retrieval of task cards from a particular stack for reporting or further processing.
  • Synchronizing card data from Nextcloud Deck into other systems or workflows.
  • Monitoring specific stacks for changes or updates by periodically fetching their cards.

For example, a user might select a board and a stack to pull all cards currently in that stack, then use this data to generate summaries, send notifications, or update external databases.

Properties

Name Meaning
Board Select a board either from a searchable list of available boards or enter its numeric ID manually. This identifies the board containing the target stack.
Stack Select a stack either from a searchable list of stacks within the chosen board or enter its numeric ID manually. This specifies the stack whose cards will be retrieved.

Output

The node outputs an array of JSON objects, each representing the data of a card retrieved from the specified stack. Each JSON object contains the card's properties as provided by the Nextcloud Deck API, such as title, description, labels, due dates, and other metadata relevant to the card.

If the node supports binary data output (not explicitly shown here), it would typically relate to attachments or images associated with cards, but for this operation, the focus is on JSON card data.

Dependencies

  • Requires connection to a Nextcloud instance with the Deck app installed.
  • Needs an API authentication token or API key credential configured in n8n to authorize requests to the Nextcloud Deck API.
  • The node uses internal handlers to interact with the Nextcloud Deck API endpoints for boards, stacks, and cards.

Troubleshooting

  • Invalid Board or Stack ID: If the entered board or stack ID does not exist or is incorrect, the node may throw an error indicating the resource was not found. Verify IDs are numeric and correspond to existing resources.
  • Authentication Errors: Failure to authenticate with the Nextcloud API will result in errors. Ensure the API credentials are correctly set up and have sufficient permissions.
  • Empty Results: If no cards are returned, confirm that the selected stack actually contains cards and that the board and stack selections are correct.
  • API Rate Limits or Connectivity Issues: Network problems or API rate limits can cause failures. Check network connectivity and API usage policies.

Links and References

Discussion