# 4.11 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](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\]**

- 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 `<span class="editor-theme-code">notice.pdf</span>` déposé sur le produit `<span class="editor-theme-code">REF001</span>` est enregistré `<span class="editor-theme-code">REF001-notice.pdf</span>`.
- 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.

<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);">Paramètre 50

**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);">Paramètre 50

**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)* 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.