X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;ds=inline;f=doc%2Fdokumentenvorlagen-und-variablen.html;h=91e245da8f5aeeb8bdef05f0131630dcd55d209a;hb=388a2ff5471adc27084f77e60fe154f25790dc9e;hp=d456541ff8a770add2ee8635833eca6cf1da9569;hpb=f89d3512c42a982714177ef491c04216254aba3b;p=kivitendo-erp.git diff --git a/doc/dokumentenvorlagen-und-variablen.html b/doc/dokumentenvorlagen-und-variablen.html index d456541ff..91e245da8 100644 --- a/doc/dokumentenvorlagen-und-variablen.html +++ b/doc/dokumentenvorlagen-und-variablen.html @@ -48,6 +48,9 @@ td {
Einige Zahlenwerte werden auch in unformatierter Form zur Verfügung + gestellt (also z.B. 35 statt 35,00 oder 12.3 statt 12,30). Der Dezimaltrenner + ist dabei also immer ein Punkt unabhaengig vom eingestellten Zahlenformat. + Diese Variabelen kann man mit der Erweiterung _nofmt (für no-format) aufrufen + (also z.B. netprice = 12,30 -- netprice_nofmt = 12.3). Variabeln die zusätzlich + unformatiert zur Verfügung stehen sind unten als variable[_nofmt] gelistet. + Die Eckigen Klammern weisen also auf eine optionale Verwändung der Erweiterung hin. +
+Früher wurde hier nur über LaTeX gesprochen. Inzwischen
unterstützt Lx-Office aber auch OpenDocument-Vorlagen. Sofern
es nicht ausdrücklich eingeschränkt wird, gilt das im
@@ -182,6 +195,43 @@ td {
zum Inhaltsverzeichnis
Um eine Variable auszugeben, müssen sie einfach nur zwischen die
+ Tags geschrieben werden, also
+ z.B. <%variablenname%>
.
+ Optional kann man auch mit Leerzeichen getrennte Flags angeben, die
+ man aber nur selten brauchen wird. Die Syntax sieht also so
+ aus: <%variablenname FLAG1 FLAG2%>
. Momentan werden
+ die folgenden Flags unterstützt:
+
NOFORMAT
gilt nur für Zahlenwerte und gibt den Wert
+ ohne Formatierung, also ohne Tausendertrennzeichen mit mit einem
+ Punkt als Dezimaltrennzeichen aus. Nützlich z.B., wenn damit in der
+ Vorlage z.B. von LaTeX gerechnet werden soll.
+ NOESCAPE
unterdrückt das Escapen von Sonderzeichen für
+ die Vorlagensprache. Wenn also in einer Variablen bereits gültiger
+ LaTeX-Code steht und dieser von LaTeX auch ausgewertet und nicht
+ wortwörtlich angezeigt werden soll, so ist dieses Flag sinnvoll.
+
+ Beispiel: <%quototal NOFORMAT%>
+
name
payment_description
payment_terms
ordnumber
payment_description
payment_terms
subtotal
subtotal[_nofmt]
discount
discount[_nofmt]
discount_sub
discount_sub[_nofmt]
linetotal
linetotal[_nofmt]
netprice
netprice[_nofmt]
nodiscount_linetotal
nodiscount_linetotal[_nofmt]
nodiscount_sub
nodiscount_sub[_nofmt]
qty
qty[_nofmt]
sellprice
sellprice[_nofmt]
serialnumber
tax_rate
transdate_oe
Für jede Position eines Lieferscheines gibt es ein Unterarray mit
+ den Informationen darüber, von welchem Lager und Lagerplatz aus die
+ Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
+ Lagerplatz sie eingelagert wurden. Diese müssen mittels
+ einer foreach
-Schleife ausgegeben werden. Diese
+ Variablen sind:
Für jede Position eines Lieferscheines gibt es ein Unterarray mit den Informationen darüber, von welchem Lager und Lagerplatz aus die Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen @@ -1252,6 +1322,81 @@ td {
++
Variablenname | Bedeutung |
---|---|
c0total |
+ Gesamtbetrag aller Rechnungen mit Fälligkeit < 30 Tage | +
c30total |
+ Gesamtbetrag aller Rechnungen mit Fälligkeit >= 30 und < 60 Tage | +
c60total |
+ Gesamtbetrag aller Rechnungen mit Fälligkeit >= 60 und < 90 Tage | +
c90total |
+ Gesamtbetrag aller Rechnungen mit Fälligkeit >= 90 Tage | +
total |
+ Gesamtbetrag aller Rechnungen | +
+
Variablenname | Bedeutung |
---|---|
invnumber |
+ Rechnungsnummer | +
invdate |
+ Rechnungsdatum | +
duedate |
+ Fälligkeitsdatum | +
amount |
+ Summe der Rechnung | +
open |
+ Noch offener Betrag der Rechnung | +
c0 |
+ Noch offener Rechnungsbetrag mit Fälligkeit < 30 Tage | +
c30 |
+ Noch offener Rechnungsbetrag mit Fälligkeit >= 30 und < 60 Tage | +
c60 |
+ Noch offener Rechnungsbetrag mit Fälligkeit >= 60 und < 90 Tage | +
c90 |
+ Noch offener Rechnungsbetrag mit Fälligkeit >= 90 Tage | +
Anmerkung zum <%end%>
: Der besseren
- Verständlichkeit halber kann man nach dem end
noch
- beliebig weitere Wörter schreiben, um so zu markieren, welche
+ Verständlichkeit halber kann man nach dem end
noch
+ beliebig weitere Wörter schreiben, um so zu markieren, welche
Anweisung (z.B. if
oder foreach
) damit
abgeschlossen wird.
Beispiel: Lautet der Beginn eines Blockes
z.B. <%if type ==
- "sales_quotation"%>
, so könnte er mit
+ "sales_quotation"%>, so könnte er mit
<%end%>
genauso abgeschlossen werden
wie mit
<%end if%>
oder auch
@@ -1295,33 +1440,33 @@ td {
wird. Beispiel: <%if not
cp_greeting%>
Zusätzlich zu dem einfachen Test, ob eine Variable gesetzt ist - oder nicht, bietet dieser Block auch die Möglichkeit, den Inhalt +
Zusätzlich zu dem einfachen Test, ob eine Variable gesetzt ist + oder nicht, bietet dieser Block auch die Möglichkeit, den Inhalt einer Variablen mit einer festen Zeichenkette oder einer anderen Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette - oder einer anderen Variablen vorgenommen wird, hängt davon ab, ob - die rechte Seite des Vergleichsoperators in Anführungszeichen + oder einer anderen Variablen vorgenommen wird, hängt davon ab, ob + die rechte Seite des Vergleichsoperators in Anführungszeichen gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit anderer Variablen). Zwei Beispiele, die beide Vergleiche zeigen:
<%if var1 == "Wert"%>
- testet die Variable "var1" auf Ãbereinstimmung mit der
+ testet die Variable "var1" auf Übereinstimmung mit der
Zeichenkette "Wert". Mittels "!=" anstelle von
- "==" würde auf Ungleichheit getestet.
<%if var1 == var2%>
testet die
- Variable "var1" auf Ãbereinstimmung mit der Variablen
+ Variable "var1" auf Übereinstimmung mit der Variablen
"var2". Mittels "!=" anstelle von "=="
- würde auf Ungleichheit getestet.
Erfahrere Benutzer können neben der Tests auf (Un-)Gleichheit auch - Tests auf Ãbereinstimmung mit regulären Ausdrücken ohne - Berücksichtung der GroÃ- und Kleinschreibung durchführen. Dazu dient +
Erfahrere Benutzer können neben der Tests auf (Un-)Gleichheit auch + Tests auf Übereinstimmung mit regulären Ausdrücken ohne + Berücksichtung der Groß- und Kleinschreibung durchführen. Dazu dient dieselbe Syntax wie oben nur mit "=~" und "!~" als Vergleichsoperatoren.
-Beispiel für einen Test, ob die Variable "intnotes" - (interne Bemerkungen) das Wort "schwierig" enthält: +
Beispiel für einen Test, ob die Variable "intnotes"
+ (interne Bemerkungen) das Wort "schwierig" enthält:
<%if intnotes =~
"schwierig"%>
<pagebreak>
<bullet>
<%foreach...%>
-Schleifen. Weiterhin benötigt
er kein Endtag.
+ Auch <bullet>
funktioniert momentan auch nur in Latex-Vorlagen.