Nextcloud Deck icon

Nextcloud Deck

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

Actions26

Overview

The node "Nextcloud Deck" enables managing various aspects of Nextcloud Deck, a kanban-style project and task management tool integrated with Nextcloud. Specifically, the "Anhang Erstellen" (Create Attachment) operation under the "Anhang" (Attachment) resource allows users to add attachments to cards within their boards.

This operation is useful when you want to programmatically attach files or textual content to specific cards in your Nextcloud Deck boards. For example, you might automate attaching meeting notes, PDFs, or other relevant documents directly to task cards, improving collaboration and documentation.

Practical scenarios include:

  • Automatically attaching generated reports or exports to project cards.
  • Linking files stored in Nextcloud's file system to Deck cards.
  • Adding textual notes or data as attachments inside the Deck app.

Properties

Name Meaning
Board Select a board from a searchable list or enter its numeric ID manually. This identifies the board where the card resides.
Stack Select a stack from a searchable list or enter its numeric ID manually. Stacks group cards within a board.
Karte (Card) Select a card from a searchable list or enter its numeric ID manually. The attachment will be added to this card.
Anhang Typ (Attachment Type) Choose the type of attachment:
• Deck-Datei: A file stored inside the Deck app itself.
• Nextcloud-Datei: A file from the regular Nextcloud file storage.
Daten (Data) For Nextcloud-Datei: Specify the file path in Nextcloud (e.g., /Documents/file.pdf).
For Deck-Datei: If binary data is provided, this field is ignored; otherwise, it is used as text content for the attachment.

Output

The node outputs JSON objects representing the result of the attachment creation operation. Each output item corresponds to one input item processed.

  • The json output contains details about the created attachment, such as identifiers and metadata returned by the Nextcloud Deck API.
  • If binary data is involved (for Deck-Datei type), the node handles it accordingly, but the main output focus is on JSON metadata describing the attachment.

Dependencies

  • Requires an API key credential for authenticating with the Nextcloud Deck API.
  • Needs access to the Nextcloud instance where Deck is installed.
  • The node uses internal handlers to interact with resources like boards, stacks, cards, comments, and attachments.
  • Proper permissions on the Nextcloud Deck instance are necessary to create attachments on cards.

Troubleshooting

  • Invalid Board/Stack/Card IDs: Ensure that the IDs entered are numeric and correspond to existing entities in your Nextcloud Deck instance. Use the list mode to select valid options.
  • File Path Errors: When using Nextcloud-Datei type, verify that the specified file path exists and is accessible in your Nextcloud file storage.
  • Permission Issues: Lack of sufficient permissions can cause failures when creating attachments. Confirm that the API key has rights to modify cards and add attachments.
  • Error Messages: The node throws errors if unknown resources are specified or if required parameters are missing. Check error messages carefully and ensure all required fields are correctly filled.
  • Continue On Fail: If enabled, the node will continue processing subsequent items even if some fail, returning error details in the output JSON.

Links and References

Discussion