Zurück zur Anleitungen / HowTos

Siehe auch Einstellungen globale und kundenspezifische Standard Texte.
Siehe auch Email zusätzlicher Text und Anhänge.
Siehe auch Persönlicher Betreuer/Angebotsersteller auf PDF.
Siehe auch FAQ: Rechnung mit Skonto.
Siehe auch FAQ: Positionsgruppen/Text mit Variable
Siehe auch FAQ: Dauerauftrag anlegen
Siehe auch Einstellungen Nummernkreise

Die PDF Erweiterungen für Power-User ermöglichen folgende Funktionalitäten (link auf die entsprechenden Dokumente):

• Schriftstile: Fett <b>, Kursiv <i>, Unterstrichen <u>
• Links auf Webseiten <a>
• Absätze/Abstände <p> / <br>
• Seitenumbruch bzw. dynamischer Seitenumbruch <pagebreak>
• Einfügen von Bildern aus Attachments <img>

Hier in diesem Dokument werden speziell folgende Funktionalitäten erläutert:

• Variablen verwenden wie z.B. $CONFIGURATION oder $obj
• Objektdaten holen und über Variablen in den Text einfügen

Gesteuert werden diese Funktionen über Funktionsaufrufe, die zwischen jeweils 2 eckigen Klammern aufgerufen werden. Hier gibt es die Möglichkeit Daten von Objekten (z.B: Gesamtpreis, Rechnungsdatum, Angebotsnummer, etc.) aus dem System zu holen und über Variablen einzufügen. Oder es gibt eine Funktion um Bilder-Attachments zu holen und als Bilder in das PDF einzufügen.

Diese Erweiterungen lassen sich auf folgende Objekte/Felder anwenden:

• Angebote/Aufträge/Rechnungen: Felder “Überschrift/Titel”, “… Beschreibung”, “… Appendix”
• Position: Felder “Positions-Bezeichnung”, “Positions-Beschreibung”
• Artikel: Feld “Beschreibung”

Variablen/Funktionen lassen sich größtenteils wie in der Dokumentation der Template Engine smarty http://www.smarty.net/docs/en/ verwenden.

ACHTUNG: seit Build 313 (2020-06-01) muss _objref statt _ref verwendet werden

Mit [[assign var="Variable" value="Wert" scope="global"]] kann der Variable “$Variable” der Text “Wert” zugewiesen werden.

Das “scope=“global”” sorgt dafür, dass diese Variable auch später zur Verfügung steht.

Hinweis: Die Texte (und damit die Variablenzuweisungen) werden der Reihenfolge nach durchgegangen, wie sie auch im PDF angezeigt werden.
Das bedeutet, die Variable $styp ist in allen nachfolgenden Positionen ebenfalls (mit dem letzten gesetzten Wert) verfügbar (durch scope=“global”). In den vorhergehenden Positionen jedoch nicht!
Die Variable ist auch im Auftrags-Appendix verfügbar - jedoch nicht in der Auftrags-Beschreibung (da diese VOR den Positionen kommt).

Beispiel siehe FAQ: Positionsgruppen/Text mit Variable

Einige Variablen stehen grundsätzlich zur Verfügung.

Siehe Variablen Übersicht

Hierzu gehören unter anderem:

• $SCHEMA die Referenz auf das gesamte Datenbank Schema - siehe Webservice Entwickler Doku Basisoperation <module>/schema
• $CONFIGURATION die aktuelle Systemkonfiguration / Systemvariablen - siehe Variablen Übersicht
• $obj das aktuelle Hauptobjekt (siehe Angebot offer / Auftrag order / Rechnung invoice)

Die Variablen lassen sich größtenteils in der von smarty bekannten Syntax ausgeben bzw. verwenden - siehe http://www.smarty.net/docs/en/language.syntax.variables.tpl

ACHTUNG:
Entgegen der Angabe in der smarty Dokumentation werden Variablen und Funktionen mit 2 eckigen Klammern aufgerufen.

Also z.B. Aufruf einer Funktion [[funktion parameter="wert"]] ODER Ausgabe einer Variable [[$variable]]

Beispiel: Verwendung des Firmennamens als Variable

Vielen Dank für Ihren Auftrag, 
Ihr [[$CONFIGURATION.ownCompany]] Team

Für die Zahlungsanweisung an den Kunden kann z.B. in der Bankverbindung (Einstellungen → Eigene Firmendaten → Bankverbindung) nochmals auf den Gesamtpreis und die Rechnungsnummer als Verwendungszweck verwiesen werden.

Das aktuelle Objekt ist über die Variable [[$obj.<fieldname>]] zugreifbar.

Beispiel: Bankverbindung mit Verwendungszweck Angabe:

Bitte überweisen Sie den offenen Rechnungsbetrag von <b>[[$obj.price_wtax|d2bcurrency]]</b> auf unser Konto und geben Sie als Verwendungszweck die Rechnungsnummer <b>[[$obj._objref]]</b> an.

In diesem Beispiel wird auch die Schriftstil-Formatierung mit <b> verwendet.

Zusätzlich kommt ein Modifikator d2bcurrency zur Verwendung, der eine Zahl als Euro Betrag mit Tausendertrennzeichen und Komma formatiert.

TIPP: Ein vollständiger Code der auch unterschiedliche Zahlungsarten berücksichtigt findet sich hier: Zahlungsart in Bankverbindung verwenden

Die Funktion [[getobject]] erlaubt das Holen von Daten eines Objekts aus der Datenbank.
Ein Objekt kann hierbei ein Angebot/Auftrag/Rechnung sein, aber auch andere Objekte wie resource oder article.

Beispiel: Holen einer resource mit Namen und Verwendung der Beschreibung description:

Ihr Projektleiter: [[getobject module="resource" by="name" name="Leo Eibler" assign="projectmgr"]]
[[$projectmgr.description|nl2br]]

Eine Übersicht der gängigsten Variablen:

Beispiele:

Eine Übersicht der gängigsten Modifikatoren:

[[$obj.price_wtax|d2bCurrency]]

[[$obj.invoice_dt|date_format:"%d.%m.%Y"]]

[[$projectmgr.description|nl2br]]

Die Variablen sind immer in [[ und ]] einzufassen.
Also z.B. um den eigenen Firmennamen zu verwenden: [[$CONFIGURATION.ownCompany]]

Die Variablen werden in PDFs (z.B. bei der Angebotsbeschreibung, Auftragsbeschreibung, Rechnungsbeschreibung, Annex, etc.) als auch bei den Email Zusatz-Texten ausgewertet.

Siehe auch Email zusätzlicher Text und Anhänge.

Nachfolgend finden sich Beispiele für den Variablen Einsatz.

Mit folgendem Schnipsel in den Angebots-Standardtexten (siehe Einstellung → Druck → Standard Texte ) wird die Gültigkeit (hier 14 Tage) automatisch berechnet und als Datum ausgewiesen.
Die 14 Tage lassen sich beliebig verändern, in dem in der Formel 14 durch die Anzahl an Tage ersetzt wird.

Angebot gültig bis [[($time+14*86400)|date_format:"%d.%m.%Y"]]

In diesem Beispiel wird die Anrede (Sehr geehrter Herr, Sehr geehrte Frau, Sehr geehrte Damen und Herren) automatisch korrekt gesetzt.

Weiters wird das Hauptbild des Angebots mit [ [ addimg ] ] eingefügt (siehe Einfügen von Bildern aus Attachments).

Zum Abschluss wird der Benutzer, der das Angebot erstellt hat automatisch eingefügt sowie die Firmentelefonnummer und der Firmenname.

Sehr geehrte[[if $obj.site_name != ""]][[if $obj.site_title == 0]](r)[[elseif $obj.site_title == 1]]r[[/if]] [[$obj.site_name]][[else]] Damen und Herren[[/if]],

vielen Dank für Ihre Anfrage zu unseren Leistungen.

Anbei finden Sie unser Angebot.

[[addimg]]

Falls das Angebot noch nicht zur Gänze Ihren Wünschen entspricht,
zögern Sie nicht Ihren persönlichen Betreuer [[$obj.created_user__firstname]] [[$obj.created_user__lastname]] unter [[$CONFIGURATION.ownTelephone]] zu kontaktieren.

Ihre [[$CONFIGURATION.ownCompany]]

Resultat:

Das folgende Beispiel kann in den Rechnungsstandardtext eingefügt werden und erkennt automatisch ob es sich um eine steuerfreie Bauleistung im österreichischem Inland handelt oder eine steuerfreie Lieferung im EU Ausland.

[[if $obj.site_tax == 0 AND ( $obj.site_country_code2 == '' OR $obj.site_country_code2 == 'AT' )]] §19 Reverse Charge Bauleistungen 
[[else if $obj.site_tax == 0]] §19 Reverse Charge innergemeinschaftliche Lieferung
[[else]] [[/if]]