Configuration
La configuration du module est accessible depuis Accueil > Configuration > Modules > DoliDrive. Elle est organisée en six onglets.
Onglet Configuration
Cet onglet regroupe les paramètres de connexion au serveur NextCloud et les options générales.
Connexion NextCloud
| Paramètre | Description |
|---|---|
| Serveur | URL de votre serveur NextCloud (par exemple https://masociete.on1.dolizen.fr) |
| Identifiant | Nom d'utilisateur NextCloud. Le mot "dolibarr" est interdit. |
| Clé de connexion à l'API | Token d'application NextCloud, généré automatiquement (voir ci-dessous) |
| Sous-dossier BASE | Dossier racine sur NextCloud qui sert de base à toute l'arborescence |
| Nom du dossier clients | Nom du sous-dossier qui contient tous les dossiers clients, situé dans le dossier BASE |
Génération de la clé API
- Renseignez l'URL du serveur et l'identifiant, puis sauvegardez
- Cliquez sur le bouton Générer une clé API
- Une fenêtre NextCloud s'ouvre pour vous authentifier
- Autorisez l'accès applicatif
- La clé est automatiquement enregistrée dans DoliDrive
Information : Si une clé API existe déjà, le bouton de génération est désactivé. Supprimez d'abord la clé existante, sauvegardez, puis générez-en une nouvelle.
Structure de l'arborescence
| Paramètre | Description |
|---|---|
| Choix de la structure | Organisation par Tiers (opérationnel) ou par Groupes d'utilisateurs |
| Considérer les prospects comme clients | Crée aussi des dossiers pour les prospects |
| Arborescence clients | Liste des sous-dossiers à créer automatiquement pour chaque client (un par ligne) |
| Limiter aux clients actifs | Ne traite que les clients ayant eu une activité commerciale dans les 12 derniers mois |
Dans la zone de texte de l'arborescence, vous pouvez utiliser des variables de substitution :
__THIRDPARTY_NAME__-- remplacé par le nom du client__SUPPLIER_NAME__-- remplacé par le nom du fournisseur__BANK_NAME__-- remplacé par le nom du compte bancaire (si activé sur le compte)
Sécurité
| Paramètre | Description |
|---|---|
| Clé secrète HMAC pour les webhooks | Si définie, toutes les requêtes webhook doivent être signées avec cette clé (en-tête X-Dolidrive-Signature) |
| Limite de requêtes webhook par minute | Nombre maximum de requêtes webhook acceptées par IP et par minute (défaut : 60, 0 pour désactiver) |
| Taille maximale des fichiers | Taille maximale autorisée pour le téléchargement de fichiers en octets (défaut : 52 428 800, soit 50 Mo) |
Performance
| Paramètre | Description |
|---|---|
| Durée de vie du cache | Durée de conservation des métadonnées en cache, en secondes (défaut : 86 400, soit 24 h. 0 pour désactiver) |
Test de connexion
Après avoir configuré la connexion et généré la clé API, cliquez sur le bouton Tester la connexion pour vérifier que DoliDrive communique correctement avec votre serveur NextCloud.
Création des dossiers pour tous les clients
Le bouton Créer tous les dossiers pour tous les clients lance la création de l'arborescence configurée pour chaque client existant dans Dolibarr.
Onglet Projets
Cet onglet configure la gestion des dossiers liés aux projets dans NextCloud.
| Paramètre | Description |
|---|---|
| Création d'une arborescence pour les projets | Active la création de dossiers projet dans NextCloud |
| Sous-dossier de stockage des projets | Nom du dossier à créer dans le dossier de chaque tiers pour y stocker les projets |
| Arborescence par projet | Liste des sous-dossiers à créer automatiquement pour chaque projet |
| Créer un dossier pour chaque tâche | Crée automatiquement un sous-dossier par tâche du projet |
Copie automatique des documents liés aux projets
Vous pouvez configurer la copie automatique des documents Dolibarr liés aux projets vers NextCloud. Pour chaque type de document, indiquez le nom du sous-dossier de destination. Laissez le champ vide pour désactiver la copie.
| Paramètre | Description |
|---|---|
| Sous-dossier devis clients | Dossier de stockage des devis liés au projet |
| Sous-dossier commandes clients | Dossier de stockage des commandes liées au projet |
| Sous-dossier contrats | Dossier de stockage des contrats liés au projet |
| Sous-dossier fiches d'intervention | Dossier de stockage des fiches d'intervention liées au projet |
| Sous-dossier factures clients | Dossier de stockage des factures liées au projet |
| Sous-dossier devis fournisseurs | Dossier de stockage des devis fournisseurs liés au projet |
| Sous-dossier commandes fournisseurs | Dossier de stockage des commandes fournisseurs liées au projet |
| Sous-dossier factures fournisseurs | Dossier de stockage des factures fournisseurs liées au projet |
Onglet Archives
Cet onglet configure l'archivage automatique des documents Dolibarr vers NextCloud lors de leur génération.
Devis / Propositions commerciales
| Paramètre | Description |
|---|---|
| Archiver les devis dans NextCloud | Active la copie automatique des devis générés |
| Dossier pour l'archivage des devis | Chemin du dossier de destination, relatif au dossier BASE. Vous pouvez utiliser __THIRDPARTY_NAME__ |
Commandes
| Paramètre | Description |
|---|---|
| Archiver les commandes dans NextCloud | Active la copie automatique des commandes générées |
| Dossier pour l'archivage des commandes | Chemin du dossier de destination, relatif au dossier BASE |
Factures
| Paramètre | Description |
|---|---|
| Archiver les factures dans NextCloud | Active la copie automatique des factures générées |
| Dossier pour l'archivage des factures | Chemin du dossier de destination, relatif au dossier BASE |
Astuce : La variable
__THIRDPARTY_NAME__est remplacée automatiquement par le nom du client. Par exemple, le cheminClients/__THIRDPARTY_NAME__/Facturescrée un sous-dossier par client.
Onglet Fichiers liés
Cet onglet configure la synchronisation des fichiers liés aux produits et services entre Dolibarr et NextCloud.
Produits et services
| Paramètre | Description |
|---|---|
| Copier les fichiers des produits Dolibarr vers NextCloud | Active la copie des fichiers joints aux produits vers NextCloud |
| Dossier de stockage des produits dans NextCloud | Chemin relatif par rapport à la BASE configurée |
| Copier les fichiers des produits de NextCloud dans la GED Dolibarr | Active la synchronisation inverse, de NextCloud vers Dolibarr |
| Propager la suppression vers NextCloud | Lorsque vous supprimez un fichier dans Dolibarr, il est aussi supprimé dans NextCloud |
| Propager la suppression vers Dolibarr | Lorsque vous supprimez un fichier dans NextCloud, il est aussi supprimé dans la GED Dolibarr |
Attention : Si vous désactivez la propagation de suppression vers NextCloud, les fichiers supprimés dans Dolibarr restent dans NextCloud. Vous devez alors les supprimer manuellement.
Onglet Logs
Cet onglet affiche le journal des opérations effectuées par DoliDrive. Consultez la page Utilisation pour plus de détails sur les logs d'activité.
Onglet À propos
Cet onglet affiche les informations générales du module : version, auteur, licence.