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

<span style="white-space: pre-wrap;">Cette section permet d'ajouter une </span>**zone de dépôt rapide de fichiers**<span style="white-space: pre-wrap;"> sur les onglets « Documents joints » de tous les objets de </span>***Dolibarr***<span style="white-space: pre-wrap;"> : propositions commerciales, commandes, factures, produits, services, tiers, contrats, projets, etc.</span>

<span style="white-space: pre-wrap;">La fonctionnalité s'appuie sur le mécanisme natif de glisser-déposer de </span>***Dolibarr***<span style="white-space: pre-wrap;"> et l'attache à la barre de titre du tableau « Fichiers joints », </span>**sans modifier aucun fichier core**.

[![workflow2.png](https://wiki.infras.fr/uploads/images/gallery/2026-06/scaled-1680-/JgwBcmRg1QRdRzcu-workflow2.png)](https://wiki.infras.fr/uploads/images/gallery/2026-06/scaled-1680-/JgwBcmRg1QRdRzcu-workflow2.png)

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

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

**Paramètre 50**

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

<span style="white-space: pre-wrap;">Sous-option visible </span>**uniquement lorsque le paramètre 1 est activé**<span style="white-space: pre-wrap;">. Concerne exclusivement les fiches </span>**produits et services**.

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

<table id="bkmrk-situationnom-enregis" style="width: 100%; border-collapse: collapse; font-size: 13px;"><colgroup><col></col><col></col></colgroup><tbody><tr><th class="align-left" style="background: rgb(238, 238, 238); padding: 9px 16px; text-align: left; border-bottom: 1px solid rgb(221, 221, 221); font-family: "Courier New", monospace; color: rgb(85, 85, 85); font-weight: 700; text-transform: uppercase; letter-spacing: 0.5px;">**Situation**

</th><th class="align-left" style="background: rgb(238, 238, 238); padding: 9px 16px; text-align: left; border-bottom: 1px solid rgb(221, 221, 221); font-family: "Courier New", monospace; color: rgb(85, 85, 85); font-weight: 700; text-transform: uppercase; letter-spacing: 0.5px;">**Nom enregistré**

</th></tr><tr style="border-bottom: 1px solid rgb(238, 238, 238);"><td style="padding: 9px 16px; color: rgb(68, 68, 68);"><span style="white-space: pre-wrap;">Paramètre 50 </span>

**désactivé**

</td><td style="padding: 9px 16px; font-family: "Courier New", monospace; color: rgb(192, 57, 43);">REF001-notice.pdf

</td></tr><tr><td style="padding: 9px 16px; color: rgb(68, 68, 68);"><span style="white-space: pre-wrap;">Paramètre 50 </span>

**activé**

</td><td style="padding: 9px 16px; font-family: "Courier New", monospace; color: rgb(58, 125, 94);">notice.pdf

</td></tr></tbody></table>

##### ***UTILISATION :*** 

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

##### ***REMARQUES :*** 

**Permissions respectées :**<span style="white-space: pre-wrap;"> 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.</span>

**Contrôles de sécurité natifs :**<span style="white-space: pre-wrap;"> les vérifications </span>***Dolibarr***<span style="white-space: pre-wrap;"> restent appliquées (analyse antivirus si configurée, détection de contenu exécutable, etc.).</span>

**Aucun fichier core modifié :**<span style="white-space: pre-wrap;"> la zone est injectée dynamiquement via un </span>**hook**<span style="white-space: pre-wrap;"> — l'intégrité de </span>***Dolibarr***<span style="white-space: pre-wrap;"> est préservée.</span>