Module Jalon FR

Sommaire

Retour index
Documentation développeur

Retour index
Documentation Utilisateur

Informations

Module name	Milestone/Jalon
Editor / Editeur	- http://www.atoo-net.com
Download or buy page / Page achat ou téléchargement	External module - www.dolistore.com
Status / Statut / Estado	Stable
Prerequisites / Prérequis	Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore
Last update date / Date mise à jour fiche / Fecha última actualización	2026-06-2
Note / Nota	⬆ Retour au sommaire

Fonctionnalités

Ce module permet d'associer/grouper des produits/services à un jalon et d'afficher le sous-total. Il est possible d'ajouter des lignes de commentaires sans détails (tva, prix, etc.), ainsi que de forcer des sauts de page dans les documents commerciaux.

Le module est compatible avec les types de documents suivants :

- Propositions commerciales
- Commandes clients
- Factures clients
- Commandes fournisseurs
- Factures fournisseurs

Compatible avec le module Multi-Company.

Les fonctionnalités principales sont :

- Regroupement de lignes : associer des produits/services à un jalon pour les regrouper visuellement et les gérer en bloc.
- Sous-total automatique : affichage du montant total par jalon sur le document et le PDF.
- Lignes de commentaire : ajout de lignes texte sans montant ni TVA.
- Saut de page forcé : insertion d'un saut de page à la position souhaitée dans le PDF.
- Déplacer une ligne dans un jalon : rattacher a posteriori une ligne existante à un jalon, via un menu déroulant.
- Clonage de bloc : dupliquer un jalon et toutes ses lignes enfants en un seul clic.
- Suppression de bloc avec options :

• • Option 1 — Supprimer le jalon et toutes ses lignes.
  • Option 2 — Supprimer le jalon seul et détacher ses lignes (elles restent sur le document).
  • Option 3 — Supprimer le jalon et migrer ses lignes vers un autre jalon existant.

- Dictionnaire de jalons : enregistrer des jalons réutilisables depuis la page de configuration.

Prérequis

Dolibarr 20.0.0 - 23.0.0

⚙️ Procédure d'installation

⚙️ Installation manuelle

1. Télécharger le fichier archive du module (.zip).
2. Placer le fichier dans le répertoire racine de Dolibarr.
3. Décompresser le fichier zip avec la commande :

unzip module_milestone-X.0.0.zip

1. Vérifier que l'emplacement correct du module est :

htdocs/custom/milestone

1. Le module est maintenant disponible et peut être activé depuis Dolibarr.

---

⚙️ Installation via l'interface Dolibarr

Vous pouvez également déployer et installer le module directement depuis l'interface Dolibarr :

1. Accédez au menu Configuration > Modules/Applications.
2. Allez dans l'onglet Déployer/Installer un module externe.
3. Cliquez sur Choisir un fichier et sélectionnez le fichier .zip du module.
4. Cliquez sur Envoyer Fichier pour lancer l'installation.
5. Activez le module une fois l'installation terminée.

✅ Le module est maintenant opérationnel et prêt à l'emploi ! ⬆ Retour au sommaire

Configuration

Pour utiliser ce module, il vous faut d'abord l'activer. Pour cela, après s'être connecté avec un compte administrateur, allez sur la page "Accueil - Configuration - Modules". Le module apparaît dans "Modules complémentaires/Outils multi-modules", cliquez sur "Activer". Un pictogramme apparaît à la fin de la ligne du module, cliquez dessus pour accéder à la page de paramétrage spécifique à ce module.

Le module est alors opérationnel.

Configuration du module

Page de configuration propre au module:

Dans la page de configuration dédiée au module, un onglet:

• Onglet Options

Vous pouvez ici régler les options suivantes :

- Cacher par défaut le détail des produits/services associés aux jalons.
- Cacher par défaut la description des produits/services associés aux jalons.
- Cacher par défaut le montant des jalons.
- Régler la couleur de fond des jalons.

Vous pouvez enregistrer dans un dictionnaire les jalons que vous voulez réutiliser.

Utilisation

Prise en main facile, en quelques clics.

Compatibilité et Synergies

Milestone/Jalon est compatible avec :

- Le module MultiCompany
- Le module UltimatePdf
- Les propositions commerciales (propal)
- Les commandes clients (order)
- Les factures clients (invoice)
- Les commandes fournisseurs (order_supplier) — support ajouté en v23
- Les factures fournisseurs (invoice_supplier) — support ajouté en v23

Remplacement d'un produit sur une ligne enfant de jalon

Nouveau !

Par défaut dans Dolibarr, le formulaire d'édition d'une ligne ne permet pas de changer le produit associé : seuls la description, le prix, la quantité et la remise sont modifiables.

Depuis la version 23.0 du module Jalon, il est possible de remplacer le produit directement depuis le formulaire d'édition, sur toutes les lignes produits rattachées à un jalon.

C'est particulièrement utile lorsque vous clonez une longue proposition commerciale pour un nouveau client ou un nouveau chantier : plutôt que de supprimer une ligne et d'en recréer une nouvelle (ce qui prend un temps fou et de nombreux allez-retour), vous pouvez simplement éditer la ligne existante et substituer le produit en quelques clics, sans perdre la structure du document.

Comment remplacer un produit

1. Ouvrir la proposition commerciale ou la commande en mode Brouillon
2. Repérer la ligne produit à modifier sous son jalon
3. Cliquer sur l'icône ✏️ (crayon) en bout de ligne
4. En haut du formulaire, un sélecteur de produit apparaît avec une recherche par référence ou libellé
5. Sélectionner le nouveau produit
6. Ajuster si besoin la quantité, le prix et la description
7. Cliquer Enregistrer

Note : Cette fonctionnalité est disponible uniquement sur les lignes enfants d'un jalon. Les lignes libres (sans jalon parent) conservent le comportement standard Dolibarr.

Notes techniques

Spécificités des éléments fournisseurs

Les classes ORM Dolibarr pour les documents fournisseurs (CommandeFournisseur, FactureFournisseur) présentent des limitations par rapport à leurs équivalents clients :

- La méthode fetch_lines() de CommandeFournisseur ne mappe pas le champ label sur les objets ligne. Le module contourne ce comportement par des requêtes SQL directes lorsque le label est vide.
- Les méthodes updateline() et addline() de ces classes ne gèrent pas le paramètre fk_parent_line. Toute écriture de ce champ (rattachement à un jalon, clonage, suppression) est effectuée par un UPDATE SQL direct sur la table de lignes correspondante.

Ces contournements sont encapsulés dans le module et transparents pour l'utilisateur final.