--- title: "Utilisation" weight: 30 description: "Navigation dans les fichiers NextCloud, gestion de l'arborescence, archivage et partage depuis Dolibarr." --- # 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. ![Onglet DoliDrive sur la fiche d'un tiers avec la liste des fichiers et dossiers](screenshots/onglet-tiers-fichiers.webp) ### 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](/view.php?path=dolidrive/configuration.md) 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). ![Onglet DoliDrive sur la fiche d'un projet avec l'explorateur de fichiers](screenshots/onglet-projet-fichiers.webp) ## Archivage automatique Lorsque l'archivage est activé dans la [configuration](/view.php?path=dolidrive/configuration.md) (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 : | Option | Description | |--------|-------------| | Libellé | Nom optionnel pour identifier le partage | | Protection par mot de passe | Mot de passe requis pour accéder au fichier (laisser vide pour aucun) | | Date d'expiration | Date après laquelle le lien ne fonctionne plus | | Permissions | Lecture seule, autoriser la modification, ou autoriser l'upload | 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](/view.php?path=dolidrive/configuration.md), 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. ![Page des logs d'activité avec les filtres et la liste des opérations](screenshots/logs-activite.webp) ### Types d'opérations enregistrées | Action | Description | |--------|-------------| | Upload | Envoi d'un fichier vers NextCloud | | Download | Téléchargement d'un fichier depuis NextCloud | | Suppression | Suppression d'un fichier | | Création dossier | Création d'un dossier sur NextCloud | | Synchronisation | Synchronisation de fichiers entre Dolibarr et NextCloud | | Ajout file d'attente | Ajout d'une opération dans la file d'attente | | Traitement file | Traitement d'une opération en file d'attente | | Purge cache | Nettoyage du cache de métadonnées | | Webhook | Réception d'une notification webhook | | Authentification | Événement d'authentification | ### 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 | Champ | Description | |-------|-------------| | Activer la création automatique | Active la création automatique de l'arborescence dans la GED externe pour ce groupe | | Liste des sous-dossiers | Arborescence de sous-dossiers à créer automatiquement, avec les variables de substitution `__THIRDPARTY_NAME__`, `__SUPPLIER_NAME__` et `__BANK_NAME__` | ### Comptes bancaires | Champ | Description | |-------|-------------| | Rendre ce compte accessible | Active l'utilisation du mot-clé `__BANK_NAME__` pour ce compte bancaire dans les créations automatiques d'arborescence |