n8n-nodes-nextcloud-ext

Nodes n8n communautaires pour Nextcloud — l'équivalent self-hosted des nodes Microsoft 365.

Gérez vos fichiers, manipulez vos tableurs, générez des documents Word/ODT depuis des templates, et lisez/remplissez des formulaires PDF — directement depuis vos workflows n8n, sans aucune dépendance au cloud Microsoft ou Google.

Nodes inclus

| Node | Équivalent MS 365 | Description | |---|---|---| | NextCloud Folder | OneDrive | Gestion de fichiers et dossiers via WebDAV | | NextCloud Spreadsheet | Excel | Lecture/écriture de fichiers tableur + tables Excel nommées | | NextCloud Search | Excel VLOOKUP | Recherche une valeur dans une colonne et retourne une valeur correspondante (RECHERCHEV) | | NextCloud Doc Template | Word (Mail Merge) | Remplissage de templates DOCX/ODT (syntaxe Carbone) + fusion d'annexes conditionnelles | | NextCloud PDF | — | Lecture, extraction de texte et remplissage de formulaires PDF AcroForm | | NextCloud OCR | — | Extraction de texte par OCR (Docling local, Mistral OCR) pour PDFs scannés ou aplatis |

Prérequis

• n8n ≥ 1.0.0
• Instance Nextcloud ≥ 20 accessible en HTTPS
• Node.js ≥ 18.10

Installation

Via l'interface n8n (recommandé)

1. Ouvrez n8n → Settings → Community Nodes
2. Cliquez Install a community node
3. Entrez n8n-nodes-nextcloud-ext
4. Cliquez Install puis redémarrez n8n

Installation manuelle

npm install n8n-nodes-nextcloud-ext

Configuration des credentials

1. Dans n8n → Credentials → New → cherchez Nextcloud API
2. Renseignez :

| Champ | Description | Exemple | |---|---|---| | Server URL | URL de base de votre Nextcloud (sans slash final) | https://cloud.mondomaine.fr | | Username | Votre identifiant Nextcloud | admin | | Password / App Password | Mot de passe ou mot de passe d'application | xxxx-xxxx-xxxx-xxxx |

Recommandé : créez un mot de passe d'application dans Nextcloud → Paramètres → Sécurité → Mots de passe d'application.

Node — NextCloud Folder

Gestion de fichiers, dossiers et partages via l'API WebDAV de Nextcloud.

Resource : File

| Opération | Description | |---|---| | List | Liste les fichiers d'un dossier | | Download | Télécharge un fichier (sortie binaire) | | Upload | Envoie un fichier binaire vers Nextcloud | | Delete | Supprime un fichier | | Move | Déplace ou renomme un fichier | | Copy | Copie un fichier vers un autre chemin |

Resource : Folder

| Opération | Description | |---|---| | List | Liste le contenu d'un dossier | | Create | Crée un nouveau dossier | | Delete | Supprime un dossier et tout son contenu |

Resource : Share

| Opération | Description | |---|---| | Create | Crée un lien de partage public ou vers un utilisateur/groupe | | Delete | Supprime un partage par son ID | | Get All | Liste tous vos partages actifs |

Node — NextCloud Spreadsheet

Lit et écrit dans des fichiers tableur stockés sur Nextcloud. Supporte .xlsx, .xls, .ods et .csv.

Les écritures utilisent xlsx-populate qui modifie uniquement les cellules demandées sans reconstruire le fichier — tableaux Excel nommés, styles, cellules fusionnées et mise en page sont préservés intégralement.

Sélection du fichier

Depuis  ▼  Depuis une liste  ← ou "Par chemin (expression)"
Dossier ▼  📁 Documents       ← liste à 2 niveaux
Fichier ▼  Arrêtés.xlsx       ← fichiers du dossier sélectionné

Resource : Sheet

Travaille sur les données d'une feuille de calcul. La première ligne est traitée comme en-tête par défaut.

Paramètre clé : Header Row — numéro de la ligne contenant les en-têtes (défaut : 1). Tous les dropdowns de colonnes se rechargent automatiquement quand cette valeur change.

| Opération | Description | |---|---| | Get Rows | Retourne toutes les lignes en tant qu'items n8n | | Append Row | Ajoute une ligne à la fin (hérite des styles de la ligne précédente) | | Update Row | Modifie une ligne existante par son numéro | | Delete Row | Supprime une ligne par son numéro | | Get Columns | Retourne la liste des en-têtes de colonnes | | Clear | Supprime toutes les lignes de données en conservant l'en-tête |

Options pour Get Rows (Sheet) :

| Option | Défaut | Description | |---|---|---| | Return Last N Rows | 0 (= toutes) | Retourner seulement les N dernières lignes | | Start From Column | 1 | Ignorer les colonnes avant la position N | | Column Names or IDs | (toutes) | Sélectionner les colonnes à inclure dans la sortie |

Resource : Table

Travaille sur une table Excel nommée (créée via Insertion → Tableau dans Excel, Ctrl+T).

| Opération | Description | |---|---| | List | Liste toutes les tables nommées du classeur | | Get Rows | Retourne les lignes de la table (filtres et options disponibles) | | Append Row | Ajoute une ligne et étend automatiquement la plage de la table | | Update Row | Modifie une ligne par son numéro dans la table | | Delete Row | Supprime une ligne et rétracte la plage de la table | | Get Columns | Retourne les en-têtes de colonnes de la table |

Options et filtres pour Get Rows (Table) :

| Option / Champ | Description | |---|---| | Include Row Number | Ajoute __rowNumber à chaque item (1 = première ligne de données). Attribué avant les filtres — reflète la position réelle dans la table. Utilisez-le dans Update Row ou Delete Row pour cibler la ligne exacte. | | Return Last N Rows | Retourner seulement les N dernières lignes | | Start From Column | Ignorer les colonnes avant la position N | | Filters | Filtrer les lignes par valeur de colonne (plusieurs filtres = logique AND) | | Column Names or IDs | Sélectionner les colonnes à inclure dans la sortie |

Workflow : trouver et modifier une ligne précise

1. Get Rows (Table)
   ├─ Table   : Suivi
   ├─ Options : Include Row Number ✓
   └─ Filters : N° = {{ $json.numero }}

2. Update Row (Table)
   ├─ Table      : Suivi
   ├─ Row Number : {{ $json.__rowNumber }}
   └─ Column Values : Statut → Validé

Resource : Workbook

| Opération | Description | |---|---| | Get Sheets | Retourne tous les noms de feuilles du classeur | | Get Tables | Retourne toutes les tables nommées de toutes les feuilles |

Node — NextCloud Search

Recherche une valeur dans une colonne d'un fichier tableur Nextcloud et retourne la valeur d'une autre colonne sur la même ligne — l'équivalent d'un VLOOKUP / RECHERCHEV directement dans n8n.

L'item d'entrée est enrichi avec les valeurs trouvées. Plusieurs lookups peuvent être configurés en une seule exécution (un seul téléchargement du fichier).

Sélection de la source

Source Type ▼  Sheet  ← ou "Table" (table Excel nommée)
From        ▼  From List
Dossier     ▼  📁 Documents
Fichier     ▼  catalogue.xlsx
Sheet       ▼  Tarifs         ← ou "Table" si Source Type = Table

Lookups

Chaque entrée du bloc Lookups configure une recherche indépendante :

| Champ | Exemple | Description | |---|---|---| | Search Column | Nom du matériel | Colonne où chercher (dropdown auto-chargé depuis le fichier) | | Search Value | {{ $json.materiel_nom_1 }} | Valeur à trouver — supporte les expressions n8n | | Return Column | Prix | Colonne dont la valeur est retournée (dropdown auto-chargé depuis le fichier) | | Output Field Name | materiel_prix_1 | Nom du champ JSON écrit dans l'item de sortie |

Exemple de résultat avec Pass Through activé (défaut) :

{
  "materiel_nom_1": "Table",
  "materiel_prix_1": "50€"
}

Options

| Option | Défaut | Description | |---|---|---| | Case Sensitive | false | Correspondance exacte de la casse | | If Not Found | Set to Null | Set to Null : null silencieux · Throw Error : arrêt avec erreur | | Pass Through Original Data | true | Conserver tous les champs d'entrée dans l'item de sortie |

Workflow typique — enrichir un bon de commande

Webhook (reçoit materiel_nom_1 = "Table")
  → NextCloud Search
      Lookup 1 : Nom du matériel = {{ $json.materiel_nom_1 }} → Prix → materiel_prix_1
      Lookup 2 : Nom du matériel = {{ $json.materiel_nom_2 }} → Prix → materiel_prix_2
  → NextCloud Doc Template (utilise materiel_prix_1, materiel_prix_2 dans le template)

Node — NextCloud Doc Template

Génère des documents Word (DOCX) ou LibreOffice Writer (ODT) à partir de templates stockés sur Nextcloud, en utilisant le moteur Carbone — syntaxe identique à n8n-nodes-carbonejs.

Syntaxe Carbone dans les templates

| Placeholder dans le document | Description | |---|---| | {d.nom} | Valeur simple | | {d.date:formatD('DD/MM/YYYY')} | Date formatée | | {d.montant:toFixed(2)} | Nombre avec 2 décimales | | {d.lignes[i].designation} | Début de boucle — répète la ligne/section pour chaque item du tableau | | {d.lignes[i+1].designation} | Fin de boucle (dernière cellule de la boucle) | | {d.actif ? 'Oui' : 'Non'} | Condition ternaire | | {!d.champ} | Affiché uniquement si vide/falsy |

Important : tapez les accolades { } directement au clavier dans du texte normal dans Word. N'utilisez pas Insertion → Champ (Ctrl+F9).

Opération : Fill Template

Sélection du template :

Template From   ▼  From List
Template Folder ▼  📁 Templates
Template File   ▼  contrat.docx

Ou mode By Path (Expression) pour un chemin dynamique.

Mode de données :

| Mode | Utilisation | |---|---| | Key-Value Pairs | Saisie variable par variable. Le dropdown Variable Name or ID charge automatiquement tous les {d.xxx} trouvés dans le template. | | JSON Object | Passage d'un objet JSON complet — obligatoire pour les boucles et les pages dynamiques. Supporte les expressions n8n : ={{ { "lignes": $json.items } }} |

Format de sortie :

| Format | Dépendance | |---|---| | DOCX (défaut) | Aucune — fonctionne sur toutes les installations n8n | | PDF | Nécessite LibreOffice installé sur le serveur n8n |

Mode de sortie — Save to Nextcloud :

Output Destination  ▼  Select Folder + File Name
Output Folder       ▼  📁 Documents / Filled
Output File Name       contrat_{{ $json.client }}.docx

Ou mode By Path (Expression) pour un chemin complet dynamique.

Mode de sortie — Return as Binary :

Binary Property  : data
Output File Name : contrat_{{ $json.client }}.docx

Opération : Get Variables

Scanne le template et retourne tous les placeholders {d.xxx} trouvés.

{
  "variables": ["{d.nom}", "{d.date}", "{d.lignes[i].designation}"],
  "rawKeys": ["nom", "date", "lignes[i].designation"],
  "count": 3,
  "templatePath": "/Templates/contrat.docx"
}

NextCloud Doc Template — Annexes conditionnelles

Cette fonctionnalité permet d'ajouter automatiquement des fichiers DOCX supplémentaires (règlements, schémas, annexes légales…) à la fin du document généré, selon des conditions évaluées à l'exécution. Un saut de page est inséré automatiquement avant chaque annexe.

Exemple : template principal (2 pages) + annexe trottoir (1 page) + annexe chaussée (1 page) → document final de 4 pages, sans créer de template combiné.

Configuration

1. Sélectionner le dossier des annexes (partagé) :

Annexes Folder  ▼  📁 Templates / Annexes

2. Ajouter une entrée par annexe ([+ Add Annexe]) :

Condition — Value to Check : {{ $json.trottoir }}
Condition                  : Is Not Empty ▼
Annexe File                : annexe_trottoir.docx ▼   ← dropdown chargé depuis Annexes Folder
Or: Annexe File Path       : (vide)

Conditions disponibles

| Condition | L'annexe est ajoutée quand… | |---|---| | Is Not Empty | La valeur n'est pas vide / null / 0 / false | | Equals | La valeur correspond exactement à Compare To | | Not Equals | La valeur est différente de Compare To | | Contains | La valeur contient la chaîne Compare To | | Always Append | Toujours ajouter, quelle que soit la valeur |

Chemin dynamique par expression

Le champ Or: Annexe File Path (Expression) prend la priorité sur le dropdown — utile quand le nom du fichier dépend d'une donnée du workflow :

Or: Annexe File Path : /Templates/Annexes/annexe_{{ $json.type_voirie }}.docx

Cumul de plusieurs annexes

Toutes les annexes dont la condition est vraie sont fusionnées dans l'ordre de la liste. La fusion gère les images (copie et renommage automatique pour éviter les conflits de rId) et les hyperliens.

[Annexe 1] trottoir   Is Not Empty → annexe_trottoir.docx   ✓ ajoutée
[Annexe 2] chaussee   Is Not Empty → annexe_chaussee.docx   ✗ ignorée (champ vide)
[Annexe 3] securite   Equals "Barrières" → annexe_barriere.docx  ✓ ajoutée

Résultat : template (2p) + annexe_trottoir (1p) + annexe_barriere (1p) = 4 pages

Node — NextCloud Doc Template (suite)

Formateurs Carbone

| Formateur | Résultat | |---|---| | {d.montant:toFixed(2)} | 1500.00 | | {d.date:formatD('DD/MM/YYYY')} | 15/05/2025 | | {d.nom:upper()} | MARTIN | | {d.nom:ucFirst()} | Martin | | {d.note:ifEmpty('N/A')} | N/A si vide | | {d.montant:convCurr('EUR','fr-FR')} | 1 500,00 € |

Node — NextCloud PDF

Lit, extrait le texte et remplit les champs de formulaires PDF stockés sur Nextcloud.

Opération : Get Fields

Extrait tous les champs d'un formulaire AcroForm interactif (PDF non aplati). Retourne un JSON structuré avec deux niveaux :

• values : objet plat { NomChamp: valeur } — utilisable directement dans les expressions ($json.values.NomChamp)
• fields : tableau détaillé avec name, type, value, options, required, readOnly

Si Get Fields retourne 0 champs, le PDF est probablement aplati — utilisez Get Text ou le node NextCloud OCR.

Types de champs supportés :

| Type | Description | Valeur retournée | |---|---|---| | text | Champ texte | string | | checkbox | Case à cocher | true / false | | radio | Bouton radio | string (option sélectionnée) | | dropdown | Liste déroulante | string | | optionList | Liste à sélection multiple | string[] | | signature | Champ de signature | null | | button | Bouton | null |

Opération : Get Text

Extrait le texte brut page par page depuis la couche texte du PDF, sans OCR. Fonctionne sur les PDFs aplatis remplis numériquement (CERFA numérique, formulaires administratifs, etc.) dont le texte est vectoriel mais non sélectionnable comme champs AcroForm.

{
  "pdfPath": "/cerfa_14023.pdf",
  "text": "DÉCLARATION DE CESSION\nVendeur : DUPONT Jean\nMarque : Renault...",
  "pageCount": 2,
  "pages": [
    { "page": 1, "text": "DÉCLARATION DE CESSION\n..." },
    { "page": 2, "text": "..." }
  ]
}

Si text est vide ou illisible, le PDF est scanné (image) — utilisez le node NextCloud OCR avec Docling.

Opération : Fill Fields

Mode de saisie :

| Mode | Description | |---|---| | Paires Clé-Valeur | Le dropdown Nom du champ charge automatiquement tous les champs du PDF avec leur type et leurs options. | | Objet JSON | Passage d'un objet JSON complet — idéal pour les webhooks : ={{ $json.body }} |

Valeurs acceptées pour les cases à cocher :

| Coché | Non coché | |---|---| | Oui, Yes, True, 1, Vrai, checked, on | Non, No, False, 0, Faux |

(insensible à la casse)

Option Aplatir le formulaire : les champs deviennent du texte imprimé non modifiable. Fonctionne même si certains champs n'ont pas été remplis — les champs vides sont aplatis comme espace blanc.

Mode de sortie — Save to Nextcloud :

Destination de sortie   ▼  Choisir un dossier + nom de fichier
Dossier de sortie       ▼  📁 Documents / Remplis
Nom du fichier de sortie   formulaire_{{ $json["Nom"] }}.pdf

Ou mode Par chemin complet (expression).

Node — NextCloud OCR

Extrait le texte de fichiers PDF stockés sur Nextcloud via un moteur OCR externe. Conçu pour les PDFs scannés (image) ou aplatis sans couche texte exploitable.

Pour les PDFs remplis numériquement (texte vectoriel), préférez NextCloud PDF → Get Text qui est plus rapide et ne nécessite aucun serveur externe.

Choisir le bon outil

| Situation | Node recommandé | |---|---| | PDF interactif avec champs AcroForm | NextCloud PDF → Get Fields | | PDF aplati rempli numériquement (texte sélectionnable) | NextCloud PDF → Get Text | | PDF scanné ou texte non sélectionnable | NextCloud OCR → Docling ou Mistral |

Moteur : Docling (local)

Envoie le PDF au serveur docling-serve auto-hébergé. Idéal pour les environnements self-hosted — aucune donnée ne quitte votre infrastructure.

| Paramètre | Défaut | Description | |---|---|---| | URL du serveur | http://localhost:5001 | URL de base du serveur docling-serve | | Version API | /v1alpha/convert/source | Chemin de l'endpoint — sélectionner selon la version installée |

Versions API :

| Version Docling-serve | Chemin | |---|---| | ≤ 0.4 | /v1alpha/convert/source | | ≥ 0.5 | /v1/convert/source | | Autre | Personnalisé (champ libre) |

Démarrer Docling en local (Docker) :

docker run -p 5001:5001 ds4sd/docling-serve

Moteur : Mistral OCR

Envoie le PDF (encodé base64) à l'API Mistral OCR.

| Paramètre | Défaut | Description | |---|---|---| | Clé API Mistral | — | Créer sur console.mistral.ai/api-keys | | Modèle | mistral-ocr-latest | Identifiant du modèle OCR |

Sortie

{
  "pdfPath": "/cerfa_14023.pdf",
  "provider": "docling",
  "text": "DÉCLARATION DE CESSION\nVendeur : DUPONT Jean\n...",
  "markdown": "# DÉCLARATION DE CESSION\n\n**Vendeur :** DUPONT Jean\n...",
  "pageCount": 2,
  "pages": [
    { "index": 0, "text": "...", "markdown": "..." }
  ]
}

pages[] est peuplé par les providers qui retournent une pagination (Mistral). markdown préserve la structure du document (titres, tableaux) — préférable pour le post-traitement AI.

Option : Inclure la réponse brute

Activez Inclure la réponse brute pour voir la réponse complète du provider dans le champ raw — utile pour diagnostiquer des problèmes ou explorer les métadonnées disponibles.

Workflow CERFA — Extraire les champs d'un formulaire aplati

NextCloud PDF → Get Text
  (si text vide → NextCloud OCR avec Docling)
    ↓
Node AI (OpenAI / Claude)
  Prompt : "Voici le texte d'un CERFA N°14023*01 (déclaration de cession).
            Extrais en JSON : nom_vendeur, prenom_vendeur, adresse_vendeur,
            nom_acheteur, prenom_acheteur, adresse_acheteur, marque, modele,
            immatriculation, vin, date_cession, kilometrage.
            Si absent → null."
    ↓
Utiliser les champs extraits dans le reste du workflow

Chemins Nextcloud

Tous les chemins sont relatifs à la racine de votre espace Nextcloud :

/                                → racine
/Documents/rapport.xlsx          → fichier dans Documents
/Templates/Annexes/trottoir.docx → sous-dossier

Workflows typiques

Contrat depuis un formulaire n8n

Form Trigger → NextCloud Doc Template (Fill Template, Return Binary) → Send Email

Remplir un PDF depuis un webhook

Webhook → NextCloud PDF (Fill Fields, Save to Nextcloud)

Facture avec tableau de lignes dynamiques

HTTP Request → NextCloud Doc Template (JSON Object mode, {d.lignes[i].xxx})

Demande avec annexes conditionnelles

Webhook → NextCloud Doc Template (Fill Template + Conditional Annexes)

Extraire les données d'un CERFA rempli numériquement (aplati)

NextCloud PDF (Get Text) → Node AI → traitement des champs extraits

Extraire les données d'un CERFA scanné

NextCloud OCR (Docling) → Node AI → traitement des champs extraits

Développement local

git clone https://github.com/wdebonne/n8n-nodes-nextcloud-ext.git
cd n8n-nodes-nextcloud-ext

NODE_OPTIONS=--use-system-ca npm install
npm run build   # TypeScript → dist/
npm run dev     # mode watch

Tester dans n8n

npm run build && npm link
# Dans le répertoire de données n8n :
npm link n8n-nodes-nextcloud-ext

Roadmap

• [ ] Support OAuth2 Nextcloud (PKCE)
• [ ] Node Nextcloud Talk (messages, salons)
• [ ] Node Nextcloud Contacts (CardDAV)
• [ ] Node Nextcloud Calendar (CalDAV)

Licence

MIT — © 2025 wdebonne

Liens

• npmjs.com/package/n8n-nodes-nextcloud-ext
• GitHub
• Changelog
• Guide Doc Template
• Documentation n8n — Community Nodes