X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentenvorlagen-und-variablen.html;h=c9a7ebb9862fb787f2548bcf7b7c73661372122e;hb=f110df03e304dd4722574a23b823a88fc4fa37d8;hp=d29b73714541e9a0184a27be707068343792d712;hpb=f84763177341da274dd63d6fe8c2f2bf52532c02;p=kivitendo-erp.git diff --git a/doc/dokumentenvorlagen-und-variablen.html b/doc/dokumentenvorlagen-und-variablen.html index d29b73714..c9a7ebb98 100644 --- a/doc/dokumentenvorlagen-und-variablen.html +++ b/doc/dokumentenvorlagen-und-variablen.html @@ -112,6 +112,7 @@ td {
if not
-Blockif
-BlockEinige 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 @@ -209,7 +216,7 @@ td { äquivalente Beispiel für HTML-Dokumentenvorlagen sieht so aus:
-<!-- config: tag-stye=($ $)>
<!-- config: tag-style=($ $) -->
packing_list.ext
pick_list.ext
bic
business
homepage
iban
language
name
payment_description
payment_terms
taxnumber
ustid
vendoremail
globalprojectnumber |
Projektnummer des ganzen Beleges | +||||||||
globalprojectdescription |
+ Projekbeschreibung des ganzen Beleges | +||||||||
intnotes |
Interne Bemerkungen | @@ -705,6 +729,10 @@ td {ordnumber |
Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde | ||||||
payment_description |
+ Name der Zahlart | +||||||||
payment_terms |
Zahlungskonditionen | @@ -726,7 +754,7 @@ td {Transportmittel | |||||||
subtotal |
+ subtotal[_nofmt] |
Zwischensumme aller Posten ohne Steuern | |||||||
Artikelbeschreibung | |||||||||
discount |
+ discount[_nofmt] |
Rabatt als Betrag | |||||||
discount_sub |
+ discount_sub[_nofmt] |
Zwischensumme mit Rabatt | |||||||
Grafik | |||||||||
linetotal |
+ linetotal[_nofmt] |
Zeilensumme (Anzahl * Einzelpreis) | |||||||
Mikrofilm | |||||||||
netprice |
+ netprice[_nofmt] |
Nettopreis | |||||||
nodiscount_linetotal |
+ nodiscount_linetotal[_nofmt] |
Zeilensumme ohne Rabatt | |||||||
nodiscount_sub |
+ nodiscount_sub[_nofmt] |
Zwischensumme ohne Rabatt | |||||||
Projektnummer | |||||||||
qty |
+ projectdescription |
+ Projektbeschreibung | +|||||||
qty[_nofmt] |
Anzahl | ||||||||
Position auf der Rechnung (1, 2, 3...) | |||||||||
sellprice |
+ sellprice[_nofmt] |
Verkaufspreis | |||||||
serialnumber |
Seriennummer | ||||||||
tax_rate |
+ Steuersatz | +||||||||
transdate_oe |
Auftragsdatum des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde | @@ -980,6 +1016,10 @@ td {dunning_duedate |
Fälligkeitsdatum für diese Mahhnung | ||||||
dunning_id |
+ Mahnungsnummer | +||||||||
fee |
Kummulative Mahngebühren | @@ -1174,6 +1214,10 @@ td {
Variablenname | Bedeutung |
---|---|
cusordnumber |
+ Bestellnummer des Kunden (im Verkauf) bzw. Bestellnummer des Lieferanten (im Einkauf) | +
donumber |
Lieferscheinnummer | @@ -1185,6 +1229,14 @@ td {
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 @@ -1203,6 +1255,10 @@ td {
si_chargenumber
si_bestbefore
si_number
+
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 | +
Der Parser kennt neben den Variablen einige weitere Konstrukte, die
- gesondert behandelt werden. Diese sind wie Variablennamen in spezieller
- Weise markiert: <%anweisung%>
if not
-Block<%if not variablenname%>
- ...
- <%end>
Eine normale "if-not-then"-Bedingung. Die Zeilen zwischen dem "if not" und - dem "end" werden nur ausgegeben, wenn die Variable "variablenname" nicht - gesetzt oder gleich 0 ist.
+Der Parser kennt neben den Variablen einige weitere Konstrukte,
+ die gesondert behandelt werden. Diese sind wie Variablennamen in
+ spezieller Weise markiert: <%anweisung%>
+ ... <%end%>
Anmerkung zum <%end%>
: Der besseren
+ 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
+ <%end%>
genauso abgeschlossen werden
+ wie mit
+ <%end if%>
oder auch
+ <%end type ==
+ "sales_quotation"%>
.
if
-Block<%if variablenname%>
...
- <%end>
Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" und dem - "end" werden nur ausgegeben, wenn die Variable "variablenname" gesetzt und - ungleich 0 ist.
+ <%end%> + +Eine normale "if-then"-Bedingung. Die Zeilen zwischen + dem "if" und dem "end" werden nur ausgegeben, + wenn die Variable "variablenname" gesetzt und ungleich 0 + ist.
+ +Die Bedingung kann auch negiert werden, indem das Wort
+ "not" nach dem "if" verwendet
+ 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 + 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 + 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
+ Zeichenkette "Wert". Mittels "!=" anstelle von
+ "==" würde auf Ungleichheit getestet.
<%if var1 == var2%>
testet die
+ 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 + 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:
+ <%if intnotes =~
+ "schwierig"%>
foreach
-Schleife<%foreach variablenname%>
...
- <%end>
Fügt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
Perl-Array der Variablen "variablenname" Elemente enthät. Dieses
@@ -1279,20 +1452,20 @@ td {
Artikelnummer: <%number%>
Beschreibung: <%description%>
...
- <%end>
Besonderheit in OpenDocument-Vorlagen: Tritt ein
- <foreach>
-Block innerhalb einer Tabellenzelle
+ <%foreach%>
-Block innerhalb einer Tabellenzelle
auf, so wird die komplette Tabellenzeile so oft wiederholt wie
notwendig. Tritt er außerhalb auf, so wird nur der Inhalt
- zwischen <foreach>
und <end>
+ zwischen <%foreach%>
und <%end%>
wiederholt, nicht aber die komplette Zeile, in der er steht.
pagebreak
-Block<%pagebreak ZpZ ZeS ZzS%>
...
- <%end>
Dieser Block existiert nur in LaTeX-Vorlagen.
@@ -1371,6 +1544,10 @@ td {<pagebreak>
<bullet>
<foreach...>
-Schleifen. Weiterhin benötigt er kein
- Endtag.
+ <%foreach...%>
-Schleifen. Weiterhin benötigt
+ er kein Endtag.
+
+ Auch <bullet>
funktioniert momentan auch nur in Latex-Vorlagen.