Module Ultimateline DE: Difference between revisions

← Older edit

Module Ultimateline DE (view source)

Revision as of 08:59, 3 October 2026

5,822 bytes added , 27 days ago

no edit summary

VisualWikitext

Grandoc

Administrators

1,918

edits

@@ Line 4: / Line 4: @@
 {{TemplateDocDev}}
 {{TemplateDocUtil}}
 =Informationen=
 {{TemplateModuleInfo
@@ Line 11: / Line 10: @@
 |webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateline}}
 |status=stable
-|prerequisites=
+|prerequisites=Dolibarr 25.0, PHP 8.2
-|minversion=18.0.x - 23.0.x
+|minversion=25.0.x
 |note=
 ''[[#Übersicht|⬆ Zurück zur Übersicht]]''
@@ Line 18: / Line 17: @@
 =Funktionen=
-Ermöglicht das automatische Hinzufügen von Servicezeilen als Unterzeilen (Kindzeilen) einer Produktzeile in Angeboten, Bestellungen und Rechnungen beim Hinzufügen oder Ändern einer Produktzeile. Das Modul kann mehrere Services gleichzeitig verwalten, die jeweils entweder als Prozentsatz des Betrags der übergeordneten Zeile oder als fester Betrag berechnet werden. Besonders geeignet zur Automatisierung der Berechnung und des Hinzufügens von Zeilen wie CO₂-Abgaben, Ökosteuern, speziellen Rabatten usw.
+UltimateLine fügt automatisch eine '''Schlusszeile''' (Öko-Beitrag, Garantieverlängerung, feste Gebühren, Rabatt...) direkt unter einer Produkt- oder Leistungszeile in Angeboten, Aufträgen und Rechnungen ein. Die Schlusszeile ist eine Leistung aus dem Katalog, berechnet als Prozentsatz des Betrags der übergeordneten Zeile oder als fester Betrag pro Einheit. Ein Produkt kann mehrere Schlusszeilen auslösen.
+Beispiel: eine Leistung „Garantieverlängerung“ zu 5 % und eine Leistung „Öko-Beitrag WEEE“ zu 3,50 € pro Einheit, einem Fenster zugeordnet, das zu 2 × 389,00 € verkauft wird, fügen unter dem Fenster eine Zeile von 38,90 € und eine Zeile von 7,00 € ein.
 ===Verhalten in Dokumenten===
-*Die Servicezeile wird automatisch direkt unter ihrer übergeordneten Produktzeile eingefügt.
+*Die Schlusszeile wird automatisch direkt unter ihrer übergeordneten Produktzeile eingefügt, mit der Menge 1 und dem MwSt.-Satz der Leistung.
-*In der Benutzeroberfläche wird die Servicezeile eingerückt und visuell mit ihrer übergeordneten Zeile gruppiert.
+*Sie wird neu berechnet, wenn sich Menge oder Preis der übergeordneten Zeile ändern, und mit ihr gelöscht.
-*In PDFs, die vom Modul UltimatePDF generiert werden, wird die Servicezeile mit einem „└“-Symbol angezeigt, um die Zugehörigkeit zur übergeordneten Zeile darzustellen.
+*In der Oberfläche ist die Schlusszeile eingerückt und optisch mit ihrer übergeordneten Zeile gruppiert.
-*Im Summenblock der PDFs wird automatisch eine Informationszeile '''mit [Service-Name]<span> </span>: [Betrag netto]''' unterhalb des Gesamtbetrags netto hinzugefügt, im gleichen visuellen Stil wie die MwSt.-Zeilen.
+*In den PDF der UltimatePDF-Vorlagen wird die Schlusszeile mit einem Symbol „└“ gedruckt, das ihre Zugehörigkeit zur übergeordneten Zeile zeigt, und unter der Nettosumme wird pro Leistung eine Zeile '''Davon [Name der Leistung]: [Nettobetrag]''' hinzugefügt.
+*Mit den Standardvorlagen von Dolibarr (cyan, eratosthene, sponge...) zeigt ein Kasten '''Davon:''' unter den Summen die Summe jeder Schlusszeilen-Leistung in der Sprache des Dokuments.
-[[File:UltimateLine_demo_06-22.0.png|800px]]
 ===Kompatibilität mit dem Modul Milestone===
-UltimateLine ist kompatibel mit dem Modul [[Module_Jalon_FR|Milestone]], das es ermöglicht, Dokumentzeilen in Meilensteine (Abschnitte) zu strukturieren. Wenn eine Produktzeile zu einem Meilenstein gehört, wird ihre UltimateLine-Servicezeile korrekt dargestellt<span> </span>:
+UltimateLine ist kompatibel mit dem Modul [[Module_Jalon_FR|Milestone]], das die Dokumentzeilen in Meilensteine gliedert. Wenn eine Produktzeile zu einem Meilenstein gehört:
-*In der Oberfläche wird die Servicezeile innerhalb des Meilenstein-Blocks angezeigt, direkt nach ihrer übergeordneten Produktzeile und vor der Zwischensumme des Meilensteins.
+*erscheint die Schlusszeile in der Oberfläche innerhalb des Meilenstein-Blocks, direkt nach ihrer übergeordneten Produktzeile und vor der Zwischensumme des Meilensteins;
-*Der Betrag der Servicezeile wird in die Berechnung der Zwischensumme des Meilensteins einbezogen.
+*wird der Betrag der Schlusszeile in die Zwischensumme des Meilensteins einbezogen;
-*In PDFs behält die Servicezeile das „└“-Symbol (und nicht das Symbol für Meilenstein-Kindelemente).
+*behält die Schlusszeile im PDF das Symbol „└“ (und nicht das Unterzeilen-Symbol des Meilensteins);
-*Die Konvertierungs-Workflows '''Angebot → Bestellung''', '''Angebot → Rechnung''' und '''Bestellung → Rechnung''' erhalten korrekt die Verknüpfung zwischen der Servicezeile und ihrer übergeordneten Produktzeile.
+*behalten die Umwandlungen '''Angebot → Auftrag''', '''Angebot → Rechnung''' und '''Auftrag → Rechnung''' die Verbindung zwischen der Schlusszeile und ihrer übergeordneten Produktzeile.
 ==Voraussetzungen==
-'''Dolibarr<span> </span>:''' Unterstützte Versionen<span> </span>:
+*'''Dolibarr 25.x''';
+*'''PHP 8.2''' oder höher (getestet bis PHP 8.5);
+*Module '''Leistungen''' und '''Rechnungen''', die mit UltimateLine automatisch aktiviert werden.
-*'''20.x'''
+Für Dolibarr 18 bis 24 verwenden Sie die Version 24.0 des Moduls.
-*'''21.x'''
-*'''22.x'''
+''[[#Übersicht|⬆ Zurück zur Übersicht]]''
-*'''23.x'''
 =⚙️ Installationsverfahren=
+===⚙️ Installation über die Oberfläche===
+#Gehen Sie zu '''Start → Einstellungen → Module/Anwendungen''', Registerkarte '''Externes Modul bereitstellen/installieren'''.
+#Wählen Sie die Datei <code>module_ultimateline-25.0.0.zip</code> und klicken Sie auf '''Datei hochladen'''.
 ===⚙️ Manuelle Installation===
-#'''Laden Sie''' die Modul-Archivdatei (.zip) herunter.
+#'''Laden''' Sie die Archivdatei des Moduls (.zip) herunter.
-#'''Legen Sie''' die Datei im Stammverzeichnis von Dolibarr ab.
+#'''Entpacken''' Sie die Datei: <code>unzip module_ultimateline-25.0.0.zip -d /tmp/ultimateline_zip</code>
-#'''Entpacken Sie''' die ZIP-Datei mit dem folgenden Befehl<span> </span>:
+#'''Kopieren''' Sie den Modulordner: <code>cp -r /tmp/ultimateline_zip/htdocs/ultimateline /pfad/zu/dolibarr/htdocs/custom/</code>
+#'''Prüfen''' Sie, dass sich das Modul in <code>htdocs/custom/ultimateline</code> befindet.
+#'''Das Modul ist nun verfügbar''' und kann in Dolibarr aktiviert werden.
-<code>unzip module_ultimateline-X.0.0.zip</code>
+'''Aktualisierung''' von einer früheren Version: ersetzen Sie den Ordner <code>ultimateline</code>, deaktivieren und aktivieren Sie dann das Modul erneut. Die Schlusszeilen-Leistungen und ihre Zuordnungen bleiben erhalten.
-#'''Überprüfen Sie''', dass sich das Modul im folgenden Verzeichnis befindet<span> </span>:
+''[[#Übersicht|⬆ Zurück zur Übersicht]]''
+=Konfiguration=
+Melden Sie sich mit einem Administratorkonto an und gehen Sie zu '''Start → Einstellungen → Module/Anwendungen'''. Das Modul erscheint in der Familie '''AtooNet''': klicken Sie auf den Aktivierungsschalter und dann auf das Zahnrad am Zeilenende, um die Einstellungsseite des Moduls zu öffnen.
+Legen Sie zuerst im Modul '''Produkte/Leistungen''' die Leistung(en) an, die als Schlusszeilen dienen sollen (zum Beispiel „Öko-Beitrag WEEE“). Ihr MwSt.-Satz wird für die Schlusszeilen übernommen.
+Die Einstellungsseite hat vier Registerkarten: '''Einrichtung der Schlusszeilen-Leistungen''', '''Benutzerhandbuch''', '''Über''' und '''Änderungsprotokoll'''.
-<code>htdocs/custom/ultimateline</code>
+===Einstiegsanleitung===
-#'''Das Modul ist jetzt verfügbar''' und kann in Dolibarr aktiviert werden.
+[[File:Ultimateline-v25-onboarding-de.png|center|thumb|800px|Einstiegsanleitung „Willkommen bei UltimateLine!“]]
-''[[#Übersicht|⬆ Zurück zur Übersicht]]''
+Beim ersten Öffnen stellt das Fenster '''Willkommen bei UltimateLine!''' die drei Schritte der Einrichtung vor (eine Schlusszeilen-Leistung anlegen, Produkte der Leistung zuordnen, das Benutzerhandbuch lesen) und hakt die bereits erledigten ab. Der Link '''Diese Anleitung nicht mehr anzeigen''' blendet es dauerhaft aus.
+==Eine Leistung als Schlusszeile festlegen==
+[[File:Ultimateline-v25-settings-de.png|center|thumb|800px|Registerkarte Einrichtung der Schlusszeilen-Leistungen]]
+Im Block '''Eine Leistung als Schlusszeile festlegen''':
+#'''Wählen Sie eine Leistung, die als Schlusszeilen-Leistung verwendet wird''': wählen Sie eine der zuvor angelegten Leistungen.
+#'''Den Produkten/Leistungen zugeordnet als''': wählen Sie die Berechnungsart:
+#*'''Satz auf den Preis (in Prozent)''': die Schlusszeile beträgt einen Prozentsatz des Nettobetrags der übergeordneten Zeile;
+#*'''Fester Betrag zum Preis hinzugefügt''': die Schlusszeile beträgt diesen Betrag multipliziert mit der Menge der übergeordneten Zeile.
+#'''Anzuwendender Wert''': geben Sie den Prozentsatz oder den Betrag ein.
+#Klicken Sie auf '''Zuweisen'''.
+==Produkte der Leistung zuordnen==
+[[File:Ultimateline-v25-details-de.png|center|thumb|800px|Einrichtung der Schlusszeilen-Leistung und zugeordnete Produkte]]
+Wählen Sie im Block '''Auswahl einer Schlusszeilen-Leistung''' die Leistung unter '''Wählen Sie eine Schlusszeilen-Leistung''' und klicken Sie auf '''Anzeigen'''.
+Das Feld '''Einrichtung der Schlusszeilen-Leistung''' zeigt die Referenz, die '''Bezeichnung der Leistung''', die '''Art der Leistung''' und den '''Wert der Leistung''', dann zwei Listen:
-=Konfiguration=
+*'''Zugeordnete Produkte''' (links): die Produkte und Leistungen, die diese Schlusszeile bereits auslösen;
-Um dieses Modul zu verwenden, müssen Sie es zunächst aktivieren. Melden Sie sich dazu mit einem Administratorkonto an und
+*'''Verfügbare Produkte''' (rechts): die Produkte und Leistungen, die hinzugefügt werden können.
-gehen Sie zur Seite „'''Start - Einrichtung - Module'''“.
-Das Modul erscheint unter „Hauptmodule / Finanzmodule (Buchhaltung/Finanzen)“. Klicken Sie auf „Aktivieren“.
-Am Ende der Modulzeile erscheint ein Symbol – klicken Sie darauf, um zur spezifischen Konfigurationsseite zu gelangen.
-Anschließend müssen Sie mindestens einen Service im Modul Produkte/Dienstleistungen erstellen.
-Das Modul ist nun einsatzbereit.
+Markieren Sie Produkte in einer Liste (oder verwenden Sie '''Alle wählen''' / '''Alle abwählen'''), verschieben Sie sie mit den Pfeilen '''←''' und '''→''' und klicken Sie dann auf '''Übernehmen''', um zu speichern.
-==Konfiguration der Servicezeilen==
+Unter den Listen entfernt '''Ausgewählte Zuordnungen löschen''' nur die angehakten Produkte aus der Liste der zugeordneten Produkte.
-'''Modulspezifische Konfigurationsseite:'''
+==Eine Schlusszeilen-Leistung löschen==
-[[File:UltimateLine_demo_01-22.0.png|800px]]
+[[File:Ultimateline-v25-confirm-delete-de.png|center|thumb|800px|Bestätigung des Löschens einer Schlusszeilen-Leistung]]
-Auf der Konfigurationsseite des Moduls<span> </span>:
+Die Schaltfläche '''Leistung löschen''' öffnet ein Bestätigungsfenster von Dolibarr. Nach der Bestätigung werden die Schlusszeilen-Leistung und alle ihre Produktzuordnungen gelöscht; die Leistung selbst bleibt im Katalog.
- - Wählen Sie einen Service aus, der als Servicezeile verwendet werden soll, indem Sie ihn aus der Dropdown-Liste auswählen.
-[[File:UltimateLine_demo_02-22.0.png|800px]]
+Eine Online-Schulung auf YouTube ansehen: [https://www.youtube.com/watch?v=OBwRoyuBrPk https://www.youtube.com/watch?v=OBwRoyuBrPk]
- - Wählen Sie die Art der zugehörigen Aktion (Prozentsatz auf den Preis oder fester Betrag).
+''[[#Übersicht|⬆ Zurück zur Übersicht]]''
+=Verwendung=
-[[File:Ultimateline_help-3.png|800px]]
+[[File:Ultimateline-v25-propal-de.png|center|thumb|800px|Schlusszeilen unter jedem Produkt eines Angebots]]
- - Geben Sie im Feld „Anzuwendender Wert“ einen numerischen Wert ein und klicken Sie anschließend auf „Zuweisen“.
+*Wenn eine Produktzeile '''hinzugefügt oder geändert''' wird, werden die zugehörigen Schlusszeilen automatisch angelegt oder neu berechnet.
+*Wenn eine Produktzeile '''gelöscht''' wird, werden ihre Schlusszeilen mit ihr gelöscht.
+*Freie Zeilen (ohne Katalogprodukt) lösen keine Schlusszeile aus.
+*'''Umwandlungen''': bei der Umwandlung eines Angebots in einen Auftrag, eines Angebots in eine Rechnung oder eines Auftrags in eine Rechnung werden die Zeilen unverändert übernommen und bleiben mit ihrer Produktzeile verbunden, ohne ein zweites Mal hinzugefügt zu werden.
+*'''Mit dem Modul Milestone''': die Schlusszeilen bleiben nach der Umwandlung in ihrem Meilenstein-Block, und ihr Betrag ist in der Zwischensumme des Meilensteins enthalten.
-[[File:Ultimateline_help-4.png|800px]]
+[[File:Ultimateline-v25-pdf-de.png|center|thumb|800px|PDF (Vorlage ultimate_propal): Schlusszeilen und „Davon“-Zeilen unter der Nettosumme]]
- - Wählen Sie nun Ihren Service aus, der in der Dropdown-Liste des nächsten Blocks erscheint, und klicken Sie auf „Anzeigen“.
+''[[#Übersicht|⬆ Zurück zur Übersicht]]''
+=Neuerungen der Version 25.0.0=
-[[File:Ultimateline_help-5.png|800px]]
+===Kompatibilität===
+*Erfordert '''Dolibarr 25''' und '''PHP 8.2''', getestet bis PHP 8.5. Die Update-Prüfung liest <code>versionmodules/ultimateline/v25/ultimateline.txt</code>.
- - Sie können nun aus der Liste der zuweisbaren Produkte diejenigen auswählen, auf die diese Regel angewendet werden soll.
+===Korrekturen===
+*Der Kasten '''Davon:''' unter den Summen der Standard-PDF-Vorlagen wurde nicht mehr gedruckt: er findet die Schlusszeilen wieder, gruppiert sie nach Leistung, verwendet Sprache und Währung des Dokuments und wird mit den Vorlagen UltimatePDF und UltimatePDFLight nicht mehr doppelt gedruckt.
+*Das Löschen einer Leistung verlangt eine Bestätigung in einem Dolibarr-Dialog, der durch ein Sicherheitstoken geschützt ist.
+*Einstellungsseite: Titel der Browser-Registerkarte, Stylesheet des Moduls, Bezeichnung „Leistungs-Ref.“ und Suchtext der Produktlisten übersetzt.
-[[File:UltimateLine_demo_03-22.0.png|800px]]
+===Übersetzungen und Dokumentation===
+*Oberfläche, Benutzerhandbuch und Wiki-Seite auf '''Französisch''', '''Englisch''', '''Deutsch''', '''Spanisch''' und '''Italienisch''', mit neuen Bildschirmfotos.
+*Eingebettete Markdown-Bibliothek entfernt: Dolibarr zeigt das Handbuch und das Änderungsprotokoll selbst an.
+*Automatische Tests (PHPUnit, PHPStan) und schlankeres DoliStore-Paket.
- - Verschieben Sie die ausgewählten Produkte mithilfe der Pfeile zwischen den Spalten und klicken Sie auf „Anwenden“.
+==Frühere Versionen==
+*'''24.0.1''' (nicht veröffentlicht, in 25.0.0 enthalten): CSRF-Token in den Verwaltungsformularen, Registerkarten '''Benutzerhandbuch''' und '''Änderungsprotokoll'''.
+*'''24.0.0''': mit Dolibarr 24 kompatible Version.
+*Versionen 18 bis 23: siehe die mit dem Modul gelieferte Datei <code>ChangeLog.md</code>.
-[[File:UltimateLine_demo_04-22.0.png|800px]]
+=FAQ=
-[[File:UltimateLine_demo_05-22.0.png|800px]]
+===Es wird keine Schlusszeile hinzugefügt===
+Prüfen Sie, dass das Produkt unter '''Zugeordnete Produkte''' der Schlusszeilen-Leistung steht und dass die Zeile ein Katalogprodukt verwendet: freie Zeilen werden ignoriert.
- - Online-Schulung auf YouTube<span> </span>: [[https://www.youtube.com/watch?v=OBwRoyuBrPk]]
+===Der Betrag der Schlusszeile scheint falsch===
+Prüfen Sie Berechnungsart (Prozentsatz oder fester Betrag) und Wert im Feld '''Einrichtung der Schlusszeilen-Leistung'''. Ein fester Betrag wird mit der Menge der übergeordneten Zeile multipliziert.
-=Verwendung=
+===Die Zuordnungen werden nicht gespeichert===
+Klicken Sie auf '''Übernehmen''', nachdem Sie Produkte von einer Liste in die andere verschoben haben.
- - Wenn eine Produktzeile '''hinzugefügt oder geändert''' wird, wird die entsprechende Servicezeile automatisch erstellt oder neu berechnet.
+===Erscheinen die „Davon“-Beträge zweimal im PDF?===
+Nein. Die Vorlagen UltimatePDF und UltimatePDFLight drucken ihre eigenen „Davon ...“-Zeilen unter der Nettosumme; der Kasten '''Davon:''' von UltimateLine wird nur mit den Standardvorlagen von Dolibarr hinzugefügt.
- - Wenn eine Produktzeile '''gelöscht''' wird, wird die zugehörige Servicezeile automatisch mit gelöscht.
+===Ändert das Modul den Dolibarr-Kern?===
+Nein. UltimateLine arbeitet mit Triggern und Hooks, ohne die Dateien von Dolibarr zu ändern.
- - '''Workflows'''<span> </span>: Bei der Umwandlung eines Angebots in eine Bestellung, eines Angebots in eine Rechnung oder einer Bestellung in eine Rechnung werden die Servicezeilen automatisch ihrer übergeordneten Produktzeile im neuen Dokument zugeordnet. Es ist keine manuelle Aktion erforderlich.
+=Andere Sprachen=
- - '''Mit dem Modul Milestone'''<span> </span>: Die Servicezeilen bleiben nach der Umwandlung korrekt innerhalb ihres Meilenstein-Blocks positioniert und ihr Betrag wird in die Zwischensumme des Meilensteins einbezogen.
+* [[Module_Ultimateline_FR|Documentation française du module UltimateLine]]
+* [[Module_Ultimateline_EN|English documentation for the UltimateLine module]]
+* [[Module_Ultimateline_ES|Documentación en español del módulo UltimateLine]]
+* [[Module_Ultimateline_IT|Documentazione in italiano del modulo UltimateLine]]