Connecteur Nextcloud
Configuration du connecteur
Le connecteur Nextcloud permet de synchroniser les fichiers et documents stockés dans votre instance Nextcloud vers Wikit Semantics. Il récupère automatiquement les fichiers du dossier configuré et applique des filtres d'inclusion ou d'exclusion de chemins selon vos besoins.
| Nom du champ | Format / Type | Obligatoire | Commentaire |
|---|---|---|---|
| URL | URL | ✅ | URL complète de votre instance Nextcloud (ex : https://cloud.exemple.com) |
| Chemin du dossier source | Texte libre | ✅ | Chemin du dossier racine à synchroniser dans Nextcloud |
| Identifiant | Texte libre | ✅ | Nom d'utilisateur ou identifiant de connexion Nextcloud |
| Mot de passe | Mot de passe | ✅ | Mot de passe du compte ou mot de passe d'application Nextcloud |
| Chemins à inclure | Liste de textes | ➖ | Liste des chemins spécifiques à inclure dans la synchronisation |
| Chemins à exclure | Liste de textes | ➖ | Liste des chemins à exclure de la synchronisation |
💡 Les champs marqués ✅ sont obligatoires pour que le connecteur puisse fonctionner.
Fonctionnement du connecteur
Le connecteur Nextcloud synchronise les fichiers de manière intelligente (smart sync) :
- Mode de synchronisation : Le connecteur détecte automatiquement les fichiers nouveaux, modifiés ou supprimés depuis la dernière synchronisation.
- Types de contenus synchronisés : Seuls les fichiers avec des types MIME autorisés sont synchronisés (documents bureautiques, PDF, images, etc.). Les dossiers sont parcourus récursivement.
- Fréquence : La synchronisation s'exécute selon la planification configurée dans Wikit Connect.
- Filtres de chemins : Vous pouvez restreindre la synchronisation à certains dossiers (chemins à inclure) ou en exclure d'autres (chemins à exclure).
- Gestion des modifications : Le connecteur compare la date de dernière modification des fichiers pour détecter les mises à jour.
- Gestion des suppressions : Les fichiers supprimés de Nextcloud sont également supprimés de Wikit Semantics lors de la synchronisation suivante.
- Protocole WebDAV : Le connecteur utilise le protocole WebDAV pour interroger et télécharger les fichiers depuis Nextcloud.
Prérequis
Avant de configurer le connecteur Nextcloud dans la console Wikit Connect, assurez-vous que :
- Compte utilisateur ou compte de service : Vous disposez d'un compte Nextcloud avec les droits en lecture sur les dossiers à synchroniser.
- Mot de passe d'application (recommandé) : Pour des raisons de sécurité, créez un mot de passe d'application spécifique dans les paramètres de votre compte Nextcloud plutôt que d'utiliser votre mot de passe principal.
- Accès WebDAV activé : L'API WebDAV doit être accessible sur votre instance Nextcloud (elle est activée par défaut). L'URL WebDAV est généralement
/remote.php/dav/files/. - Droits d'accès : Le compte utilisé doit avoir accès en lecture aux dossiers et fichiers que vous souhaitez synchroniser.
FAQ
Comment fonctionnent les chemins à inclure et à exclure ?
Les chemins à inclure permettent de restreindre la synchronisation à certains dossiers uniquement. Les chemins à exclure permettent d'ignorer certains sous-dossiers. Si vous renseignez des chemins à inclure, seuls les fichiers dans ces chemins seront synchronisés. Les exclusions sont appliquées ensuite, même si un chemin est inclus. Le format attendu est : Nom-du-dossier/Sous-dossier.
Pourquoi certains fichiers ne sont-ils pas synchronisés ?
Le connecteur ne synchronise que les fichiers dont le type MIME est autorisé (documents, PDF, images, etc.). Les fichiers exécutables, archives ZIP non autorisées ou types de fichiers non supportés sont ignorés. Vérifiez également que le compte utilisé dispose des droits d'accès en lecture sur ces fichiers.