Module Jalon DE

Inhaltsverzeichnis

Informationen

Module name	Milestone
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	⬆ Zurück zum Anfang

Funktionen

Dieses Modul ermöglicht es, Produkte/Dienstleistungen einem Meilenstein zuzuordnen/zu gruppieren und die Zwischensumme anzuzeigen. Es ist möglich, Kommentarzeilen ohne Details (Steuer, Preis usw.) hinzuzufügen sowie Seitenumbrüche in Geschäftsdokumenten zu erzwingen.

Das Modul ist mit folgenden Dokumenttypen kompatibel:

- Angebote
- Kundenbestellungen
- Kundenrechnungen
- Lieferantenbestellungen
- Lieferantenrechnungen

Kompatibel mit dem Multi-Company-Modul.

Hauptfunktionen:

- Zeilengroupierung: Produkte/Dienstleistungen einem Meilenstein zuordnen, um sie visuell zu gruppieren und als Block zu verwalten.
- Automatische Zwischensumme: Anzeige des Gesamtbetrags pro Meilenstein im Dokument und im PDF.
- Kommentarzeilen: Textzeilen ohne Betrag oder Steuer hinzufügen.
- Erzwungener Seitenumbruch: Einfügen eines Seitenumbruchs an einer beliebigen Stelle im PDF.
- Zeile in einen Meilenstein verschieben: eine bestehende Zeile nachträglich einem Meilenstein zuordnen, über ein Dropdown-Menü.
- Block-Duplizierung: einen Meilenstein und alle seine untergeordneten Zeilen mit einem einzigen Klick duplizieren.
- Block-Löschung mit Optionen:

- Option 1 — Den Meilenstein und alle seine Zeilen löschen.
- Option 2 — Nur den Meilenstein löschen und seine Zeilen abtrennen (sie verbleiben im Dokument).
- Option 3 — Den Meilenstein löschen und seine Zeilen in einen anderen bestehenden Meilenstein verschieben.

- Meilenstein-Wörterbuch: wiederverwendbare Meilensteine auf der Konfigurationsseite speichern.

Voraussetzungen

Dolibarr 20.0.0 - 23.0.0

⚙️ Installation

⚙️ Manuelle Installation

Laden Sie die Modul-Archivdatei (.zip) herunter.
Legen Sie die Datei im Dolibarr-Stammverzeichnis ab.
Entpacken Sie die ZIP-Datei mit folgendem Befehl:

unzip module_milestone-X.0.0.zip

Überprüfen Sie, dass das Modul am richtigen Ort liegt:

htdocs/custom/milestone

Das Modul ist nun verfügbar und kann in Dolibarr aktiviert werden.

---

⚙️ Installation über die Dolibarr-Oberfläche

Sie können das Modul auch direkt über die Dolibarr-Oberfläche bereitstellen und installieren:

Gehen Sie zum Menü Konfiguration > Module/Anwendungen.
Öffnen Sie die Registerkarte Externes Modul bereitstellen/installieren.
Klicken Sie auf Datei auswählen und wählen Sie die .zip-Datei des Moduls aus.
Klicken Sie auf Datei senden, um die Installation zu starten.
Aktivieren Sie das Modul nach Abschluss der Installation.

✅ Das Modul ist nun betriebsbereit und einsatzbereit! ⬆ Zurück zum Anfang

Konfiguration

Um dieses Modul zu verwenden, müssen Sie es zunächst aktivieren. Melden Sie sich dazu mit einem Administratorkonto an und gehen Sie zu „Startseite - Konfiguration - Module". Das Modul erscheint unter „Zusatzmodule/Modulübergreifende Werkzeuge". Klicken Sie auf „Aktivieren". Am Ende der Modulzeile erscheint ein Einstellungssymbol — klicken Sie darauf, um zur modulspezifischen Konfigurationsseite zu gelangen.

Das Modul ist dann einsatzbereit.

Modulkonfiguration

Modulspezifische Konfigurationsseite:

Die Konfigurationsseite enthält einen Reiter:

Reiter Optionen

Folgende Optionen stehen zur Verfügung:

- Standardmäßig die Details der den Meilensteinen zugeordneten Produkte/Dienstleistungen ausblenden.
- Standardmäßig die Beschreibung der den Meilensteinen zugeordneten Produkte/Dienstleistungen ausblenden.
- Standardmäßig den Betrag der Meilensteine ausblenden.
- Die Hintergrundfarbe der Meilensteine festlegen.

Sie können Meilensteine, die Sie wiederverwenden möchten, in einem Wörterbuch speichern.

Verwendung

Einfacher Einstieg — nur wenige Klicks erforderlich.

Kompatibilität und Synergien

Milestone ist kompatibel mit:

- Dem MultiCompany-Modul
- Dem UltimatePdf-Modul
- Angeboten (propal)
- Kundenbestellungen (order)
- Kundenrechnungen (invoice)
- Lieferantenbestellungen (order_supplier) — Unterstützung in v23 hinzugefügt
- Lieferantenrechnungen (invoice_supplier) — Unterstützung in v23 hinzugefügt

Ersetzen eines Produkts in einer untergeordneten Meilensteinzeile

Neu!

Standardmäßig erlaubt das Bearbeitungsformular einer Zeile in Dolibarr nicht, das zugehörige Produkt zu ändern : nur die Beschreibung, der Preis, die Menge und der Rabatt sind bearbeitbar.

Ab Version 23.0 des Meilenstein-Moduls ist es möglich, das Produkt direkt im Bearbeitungsformular zu ersetzen, und zwar in allen Produktzeilen, die einem Meilenstein zugeordnet sind.

Dies ist besonders nützlich, wenn Sie ein langes Angebot für einen neuen Kunden oder ein neues Projekt klonen : Anstatt eine Zeile zu löschen und eine neue zu erstellen (was sehr zeitaufwändig ist und viele Hin- und Herwechsel erfordert), können Sie einfach die vorhandene Zeile bearbeiten und das Produkt mit wenigen Klicks ersetzen, ohne die Struktur des Dokuments zu verlieren.

Wie ersetzt man ein Produkt

Das Angebot oder den Auftrag im Modus Entwurf öffnen
Die zu ändernde Produktzeile unter dem zugehörigen Meilenstein suchen
Auf das Symbol ✏️ (Stift) am Ende der Zeile klicken
Oben im Formular erscheint eine Produktauswahl mit Suche nach Referenz oder Bezeichnung
Das neue Produkt auswählen
Bei Bedarf Menge, Preis und Beschreibung anpassen
Auf Speichern klicken

Hinweis : Diese Funktion ist nur für untergeordnete Zeilen eines Meilensteins verfügbar. Freie Zeilen (ohne übergeordneten Meilenstein) behalten das Standardverhalten von Dolibarr bei.

Technische Hinweise

Besonderheiten bei Lieferantendokumenten

Die Dolibarr-ORM-Klassen für Lieferantendokumente (CommandeFournisseur, FactureFournisseur) weisen im Vergleich zu ihren kundenseitigen Entsprechungen Einschränkungen auf:

- Die Methode fetch_lines() von CommandeFournisseur ordnet das Feld label nicht den Zeilenobjekten zu. Das Modul umgeht dieses Verhalten durch direkte SQL-Abfragen, wenn das Label leer ist.
- Die Methoden updateline() und addline() dieser Klassen verarbeiten den Parameter fk_parent_line nicht. Jede Schreiboperation auf dieses Feld (Zuweisung zu einem Meilenstein, Duplizierung, Löschung) erfolgt über ein direktes SQL UPDATE auf der entsprechenden Zeilentabelle.

Diese Workarounds sind im Modul gekapselt und für den Endbenutzer vollständig transparent.

Entwicklung

Milestone wird im Framasoft-Git-Repository gepflegt: https://git.framasoft.org/inodbox/milestone