Utilisation

Onglet DoliDrive sur les fiches Tiers

Après activation et configuration du module, un onglet DoliDrive apparaît sur chaque fiche Tiers. Cet onglet affiche l'explorateur de fichiers NextCloud du client.

Navigation dans les fichiers

L'explorateur affiche les fichiers et dossiers du client sous forme de liste. Pour chaque élément, vous voyez :

• Le nom du fichier ou dossier
• Le type (fichier ou dossier)
• La taille
• La date de dernière modification

Cliquez sur un dossier pour naviguer à l'intérieur. Cliquez sur un fichier pour le télécharger.

Mode album photo

Cliquez sur le bouton Album pour basculer l'affichage en mode galerie. Ce mode affiche les miniatures des images contenues dans le dossier courant. Cliquez sur le bouton liste pour revenir à l'affichage standard.

Ouvrir dans NextCloud

Le bouton en forme de lien (icône infini) ouvre le dossier courant directement dans l'interface web de NextCloud, dans un nouvel onglet.

Créer le répertoire d'accueil

Si le dossier du client n'existe pas encore sur NextCloud, le bouton Créer le répertoire d'accueil apparaît. Il crée le dossier racine du client sur le serveur NextCloud.

Créer l'arborescence

Le bouton Créer l'arborescence crée tous les sous-dossiers configurés dans la configuration pour ce client. Cette opération est idempotente : les dossiers déjà existants ne sont pas modifiés.

Envoyer des fichiers par email

Sélectionnez un ou plusieurs fichiers, puis cliquez sur le bouton d'envoi par email. Dolibarr ouvre le formulaire d'envoi d'email avec les fichiers sélectionnés en pièces jointes.

Attention : Les fichiers trop volumineux ne peuvent pas être joints. Un message vous informe si certains fichiers n'ont pas pu être attachés.

Onglet DoliDrive sur les fiches Projet

Un onglet DoliDrive apparaît également sur chaque fiche Projet. Il fonctionne de la même manière que l'onglet Tiers, avec en plus la possibilité de créer l'arborescence spécifique au projet (sous-dossiers par tâche, dossiers de stockage des documents liés).

Archivage automatique

Lorsque l'archivage est activé dans la configuration (onglet Archives), les documents générés par Dolibarr sont automatiquement copiés vers NextCloud :

• Devis -- copie lors de la génération du PDF
• Commandes -- copie lors de la génération du PDF
• Factures -- copie lors de la génération du PDF

Le chemin de destination est celui configuré dans l'onglet Archives, avec substitution automatique de la variable __THIRDPARTY_NAME__ par le nom du client.

Synchronisation des produits

Si la synchronisation des fichiers produits est activée dans l'onglet Fichiers liés :

• Les fichiers joints aux fiches produits dans Dolibarr sont copiés vers NextCloud
• Les fichiers ajoutés dans NextCloud sont importés dans la GED native de Dolibarr
• La suppression est propagée selon la configuration choisie

Liens de partage

DoliDrive permet de créer des liens de partage NextCloud directement depuis Dolibarr.

Créer un lien de partage

1. Depuis l'explorateur de fichiers, repérez le fichier à partager
2. Cliquez sur Créer un lien de partage
3. Configurez les options du partage :

4. Cliquez sur Valider

Gérer les partages existants

Les liens de partage existants sont affichés avec leur URL, la date de création et la date d'expiration. Vous pouvez :

• Copier le lien dans le presse-papiers
• Modifier les options du partage (mot de passe, expiration, permissions)
• Supprimer le lien de partage

Synchronisation planifiée

DoliDrive enregistre une tâche planifiée (cron) qui exécute la synchronisation de NextCloud vers Dolibarr toutes les 15 minutes. Cette tâche est désactivée par défaut.

Pour l'activer :

1. Allez dans Accueil > Configuration > Tâches planifiées
2. Recherchez la tâche SyncNextCloudToDolibarr
3. Activez-la

Webhook NextCloud

DoliDrive fournit un point d'entrée webhook à l'adresse dolidrive/public/hook.php. Configurez NextCloud pour envoyer des notifications vers cette URL afin de déclencher des synchronisations en temps réel.

Si vous avez défini une clé secrète HMAC dans la configuration, toutes les requêtes webhook doivent inclure l'en-tête X-Dolidrive-Signature contenant la signature HMAC-SHA256 du corps de la requête.

Logs d'activité

L'onglet Logs de la configuration du module affiche un journal détaillé de toutes les opérations effectuées par DoliDrive.

Types d'opérations enregistrées

Filtres disponibles

Vous pouvez filtrer les logs par :

• Niveau (information, avertissement, erreur)
• Type d'action
• Utilisateur
• Période (date de début et de fin)
• Texte libre

Rétention des logs

Les logs sont automatiquement purgés au-delà de la durée de rétention configurée (défaut : 90 jours). Vous pouvez aussi purger manuellement les logs depuis cette page.

Groupes d'utilisateurs et comptes bancaires

DoliDrive ajoute des champs supplémentaires sur deux objets Dolibarr :

Groupes d'utilisateurs

Comptes bancaires