mohsinalimat / erpnext_druckformate

ERPNext-Druckformate nach DIN 5008

ERPNext-Druckformate nach DIN 5008

Entwickelt und getestet für ERPNext version-13. (Kann mit kleinen Anpassungen auch für andere Versionen verwendet werden.)

• letter_head.html: HTML und CSS für die Fußzeile.
• print_style/print_style.scss: Einheitliches CSS für alle Druckformate.
• print_format/*.html: HTML für den jeweiligen DocType.

Abhängigkeiten

Sass wird benötigt, um das SCSS zu CSS zu kompilieren (npm install -g sass oder brew install sass/sass/sass).

Der folgende Befehl erzeugt die Datei print_style.css im Ordner print_style:

sass --style=compressed print_style/print_style.scss print_style/print_style.css

Einrichtung

1. Neuen Letter Head (dt. Briefkopf) erstellen

   1. Den Inhalt von letter_head.html in das Feld "Footer HTML" kopieren.

      

   2. Einen Briefkopf als Bild oder HTML hinterlegen

2. Company (dt. Unternehmen) öffnen und

   1. Den im vorigen Schritt erstellten Letter Head als "Default Letter Head" hinterlegen.
   2. Eine Adresse für das Unternehmen hinzufügen. Diese erscheint im Druckformat als Absender.

3. Address Templates für die Zielländer anlegen.

4. Print Format (dt. Druckformat) für Quotation (dt. Angebot), Sales Invoice (dt. Verkaufsrechnung) und Sales Order (dt. Auftrag) anlegen. Hierzu den Inhalt der jeweiligen Datei aus dem Order print_format und das CSS aus print_style/print_style.css kopieren.

   

5. Über Customize Form (dt. Formular anpassen) das "Default Print Format" für den jeweiligen DocType hinterlegen

Anpassung und Entwicklung

Print Style

Es ist wichtig, dass möglichst jeder CSS-Block im Scope von .print-format und damit auf das Druckformat beschränkt ist. Andernfalls wirkt sicher der Stil auf das gesamte System aus.

Jinja

Alle Druckformate sind Jinja Templates. Das heißt, es kann über das dictionary doc auf alle Felder des DocTypes zugegriffen werden. Bei Rechnungen steckt hinter {{ doc.due_date }} beispielsweise das Fälligkeitdatum und hinter {{ doc.name }} die Rechnungsnummer. Der Befehl {{ doc.get_formatted('due_date') }} gibt das Fälligkeitdatum (oder jedes andere Feld) schön formatiert aus (24.12.2020 statt 2020-12-24, € 10,00 statt 10.0, etc.).

Außerdem können einige Python- und Frappe-Funktionen genutzt werden. Beipielsweise hinterlegt {% set company = frappe.get_doc("Company", doc.company) %} alle Daten des zugehörigen Unternehmens in der variable company. Danach könnte beispielsweise die dort hinterlegte Website mit {{ company.website }} eingefügt werden.

Frappe stellt einige eigene Variablen wie footer oder print_settings zur Verfügung, die in jedem Print Format genutzt werden können. Eine Auflistung der verfügbaren Variablen findet sich in der datei printview.py.

Weitere Dateien, die dem Verständnis, der Inspiration oder Fehlersuche dienen können:

• standard.css

  CSS für das Standard-Druckformat

• standard.html

  Jinja-Template für das Standard-Druckformat

Übersetzungen

Alle Dokumente sollten auf Deutsch und Englisch funktionieren.

Kurze Begriffe können mit _('Translate me!') übersetzt werden. Hierbei ist in der Regel der englische Begriff zu verwenden.

Sätze und längere Texte können per if-Statement übersetzt werden:

{% if doc.language == "de" %}
    <p>Sehr geehrte Damen und Herren,<p>
{% else %}
    <p>Dear Sir or Madam,<p>
{% endif %}

Aktualisieren

Das Skript update.py kann genutzt werden, um automatisch alle Druckformate in ERPNext zu aktualisieren.

Einrichtung

mkdir env
python3 -m venv env/
source env/bin/activate
pip install -r requirements.txt

Die Konstanten ERPNEXT_URL und PRINT_FORMATS in update.py müssen vor der Verwendung entsprechend des Zielsystems angepasst werden.

Verwendung

Usage: update.py [OPTIONS]

Options:
  --username TEXT
  --password TEXT
  --install-completion [bash|zsh|fish|powershell|pwsh]
                                  Install completion for the specified shell.
  --show-completion [bash|zsh|fish|powershell|pwsh]
                                  Show completion for the specified shell, to
                                  copy it or customize the installation.
  --help                          Show this message and exit.

Beispiel:

source env/bin/activate
python update.py --username "Administrator" --password "P@ssw0rd"

Unterstützung erhalten

Wenn Sie Unterstützung bei der Anpassung der Druckformate benötigen, kontaktieren Sie uns gerne. Alle Kontaktdaten finden Sie auf unserer Webseite.