n8n-nodes-nextcloud-deck

Ein n8n Community Node für die Integration mit Nextcloud Deck. Diese Node ermöglicht es Ihnen, Ihre Nextcloud Deck Boards, Stacks und Karten zu verwalten.

🤖 AI Agent Support: Diese Node ist vollständig kompatibel mit n8n AI Agents und kann als intelligentes Tool in automatisierten Workflows verwendet werden.

Installation

Um diesen Node in n8n zu installieren, folgen Sie der Anleitung für Community Nodes.

npm install n8n-nodes-nextcloud-deck

AI Agent Support 🤖

Diese Node unterstützt n8n AI Agents und kann als Tool in AI-gesteuerten Workflows verwendet werden. AI Agents können automatisch:

• ✅ Boards erstellen und verwalten
• ✅ Stacks organisieren (z.B. "To Do", "In Progress", "Done")
• ✅ Karten mit intelligenten Titeln und Beschreibungen erstellen
• ✅ Kommentare basierend auf Kontext hinzufügen
• ✅ Anhänge hochladen und verwalten
• ✅ Labels zuweisen und organisieren
• ✅ Benutzer zu Aufgaben zuweisen

Aktivierung

Die Node ist automatisch als AI Agent Tool verfügbar, wenn folgende Eigenschaften konfiguriert sind:

• usableAsTool: true ✅
• aiEnabled: true ✅

Bekannte Limitation: AI-Icons

⚠️ Problem: Nicht alle Textfelder zeigen das AI-Zauberstab-Icon (⚡) in der Benutzeroberfläche an, obwohl die AI-Funktionalität technisch vollständig implementiert ist.

Betroffene Felder:

• Beschreibungsfelder bei Karten
• Nachrichtenfelder bei Kommentaren
• Möglicherweise weitere mehrzeilige Textfelder

Technischer Hintergrund:

• Alle Felder sind mit AIEnabled: true und canBeExpression: true konfiguriert
• Die AI-Funktionalität funktioniert trotz fehlender Icons vollständig
• Das Problem liegt vermutlich in der n8n UI-Darstellung spezifischer Feldtypen

Workarounds:

1. Manuelle Expression-Eingabe: Sie können AI-Expressions manuell in Felder eingeben (z.B. {{ $ai.generateText("Beschreibe diese Aufgabe") }})
2. AI Agent Nutzung: AI Agents funktionieren normal und können alle Felder programmatisch ausfüllen
3. Copy-Paste: Texte aus AI-fähigen Feldern können in nicht-AI-fähige Felder kopiert werden

Status: Das Problem ist dokumentiert und wird in zukünftigen Updates adressiert. Die Kernfunktionalität ist nicht beeinträchtigt.

Kompatibilität

• Nextcloud Deck Version: 1.3.0+
• n8n Version: 0.180.0+

Konfiguration

Credentials

Erstellen Sie neue Credentials für "Nextcloud Deck API" mit:

• Nextcloud URL: Die URL Ihrer Nextcloud-Instanz (z.B. https://cloud.example.com)
• Benutzername: Ihr Nextcloud Benutzername
• Passwort: Ihr Nextcloud Passwort oder App-Passwort (empfohlen)

Tipp: Es wird dringend empfohlen, ein App-Passwort zu verwenden. Erstellen Sie eines unter Einstellungen > Sicherheit > App-Passwörter.

Funktionen

Board-Operationen

• Alle Boards abrufen: Listet alle verfügbaren Boards auf
• Board abrufen: Ruft ein spezifisches Board ab (mit Dropdown-Auswahl)
• Board erstellen: Erstellt ein neues Board
• Board aktualisieren: Aktualisiert ein vorhandenes Board (mit Dropdown-Auswahl)
• Board löschen: Löscht ein Board (mit Dropdown-Auswahl)

Stack-Operationen (Spalten)

• Alle Stacks abrufen: Listet alle Stacks eines Boards auf (mit Board-Dropdown)
• Stack abrufen: Ruft einen spezifischen Stack ab (mit Board- und Stack-Dropdown)
• Stack erstellen: Erstellt einen neuen Stack in einem Board (mit Board-Dropdown)
• Stack aktualisieren: Aktualisiert einen vorhandenen Stack (mit Dropdown-Auswahl)
• Stack löschen: Löscht einen Stack (mit Dropdown-Auswahl)

Card-Operationen (Karten)

• Stack mit Karten abrufen: Ruft einen Stack mit allen enthaltenen Karten ab (mit Board- und Stack-Dropdown)
• Karte abrufen: Ruft eine spezifische Karte ab (mit Board-, Stack- und Card-Dropdown)
• Karte erstellen: Erstellt eine neue Karte in einem Stack
  • Titel (erforderlich)
  • Beschreibung (optional, mehrzeilig)
  • Typ: Standard oder Markdown (optional)
  • Reihenfolge im Stack (optional)
  • Fälligkeitsdatum (optional)
  • 🆕 Benutzer zuweisen (optional) - Direkte Benutzerzuweisung bei Erstellung
• Karte aktualisieren: Aktualisiert eine vorhandene Karte (mit Dropdown-Auswahl)
  • Alle Felder optional
  • 🆕 Benutzer zuweisen (optional) - Zusätzlichen Benutzer zuweisen
• Karte löschen: Löscht eine Karte (mit Dropdown-Auswahl)
• Benutzer zuweisen: Weist einen Benutzer zu einer Karte zu
• Benutzer entfernen: Entfernt einen Benutzer von einer Karte

⚠️ Hinweis zu Labels: Die direkte Label-Zuweisung bei Kartenerstellung/-aktualisierung ist temporär deaktiviert aufgrund von UI-Kompatibilitätsproblemen. Verwenden Sie stattdessen die separaten Label-Operationen "Label zu Karte zuweisen".

Label-Operationen (Tags/Etiketten)

• 🆕 Alle Labels abrufen: Listet alle Labels eines Boards auf (mit Board-Dropdown)
• 🆕 Label abrufen: Ruft ein spezifisches Label ab (mit Board- und Label-Dropdown)
• 🆕 Label erstellen: Erstellt ein neues Label in einem Board
  • Titel (erforderlich)
  • Farbe (erforderlich, mit Farbwähler)
• 🆕 Label aktualisieren: Aktualisiert ein vorhandenes Label (mit Dropdown-Auswahl)
  • Titel und Farbe optional
• 🆕 Label löschen: Löscht ein Label (mit Dropdown-Auswahl)
• 🆕 Label zu Karte zuweisen: Weist ein Label zu einer Karte zu
• 🆕 Label von Karte entfernen: Entfernt ein Label von einer Karte

Comment-Operationen (Kommentare)

• 🆕 Alle Kommentare Abrufen: Listet alle Kommentare einer Karte auf
• 🆕 Kommentar Abrufen: Ruft einen spezifischen Kommentar ab
• 🆕 Kommentar Erstellen: Erstellt einen neuen Kommentar an einer Karte
  • Nachricht (erforderlich, mehrzeilig)
• 🆕 Kommentar Aktualisieren: Aktualisiert einen vorhandenen Kommentar
  • Neue Nachricht (erforderlich)
• 🆕 Kommentar Löschen: Löscht einen Kommentar

Hinweis: Kommentare werden über die Nextcloud OCS Comments API verwaltet und erfordern entsprechende Berechtigungen.

Attachment-Operationen (Anhänge) 🆕

• ✨ Alle Anhänge Abrufen: Listet alle Anhänge einer Karte auf
  • Vollständige Board → Stack → Card Auswahl mit ResourceLocator
  • Zeigt alle Attachment-Details inkl. Dateigröße und MIME-Type
• ✨ Anhang Abrufen: Ruft einen spezifischen Anhang ab
  • Genaue Attachment-Details und Metadaten
• ✨ Anhang Erstellen: Fügt einen neuen Anhang zu einer Karte hinzu
  • Typ-Auswahl: "Deck-Datei" oder "Nextcloud-Datei"
  • Flexible Datenquelle: Dateipfad oder Dateiinhalt
  • Automatische Integration: Direkte Synchronisation mit Nextcloud Files
• ✨ Anhang Aktualisieren: Aktualisiert einen vorhandenen Anhang
  • Optionale Datenänderung: Neue Datei oder Pfad (optional)
• ✨ Anhang Löschen: Entfernt einen Anhang komplett
  • Sichere Löschung: Bestätigung via Attachment-ID

Attachment-Typ Unterstützung

• deck_file: Dateien, die direkt innerhalb der Deck-App gespeichert werden
  • Legacy-Support für ältere Deck-Versionen (< 1.3.0)
  • Interne Deck-Dateiverwaltung
• file: Dateien aus der regulären Nextcloud-Dateiverwaltung (empfohlen)
  • Standard ab Deck 1.3.0+
  • Integration mit Nextcloud Files
  • Bessere Synchronisation und Freigabe

💡 API-Hinweis: Die Attachment-Funktionalität basiert auf der offiziellen Deck Attachments API und verwendet REST-Endpunkte für optimale Kompatibilität.

UI-Verbesserungen

• Resource Locator: Flexible Auswahl zwischen Dropdown-Listen und direkter ID-Eingabe
  • Listen-Modus: Benutzerfreundliche Dropdown-Listen mit Suchfunktion
  • ID-Modus: Direkte Eingabe von Board- und Stack-IDs für Automatisierung
• Dynamische Listen: Stack-Listen werden automatisch basierend auf der Board-Auswahl aktualisiert
• Intelligente Validierung: Optionale Felder werden nur gesendet wenn sie Werte enthalten
• Suchfunktion: Alle Listen sind durchsuchbar für bessere Benutzerfreundlichkeit

Flexibilität

• Hybrid-Auswahl: Jedes Board/Stack-Feld kann sowohl über Liste als auch über ID ausgewählt werden
• API-Integration: Perfekt für Workflows, die IDs aus anderen Systemen verwenden
• Benutzerfreundlichkeit: Dropdown-Listen für manuelle Auswahl, ID-Eingabe für Automatisierung

Label-Management System

• 🎨 Farb-basierte Organisation: Erstellen Sie farbkodierte Labels für bessere visuelle Organisation
• 🔄 Vollständige CRUD-Operationen: Erstellen, Lesen, Aktualisieren und Löschen von Labels
• 🏷️ Flexibles Tagging: Weisen Sie Labels dynamisch zu Karten zu oder entfernen Sie sie
• 📋 Board-übergreifende Verwaltung: Labels werden auf Board-Ebene verwaltet und können allen Karten des Boards zugewiesen werden
• 🔍 Suchbare Listen: Alle Label-Listen sind durchsuchbar für bessere Benutzerfreundlichkeit

Geplante Funktionen

• ~~Anhänge verwalten~~ ✅ Implementiert!
• ~~Kommentar-System~~ ✅ Implementiert!

API-Dokumentation

Diese Node basiert auf der Nextcloud Deck REST API.

Beispiel-Workflow

1. Board und Stacks erstellen

   • Ressource: Board → Operation: Board erstellen
   • Titel: "Mein Projekt", Farbe: "0082C9"
   • Ressource: Stack → Operation: Stack erstellen
   • Board-ID: {Board-ID}, Titel: "To Do"

2. Workflow organisieren

   • Erstellen Sie Stacks wie "To Do", "In Progress", "Done"
   • Verwenden Sie die Reihenfolge-Parameter für die richtige Anordnung

Entwicklung

# Dependencies installieren
npm install

# Build
npm run build

# Linting
npm run lint

# Entwicklungsmodus
npm run dev

Lizenz

MIT

Support

Bei Problemen oder Feature-Anfragen erstellen Sie bitte ein Issue im GitHub Repository.

Autor

Niko Terschawetz - [email protected]

Changelog

Version 1.2.7 (2025-01-03)

• 🔧 AI Tool Kompatibilität: DisplayName-Felder ohne Umlaute und Bindestriche angepasst
• ✨ Schema-Fixes: "Fälligkeitsdatum" → "Faelligkeitsdatum", "Anhang-ID" → "Anhang ID"
• 🤖 Bessere AI Integration: Vermeidung von Schema-Fehlern bei AI Tool Verwendung

Version 1.2.6 (2025-05-30)

• 📝 Dokumentation: AI Support Limitation dokumentiert und Workarounds hinzugefügt
• 📋 README Update: Umfassende Dokumentation der AI Agent Funktionalität

Version 1.2.5 (2025-05-30)

• ✨ AI Agent Tool Support: Node kann jetzt als Tool für n8n AI Agents verwendet werden
• 🔧 AI Field Configuration: Alle Textfelder mit AIEnabled: true und canBeExpression: true konfiguriert
• ⚠️ Bekannte Limitation: Nicht alle Felder zeigen AI-Icons an (funktioniert trotzdem)
• 📝 Dokumentation: Umfassende AI Support Dokumentation hinzugefügt

Version 1.1.4 (2025-05-30)

• ✨ Attachment System: Vollständiges Anhang-Management implementiert
• 🔄 Binary Data Support: Proper n8n Binary-Daten Integration
• 📎 Multipart Upload: FormData-basierte Datei-Uploads
• 🔧 Filename Detection: Automatische Dateinamen und MIME-Type Erkennung

Version 1.1.0 (2025-05-30)

• ✨ Comment System: Vollständiges Kommentar-Management
• ✨ Label Management: Umfassendes Label-System mit CRUD-Operationen
• 🎨 Color Support: Farbwähler für Boards und Labels
• 👥 User Assignment: Direkte Benutzerzuweisung bei Kartenerstellung
• 🔍 Improved UI: ResourceLocator für bessere Benutzerfreundlichkeit

Version 1.0.0 (2025-05-30)

• 🎉 Initial Release: Board, Stack und Card Management
• 📊 Resource Locator: Flexible Board/Stack/Card Auswahl
• 🔄 Dynamic Lists: Automatische Dropdown-Aktualisierung
• ✅ Full CRUD: Erstellen, Lesen, Aktualisieren, Löschen für alle Ressourcen