X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentenvorlagen-und-variablen.html;h=b9ca939c4392af36c3cbe2febee10cc557a230ef;hb=65573957980291104639ebe3ab16ecf2c4bef433;hp=4ca82e372ccb577ad93eee4dd417cd88c33816fe;hpb=8f2157619ac4656eabb16fa972846a0e38c98ad0;p=kivitendo-erp.git diff --git a/doc/dokumentenvorlagen-und-variablen.html b/doc/dokumentenvorlagen-und-variablen.html index 4ca82e372..b9ca939c4 100644 --- a/doc/dokumentenvorlagen-und-variablen.html +++ b/doc/dokumentenvorlagen-und-variablen.html @@ -48,6 +48,9 @@ td {
include
-Anweisungif not
-BlockDies ist eine Auflistung der Standard-Dokumentenvorlagen und aller
zur Bearbeitung verfügbaren Variablen. Eine Variable wird in
einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
- <%variablenname%>
verwendet wird.
<%variablenname%>
verwendet wird. Für LaTeX-
+ und HTML-Vorlagen kann man die Form dieser Tags auch
+
+ verändern.
+
Früher wurde hier nur über LaTeX gesprochen. Inzwischen
unterstützt Lx-Office aber auch OpenDocument-Vorlagen. Sofern
@@ -156,6 +175,36 @@ td {
zum Inhaltsverzeichnis
Der Standardstil für Tags sieht vor, dass ein Tag mit dem
+ Kleinerzeichen und einem Prozentzeichen beginnt und mit dem
+ Prozentzeichen und dem Größerzeichen endet,
+ beispielsweise <%customer%>
. Da diese Form aber
+ z.B. in LaTeX zu Problemen führen kann, weil das Prozentzeichen
+ dort Kommentare einleitet, kann pro HTML- oder
+ LaTeX-Dokumentenvorlage der Stil umgestellt werden.
Dazu werden in die Datei Zeilen geschrieben, die mit dem für
+ das Format gültigen Kommentarzeichen anfangen,
+ dann config:
enthalten, die entsprechende Option setzen
+ und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen
+ enden. Beispiel für LaTeX:
% config: tag-style=($ $)
Dies würde Lx-Office dazu veranlassen, Variablen zu ersetzen,
+ wenn sie wie folgt aussehen: ($customer$)
. Das
+ äquivalente Beispiel für HTML-Dokumentenvorlagen sieht so
+ aus:
<!-- config: tag-stye=($ $)>
business
city
customernumber
customeremail
customerfax
customernotes
customernumber
customerphone
discount
name
payment_terms
phone
taxnumber
terms
vendoremail
shiptocontact
).
-
employee_company |
Firmenname | +||
employee_co_ustid |
+ Usatzsteuer-Identifikationsnummer | +||
employee_duns |
+ DUNS-Nummer | +||
employee_email |
employee_signature |
Signatur | |
employee_taxnumber |
+ Steuernummer | +||
employee_tel |
Telefonnummer | @@ -428,6 +501,59 @@ td {
+
Variablenname | Bedeutung |
---|---|
salesman_address |
+ Adressfeld | +
salesman_businessnumber |
+ Firmennummer | +
salesman_company |
+ Firmenname | +
salesman_co_ustid |
+ Usatzsteuer-Identifikationsnummer | +
salesman_duns |
+ DUNS-Nummer | +
salesman_email |
+ |
salesman_fax |
+ Fax | +
salesman_name |
+ voller Name | +
salesman_signature |
+ Signatur | +
salesman_taxnumber |
+ Steuernummer | +
salesman_tel |
+ Telefonnummer | +
duedate
globalprojectnumber
intnotes
notes
orddate
ordnumber
payment_terms
quodate
quonumber
total
transaction_description
transdate
partsgroup
price_factor
price_factor_name
projectnumber
Die Namen der Vorlagen werden im System-Menü vom Benutzer
+ eingegeben. Wird für ein Mahnlevel die Option zur automatischen
+ Erstellung einer Rechnung über die Mahngebühren und Zinsen
+ aktiviert, so wird der Name der Vorlage für diese Rechnung aus
+ dem Vorlagenname für diese Mahnstufe mit dem
+ Zusatz _invoice
gebildet. Weiterhin werden die
+ Kürzel für die ausgewählte Sprache und den
+ ausgewählten Drucker angehängt.
Die Variablen des Verkäufers stehen wie gewohnt
+ als employee_...
zur Verfügung. Die Adressdaten des
+ Kunden stehen als Variablen name
, street
,
+ zipcode
, city
, country
,
+ department_1
, department_2
, und
+ email
zur Verfügung.
+
Weitere Variablen beinhalten:
+ ++
Variablenname | Bedeutung |
---|---|
dunning_date |
+ Datum der Mahnung | +
dunning_duedate |
+ Fälligkeitsdatum für diese Mahhnung | +
fee |
+ Kummulative Mahngebühren | +
interest_rate |
+ Zinssatz per anno in Prozent | +
total_amount |
+ Gesamter noch zu zahlender Betrag als fee + total_interest + total_open_amount |
+
total_interest |
+ Zinsen per anno über alle Rechnungen | +
total_open_amount |
+ Summe über alle offene Beträge der Rechnungen | +
+
Variablenname | Bedeutung |
---|---|
dn_amount |
+ Rechnungssumme (brutto) | +
dn_duedate |
+ Originales Fälligkeitsdatum der Rechnung | +
dn_dunning_date |
+ Datum der Mahnung | +
dn_dunning_duedate |
+ Fälligkeitsdatum der Mahnung | +
dn_fee |
+ Kummulative Mahngebühr | +
dn_interest |
+ Zinsen per anno für diese Rechnung | +
dn_invnumber |
+ Rechnungsnummer | +
dn_linetotal |
+ Noch zu zahlender Betrag (ergibt sich aus dn_open_amount + dn_fee + dn_interest ) |
+
dn_netamount |
+ Rechnungssumme (netto) | +
dn_open_amount |
+ Offener Rechnungsbetrag | +
dn_ordnumber |
+ Bestellnummer | +
dn_transdate |
+ Rechnungsdatum | +
Die Variablen des Verkäufers stehen wie gewohnt
+ als employee_...
zur Verfügung. Die Adressdaten des
+ Kunden stehen als Variablen name
, street
,
+ zipcode
, city
, country
,
+ department_1
, department_2
, und
+ email
zur Verfügung.
+
Weitere Variablen beinhalten:
+ ++
Variablenname | Bedeutung |
---|---|
duedate |
+ Fälligkeitsdatum der Rechnung | +
dunning_id |
+ Mahnungsnummer | +
fee |
+ Mahngebühren | +
interest |
+ Zinsen | +
invamount |
+ Rechnungssumme (ergibt sich aus fee + interest ) |
+
invdate |
+ Rechnungsdatum | +
invnumber |
+ Rechnungsnummer | +
<%anweisung%>
- Achtung: Blöcke können in LaTeX-Vorlagen momentan nicht
- verschachtelt werden. Das bedeutet, dass innerhalb einer
- <%foreach%>
-Schleife keine
- <%if%>
-Abfragen verwendet werden können. Dieses
- kann man aber mit LaTeX-Bordmitteln selber nachgebildet werden. Dazu muss
- im Vorspann das Paket ifthen
eingebunden werden. Das Konstrukt
- selber sieht dann wie folgt aus:
\ifthenelse{\equal{<%variable%>}{}}{}{Dieser
- Text erscheint nur, wenn <%variable%> nicht leer ist.}
Die eben erwähnten Einschränkungen für
- LaTeX-Vorlagen gelten in abgeschwächter Form auch für
- OpenDocument-Vorlagen. Auch bei OpenDocument-Vorlagen können
- Blöcke nicht verschachtelt werden. Einzige Ausnahme ist, dass
- <if>
und
- <ifnot>
-Blöcke innerhalb von
- <foreach>
-Blöcken auftreten
- dürfen.
include
-Anweisung<%include dateiname.ext%>
Dieser Block funktioniert nur in LaTeX- und HTML-Vorlagen.
- -Fügt den Inhalt einer Datei an der entsprechenden Stelle ein. Der - eingefügte Text wird ganz normal durch den Parser behandelt und kann - Variablen und Blöcke enthalten.
-if not
-Block<%if not variablenname%>
...
- <%end if>
Eine normale "if-not-then"-Bedingung. Die Zeilen zwischen dem "if not" und dem "end" werden nur ausgegeben, wenn die Variable "variablenname" nicht @@ -743,7 +1028,7 @@ td {
<%if variablenname%>
...
- <%end if>
Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" und dem "end" werden nur ausgegeben, wenn die Variable "variablenname" gesetzt und @@ -753,7 +1038,7 @@ td {
<%foreach variablenname%>
...
- <%end foreach>
Fügt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
Perl-Array der Variablen "variablenname" Elemente enthät. Dieses
@@ -771,21 +1056,20 @@ td {
Artikelnummer: <%number%>
Beschreibung: <%description%>
...
- <%end foreach>
Besonderheit in OpenDocument-Vorlagen: Tritt ein
- <foreach>
-Blcok 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
- foreach>
wiederholt, nicht aber die komplette Zeile, in
- der er steht.
<foreach>
und <end>
+ wiederholt, nicht aber die komplette Zeile, in der er steht.
pagebreak
-Block<%pagebreak ZpZ ZeS ZzS%>
...
- <%end pagebreak%>
Dieser Block existiert nur in LaTeX-Vorlagen.