X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;ds=sidebyside;f=doc%2Fdokumentenvorlagen-und-variablen.html;h=ba8a1d16d07fbc3232a95c7637f8eec58d309f64;hb=4dbd40c0260327ca136a5c0f49c67822e837f451;hp=e0caebbea336333b5812567887b13ebc4bcae8f5;hpb=6a9e0071135379dbcf767c03ddcc12554a8cec9c;p=kivitendo-erp.git diff --git a/doc/dokumentenvorlagen-und-variablen.html b/doc/dokumentenvorlagen-und-variablen.html index e0caebbea..ba8a1d16d 100644 --- a/doc/dokumentenvorlagen-und-variablen.html +++ b/doc/dokumentenvorlagen-und-variablen.html @@ -240,7 +240,7 @@ td { packing_list.ext - Verpackungsliste + Packliste pick_list.ext @@ -566,7 +566,7 @@ td {

- Informationen über den Verkäfer (nur bei Verkaufsmasken):

+ Informationen über den Verkäufer (nur bei Verkaufsmasken):

@@ -678,6 +678,10 @@ td { + + + + @@ -841,6 +845,10 @@ td { + + + + @@ -981,6 +989,10 @@ td { + + + + @@ -1175,6 +1187,10 @@ td {

globalprojectnumber Projektnummer des ganzen Beleges
globalprojectdescriptionProjekbeschreibung des ganzen Beleges
intnotes Interne Bemerkungenprojectnumber Projektnummer
projectdescriptionProjektbeschreibung
qty Anzahldunning_duedate Fälligkeitsdatum für diese Mahhnung
dunning_idMahnungsnummer
fee Kummulative Mahngebühren
+ + + + @@ -1204,6 +1220,10 @@ td { + + + + @@ -1234,59 +1254,77 @@ td {

Blöcke, bedingte Anweisungen und Schleifen

-

Der Parser kennt neben den Variablen einige weitere Konstrukte, die - gesondert behandelt werden. Diese sind wie Variablennamen in spezieller - Weise markiert: <%anweisung%>

+

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"%>.

Der if-Block

<%if variablenname%>
...
- <%end>

+ <%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.

+

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 +

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.

+ "==" 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.

+ 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: - <%if intnotes =~ schwierig%>

+

Beispiel für einen Test, ob die Variable "intnotes" + (interne Bemerkungen) das Wort "schwierig" enthält: + <%if intnotes =~ + "schwierig"%>

Die foreach-Schleife

<%foreach variablenname%>
...
- <%end>

+ <%end%>

Fügt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das Perl-Array der Variablen "variablenname" Elemente enthät. Dieses @@ -1304,20 +1342,20 @@ td { Artikelnummer: <%number%>
Beschreibung: <%description%>
...
- <%end>

+ <%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.

Der pagebreak-Block

<%pagebreak ZpZ ZeS ZzS%>
...
- <%end>

+ <%end%>

Dieser Block existiert nur in LaTeX-Vorlagen.

@@ -1406,8 +1444,8 @@ td { href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">pagebreak-Block voreingestellten Werte einen Seitenumbruch nach der aktuellen Rechnungsposition. Dementsprechend funktioniert er nur innerhalb von - <foreach...>-Schleifen. Weiterhin benötigt er kein - Endtag.

+ <%foreach...%>-Schleifen. Weiterhin benötigt + er kein Endtag.

zum Inhaltsverzeichnis
VariablennameBedeutung
cusordnumberBestellnummer des Kunden (im Verkauf) bzw. Bestellnummer des Lieferanten (im Einkauf)
donumber Lieferscheinnummersi_chargenumber Chargennummer
si_bestbeforeMindesthaltbarkeit
si_number Artikelnummer