3.2. Dokumentenvorlagen und verfügbare Variablen

3.2. Dokumentenvorlagen und verfügbare Variablen
Zurück	Kapitel 3. Features und Funktionen	Weiter

3.2.1. Einführung

Dies ist eine Auflistung der Standard-Dokumentenvorlagen und - aller zur Bearbeitung verfügbaren Variablen. Eine Variable wird in + + 3.2. Dokumentenvorlagen und verfÃ¼gbare Variablen

3.2. Dokumentenvorlagen und verfÃ¼gbare Variablen
ZurÃ¼ck	Kapitel 3. Features und Funktionen	Weiter

3.2. Dokumentenvorlagen und verfÃ¼gbare Variablen

3.2.1. EinfÃ¼hrung

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 Lx-Office aber auch OpenDocument-Vorlagen. Sofern es nicht - ausdrücklich eingeschränkt wird, gilt das im Folgenden gesagte für + <%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 - verfügbar als hier aufgelistet werden. Die meisten davon können + 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.pm die Funktion + SL/Form.pm Ã¶ffnen und am Anfang die + Zeile "use Data::Dumper;" einfÃ¼gen.
In Form.pm die Funktion parse_template suchen 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.log Apache steht die Ausgabe + 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.log Apache steht die Ausgabe der Variablen $self in der Form 'key' => 'value',. Alle keys sind - verfügbar.

3.2.2. Variablen ausgeben

Um eine Variable auszugeben, müssen sie einfach nur zwischen die + verfÃ¼gbar.

3.2.2. Variablen ausgeben

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:

- NOFORMAT gilt nur für Zahlenwerte und gibt + werden die folgenden Flags unterstÃ¼tzt:
- + NOFORMAT gilt 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 + mit einem Punkt als Dezimaltrennzeichen aus. NÃ¼tzlich z.B., wenn damit in der Vorlage z.B. von LaTeX gerechnet werden soll.
- - NOESCAPE unterdrü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%>
```

3.2.3. Verwendung in Druckbefehlen

In der Admininstration können Drucker definiert werden. Auch im - dort eingebbaren Druckbefehl können die hier aufgelisteten Variablen + NOESCAPE unterdrÃ¼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%>

3.2.3. Verwendung in Druckbefehlen

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

3.2.4. Anfang und Ende der Tags verändern

Der Standardstil für Tags sieht vor, dass ein Tag mit dem + 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%>

3.2.4. Anfang und Ende der Tags verÃ¤ndern

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 + 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 + 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 + 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, + 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=($ $) -->

3.2.5. Zuordnung von den Dateinamen zu den Funktionen

Diese folgende kurze Auflistung zeigt, welche Vorlage bei + Ã¤quivalente Beispiel fÃ¼r HTML-Dokumentenvorlagen sieht so aus:

<!-- config: tag-style=($ $) -->

3.2.5. Zuordnung von den Dateinamen zu den Funktionen

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.

+ ".tex" fÃ¼r LaTeX-Vorlagen und + ".odt" fÃ¼r OpenDocument-Vorlagen. bin_list.ext Lagerliste check.ext @@ -84,19 +84,19 @@ zahlungserinnerung.ext Mahnung (Dateiname im Programm konfigurierbar) zahlungserinnerung_invoice.ext - Rechnung über Mahngebühren (Dateiname im Programm - konfigurierbar)

3.2.6. Sprache, Drucker und E-Mail

Angeforderte Sprache und Druckerkürzel in den Dateinamen mit +

Rechnung Ã¼ber MahngebÃ¼hren (Dateiname im Programm + konfigurierbar)

3.2.6. Sprache, Drucker und E-Mail

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 + 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 + 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 + 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.tex @@ -106,32 +106,32 @@ sales_order.tex
default.tex -

Die kurzen Varianten dieser Vorlagentitel müssen dann entweder +

Die kurzen Varianten dieser Vorlagentitel mÃ¼ssen dann entweder Standardwerte anzeigen, oder die angeforderten Werte selbst auswerten, siehe dazu Metainformationen zur angeforderten Vorlage.

3.2.7. Allgemeine Variablen, die in allen Vorlagen vorhanden - sind

3.2.7.1. Metainformationen zur angeforderten Vorlage

Diese Variablen liefern Informationen darüber welche Variante - einer Vorlage der Benutzer angefragt hat. Sie sind nützlich für + sind

3.2.7.1. 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.

+ 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 + Verkaufsauftrag enthÃ¤lt hier sales_order. 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. + VorlagenÃ¼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 + 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 + interessant fÃ¼r Vorlagen die mit unformatierten Werten arbeiten. template_meta.format Das angeforderte Format. Kann im Moment die Werte @@ -144,16 +144,18 @@ format entschieden. template_meta.media Ausgabemedium. Kann zur Zeit die Werte - screen für Bildschirm, - email für E-Mmail (triggert das - _email Kürzel im Dateinamen), - printer für Drucker, und - queue für Warteschlange enthalten. + screen fÃ¼r Bildschirm, + email fÃ¼r E-Mmail (triggert das + _email KÃ¼rzel im Dateinamen), + printer fÃ¼r Drucker, und + queue fÃ¼r Warteschlange enthalten. template_meta.printer.description - Beschreibung des ausgewählten Druckers + 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.

3.2.7.2. Stammdaten von Kunden und Lieferanten

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

3.2.7.2. Stammdaten von Kunden und Lieferanten

account_number: Kontonummer
bank @@ -188,15 +190,15 @@ creditlimit: Kreditlimit
customeremail -: Email des Kunden; nur für Kunden
+: Email des Kunden; nur fÃ¼r Kunden
customerfax -: Faxnummer des Kunden; nur für Kunden
+: Faxnummer des Kunden; nur fÃ¼r Kunden
customernotes -: Bemerkungen beim Kunden; nur für Kunden
+: Bemerkungen beim Kunden; nur fÃ¼r Kunden
customernumber -: Kundennummer; nur für Kunden
+: Kundennummer; nur fÃ¼r Kunden
customerphone -: Telefonnummer des Kunden; nur für Kunden
+: Telefonnummer des Kunden; nur fÃ¼r Kunden
discount: Rabatt
email @@ -246,37 +248,37 @@: Telefonnummer (Lieferadresse) *
shiptostreet -: Straße und Hausnummer (Lieferadresse) * +; StraÃe und Hausnummer (Lieferadresse) *
shiptozipcode: Postleitzahl (Lieferadresse) *
street -: Straße und Hausnummer
+: StraÃe und Hausnummer
taxnumber: Steuernummer
ustid: Umsatzsteuer-Identifikationsnummer
vendoremail -: Email des Lieferanten; nur für Lieferanten
+: Email des Lieferanten; nur fÃ¼r Lieferanten
vendorfax -: Faxnummer des Lieferanten; nur für Lieferanten
+: Faxnummer des Lieferanten; nur fÃ¼r Lieferanten
vendornotes -: Bemerkungen beim Lieferanten; nur für Lieferanten
+: Bemerkungen beim Lieferanten; nur fÃ¼r Lieferanten
vendornumber -: Lieferantennummer; nur für Lieferanten
+: Lieferantennummer; nur fÃ¼r Lieferanten
vendorphone -: Telefonnummer des Lieferanten; nur für +; Telefonnummer des Lieferanten; nur fÃ¼r Lieferanten
zipcode -: Postleitzahl

Anmerkung

Anmerkung: Sind die shipto*-Felder in den +

Postleitzahl

	Anmerkung
	Anmerkung: Sind die `shipto`-Felder in den Stammdaten nicht eingetragen, so haben die Variablen `shipto` den gleichen Wert wie die die entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich einige `shipto*`-Variablen so nicht in den Stammdaten wiederfinden sondern schlicht Kopien der Lieferdatenvariablen sind (z.B. - `shiptocontact`).

3.2.7.3. Informationen über den Bearbeiter

+ shiptocontact).

3.2.7.3. Informationen Ã¼ber den Bearbeiter

employee_address: Adressfeld
employee_businessnumber @@ -298,7 +300,7 @@ employee_taxnumber: Steuernummer
employee_tel -: Telefonnummer

3.2.7.4. Informationen über den Bearbeiter

+: Telefonnummer

3.2.7.4. Informationen Ã¼ber den Bearbeiter

salesman_address: Adressfeld
salesman_businessnumber @@ -320,7 +322,7 @@ salesman_taxnumber: Steuernummer
salesman_tel -: Telefonnummer

3.2.7.5. Variablen für die einzelnen Steuern

+: Telefonnummer

3.2.7.5. Variablen fÃ¼r die einzelnen Steuern

tax: Steuer
taxbase @@ -332,13 +334,13 @@ creditremaining: Verbleibender Kredit
currency -: Währung
+: WÃ¤hrung
cusordnumber: Bestellnummer beim Kunden
deliverydate: Lieferdatum
duedate -: Fälligkeitsdatum
+: FÃ¤lligkeitsdatum
globalprojectnumber: Projektnummer des ganzen Beleges
globalprojectdescription @@ -373,13 +375,13 @@ subtotal: Zwischensumme aller Posten ohne Steuern
total -: Restsumme der Rechnung (Summe abzüglich bereits +; Restsumme der Rechnung (Summe abzÃ¼glich bereits bezahlter Posten)
transaction_description: Vorgangsbezeichnung
transdate: Auftragsdatum wenn die Rechnung aus einem Auftrag - erstellt wurde

3.2.8.2. Variablen für jeden Posten auf der Rechnung

+ erstellt wurde

3.2.8.2. Variablen fÃ¼r jeden Posten auf der Rechnung

bin: Stellage
description @@ -445,15 +447,15 @@ unit: Einheit
weight -: Gewicht

Für jeden Posten gibt es ein Unterarray mit den Informationen - über Lieferanten und Lieferantenartikelnummer. Diese müssen mit +

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:

+ fÃ¼r jeden Artikel mehrere Lieferanteninformationen hinterlegt sein + kÃ¶nnen. Die Variablen dafÃ¼r lauten: make Lieferant model - Lieferantenartikelnummer

3.2.8.3. Variablen für die einzelnen Zahlungseingänge

+: Lieferantenartikelnummer

3.2.8.3. Variablen fÃ¼r die einzelnen ZahlungseingÃ¤nge

payment: Betrag
paymentaccount @@ -463,36 +465,36 @@ paymentmemo: Memo
paymentsource -: Beleg

3.2.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen

Die vom Benutzer definierten Variablen für Kunden und +

Beleg

3.2.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen

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 + 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 + Mitarbeiter des Unternehmens enthÃ¤lt. Diese Variable steht dann unter dem Namen vc_cvar_number_of_employees zur - Verfügung.

3.2.9. Variablen in Mahnungen und Rechnungen Ã¼ber MahngebÃ¼hren

3.2.9.1. Namen der Vorlagen

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.

3.2.9.2. Allgemeine Variablen in Mahnungen

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:

+ und email zur VerfÃ¼gung. Weitere Variablen beinhalten: dunning_date Datum der Mahnung dunning_duedate - Fälligkeitsdatum für diese Mahhnung + FÃ¤lligkeitsdatum fÃ¼r diese Mahhnung dunning_id Mahnungsnummer fee - Kummulative Mahngebühren + Kummulative MahngebÃ¼hren interest_rate Zinssatz per anno in Prozent total_amount @@ -501,21 +503,21 @@ + total_open_amount total_interest - Zinsen per anno über alle Rechnungen + Zinsen per anno Ã¼ber alle Rechnungen total_open_amount - Summe über alle offene Beträge der Rechnungen

3.2.9.3. Variablen für jede gemahnte Rechnung in einer Mahnung

+: Summe Ã¼ber alle offene BetrÃ¤ge der Rechnungen

3.2.9.3. Variablen fÃ¼r jede gemahnte Rechnung in einer Mahnung

dn_amount: Rechnungssumme (brutto)
dn_duedate -: Originales Fälligkeitsdatum der Rechnung
+: Originales FÃ¤lligkeitsdatum der Rechnung
dn_dunning_date: Datum der Mahnung
dn_dunning_duedate -: Fälligkeitsdatum der Mahnung
+: FÃ¤lligkeitsdatum der Mahnung
dn_fee -: Kummulative Mahngebühr
+: Kummulative MahngebÃ¼hr
dn_interest -: Zinsen per anno für diese Rechnung
+: Zinsen per anno fÃ¼r diese Rechnung
dn_invnumber: Rechnungsnummer
dn_linetotal @@ -531,21 +533,21 @@ dn_transdate: Rechnungsdatum
dn_curr -: Währung, in der die Rechnung erstellt wurde. (Die - Rechnungsbeträge sind aber immer in der Hauptwährung)

3.2.9.4. Variablen in automatisch erzeugten Rechnungen über - Mahngebühren

Die Variablen des Verkäufers stehen wie gewohnt als - employee_... zur Verfügung. Die Adressdaten des +

WÃ¤hrung, in der die Rechnung erstellt wurde. (Die + RechnungsbetrÃ¤ge sind aber immer in der HauptwÃ¤hrung)

3.2.9.4. Variablen in automatisch erzeugten Rechnungen Ã¼ber + MahngebÃ¼hren

Weitere Variablen beinhalten:

+ und email zur VerfÃ¼gung. Weitere Variablen beinhalten: duedate - Fälligkeitsdatum der Rechnung + FÃ¤lligkeitsdatum der Rechnung dunning_id Mahnungsnummer fee - Mahngebühren + MahngebÃ¼hren interest Zinsen invamount @@ -554,25 +556,25 @@ invdate Rechnungsdatum invnumber - Rechnungsnummer

3.2.10. Variablen in anderen Vorlagen

3.2.10.1. Einführung

Die Variablen in anderen Vorlagen sind ähnlich wie in der - Rechnung. Allerdings heißen die Variablen, die mit +

Rechnungsnummer

3.2.10. Variablen in anderen Vorlagen

3.2.10.1. EinfÃ¼hrung

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

3.2.10.2. Angebote und Preisanfragen

+ kÃ¶nnen. Im Folgenden werden nur wichtige Unterschiede zu den Variablen + in Rechnungen aufgefÃ¼hrt.

3.2.10.2. Angebote und Preisanfragen

quonumber: Angebots- bzw. Anfragenummer
reqdate -: Gültigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei +; GÃ¼ltigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei Preisanfragen)
transdate -: Angebots- bzw. Anfragedatum

3.2.10.3. Auftragsbestätigungen und Lieferantenaufträge

+: Angebots- bzw. Anfragedatum

3.2.10.3. AuftragsbestÃ¤tigungen und LieferantenauftrÃ¤ge

ordnumber: Auftragsnummer
reqdate @@ -585,10 +587,10 @@ 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 +

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 + Lagerplatz sie eingelagert wurden. Diese mÃ¼ssen mittels einer foreach-Schleife ausgegeben werden. Diese Variablen sind:

si_bin @@ -606,90 +608,98 @@ si_unit: Einheit
si_warehouse -: Lager

3.2.10.5. Variablen für Sammelrechnung

+: Lager

3.2.10.5. Variablen fÃ¼r Sammelrechnung

c0total -: Gesamtbetrag aller Rechnungen mit Fälligkeit < 30 +; Gesamtbetrag aller Rechnungen mit FÃ¤lligkeit < 30 Tage
c30total -: Gesamtbetrag aller Rechnungen mit Fälligkeit >= 30 +; Gesamtbetrag aller Rechnungen mit FÃ¤lligkeit >= 30 und < 60 Tage
c60total -: Gesamtbetrag aller Rechnungen mit Fälligkeit >= 60 +; Gesamtbetrag aller Rechnungen mit FÃ¤lligkeit >= 60 und < 90 Tage
c90total -: Gesamtbetrag aller Rechnungen mit Fälligkeit >= 90 +; Gesamtbetrag aller Rechnungen mit FÃ¤lligkeit >= 90 Tage
total -: Gesamtbetrag aller Rechnungen

Variablen für jede Rechnungsposition in Sammelrechnung:

+: Gesamtbetrag aller Rechnungen

Variablen fÃ¼r jede Rechnungsposition in Sammelrechnung:

invnumber: Rechnungsnummer
invdate: Rechnungsdatum
duedate -: Fälligkeitsdatum
+: FÃ¤lligkeitsdatum
amount: Summe der Rechnung
open: Noch offener Betrag der Rechnung
c0 -: Noch offener Rechnungsbetrag mit Fälligkeit < 30 +; Noch offener Rechnungsbetrag mit FÃ¤lligkeit < 30 Tage
c30 -: Noch offener Rechnungsbetrag mit Fälligkeit >= 30 und +; Noch offener Rechnungsbetrag mit FÃ¤lligkeit >= 30 und < 60 Tage
c60 -: Noch offener Rechnungsbetrag mit Fälligkeit >= 60 und +; Noch offener Rechnungsbetrag mit FÃ¤lligkeit >= 60 und < 90 Tage
c90 -: Noch offener Rechnungsbetrag mit Fälligkeit >= 90 - Tage

3.2.11. BlÃ¶cke, bedingte Anweisungen und Schleifen

3.2.11.1. EinfÃ¼rhung

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 + 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 + <%if type == "sales_quotation"%>, so kÃ¶nnte er mit <%end%> genauso abgeschlossen werden wie mit <%end if%> oder auch <%end type == "sales_quotation"%>.

3.2.11.2. Der 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.

Die Bedingung kann auch negiert werden, indem das Wort + 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 +<%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 + 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. + Ã¼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 + 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 + !~ als Vergleichsoperatoren.

Beispiel fÃ¼r einen Test, ob die Variable intnotes (interne Bemerkungen) das Wort - schwierig enthält:

<%if intnotes =~ "schwierig"%>

3.2.11.3. Der foreach-Block

<%foreach variablenname%>
+          schwierig enthÃ¤lt:
<%if intnotes =~ "schwierig"%>

3.2.11.3. Der foreach-Block

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

Fügt die Zeilen zwischen den beiden Anweisungen so oft ein, +<%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 + 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 + 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%>
@@ -699,17 +709,17 @@ 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 + 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.

Zurück	Nach oben	Weiter
Kapitel 3. Features und Funktionen	Zum Anfang	3.3. Excel-Vorlagen