Skip to main content

4.8 Gestion du glisser-déposer pour les documents joints

Cette section permet d'ajouter une zone de dépôt rapide de fichiers sur les onglets « Documents joints » de tous les objets de Dolibarr : propositions commerciales, commandes, factures, produits, services, tiers, contrats, projets, etc.

La fonctionnalité s'appuie sur le mécanisme natif de glisser-déposer de Dolibarr et l'attache à la barre de titre du tableau « Fichiers joints », sans modifier aucun fichier core.

workflow2.png

1. ACTIVER UNE ZONE DE GLISSER-DÉPOSER (DRAG AND DROP) [Ligne 1]

  • Ajoute une zone de glisser-déposer directement sur la barre de titre du tableau « Fichiers joints », dans les onglets « Documents joints » de tous les objets.
  • La mention « ou déposez un fichier ici » apparaît dans l'en-tête du tableau, accompagnée d'une icône de téléversement.
  • Pour ajouter un document : faites glisser un fichier depuis votre ordinateur et déposez-le sur cette zone — le téléversement démarre immédiatement, sans passer par le formulaire de sélection de fichier.
  • Fonctionne sur tous les types d'objets disposant d'un onglet « Documents joints », sans configuration supplémentaire par module.
  • Prérequis : JavaScript doit être activé dans le navigateur.

Paramètre 50

2. CONSERVER LE NOM ORIGINAL DU FICHIER (PRODUITS/SERVICES) [Ligne 2]

Sous-option visible uniquement lorsque le paramètre 1 est activé. Concerne exclusivement les fiches produits et services.

  • Par défaut, Dolibarr préfixe automatiquement le nom du fichier déposé sur un produit ou service par la référence du produit (masque de nom).
  • Exemple : un fichier notice.pdf déposé sur le produit REF001 est enregistré REF001-notice.pdf.
  • Lorsque cette option est activée, le nom original est conservé tel quel lors du glisser-déposer (aucun préfixage par la référence).
  • N'a aucun effet sur les autres types d'objets : seuls les produits et services sont concernés.
  • Le dépôt sur un produit/service est alors traité par un point d'entrée dédié du module qui désactive le masque de nom.

Situation

Nom enregistré

Paramètre 50

désactivé

REF001-notice.pdf

Paramètre 50

activé

notice.pdf

UTILISATION :
    1. Activez l' Option 1 dans l'onglet Paramètres.
    2. (Facultatif) Activez l' Option 2 si vous gérez des fichiers sur des produits/services et souhaitez préserver leur nom d'origine.
    3. Ouvrez l'onglet « Documents joints » de n'importe quel objet.
    4. Faites glisser un ou plusieurs fichiers depuis votre ordinateur vers la barre de titre du tableau « Fichiers joints ».
    5. Le ou les fichiers sont téléversés automatiquement et apparaissent immédiatement dans la liste des fichiers joints.
REMARQUES :

Permissions respectées : la zone de glisser-déposer tient compte des droits de l'utilisateur — seuls les utilisateurs autorisés à écrire sur l'objet peuvent y déposer des fichiers.

Contrôles de sécurité natifs : les vérifications Dolibarr restent appliquées (analyse antivirus si configurée, détection de contenu exécutable, etc.).

Aucun fichier core modifié : la zone est injectée dynamiquement via un hook — l'intégrité de Dolibarr est préservée.

Back to top