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).
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 diese wie folgt erhalten werden:
SL/Form.pmöffnen und am Anfang die Zeile "use Data::Dumper;" einfügen.In
Form.pmdie Funktionparse_templatesuchen und hier die Zeile print(STDERR Dumper($self)); einfügen.Einmal per Browser die gewünschte Vorlage "benutzen", z.B. ein PDF für eine Rechnung erzeugen.
Im
error.logApache steht die Ausgabe der Variablen$selfin der Form'key' => 'value',. Allekeys sind verfügbar.
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:
NOFORMATgilt 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.NOESCAPEunterdrü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%>
In der Admininstration können Drucker definiert werden. Auch im
dort eingebbaren Druckbefehl können die hier aufgelisteten Variablen
und Kontrollstrukturen verwendet werden. Ihr Inhalt wird dabei nach
den Regeln der gängigen Shells formatiert, sodass Sonderzeichen wie
`...` nicht zu unerwünschtem Verhalten
führen.
Dies erlaubt z.B. die Definition eines Faxes als Druckerbefehl, für das die Telefonnummer eines Ansprechpartners als Teil der Kommandozeile verwendet wird. Für ein fiktives Kommando könnte das z.B. wie folgt aussehen:
send_fax --number <%if cp_phone2%><%cp_phone2%><%else%><%cp_phone1%><%end%>
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 kivitendo dazu veranlassen, Variablen zu ersetzen,
wenn sie wie folgt aussehen: ($customer$). Das
äquivalente Beispiel für HTML-Dokumentenvorlagen sieht so aus:
<!-- config: tag-style=($ $) -->
Diese folgende kurze Auflistung zeigt, welche Vorlage bei
welcher Funktion ausgelesen wird. Dabei ist die Dateiendung
".ext" geeignet zu ersetzen:
".tex" für LaTeX-Vorlagen und
".odt" für OpenDocument-Vorlagen.
-
bin_list.ext Lagerliste
-
check.ext ?
-
invoice.ext Rechnung
-
packing_list.ext Packliste
-
pick_list.ext Sammelliste
-
purchase_delivery_order.ext Lieferschein (Einkauf)
-
purcharse_order.ext Bestellung an Lieferanten
-
request_quotation.ext Anfrage an Lieferanten
-
sales_delivery_order.ext Lieferschein (Verkauf)
-
sales_order.ext Bestellung
-
sales_quotation.ext Angebot an Kunden
-
zahlungserinnerung.ext Mahnung (Dateiname im Programm konfigurierbar)
-
zahlungserinnerung_invoice.ext Rechnung über Mahngebühren (Dateiname im Programm konfigurierbar)
Angeforderte Sprache und Druckerkürzel in den Dateinamen mit
eingearbeitet. So wird aus der Vorlage
sales_order.ext bei Sprache
de und Druckerkürzel lpr2
der Vorlagenname sales_order_de_lpr2.ext.
Zusätzlich können für E-Mails andere Vorlagen erstellt werden, diese
bekommen dann noch das Kürzel _email, der
vollständige Vorlagenname wäre dann
sales_order_email_de_lpr2.ext. In allen Fällen
kann eine Standarddatei default.ext hinterlegt
werden. Diese wird verwendet, wenn keine der anderen Varianten
gefunden wird.
Die vollständige Suchreihenfolge für einen Verkaufsauftrag mit der Sprache "de" und dem Drucker "lpr2", der per E-Mail im Format PDF verschickt wird, ist:
sales_order_email_de_lpr2.texsales_order_de_lpr2.texsales_order.texdefault.tex
Die kurzen Varianten dieser Vorlagentitel müssen dann entweder Standardwerte anzeigen, oder die angeforderten Werte selbst auswerten, siehe dazu Metainformationen zur angeforderten Vorlage.
Diese Variablen liefern Informationen darüber welche Variante einer Vorlage der Benutzer angefragt hat. Sie sind nützlich für Vorlagenautoren, die aus einer zentralen Layoutvorlage die einzelnen Formulare einbinden möchten.
-
template_meta.formname Basisname der Vorlage. Identisch mit der Zurordnung zu den Dateinamen ohne die Erweiterung. Ein Verkaufsauftrag enthält hier
sales_order.-
template_meta.language.description Beschreibung der verwendeten Sprache
-
template_meta.language.template_code 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 interessant für Vorlagen die mit unformatierten Werten arbeiten.-
template_meta.language.output_dateformat Datumsformat der verwendeten Sprache in der Form "
dd.mm.yyyy". Experimentell! Nur interessant für Vorlagen die mit unformatierten Werten arbeiten.-
template_meta.format Das angeforderte Format. Kann im Moment die Werte
pdf,postscript,html,opendocument,opendocument_pdfundexcelenthalten.-
template_meta.extension Dateierweiterung, wie im Dateinamen. Wird aus
formatentschieden.-
template_meta.media Ausgabemedium. Kann zur Zeit die Werte
screenfür Bildschirm,emailfür E-Mail (triggert das_emailKürzel im Dateinamen),printerfür Drucker, undqueuefür Warteschlange enthalten.-
template_meta.printer.description Beschreibung des ausgewählten Druckers
-
template_meta.printer.template_code Vorlagenürzel des ausgewählten Druckers, identisch mit dem Kürzel das im Dateinamen verwendetet wird.
-
template_meta.tmpfile Datei-Prefix für temporäre Dateien.
-
account_number Kontonummer
-
bank Name der Bank
-
bank_code Bankleitzahl
-
bic Bank-Identifikations-Code (Bank Identifier Code, BIC)
-
business Kunden-/Lieferantentyp
-
city Stadt
-
contact Kontakt
-
country Land
-
c_vendor_id Lieferantennummer beim Kunden (nur Kunden)
-
v_customer_id Kundennummer beim Lieferanten (nur Lieferanten)
-
cp_email Email des Ansprechpartners
-
cp_givenname Vorname des Ansprechpartners
-
cp_greeting Anrede des Ansprechpartners
-
cp_name Name des Ansprechpartners
-
cp_phone1 Telefonnummer 1 des Ansprechpartners
-
cp_phone2 Telefonnummer 2 des Ansprechpartners
-
cp_title Titel des Ansprechpartners
-
creditlimit Kreditlimit
-
customeremail Email des Kunden; nur für Kunden
-
customerfax Faxnummer des Kunden; nur für Kunden
-
customernotes Bemerkungen beim Kunden; nur für Kunden
-
customernumber Kundennummer; nur für Kunden
-
customerphone Telefonnummer des Kunden; nur für Kunden
-
discount Rabatt
-
email Emailadresse
-
fax Faxnummer
-
gln GLN (Globale Lokationsnummer)
-
greeting Anrede
-
homepage Homepage
-
iban Internationale Kontonummer (International Bank Account Number, IBAN)
-
language Sprache
-
name Firmenname
-
natural_person Flag "natürliche Person"; Siehe auch Hinweise zur Anrede
-
payment_description Name der Zahlart
-
payment_terms Zahlungskonditionen
-
phone Telefonnummer
-
shiptocity Stadt (Lieferadresse) *
-
shiptocontact Kontakt (Lieferadresse) *
-
shiptocountry Land (Lieferadresse) *
-
shiptodepartment_1 Abteilung 1 (Lieferadresse) *
-
shiptodepartment_2 Abteilung 2 (Lieferadresse) *
-
shiptoemail Email (Lieferadresse) *
-
shiptofax Fax (Lieferadresse) *
-
shiptogln GLN (Globale Lokationsnummer) (Lieferadresse) *
-
shiptoname Firmenname (Lieferadresse) *
-
shiptophone Telefonnummer (Lieferadresse) *
-
shiptostreet Straße und Hausnummer (Lieferadresse) *
-
shiptozipcode Postleitzahl (Lieferadresse) *
-
street Straße und Hausnummer
-
taxnumber Steuernummer
-
ustid Umsatzsteuer-Identifikationsnummer
-
vendoremail Email des Lieferanten; nur für Lieferanten
-
vendorfax Faxnummer des Lieferanten; nur für Lieferanten
-
vendornotes Bemerkungen beim Lieferanten; nur für Lieferanten
-
vendornumber Lieferantennummer; nur für Lieferanten
-
vendorphone Telefonnummer des Lieferanten; nur für Lieferanten
-
zipcode Postleitzahl
![[Anmerkung]](system/docbook-xsl/images/note.png)
-
employee_address Adressfeld
-
employee_businessnumber Firmennummer
-
employee_company Firmenname
-
employee_co_ustid Usatzsteuer-Identifikationsnummer
-
employee_duns DUNS-Nummer
-
employee_email Email
-
employee_fax Fax
-
employee_name voller Name
-
employee_signature Signatur
-
employee_taxnumber Steuernummer
-
employee_tel Telefonnummer
-
salesman_address Adressfeld
-
salesman_businessnumber Firmennummer
-
salesman_company Firmenname
-
salesman_co_ustid Usatzsteuer-Identifikationsnummer
-
salesman_duns DUNS-Nummer
-
salesman_email Email
-
salesman_fax Fax
-
salesman_name voller Name
-
salesman_signature Signatur
-
salesman_taxnumber Steuernummer
-
salesman_tel Telefonnummer
-
tax Steuer
-
taxbase zu versteuernder Betrag
-
taxdescription Name der Steuer
-
taxrate Steuersatz
-
creditremaining Verbleibender Kredit
-
currency Währung
-
cusordnumber Bestellnummer beim Kunden
-
deliverydate Lieferdatum
-
duedate Fälligkeitsdatum
-
globalprojectnumber Projektnummer des ganzen Beleges
-
globalprojectdescription Projekbeschreibung des ganzen Beleges
-
intnotes Interne Bemerkungen
-
invdate Rechnungsdatum
-
invnumber Rechnungsnummer
-
invtotal gesamter Rechnungsbetrag
-
notes Bemerkungen der Rechnung
-
orddate Auftragsdatum
-
ordnumber Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde
-
payment_description Name der Zahlart
-
payment_terms Zahlungskonditionen
-
quodate Angebotsdatum
-
quonumber Angebotsnummer
-
rounding Betrag, um den
invtotalgerundet wurde (kann positiv oder negativ sein)-
shippingpoint Versandort
-
shipvia Transportmittel
-
subtotal Zwischensumme aller Posten ohne Steuern
-
total Restsumme der Rechnung (Summe abzüglich bereits bezahlter Posten)
-
transaction_description Vorgangsbezeichnung
-
transdate Auftragsdatum wenn die Rechnung aus einem Auftrag erstellt wurde
-
bin Stellage
-
description Artikelbeschreibung
-
cusordnumber_oe 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.
-
drawing Zeichnung
-
ean EAN-Code
-
image Grafik
-
linetotal Zeilensumme (Anzahl * Einzelpreis)
-
longdescription Langtext, vorbelegt mit dem Feld Bemerkungen der entsprechenden Ware
-
microfiche Mikrofilm
-
netprice Alternative zu
sellprice, abernetpriceentspricht dem effektiven Einzelpreis und beinhaltet Zeilenrabatt und Preisfaktor.netpricewird 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.netpricehat nichts mit Netto/Brutto im Sinne von Steuern zu tun.-
nodiscount_linetotal Zeilensumme ohne Rabatt
-
nodiscount_sub Zwischensumme ohne Rabatt
-
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.
-
p_discount Rabatt in Prozent
-
partnotes Die beim Artikel gespeicherten Bemerkungen
-
partsgroup Warengruppe
-
price_factor Der Preisfaktor als Zahl, sofern einer eingestellt ist
-
price_factor_name Der Name des Preisfaktors, sofern einer eingestellt ist
-
projectnumber Projektnummer
-
projectdescription Projektbeschreibung
-
qty Anzahl
-
reqdate Lieferdatum
-
runningnumber Position auf der Rechnung (1, 2, 3...)
-
sellprice Verkaufspreis
-
serialnumber Seriennummer
-
tax_rate Steuersatz
-
transdate_do 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.
-
transdate_quo Datum des Angebots, wenn die Position im Rahmen des Workflows aus einem Angebot stammte.
-
unit Einheit
-
weight Gewicht
Für jeden Posten gibt es ein Unterarray mit den Informationen
über Lieferanten und Lieferantenartikelnummer. Diese müssen mit
einer foreach-Schleife ausgegeben werden, da
für jeden Artikel mehrere Lieferanteninformationen hinterlegt sein
können. Die Variablen dafür lauten:
-
make Lieferant
-
model Lieferantenartikelnummer
-
payment Betrag
-
paymentaccount Konto
-
paymentdate Datum
-
paymentmemo Memo
-
paymentsource Beleg
Die vom Benutzer definierten Variablen für Kunden und
Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen
ebenfalls zur Verfügung. Ihre Namen setzen sich aus dem Präfix
vc_cvar_ und dem vom Benutzer festgelegten
Variablennamen zusammen.
Beispiel: Der Benutzer hat eine Variable namens
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 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 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 Fälligkeitsdatum für diese Mahhnung
-
dunning_id Mahnungsnummer
-
fee Kumulative 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
-
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
-
dn_curr Währung, in der die Rechnung erstellt wurde. (Die Rechnungsbeträge sind aber immer in der Hauptwährung)
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:
-
duedate Fälligkeitsdatum der Rechnung
-
dunning_id Mahnungsnummer
-
fee Mahngebühren
-
interest Zinsen
-
invamount Rechnungssumme (ergibt sich aus
fee+interest)-
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:
quodate für Angebotsdatum etc. Bei Bestellungen
wiederum fangen sie mit ord für "order" an:
ordnumber für Bestellnummer etc.
Manche Variablen sind in anderen Vorlagen hingegen gar nicht vorhanden wie z.B. die für bereits verbuchte Zahlungseingänge. Dies sind Variablen, die vom Geschäftsablauf her in der entsprechenden Vorlage keine Bedeutung haben oder noch nicht belegt sein können.
Im Folgenden werden nur wichtige Unterschiede zu den Variablen in Rechnungen aufgeführt.
-
quonumber Angebots- bzw. Anfragenummer
-
reqdate Gültigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei Preisanfragen)
-
transdate Angebots- bzw. Anfragedatum
-
ordnumber Auftragsnummer
-
reqdate Lieferdatum
-
transdate Auftragsdatum
-
cusordnumber Bestellnummer des Kunden (im Verkauf) bzw. Bestellnummer des Lieferanten (im Einkauf)
-
donumber Lieferscheinnummer
-
transdate Lieferscheindatum
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:
-
si_bin Lagerplatz
-
si_chargenumber Chargennummer
-
si_bestbefore Mindesthaltbarkeit
-
si_number Artikelnummer
-
si_qty Anzahl bzw. Menge
-
si_runningnumber Positionsnummer (1, 2, 3 etc)
-
si_unit Einheit
-
si_warehouse Lager
-
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
Variablen für jede Rechnungsposition in Sammelrechnung:
-
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%> ... <%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 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.
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%> € <%end foreach%> <%end if%>
Die Bedingung kann auch negiert werden, indem das Wort
not nach dem if verwendet
wird. Beispiel:
<%if not cp_greeting%> ... <%end%>
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. Mittel
!= 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 variablenname%> ... <%end%>
Fügt die Zeilen zwischen den beiden Anweisungen so oft ein,
wie das Perl-Array der Variablen variablenname
Elemente enthät. Dieses Konstrukt wird zur Ausgabe der einzelnen
Posten einer Rechnung / eines Angebots sowie zur Ausgabe der Steuern
benutzt. In jedem Durchlauf werden die zeilenbezogenen
Variablen jeweils auf den Wert für die aktuelle Position
gesetzt.
Die Syntax sieht normalerweise wie folgt aus:
<%foreach number%> Position: <%runningnumber%> Anzahl: <%qty%> Artikelnummer: <%number%> Beschreibung: <%description%> ... <%end%>
Besonderheit in OpenDocument-Vorlagen: Tritt ein
<%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%> wiederholt, nicht aber die
komplette Zeile, in der er steht.
Wenn der Benutzer innhalb von Formularen in kivitendo Text anders formatiert haben möchte, so ist dies begrenzt möglich. kivitendo unterstützt die Textformatierung mit HTML-ähnlichen Tags. Der Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung Teile des Texts zwischen Start- und Endtags setzen. Dieser Teil wird dann automatisch in Anweisungen für das ausgewählte Vorlagenformat (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%>