X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;ds=sidebyside;f=doc%2Fhtml%2Fch03s03.html;h=a6445abd3fc3c0317c31036083f7784f365aacbb;hb=f044d58d95464652f923f0c27d74566f72c1fb47;hp=f38b7eb2d9bb668c4e10a89913d51c47af4b50d8;hpb=dd75cbf32d9238944731b2fb059bddce03bb64eb;p=kivitendo-erp.git diff --git a/doc/html/ch03s03.html b/doc/html/ch03s03.html index f38b7eb2d..a6445abd3 100644 --- a/doc/html/ch03s03.html +++ b/doc/html/ch03s03.html @@ -1,14 +1,13 @@
-Dies ist eine Auflistung der Standard-Dokumentenvorlagen und +
Dies 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. Für
LaTeX- und HTML-Vorlagen kann man die Form dieser Tags auch verändern
- (siehe Anfang und Ende der Tags verändern).
Früher wurde hier nur über LaTeX gesprochen. Inzwischen - unterstützt kivitendo aber auch OpenDocument-Vorlagen. Sofern es nicht - ausdrücklich eingeschränkt wird, gilt das im Folgenden gesagte für - alle Vorlagenarten.
Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen + (siehe Anfang und Ende der Tags verändern).
kivitendo unterstützt LaTeX-, HTML- und OpenDocument-Vorlagen. + Sofern es nicht ausdrücklich eingeschränkt wird, gilt das im Folgenden + gesagte für alle Vorlagenarten.
Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
verfügbar als hier aufgelistet werden. Die meisten davon können
allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann
@@ -121,8 +120,8 @@
template_meta.language.description
Beschreibung der verwendeten Sprache
template_meta.language.template_code
- Vorlagenürzel der verwendeten Sprache, identisch mit dem - Kürzel das im Dateinamen verwendetet wird.
Vorlagenkürzel der verwendeten Sprache, identisch mit + dem Kürzel das im Dateinamen verwendetet wird.
template_meta.language.output_numberformat
Zahlenformat der verwendeten Sprache in der Form
"1.000,00
". Experimentell! Nur
@@ -209,6 +208,8 @@
Emailadresse
fax
Faxnummer
gln
+ GLN (Globale Lokationsnummer)
greeting
Anrede
homepage
@@ -220,6 +221,10 @@
Sprache
name
Firmenname
natural_person
+ Flag "natürliche Person"; Siehe auch + Hinweise zur Anrede +
payment_description
Name der Zahlart
payment_terms
@@ -235,10 +240,10 @@
shiptocountry
Land (Lieferadresse) *
shiptodepartment1
+ shiptodepartment_1
Abteilung 1 (Lieferadresse) *
shiptodepartment2
+ shiptodepartment_2
Abteilung 2 (Lieferadresse) *
shiptoemail
@@ -246,6 +251,9 @@
shiptofax
Fax (Lieferadresse) * +
shiptogln
+ GLN (Globale Lokationsnummer) (Lieferadresse) *
shiptoname
Firmenname (Lieferadresse) *
@@ -342,7 +350,24 @@
delivery_term.description
Beschreibung der Lieferbedingung
delivery_term.description_long
- Langtext bzw. übersetzter Langtext der Lieferbedingung
+ Abweichende Rechnungsadressen gibt es nur in Verkaufsbelegen. Die entsprechenden Variablen sind nur dann mit Inhalt gefüllt,
+ wenn im Beleg eine abweichende Rechnungsadresse ausgewählt wurde. Ob eine Adresse überhaupt ausgewählt wurde, kann über die
+ Variable billing_address_id
getestet werden, die die Datenbank-ID der abweichenden Rechnungsadresse enthält,
+ wenn eine ausgewählt ist.
+
+ Die Variablennamen starten alle mit dem Präfix billing_address_
und heiÃen anschlieÃend so, wie ihre Pendants
+ aus der Standard-Rechnungsadresse des Kunden. Beispiel: die Postleitzahl, die in der normalen Rechnungsadresse in
+ zipcode
steht, steht für die abweichende Rechnungsadresse in billing_address_zipcode
.
+
+ Die folgenden Variablen stehen so zur Verfügung: billing_address_name
,
+ billing_address_department_1
, billing_address_department_2
,
+ billing_address_contact
, billing_address_street
,
+ billing_address_zipcode
, billing_address_city
, billing_address_country
,
+ billing_address_gln
, billing_address_email
, billing_address_phone
und
+ billing_address_fax
.
+
creditremaining
Verbleibender Kredit
currency
@@ -380,6 +405,9 @@
Angebotsdatum
quonumber
Angebotsnummer
rounding
+ Betrag, um den invtotal
gerundet
+ wurde (kann positiv oder negativ sein)
shippingpoint
Versandort
shipvia
@@ -399,13 +427,16 @@
description
Artikelbeschreibung
cusordnumber_oe
- Bestellnummer des Kunden aus dem Auftrag, aus dem der Posten ursprünglich stammt (nur Verkauf)
Bestellnummer des Kunden aus dem Auftrag, aus dem der + Posten ursprünglich stammt (nur Verkauf)
discount
Rabatt als Betrag
discount_sub
Zwischensumme mit Rabatt
donumber_do
- Lieferscheinnummer des Lieferscheins, aus dem die Position ursprünglich stammt, wenn die Rechnung im Rahmen des Workflows aus einem Lieferschein erstellt wurde.
Lieferscheinnummer des Lieferscheins, aus dem die + Position ursprünglich stammt, wenn die Rechnung im Rahmen des + Workflows aus einem Lieferschein erstellt wurde.
drawing
Zeichnung
ean
@@ -415,11 +446,19 @@
linetotal
Zeilensumme (Anzahl * Einzelpreis)
longdescription
- Langtext
Langtext, vorbelegt mit dem Feld Bemerkungen der entsprechenden Ware
microfiche
Mikrofilm
netprice
- Alternative zu sellprice
, aber netprice
entspricht dem effektiven Einzelpreis und beinhaltet Zeilenrabatt und Preisfaktor. netprice
wird rückgerechnet aus Zeilensumme / Menge. Diese Variable ist nützlich, wenn man den gewährten Rabatt in der Druckvorlage nicht anzeigen möchte, aber Menge * Einzelpreis trotzdem die angezeigte Zeilensumme ergeben soll. netprice
hat nichts mit Netto/Brutto im Sinne von Steuern zu tun.
Alternative zu sellprice
, aber
+ netprice
entspricht dem effektiven
+ Einzelpreis und beinhaltet Zeilenrabatt und Preisfaktor.
+ netprice
wird rückgerechnet aus Zeilensumme
+ / Menge. Diese Variable ist nützlich, wenn man den gewährten
+ Rabatt in der Druckvorlage nicht anzeigen möchte, aber Menge *
+ Einzelpreis trotzdem die angezeigte Zeilensumme ergeben soll.
+ netprice
hat nichts mit Netto/Brutto im
+ Sinne von Steuern zu tun.
nodiscount_linetotal
Zeilensumme ohne Rabatt
nodiscount_sub
@@ -427,7 +466,12 @@
number
Artikelnummer
ordnumber_oe
- Auftragsnummer des Originalauftrags, aus dem der Posten ursprünglich stammt. Nützlich, wenn die Rechnung aus mehreren Lieferscheinen zusammengefasst wurde, oder wenn zwischendurch eine Sammelauftrag aus mehreren Aufträgen erstellt wurde. In letzterem Fall wird die unsprüngliche Auftragsnummer angezeigt.
Auftragsnummer des Originalauftrags, aus dem der Posten + ursprünglich stammt. Nützlich, wenn die Rechnung aus mehreren + Lieferscheinen zusammengefasst wurde, oder wenn zwischendurch + eine Sammelauftrag aus mehreren Aufträgen erstellt wurde. In + letzterem Fall wird die unsprüngliche Auftragsnummer + angezeigt.
p_discount
Rabatt in Prozent
partnotes
@@ -457,11 +501,16 @@
tax_rate
Steuersatz
transdate_do
- Datum des Lieferscheins, wenn die Rechnung im Rahmen des Workflows aus einem Lieferschein stammte.
Datum des Lieferscheins, wenn die Rechnung im Rahmen des + Workflows aus einem Lieferschein stammte.
transdate_oe
- Datum des Auftrags, wenn die Rechnung im Rahmen des Workflows aus einem Auftrag erstellt wurde. Wenn es Sammelaufträge gab wird das Datum des ursprünglichen Auftrags genommen.
Datum des Auftrags, wenn die Rechnung im Rahmen des + Workflows aus einem Auftrag erstellt wurde. Wenn es + Sammelaufträge gab wird das Datum des ursprünglichen Auftrags + genommen.
transdate_quo
- Datum des Angebots, wenn die Position im Rahmen des Workflows aus einem Angebot stammte.
Datum des Angebots, wenn die Position im Rahmen des + Workflows aus einem Angebot stammte.
unit
Einheit
weight
@@ -491,20 +540,30 @@
number_of_employees
definiert, die die Anzahl der
Mitarbeiter des Unternehmens enthält. Diese Variable steht dann
unter dem Namen vc_cvar_number_of_employees
zur
- Verfügung.Die Namen der Vorlagen werden im System-Menü vom Benutzer + Verfügung.
Die benutzerdefinierten Variablen der Lieferadressen stehen
+ unter einem ähnlichen Namensschema zur Verfügung. Hier lautet der
+ Präfix shiptocvar_
.
Analog stehen die benutzerdefinierten Variablen für
+ Ansprechpersonen mit dem Namenspräfix cp_cvar_
+ zur Verfügung.
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:
Die Variablen des Bearbeiters, bzw. Verkäufers stehen wie
+ gewohnt als employee_...
bzw.
+ salesman_...
zur Verfügung. Werden mehrere
+ Rechnungen in einer Mahnung zusammengefasst, so werden die Metadaten
+ (Bearbeiter, Abteilung, etc) der ersten angemahnten Rechnung im
+ Ausdruck genommen.
Die Adressdaten des Kunden stehen als Variablen
+ name
, street
,
+ zipcode
, city
,
+ country
, department_1
,
+ department_2
, und email
zur
+ Verfügung. Der Ansprechpartner cp_...
steht auch
+ zu Verfügung, wird allerdings auch nur von der ersten angemahnten
+ Rechnung (s.o.) genommen.
Weitere Variablen beinhalten:
dunning_date
Datum der Mahnung
dunning_duedate
@@ -512,7 +571,7 @@
dunning_id
Mahnungsnummer
fee
- Kummulative Mahngebühren
Kumulative Mahngebühren
interest_rate
Zinssatz per anno in Prozent
total_amount
@@ -574,7 +633,7 @@
invdate
Rechnungsdatum
invnumber
- Rechnungsnummer
Die Variablen in anderen Vorlagen sind ähnlich wie in der
Rechnung. Allerdings heiÃen die Variablen, die mit
inv
beginnen, jetzt anders. Bei den Angeboten
fangen sie mit quo
für "quotation" an:
@@ -678,10 +737,13 @@
...
<%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.
Handelt es sich bei der benannten Variable um ein Array, also um einen Variablennamen, über den man mit - <%foreach variablenname%> iteriert, so wird mit diesem Konstrukt darauf getestet, ob das Array Elemente - enthält. Somit würde im folgenden Beispiel nur dann eine Liste von Zahlungseingängen samt ihrer Ãberschrift "Zahlungseingänge" - ausgegeben, wenn tatsächlich welche getätigt wurden:
<%if payment%> +variablenname
gesetzt und ungleich 0 ist.Handelt es sich bei der benannten Variable um ein Array, also + um einen Variablennamen, über den man mit <%foreach + variablenname%> iteriert, so wird mit diesem Konstrukt + darauf getestet, ob das Array Elemente enthält. Somit würde im + folgenden Beispiel nur dann eine Liste von Zahlungseingängen samt + ihrer Ãberschrift "Zahlungseingänge" ausgegeben, wenn tatsächlich + welche getätigt wurden:
<%if payment%> Zahlungseingänge: <%foreach payment%> Am <%paymentdate%>: <%payment%> ⬠@@ -740,4 +802,12 @@ Beschreibung: <%description%> (HTML oder PDF über LaTeX) umgesetzt.Die unterstützen Formatierungen sind:
- <b>Text</b>
Text wird in Fettdruck gesetzt.
- <i>Text</i>
Text wird kursiv gesetzt.
- <u>Text</u>
Text wird unterstrichen.
- <s>Text</s>
Text wird durchgestrichen. Diese Formatierung ist nicht bei der Ausgabe als PDF über LaTeX verfügbar.
- <bullet>
Erzeugt einen ausgefüllten Kreis für Aufzählungen (siehe unten).
Der Befehl <bullet> funktioniert - momentan auch nur in Latex-Vorlagen.
Das Flag "natürliche Person"
+ (natural_person
) aus den Kunden- oder
+ Lieferantenstammdaten kann in den Druckvorlagen zusammen mit
+ dem Feld "Anrede" (greeting
) z.B. dafür
+ verwendet werden, die Anrede zwischen einer allgemeinen und
+ einer persönlichen Anrede zu unterscheiden.
+
<%if natural_person%><%greeting%> <%name%><%else%>Sehr geehrte Damen und Herren<%end if%>
+ +