Im letzten Blog habe ich dir gezeigt, wie du in Odoo ein eine einfache Report-Struktur erstellst, die dein benutzerdefiniertes Layout in den Standard Odoo Report-Flow einschleust, sodass alle Standard Aktionen erhalten bleiben. Jetzt zeige ich dir, wie du in dieses benutzerdefinierte Template in ein Angebots-Template im gleichen Dokumentenlayout wie Galaxus umwandelst.
Was ist wichtig bei einem custom Report-Template?
Die Odoo Standard-Reports müssen für alle potentiellen Odoo Benutzer funktionieren. Da es unglaublich viele Verschiedene Anwendungsfälle für Odoo gibt, sind die Standard-Reports sehr allgemein gehalten und weisen eine relative verschachtelte Template Struktur auf, die auch noch durch die jeweiligen Lokalisationen (l10n) und das ausgewählte Dokumentenlayout in den Company-Infos beeinflusst wird. Wenn wir ein komplett benutzerdefiniertes Layout erstellen, können wir die Template Struktur massiv vereinfachen, da sie dann nur noch für unsere Firma bzw. Firmen in einem Multi-Company-Setup passen muss. Wenn wir selber ein Template erstellen ist folgendes wichtig:
- Verwende ein separates Template für Header und Footer, da diese für alle deine Dokumente identisch sein sollten, um das Corporate Design sauber durchzuziehen.
- Kommentiere die Templates sauber, da es die Navigation in langen Templates sehr vereinfacht.
- Versuche alle Logik aus dem Standard-Odoo Template zu verstehen und integriere alle notwendige Logik auch in dein Template. Zum Beispiel die Optionen im Sale Order.
- Vermeide es, in deinem Tempalate odoo CSS Klassen oder andere Odoo Templates zu verwenden. Dadurch machst du Upgrades schwieriger und du hast nicht die volle Kontrolle über das Styling in deinem Report
- Verwende Inline-Styles anstatt separate Stylesheets. Da sich Reports normalerweise auf eine Seite beschränken, macht das Änderungen einfacher und Styles können auch direkt in der Datenbank ohne Änderungen an der Code-Basis angewendet werden. Das macht schnelle Korrekturen oder Anpassungen einfacher.
So erstellst du das Galaxus Dokumentenlayout in Odoo
Schritt 1: Füge ?debug=1 an die Odoo-URL an, um den Developer Mode zu aktivieren. Erstelle unter Einstellungen / Technisch / Benutzerschnittstelle / Ansichten eine neue Ansicht mit folgenden Daten:
- Name: External Layout Custom
- Ansichtstyp: QWeb
- Vererbungsmodus für Ansicht: Basisansicht
- Architektur: Link zu Github
Schritt 2: Exportiere die Ansicht und aktiviere dabei "Ich will Daten aktualisieren". Der Export ist notwendig, weil Odoo dann die external_id generiert, die wir später in unserem custom template referenzieren.
Schritt 3: Öffne die Ansicht "report_saleorder_document_custom", die wir im letzten Blogbeitrag erstellt haben. Ersetze den QWeb Code darin durch folgenden Code: Link zu Github
Schritt 4: Kopiere die External ID vom External Layout welches wir zuvor erstellt und exportiert haben, und füge sie in der report_saleorder Ansicht an der richtigen Stelle ein.
Schritt 5: Installiere folgende Module, damit alle notwendigen Felder für den Galaxus Report verfügbar sind. Alles sind Odoo S.A Module, sie du unter "Apps" in deiner Datenbank installieren kannst.
'sale',
'purchase',
'product',
'mail',
'account',
'stock',
'sale_stock',
'stock_delivery'
Schritt 6: Übersetze die beiden neu erstellten Ansichten auf Deutsch, oder jede andere beliebige Sprache, indem du auf das "EN" Symbol oben rechts klickst. So werden die Berichte immer korrekt in die Empfängersprache übersetzt.
Fertig - nun hast du einen Verkaufsbericht (Angebot und Auftragesbestätigung) im Galaxus-Style. 😊
Wenn du Odoo.sh oder Odoo onPremise verwendest, findest du unter diesem Link kostenlos die gesamte Report Suite für die Galaxus Report. Installiere sie einfach und du hast sofort alle Reports im Galaxus Style verfügbar!
Falls du noch Fragen hast, hinterlasse gerne einen Kommentar oder schreibe mir eine E-Mail.
Nathanael Lee