Odoo und FastReport einrichten
- j.eberle@equitania.de (Unlicensed)
Als Kunde der Equitania Software GmbH erhalten Sie Ihr System i.d.R. bereits fertig konfiguriert und bereit zum Druck.
Wir werden hier jedoch noch einmal Schritt für Schritt erklären, auf was Sie achten müssen, wenn Sie FastReport einrichten und nutzen wollen.
Odoo und ownERP FastReport UI verbinden
Module installieren
Die FastReport Apps müssen in Odoo installiert sein.
Alte Berichte löschen
Löschen Sie unter Technisch > Berichte alle Reports.
Lassen Sie anschließend von Ihrem Administrator einen Update all auf Ihr Odoosystem laufen.
Verbindung herstellen
Gehen Sie unter Einstellungen > Benutzer und Unternehmen > Unternehmen und dort ins Tab FastReport.
Fügen Sie dort Ihre Zugangsdaten ein und führen Sie den Verbindungstest erfolgreich durch.
Wichtig - der Wert in den Systemparametern muss der API URL hier entsprechen.
Odoo FastReport UI mit Reports füllen
Melden Sie sich an Ihrer Odoo FastReport Schnittstelle über den Browser an.
Sollte die Instanz noch komplett leer sein (bei Equitania Kunden sind die Reports schon enthalten)
gehen Sie auf den Menüpunkt Upload:
Über den Mehrfachupload können nun alle Frx-Dateien hochgeladen werden.
Standard Reports V12: https://gitlab.ownerp.io/fast-report/fr-core-yaml/-/tree/develop/v12/reports
Standard Reports V13: https://gitlab.ownerp.io/fast-report/fr-core-yaml/-/tree/develop/v13/reports
(Gitlab Zugriff nur auf Nachfrage & für unsere Kunden)
Die Odoo ownERP FastReport UI ist nun fertig vorbereitet.
Über den Menüpunkt Settings können Sie das Adminpasswort ändern.
Über den Menüpunkt Download Logfile bei Problemen beim Druck ein Logfile herunterladen zur Fehlersuche.
Über den Menüpunkt Delete Data files können alle Datenbank Dateien auf einmal gelöscht werden.
Basis Report in Odoo setzen
Der Basis Report beinhaltet die Kopf- und Fußdaten Ihres Unternehmens und in der Regel auch den Container für Ihr Logo.
Damit dieser Schritt funktioniert, muss in Odoo vorher das Unternehmen inklusive Logo und einem Bankkonto komplett eingerichtet werden, sonst könnte Ihr Ergebnis später anders aussehen.
Gehen Sie in Odoo und springen Sie über Einstellungen > Benutzer und Unternehmen > Unternehmen.
Gehen Sie dort wieder ins Tab FastReport und klicken Sie “Basis Report setzen”.
In MyOdoo FastReport UI wird zeitgleich ein Basisreport mit Angaben zum Erstellungszeitpunkt im Dateinamen erzeugt. Bis ein neuer Report gesetzt wurde, bleibt dies der BasisReport für alle anderen Reports. Beispiel:
Wichtig: Sie müssen bei Änderungen am Unternehmen jedes Mal den Basis Report neu setzen, da sich die Änderung sonst auf den Reports nicht auswirkt.
Multi Company
Ab der Odoo Version 12 unterstützen unsere Fast Report Schnittstelle ebenfalls die Multi Company Funktionalität von Odoo, das heißt Sie können verschiedene Base Reports für die einzelnen Unternehmen anlegen.
Sie haben die Möglichkeit im Feld Basis Report Dateiname auf verschiedene Basis Reports zu verlinken:
Dazu gehen wir wie folgt vor:
Basis Report (eq_fr_core_base.frx) duplizieren und umbenennen.
Unter den neuen Namen wieder in die API hochladen.
Anpassungen im Report Designer vornehmen und den bearbeiteten Report über den Designer wieder in die API hochladen. (dies wird im Artikel https://equitania.atlassian.net/wiki/x/AwCNIg ausführlich beschrieben!)
Im Unternehmen im Feld Basis Report Dateiname den Basis Report mit dem neuen Namen setzen.
Dann den Basis Report über den Button erneut setzen.
Den Vorgang für jedes Unternehmen wiederholen.
YAML-File ausführen (technische Anwender)
ACHTUNG: Dieser Schritt ist nur mit einer entsprechenden Entwicklungsumgebung unter Python möglich!
Wir erläutern in diesem Fall den Weg über die Entwicklungsoberfläche PyCharm unter Linux. Es gibt jedoch auch einen Weg über Python unter Windows, der jedoch hier nicht weiter erläutert wird.
Odoo FR Mapper Plugin in PyCharm installieren
Gehen Sie über File > Settings in die Einstellungen von Pycharm
und installieren Sie für Ihr Project unter Python Interpreter den odoo-fast-report-mapper-equitania
Sie müssen diesen ggf. über das Plus-Symbol suchen & hinzufügen.
Legen Sie sich in Ihrem FastReport Repository einen connections Ordner an inklusive einer zunächst leeren local.yaml Datei an. Dort fügen Sie die Server Konfiguration ein. (Die local.yaml niemals committen!)
Diesen Code in die local.yaml einsetzen und die Server Konfiguration einfügen (Platzhalter mit Zugangsdaten ändern).
---
# Server configuration
Server:
url: http://localhost # URL to Odoo - for localhost write http://localhost
port: 8069 # Port of Odoo - Remote over SSL write 443 - for localhost write 8069 or other Odoo port
user: admin # Your Odoo admin-user or user with setting rights
password: ownerp2020 # Password for the user
database: db_name # Name of the Odoo database
delete_old_reports: False # Cleanup old Fast-Report Settings in Odoo systems
# This entry depends on your report yaml files
language: ger # Name settings in Odoo system. With "en" names will be English depends on the YAML-file for reports
Öffnen Sie ein Terminal und navigieren Sie per cd Befehl ins richtige FastReport Verzeichnis.
Dort angekommen tippen Sie folgenden Befehl ein:
odoo-fr-mapperund bestätigen Sie mit Enter. Sie werden zuerst nach dem Ordner zu der local.yaml (mit den Zugangsdaten) und danach nach dem Report Folder in dem die Yaml-Dateien liegen, gefragt. Tippen Sie beides ein und bestätigen Sie mit Enter.
Das Skript läuft nun durch. Dies kann ca.10 Minuten dauern.
Ergebnis in Odoo prüfen:
Abschließend kann man im Backend überprüfen, ob alle FastReport wie gewünscht angelegt wurden.
Gehen Sie nochmals in Einstellungen > Technisch > Berichte.
Dort sollten nun genauso viele FastReport Einträge vorhanden sein, wie sich Yaml-Files in Ihrem yaml-Ordner befinden.
In unserem Buch Einstieg in Odoo widmen wir FastReport ein ganzes Kapitel.