Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision cb484787

Von Kivitendo Admin vor mehr als 9 Jahren hinzugefügt

  • ID cb4847870dd086f46098ccd12dd03955766b2896
  • Vorgänger 73d140a8
  • Nachfolger 782686e8

Dokumentation aktualisiert (html und pdf)

Unterschiede anzeigen:

doc/html/ch03s03.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>3.3. Excel-Vorlagen</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.2.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s02.html" title="3.2. Dokumentenvorlagen und verfügbare Variablen"><link rel="next" href="ch03s04.html" title="3.4. Mandantenkonfiguration Lager"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.3. Excel-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s02.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.3. Excel-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="excel-templates"></a>3.3. Excel-Vorlagen</h2></div></div></div><div class="sect2" title="3.3.1. Zusammenfassung"><div class="titlepage"><div><div><h3 class="title"><a name="excel-templates.summary"></a>3.3.1. Zusammenfassung</h3></div></div></div><p>Dieses Dokument beschreibt den Mechanismus, mit dem
4
        Exceltemplates abgearbeitet werden, und die Einschränkungen, die damit
5
        einhergehen.</p></div><div class="sect2" title="3.3.2. Bedienung"><div class="titlepage"><div><div><h3 class="title"><a name="excel-templates.usage"></a>3.3.2. Bedienung</h3></div></div></div><p>Der Excel Mechanismus muss in der Konfigurationsdatei aktiviert
6
        werden. Die Konfigurationsoption heißt <code class="varname">excel_templates =
7
        1</code> im Abschnitt <code class="varname">[print_templates]</code>.</p><p>Eine Excelvorlage kann dann unter dem Namen einer beliebigen
8
        anderen Vorlage mit der Endung <code class="filename">.xls</code> gespeichert
9
        werden. In den normalen Verkaufsmasken taucht nun
10
        <code class="constant">Excel</code> als auswählbares Format auf und kann von da
11
        an wie LaTeX- oder OpenOffice-Vorlagen benutzt werden.</p><p>Der Sonderfall der Angebote aus der Kundenmaske ist ebenfalls
12
        eine Angebotsvorlage und wird unter dem internen Namen der Angebote
13
        <code class="filename">sales_quotation.xls</code> gespeichert.</p></div><div class="sect2" title="3.3.3. Variablensyntax"><div class="titlepage"><div><div><h3 class="title"><a name="excel-templates.syntax"></a>3.3.3. Variablensyntax</h3></div></div></div><p>Einfache Syntax:
14
        <span class="command"><strong>&lt;&lt;varname&gt;&gt;</strong></span>
15
            </p><p>Dabei sind <code class="constant">&lt;&lt;</code> und
16
        <code class="constant">&gt;&gt;</code> die Delimiter. Da Excel auf festen
17
        Breiten besteht, kann der Tag künstlich verlängert werden, indem
18
        weitere <code class="constant">&lt;</code> oder <code class="constant">&gt;</code>
19
        eingefügt werden. Der Tag muss nicht symmetrisch sein.
20
        Beispiel:</p><pre class="programlisting">&lt;&lt;&lt;&lt;&lt;varname&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;</pre><p>Um die Limitierung der festen Breite zu reduzieren, können
21
        weitere Variablen in einem Block interpoliert werden. Whitespace wird
22
        dazwishen dann erhalten. Beispiel:</p><pre class="programlisting">&lt;&lt;&lt;&lt;&lt;varname1 varname2   varname3&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;</pre><p>Die Variablen werden interpoliert, und linksbündig mit
23
        Leerzeichen auf die gewünschte Länge aufgefüllt. Ist der String zu
24
        lang, werden überzählige Zeichen abgeschnitten.</p><p>Es ist ausserdem möglich, Daten rechtsbündig darzustellen, wenn
25
        der Block mit einem Leerzeichen anfängt. Beispiel:</p><pre class="programlisting">&lt;&lt;&lt;&lt;&lt;&lt;            varname&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;</pre><p>Dies würde rechtsbündig triggern. Wenn bei rechtsbündiger
26
        Ausrichtung Text abgeschnitten werden muss, wird er vom linken Ende
27
        entfernt.</p></div><div class="sect2" title="3.3.4. Einschränkungen"><div class="titlepage"><div><div><h3 class="title"><a name="excel-templates.limitations"></a>3.3.4. Einschränkungen</h3></div></div></div><p>Das Excelformat bis 2002 ist ein binäres Format, und kann nicht
28
        mit vertretbarem Aufwand editiert werden. Der Templatemechanismus
29
        beschränkt sich daher darauf, Textstellen exakt durch einen anderen
30
        Text zu ersetzen.</p><p>Aus dem gleichen Grund sind die Kontrolllstrukturen
31
        <span class="command"><strong>&lt;%if%&gt;</strong></span> und
32
        <span class="command"><strong>&lt;%foreach%&gt;</strong></span> nicht vorhanden. Der Delimiter
33
        <code class="constant">&lt;% %&gt;</code> kommt in den Headerinformationen
34
        evtl. vor. Deshalb wurde auf den sichereren Delimiter
35
        <code class="constant">&lt;&lt;</code> und <code class="constant">&gt;&gt;</code>
36
        gewechselt.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s02.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.2. Dokumentenvorlagen und verfügbare Variablen&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;3.4. Mandantenkonfiguration Lager</td></tr></table></div></body></html>
3
   <title>3.3. Dokumentenvorlagen und verfügbare Variablen</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.3.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s02.html" title="3.2. Bankerweiterung"><link rel="next" href="ch03s04.html" title="3.4. Excel-Vorlagen"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.3. Dokumentenvorlagen und verfügbare Variablen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s02.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch03s04.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.3. Dokumentenvorlagen und verfügbare Variablen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="dokumentenvorlagen-und-variablen"></a>3.3. Dokumentenvorlagen und verfügbare Variablen</h2></div></div></div><div class="sect2" title="3.3.1. Einführung"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.einf%C3%BChrung"></a>3.3.1. Einführung</h3></div></div></div><p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und
4
        aller zur Bearbeitung verfügbaren Variablen. Eine Variable wird in
5
        einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
6
        <code class="function">&lt;%variablenname%&gt;</code> verwendet wird. Für
7
        LaTeX- und HTML-Vorlagen kann man die Form dieser Tags auch verändern
8
        (siehe <a class="xref" href="ch03s03.html#dokumentenvorlagen-und-variablen.tag-style" title="3.3.4. Anfang und Ende der Tags verändern">Anfang und Ende der Tags verändern</a>).</p><p>Früher wurde hier nur über LaTeX gesprochen. Inzwischen
9
        unterstützt kivitendo aber auch OpenDocument-Vorlagen. Sofern es nicht
10
        ausdrücklich eingeschränkt wird, gilt das im Folgenden gesagte für
11
        alle Vorlagenarten.</p><p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
12
        verfügbar als hier aufgelistet werden. Die meisten davon können
13
        allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
14
        werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann
15
        diese wie folgt erhalten werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
16
                     <code class="filename">SL/Form.pm</code> öffnen und am Anfang die
17
            Zeile "<span class="command"><strong>use Data::Dumper;</strong></span>" einfügen.</p></li><li class="listitem"><p>In <code class="filename">Form.pm</code> die Funktion
18
            <code class="function">parse_template</code> suchen und hier die Zeile
19
            <span class="command"><strong>print(STDERR Dumper($self));</strong></span> einfügen.</p></li><li class="listitem"><p>Einmal per Browser die gewünschte Vorlage "benutzen", z.B.
20
            ein PDF für eine Rechnung erzeugen.</p></li><li class="listitem"><p>Im <code class="filename">error.log</code> Apache steht die Ausgabe
21
            der Variablen <code class="varname">$self</code> in der Form <code class="varname">'key'
22
            =&gt; 'value',</code>. Alle <code class="varname">key</code>s sind
23
            verfügbar.</p></li></ul></div></div><div class="sect2" title="3.3.2. Variablen ausgeben"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.variablen-ausgeben"></a>3.3.2. Variablen ausgeben</h3></div></div></div><p>Um eine Variable auszugeben, müssen sie einfach nur zwischen die
24
        Tags geschrieben werden, also z.B.
25
        <code class="varname">&lt;%variablenname%&gt;</code>.</p><p>Optional kann man auch mit Leerzeichen getrennte Flags angeben,
26
        die man aber nur selten brauchen wird. Die Syntax sieht also so aus:
27
        <code class="varname">&lt;%variablenname FLAG1 FLAG2%&gt;</code>. Momentan
28
        werden die folgenden Flags unterstützt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
29
                     <code class="option">NOFORMAT</code> gilt nur für Zahlenwerte und gibt
30
            den Wert ohne Formatierung, also ohne Tausendertrennzeichen mit
31
            mit einem Punkt als Dezimaltrennzeichen aus. Nützlich z.B., wenn
32
            damit in der Vorlage z.B. von LaTeX gerechnet werden soll.</p></li><li class="listitem"><p>
33
                     <code class="option">NOESCAPE</code> unterdrückt das Escapen von
34
            Sonderzeichen für die Vorlagensprache. Wenn also in einer
35
            Variablen bereits gültiger LaTeX-Code steht und dieser von LaTeX
36
            auch ausgewertet und nicht wortwörtlich angezeigt werden soll, so
37
            ist dieses Flag sinnvoll.</p></li></ul></div><p>Beispiel:</p><pre class="programlisting">&lt;%quototal NOFORMAT%&gt;</pre></div><div class="sect2" title="3.3.3. Verwendung in Druckbefehlen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.verwendung-in-druckbefehlen"></a>3.3.3. Verwendung in Druckbefehlen</h3></div></div></div><p>In der Admininstration können Drucker definiert werden. Auch im
38
        dort eingebbaren Druckbefehl können die hier aufgelisteten Variablen
39
        und Kontrollstrukturen verwendet werden. Ihr Inhalt wird dabei nach
40
        den Regeln der gängigen Shells formatiert, sodass Sonderzeichen wie
41
        <code class="function">`...`</code> nicht zu unerwünschtem Verhalten
42
        führen.</p><p>Dies erlaubt z.B. die Definition eines Faxes als Druckerbefehl,
43
        für das die Telefonnummer eines Ansprechpartners als Teil der
44
        Kommandozeile verwendet wird. Für ein fiktives Kommando könnte das
45
        z.B. wie folgt aussehen:</p><pre class="programlisting">send_fax --number &lt;%if cp_phone2%&gt;&lt;%cp_phone2%&gt;&lt;%else%&gt;&lt;%cp_phone1%&gt;&lt;%end%&gt;</pre></div><div class="sect2" title="3.3.4. Anfang und Ende der Tags verändern"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.tag-style"></a>3.3.4. Anfang und Ende der Tags verändern</h3></div></div></div><p>Der Standardstil für Tags sieht vor, dass ein Tag mit dem
46
        Kleinerzeichen und einem Prozentzeichen beginnt und mit dem
47
        Prozentzeichen und dem Größerzeichen endet, beispielsweise
48
        <code class="function">&lt;%customer%&gt;</code>. Da diese Form aber z.B. in
49
        LaTeX zu Problemen führen kann, weil das Prozentzeichen dort
50
        Kommentare einleitet, kann pro HTML- oder LaTeX-Dokumentenvorlage der
51
        Stil umgestellt werden.</p><p>Dazu werden in die Datei Zeilen geschrieben, die mit dem für das
52
        Format gültigen Kommentarzeichen anfangen, dann
53
        <code class="function">config:</code> enthalten, die entsprechende Option
54
        setzen und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen
55
        enden. Beispiel für LaTeX:</p><pre class="programlisting">% config: tag-style=($ $)</pre><p>Dies würde kivitendo dazu veranlassen, Variablen zu ersetzen,
56
        wenn sie wie folgt aussehen: <code class="function">($customer$)</code>. Das
57
        äquivalente Beispiel für HTML-Dokumentenvorlagen sieht so aus:</p><pre class="programlisting">&lt;!-- config: tag-style=($ $) --&gt;</pre></div><div class="sect2" title="3.3.5. Zuordnung von den Dateinamen zu den Funktionen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.zuordnung-dateinamen"></a>3.3.5. Zuordnung von den Dateinamen zu den Funktionen</h3></div></div></div><p>Diese folgende kurze Auflistung zeigt, welche Vorlage bei
58
        welcher Funktion ausgelesen wird. Dabei ist die Dateiendung
59
        "<code class="filename">.ext</code>" geeignet zu ersetzen:
60
        "<code class="filename">.tex</code>" für LaTeX-Vorlagen und
61
        "<code class="filename">.odt</code>" für OpenDocument-Vorlagen.</p><div class="variablelist"><dl><dt><span class="term">
62
                     <code class="filename">bin_list.ext</code>
63
                  </span></dt><dd><p>Lagerliste</p></dd><dt><span class="term">
64
                     <code class="filename">check.ext</code>
65
                  </span></dt><dd><p>?</p></dd><dt><span class="term">
66
                     <code class="filename">invoice.ext</code>
67
                  </span></dt><dd><p>Rechnung</p></dd><dt><span class="term">
68
                     <code class="filename">packing_list.ext</code>
69
                  </span></dt><dd><p>Packliste</p></dd><dt><span class="term">
70
                     <code class="filename">pick_list.ext</code>
71
                  </span></dt><dd><p>Sammelliste</p></dd><dt><span class="term">
72
                     <code class="filename">purchase_delivery_order.ext</code>
73
                  </span></dt><dd><p>Lieferschein (Einkauf)</p></dd><dt><span class="term">
74
                     <code class="filename">purcharse_order.ext</code>
75
                  </span></dt><dd><p>Bestellung an Lieferanten</p></dd><dt><span class="term">
76
                     <code class="filename">request_quotation.ext</code>
77
                  </span></dt><dd><p>Anfrage an Lieferanten</p></dd><dt><span class="term">
78
                     <code class="filename">sales_delivery_order.ext</code>
79
                  </span></dt><dd><p>Lieferschein (Verkauf)</p></dd><dt><span class="term">
80
                     <code class="filename">sales_order.ext</code>
81
                  </span></dt><dd><p>Bestellung</p></dd><dt><span class="term">
82
                     <code class="filename">sales_quotation.ext</code>
83
                  </span></dt><dd><p>Angebot an Kunden</p></dd><dt><span class="term">
84
                     <code class="filename">zahlungserinnerung.ext</code>
85
                  </span></dt><dd><p>Mahnung (Dateiname im Programm konfigurierbar)</p></dd><dt><span class="term">
86
                     <code class="filename">zahlungserinnerung_invoice.ext</code>
87
                  </span></dt><dd><p>Rechnung über Mahngebühren (Dateiname im Programm
88
              konfigurierbar)</p></dd></dl></div></div><div class="sect2" title="3.3.6. Sprache, Drucker und E-Mail"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dateinamen-erweitert"></a>3.3.6. Sprache, Drucker und E-Mail</h3></div></div></div><p>Angeforderte Sprache und Druckerkürzel in den Dateinamen mit
89
        eingearbeitet. So wird aus der Vorlage
90
        <code class="filename">sales_order.ext</code> bei Sprache
91
        <code class="function">de</code> und Druckerkürzel <code class="function">lpr2</code>
92
        der Vorlagenname <code class="filename">sales_order_de_lpr2.ext</code>.
93
        Zusätzlich können für E-Mails andere Vorlagen erstellt werden, diese
94
        bekommen dann noch das Kürzel <code class="filename">_email</code>, der
95
        vollständige Vorlagenname wäre dann
96
        <code class="filename">sales_order_email_de_lpr2.ext</code>. In allen Fällen
97
        kann eine Standarddatei <code class="filename">default.ext</code> hinterlegt
98
        werden. Diese wird verwendet, wenn keine der anderen Varianten
99
        gefunden wird.</p><p>Die vollständige Suchreihenfolge für einen Verkaufsauftrag mit
100
        der Sprache "de" und dem Drucker "lpr2", der per E-Mail im Format PDF
101
        verschickt wird, ist:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
102
                     <code class="filename">sales_order_email_de_lpr2.tex</code>
103
                  </p></li><li class="listitem"><p>
104
                     <code class="filename">sales_order_de_lpr2.tex</code>
105
                  </p></li><li class="listitem"><p>
106
                     <code class="filename">sales_order.tex</code>
107
                  </p></li><li class="listitem"><p>
108
                     <code class="filename">default.tex</code>
109
                  </p></li></ol></div><p>Die kurzen Varianten dieser Vorlagentitel müssen dann entweder
110
        Standardwerte anzeigen, oder die angeforderten Werte selbst auswerten,
111
        siehe dazu <a class="xref" href="ch03s03.html#dokumentenvorlagen-und-variablen.allgemeine-variablen.meta" title="3.3.7.1. Metainformationen zur angeforderten Vorlage">Metainformationen zur angeforderten Vorlage</a>.</p></div><div class="sect2" title="3.3.7. Allgemeine Variablen, die in allen Vorlagen vorhanden sind"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen"></a>3.3.7. Allgemeine Variablen, die in allen Vorlagen vorhanden
112
        sind</h3></div></div></div><div class="sect3" title="3.3.7.1. Metainformationen zur angeforderten Vorlage"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen.meta"></a>3.3.7.1. Metainformationen zur angeforderten Vorlage</h4></div></div></div><p>Diese Variablen liefern Informationen darüber welche Variante
113
          einer Vorlage der Benutzer angefragt hat. Sie sind nützlich für
114
          Vorlagenautoren, die aus einer zentralen Layoutvorlage die einzelnen
115
          Formulare einbinden möchten.</p><div class="variablelist"><dl><dt><span class="term">
116
                        <code class="varname">template_meta.formname</code>
117
                     </span></dt><dd><p>Basisname der Vorlage. Identisch mit der <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.zuordnung-dateinamen" title="3.3.5. Zuordnung von den Dateinamen zu den Funktionen">Zurordnung
118
                zu den Dateinamen</a> ohne die Erweiterung. Ein
119
                Verkaufsauftrag enthält hier
120
                <code class="constant">sales_order</code>.</p></dd><dt><span class="term">
121
                        <code class="varname">template_meta.language.description</code>
122
                     </span></dt><dd><p>Beschreibung der verwendeten Sprache</p></dd><dt><span class="term">
123
                        <code class="varname">template_meta.language.template_code</code>
124
                     </span></dt><dd><p>Vorlagenürzel der verwendeten Sprache, identisch mit dem
125
                Kürzel das im Dateinamen verwendetet wird.</p></dd><dt><span class="term">
126
                        <code class="varname">template_meta.language.output_numberformat</code>
127
                     </span></dt><dd><p>Zahlenformat der verwendeten Sprache in der Form
128
                "<code class="constant">1.000,00</code>". Experimentell! Nur
129
                interessant für Vorlagen die mit unformatierten Werten
130
                arbeiten.</p></dd><dt><span class="term">
131
                        <code class="varname">template_meta.language.output_dateformat</code>
132
                     </span></dt><dd><p>Datumsformat der verwendeten Sprache in der Form
133
                "<code class="constant">dd.mm.yyyy</code>". Experimentell! Nur
134
                interessant für Vorlagen die mit unformatierten Werten
135
                arbeiten.</p></dd><dt><span class="term">
136
                        <code class="varname">template_meta.format</code>
137
                     </span></dt><dd><p>Das angeforderte Format. Kann im Moment die Werte
138
                <code class="constant">pdf</code>, <code class="constant">postscript</code>,
139
                <code class="constant">html</code>, <code class="constant">opendocument</code>,
140
                <code class="constant">opendocument_pdf</code> und
141
                <code class="constant">excel</code> enthalten.</p></dd><dt><span class="term">
142
                        <code class="varname">template_meta.extension</code>
143
                     </span></dt><dd><p>Dateierweiterung, wie im Dateinamen. Wird aus
144
                <code class="constant">format</code> entschieden.</p></dd><dt><span class="term">
145
                        <code class="varname">template_meta.media</code>
146
                     </span></dt><dd><p>Ausgabemedium. Kann zur Zeit die Werte
147
                <code class="constant">screen</code> für Bildschirm,
148
                <code class="constant">email</code> für E-Mail (triggert das
149
                <code class="constant">_email</code> Kürzel im Dateinamen),
150
                <code class="constant">printer</code> für Drucker, und
151
                <code class="constant">queue</code> für Warteschlange enthalten.</p></dd><dt><span class="term">
152
                        <code class="varname">template_meta.printer.description</code>
153
                     </span></dt><dd><p>Beschreibung des ausgewählten Druckers</p></dd><dt><span class="term">
154
                        <code class="varname">template_meta.printer.template_code</code>
155
                     </span></dt><dd><p>Vorlagenürzel des ausgewählten Druckers, identisch mit
156
                dem Kürzel das im Dateinamen verwendetet wird.</p></dd><dt><span class="term">
157
                        <code class="varname">template_meta.tmpfile</code>
158
                     </span></dt><dd><p>Datei-Prefix für temporäre Dateien.</p></dd></dl></div></div><div class="sect3" title="3.3.7.2. Stammdaten von Kunden und Lieferanten"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen.kunden-lieferanten"></a>3.3.7.2. Stammdaten von Kunden und Lieferanten</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
159
                        <code class="varname">account_number</code>
160
                     </span></dt><dd><p>Kontonummer</p></dd><dt><span class="term">
161
                        <code class="varname">bank</code>
162
                     </span></dt><dd><p>Name der Bank</p></dd><dt><span class="term">
163
                        <code class="varname">bank_code</code>
164
                     </span></dt><dd><p>Bankleitzahl</p></dd><dt><span class="term">
165
                        <code class="varname">bic</code>
166
                     </span></dt><dd><p>Bank-Identifikations-Code (Bank Identifier Code,
167
                BIC)</p></dd><dt><span class="term">
168
                        <code class="varname">business</code>
169
                     </span></dt><dd><p>Kunden-/Lieferantentyp</p></dd><dt><span class="term">
170
                        <code class="varname">city</code>
171
                     </span></dt><dd><p>Stadt</p></dd><dt><span class="term">
172
                        <code class="varname">contact</code>
173
                     </span></dt><dd><p>Kontakt</p></dd><dt><span class="term">
174
                        <code class="varname">country</code>
175
                     </span></dt><dd><p>Land</p></dd><dt><span class="term">
176
                        <code class="varname">c_vendor_id</code>
177
                     </span></dt><dd><p>Lieferantennummer beim Kunden (nur Kunden)</p></dd><dt><span class="term">
178
                        <code class="varname">v_customer_id</code>
179
                     </span></dt><dd><p>Kundennummer beim Lieferanten (nur Lieferanten)</p></dd><dt><span class="term">
180
                        <code class="varname">cp_email</code>
181
                     </span></dt><dd><p>Email des Ansprechpartners</p></dd><dt><span class="term">
182
                        <code class="varname">cp_givenname</code>
183
                     </span></dt><dd><p>Vorname des Ansprechpartners</p></dd><dt><span class="term">
184
                        <code class="varname">cp_greeting</code>
185
                     </span></dt><dd><p>Anrede des Ansprechpartners</p></dd><dt><span class="term">
186
                        <code class="varname">cp_name</code>
187
                     </span></dt><dd><p>Name des Ansprechpartners</p></dd><dt><span class="term">
188
                        <code class="varname">cp_phone1</code>
189
                     </span></dt><dd><p>Telefonnummer 1 des Ansprechpartners</p></dd><dt><span class="term">
190
                        <code class="varname">cp_phone2</code>
191
                     </span></dt><dd><p>Telefonnummer 2 des Ansprechpartners</p></dd><dt><span class="term">
192
                        <code class="varname">cp_title</code>
193
                     </span></dt><dd><p>Titel des Ansprechpartners</p></dd><dt><span class="term">
194
                        <code class="varname">creditlimit</code>
195
                     </span></dt><dd><p>Kreditlimit</p></dd><dt><span class="term">
196
                        <code class="varname">customeremail</code>
197
                     </span></dt><dd><p>Email des Kunden; nur für Kunden</p></dd><dt><span class="term">
198
                        <code class="varname">customerfax</code>
199
                     </span></dt><dd><p>Faxnummer des Kunden; nur für Kunden</p></dd><dt><span class="term">
200
                        <code class="varname">customernotes</code>
201
                     </span></dt><dd><p>Bemerkungen beim Kunden; nur für Kunden</p></dd><dt><span class="term">
202
                        <code class="varname">customernumber</code>
203
                     </span></dt><dd><p>Kundennummer; nur für Kunden</p></dd><dt><span class="term">
204
                        <code class="varname">customerphone</code>
205
                     </span></dt><dd><p>Telefonnummer des Kunden; nur für Kunden</p></dd><dt><span class="term">
206
                        <code class="varname">discount</code>
207
                     </span></dt><dd><p>Rabatt</p></dd><dt><span class="term">
208
                        <code class="varname">email</code>
209
                     </span></dt><dd><p>Emailadresse</p></dd><dt><span class="term">
210
                        <code class="varname">fax</code>
211
                     </span></dt><dd><p>Faxnummer</p></dd><dt><span class="term">
212
                        <code class="varname">greeting</code>
213
                     </span></dt><dd><p>Anrede</p></dd><dt><span class="term">
214
                        <code class="varname">homepage</code>
215
                     </span></dt><dd><p>Homepage</p></dd><dt><span class="term">
216
                        <code class="varname">iban</code>
217
                     </span></dt><dd><p>Internationale Kontonummer (International Bank Account
218
                Number, IBAN)</p></dd><dt><span class="term">
219
                        <code class="varname">language</code>
220
                     </span></dt><dd><p>Sprache</p></dd><dt><span class="term">
221
                        <code class="varname">name</code>
222
                     </span></dt><dd><p>Firmenname</p></dd><dt><span class="term">
223
                        <code class="varname">payment_description</code>
224
                     </span></dt><dd><p>Name der Zahlart</p></dd><dt><span class="term">
225
                        <code class="varname">payment_terms</code>
226
                     </span></dt><dd><p>Zahlungskonditionen</p></dd><dt><span class="term">
227
                        <code class="varname">phone</code>
228
                     </span></dt><dd><p>Telefonnummer</p></dd><dt><span class="term">
229
                        <code class="varname">shiptocity</code>
230
                     </span></dt><dd><p>Stadt (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
231
                        </p></dd><dt><span class="term">
232
                        <code class="varname">shiptocontact</code>
233
                     </span></dt><dd><p>Kontakt (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
234
                        </p></dd><dt><span class="term">
235
                        <code class="varname">shiptocountry</code>
236
                     </span></dt><dd><p>Land (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
237
                        </p></dd><dt><span class="term">
238
                        <code class="varname">shiptodepartment1</code>
239
                     </span></dt><dd><p>Abteilung 1 (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
240
                        </p></dd><dt><span class="term">
241
                        <code class="varname">shiptodepartment2</code>
242
                     </span></dt><dd><p>Abteilung 2 (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
243
                        </p></dd><dt><span class="term">
244
                        <code class="varname">shiptoemail</code>
245
                     </span></dt><dd><p>Email (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
246
                        </p></dd><dt><span class="term">
247
                        <code class="varname">shiptofax</code>
248
                     </span></dt><dd><p>Fax (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
249
                        </p></dd><dt><span class="term">
250
                        <code class="varname">shiptoname</code>
251
                     </span></dt><dd><p>Firmenname (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
252
                        </p></dd><dt><span class="term">
253
                        <code class="varname">shiptophone</code>
254
                     </span></dt><dd><p>Telefonnummer (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
255
                        </p></dd><dt><span class="term">
256
                        <code class="varname">shiptostreet</code>
257
                     </span></dt><dd><p>Straße und Hausnummer (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
258
                        </p></dd><dt><span class="term">
259
                        <code class="varname">shiptozipcode</code>
260
                     </span></dt><dd><p>Postleitzahl (Lieferadresse) <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
261
                        </p></dd><dt><span class="term">
262
                        <code class="varname">street</code>
263
                     </span></dt><dd><p>Straße und Hausnummer</p></dd><dt><span class="term">
264
                        <code class="varname">taxnumber</code>
265
                     </span></dt><dd><p>Steuernummer</p></dd><dt><span class="term">
266
                        <code class="varname">ustid</code>
267
                     </span></dt><dd><p>Umsatzsteuer-Identifikationsnummer</p></dd><dt><span class="term">
268
                        <code class="varname">vendoremail</code>
269
                     </span></dt><dd><p>Email des Lieferanten; nur für Lieferanten</p></dd><dt><span class="term">
270
                        <code class="varname">vendorfax</code>
271
                     </span></dt><dd><p>Faxnummer des Lieferanten; nur für Lieferanten</p></dd><dt><span class="term">
272
                        <code class="varname">vendornotes</code>
273
                     </span></dt><dd><p>Bemerkungen beim Lieferanten; nur für Lieferanten</p></dd><dt><span class="term">
274
                        <code class="varname">vendornumber</code>
275
                     </span></dt><dd><p>Lieferantennummer; nur für Lieferanten</p></dd><dt><span class="term">
276
                        <code class="varname">vendorphone</code>
277
                     </span></dt><dd><p>Telefonnummer des Lieferanten; nur für
278
                Lieferanten</p></dd><dt><span class="term">
279
                        <code class="varname">zipcode</code>
280
                     </span></dt><dd><p>Postleitzahl</p></dd></dl></div><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left"><a name="dokumentenvorlagen-und-variablen.anmerkung-shipto"></a>Anmerkung</th></tr><tr><td align="left" valign="top"><p>Anmerkung: Sind die <code class="varname">shipto*</code>-Felder in den
281
            Stammdaten nicht eingetragen, so haben die Variablen
282
            <code class="varname">shipto*</code> den gleichen Wert wie die die
283
            entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich
284
            einige <code class="varname">shipto*</code>-Variablen so nicht in den
285
            Stammdaten wiederfinden sondern schlicht Kopien der
286
            Lieferdatenvariablen sind (z.B.
287
            <code class="varname">shiptocontact</code>).</p></td></tr></table></div></div><div class="sect3" title="3.3.7.3. Informationen über den Bearbeiter"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-bearbeiter"></a>3.3.7.3. Informationen über den Bearbeiter</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
288
                        <code class="varname">employee_address</code>
289
                     </span></dt><dd><p>Adressfeld</p></dd><dt><span class="term">
290
                        <code class="varname">employee_businessnumber</code>
291
                     </span></dt><dd><p>Firmennummer</p></dd><dt><span class="term">
292
                        <code class="varname">employee_company</code>
293
                     </span></dt><dd><p>Firmenname</p></dd><dt><span class="term">
294
                        <code class="varname">employee_co_ustid</code>
295
                     </span></dt><dd><p>Usatzsteuer-Identifikationsnummer</p></dd><dt><span class="term">
296
                        <code class="varname">employee_duns</code>
297
                     </span></dt><dd><p>DUNS-Nummer</p></dd><dt><span class="term">
298
                        <code class="varname">employee_email</code>
299
                     </span></dt><dd><p>Email</p></dd><dt><span class="term">
300
                        <code class="varname">employee_fax</code>
301
                     </span></dt><dd><p>Fax</p></dd><dt><span class="term">
302
                        <code class="varname">employee_name</code>
303
                     </span></dt><dd><p>voller Name</p></dd><dt><span class="term">
304
                        <code class="varname">employee_signature</code>
305
                     </span></dt><dd><p>Signatur</p></dd><dt><span class="term">
306
                        <code class="varname">employee_taxnumber</code>
307
                     </span></dt><dd><p>Steuernummer</p></dd><dt><span class="term">
308
                        <code class="varname">employee_tel</code>
309
                     </span></dt><dd><p>Telefonnummer</p></dd></dl></div></div><div class="sect3" title="3.3.7.4. Informationen über den Verkäufer"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-verkaeufer"></a>3.3.7.4. Informationen über den Verkäufer</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
310
                        <code class="varname">salesman_address</code>
311
                     </span></dt><dd><p>Adressfeld</p></dd><dt><span class="term">
312
                        <code class="varname">salesman_businessnumber</code>
313
                     </span></dt><dd><p>Firmennummer</p></dd><dt><span class="term">
314
                        <code class="varname">salesman_company</code>
315
                     </span></dt><dd><p>Firmenname</p></dd><dt><span class="term">
316
                        <code class="varname">salesman_co_ustid</code>
317
                     </span></dt><dd><p>Usatzsteuer-Identifikationsnummer</p></dd><dt><span class="term">
318
                        <code class="varname">salesman_duns</code>
319
                     </span></dt><dd><p>DUNS-Nummer</p></dd><dt><span class="term">
320
                        <code class="varname">salesman_email</code>
321
                     </span></dt><dd><p>Email</p></dd><dt><span class="term">
322
                        <code class="varname">salesman_fax</code>
323
                     </span></dt><dd><p>Fax</p></dd><dt><span class="term">
324
                        <code class="varname">salesman_name</code>
325
                     </span></dt><dd><p>voller Name</p></dd><dt><span class="term">
326
                        <code class="varname">salesman_signature</code>
327
                     </span></dt><dd><p>Signatur</p></dd><dt><span class="term">
328
                        <code class="varname">salesman_taxnumber</code>
329
                     </span></dt><dd><p>Steuernummer</p></dd><dt><span class="term">
330
                        <code class="varname">salesman_tel</code>
331
                     </span></dt><dd><p>Telefonnummer</p></dd></dl></div></div><div class="sect3" title="3.3.7.5. Variablen für die einzelnen Steuern"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-steuern"></a>3.3.7.5. Variablen für die einzelnen Steuern</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
332
                        <code class="varname">tax</code>
333
                     </span></dt><dd><p>Steuer</p></dd><dt><span class="term">
334
                        <code class="varname">taxbase</code>
335
                     </span></dt><dd><p>zu versteuernder Betrag</p></dd><dt><span class="term">
336
                        <code class="varname">taxdescription</code>
337
                     </span></dt><dd><p>Name der Steuer</p></dd><dt><span class="term">
338
                        <code class="varname">taxrate</code>
339
                     </span></dt><dd><p>Steuersatz</p></dd></dl></div></div><div class="sect3" title="3.3.7.6. Variablen für Lieferbedingungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-lieferbedingungen"></a>3.3.7.6. Variablen für Lieferbedingungen</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
340
                        <code class="varname">delivery_term</code>
341
                     </span></dt><dd><p>Datenbank-Objekt der Lieferbedingung</p></dd><dt><span class="term">
342
                        <code class="varname">delivery_term.description</code>
343
                     </span></dt><dd><p>Beschreibung der Lieferbedingung</p></dd><dt><span class="term">
344
                        <code class="varname">delivery_term.description_long</code>
345
                     </span></dt><dd><p>Langtext bzw. übersetzter Langtext der Lieferbedingung</p></dd></dl></div></div></div><div class="sect2" title="3.3.8. Variablen in Rechnungen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.invoice"></a>3.3.8. Variablen in Rechnungen</h3></div></div></div><div class="sect3" title="3.3.8.1. Allgemeine Variablen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-allgemein"></a>3.3.8.1. Allgemeine Variablen</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
346
                        <code class="varname">creditremaining</code>
347
                     </span></dt><dd><p>Verbleibender Kredit</p></dd><dt><span class="term">
348
                        <code class="varname">currency</code>
349
                     </span></dt><dd><p>Währung</p></dd><dt><span class="term">
350
                        <code class="varname">cusordnumber</code>
351
                     </span></dt><dd><p>Bestellnummer beim Kunden</p></dd><dt><span class="term">
352
                        <code class="varname">deliverydate</code>
353
                     </span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term">
354
                        <code class="varname">duedate</code>
355
                     </span></dt><dd><p>Fälligkeitsdatum</p></dd><dt><span class="term">
356
                        <code class="varname">globalprojectnumber</code>
357
                     </span></dt><dd><p>Projektnummer des ganzen Beleges</p></dd><dt><span class="term">
358
                        <code class="varname">globalprojectdescription</code>
359
                     </span></dt><dd><p>Projekbeschreibung des ganzen Beleges</p></dd><dt><span class="term">
360
                        <code class="varname">intnotes</code>
361
                     </span></dt><dd><p>Interne Bemerkungen</p></dd><dt><span class="term">
362
                        <code class="varname">invdate</code>
363
                     </span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">
364
                        <code class="varname">invnumber</code>
365
                     </span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term">
366
                        <code class="varname">invtotal</code>
367
                     </span></dt><dd><p>gesamter Rechnungsbetrag</p></dd><dt><span class="term">
368
                        <code class="varname">notes</code>
369
                     </span></dt><dd><p>Bemerkungen der Rechnung</p></dd><dt><span class="term">
370
                        <code class="varname">orddate</code>
371
                     </span></dt><dd><p>Auftragsdatum</p></dd><dt><span class="term">
372
                        <code class="varname">ordnumber</code>
373
                     </span></dt><dd><p>Auftragsnummer, wenn die Rechnung aus einem Auftrag
374
                erstellt wurde</p></dd><dt><span class="term">
375
                        <code class="varname">payment_description</code>
376
                     </span></dt><dd><p>Name der Zahlart</p></dd><dt><span class="term">
377
                        <code class="varname">payment_terms</code>
378
                     </span></dt><dd><p>Zahlungskonditionen</p></dd><dt><span class="term">
379
                        <code class="varname">quodate</code>
380
                     </span></dt><dd><p>Angebotsdatum</p></dd><dt><span class="term">
381
                        <code class="varname">quonumber</code>
382
                     </span></dt><dd><p>Angebotsnummer</p></dd><dt><span class="term">
383
                        <code class="varname">shippingpoint</code>
384
                     </span></dt><dd><p>Versandort</p></dd><dt><span class="term">
385
                        <code class="varname">shipvia</code>
386
                     </span></dt><dd><p>Transportmittel</p></dd><dt><span class="term">
387
                        <code class="varname">subtotal</code>
388
                     </span></dt><dd><p>Zwischensumme aller Posten ohne Steuern</p></dd><dt><span class="term">
389
                        <code class="varname">total</code>
390
                     </span></dt><dd><p>Restsumme der Rechnung (Summe abzüglich bereits
391
                bezahlter Posten)</p></dd><dt><span class="term">
392
                        <code class="varname">transaction_description</code>
393
                     </span></dt><dd><p>Vorgangsbezeichnung</p></dd><dt><span class="term">
394
                        <code class="varname">transdate</code>
395
                     </span></dt><dd><p>Auftragsdatum wenn die Rechnung aus einem Auftrag
396
                erstellt wurde</p></dd></dl></div></div><div class="sect3" title="3.3.8.2. Variablen für jeden Posten auf der Rechnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-posten"></a>3.3.8.2. Variablen für jeden Posten auf der Rechnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
397
                        <code class="varname">bin</code>
398
                     </span></dt><dd><p>Stellage</p></dd><dt><span class="term">
399
                        <code class="varname">description</code>
400
                     </span></dt><dd><p>Artikelbeschreibung</p></dd><dt><span class="term">
401
                        <code class="varname">cusordnumber_oe</code>
402
                     </span></dt><dd><p>Bestellnummer des Kunden aus dem Auftrag, aus dem der Posten ursprünglich stammt (nur Verkauf)</p></dd><dt><span class="term">
403
                        <code class="varname">discount</code>
404
                     </span></dt><dd><p>Rabatt als Betrag</p></dd><dt><span class="term">
405
                        <code class="varname">discount_sub</code>
406
                     </span></dt><dd><p>Zwischensumme mit Rabatt</p></dd><dt><span class="term">
407
                        <code class="varname">donumber_do</code>
408
                     </span></dt><dd><p>Lieferscheinnummer des Lieferscheins, aus dem die Position ursprünglich stammt, wenn die Rechnung im Rahmen des Workflows aus einem  Lieferschein erstellt wurde.</p></dd><dt><span class="term">
409
                        <code class="varname">drawing</code>
410
                     </span></dt><dd><p>Zeichnung</p></dd><dt><span class="term">
411
                        <code class="varname">ean</code>
412
                     </span></dt><dd><p>EAN-Code</p></dd><dt><span class="term">
413
                        <code class="varname">image</code>
414
                     </span></dt><dd><p>Grafik</p></dd><dt><span class="term">
415
                        <code class="varname">linetotal</code>
416
                     </span></dt><dd><p>Zeilensumme (Anzahl * Einzelpreis)</p></dd><dt><span class="term">
417
                        <code class="varname">longdescription</code>
418
                     </span></dt><dd><p>Langtext</p></dd><dt><span class="term">
419
                        <code class="varname">microfiche</code>
420
                     </span></dt><dd><p>Mikrofilm</p></dd><dt><span class="term">
421
                        <code class="varname">netprice</code>
422
                     </span></dt><dd><p>Alternative zu <code class="varname">sellprice</code>, aber <code class="varname">netprice</code> entspricht dem effektiven Einzelpreis und beinhaltet Zeilenrabatt und Preisfaktor. <code class="varname">netprice</code> 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. <code class="varname">netprice</code> hat nichts mit Netto/Brutto im Sinne von Steuern zu tun.</p></dd><dt><span class="term">
423
                        <code class="varname">nodiscount_linetotal</code>
424
                     </span></dt><dd><p>Zeilensumme ohne Rabatt</p></dd><dt><span class="term">
425
                        <code class="varname">nodiscount_sub</code>
426
                     </span></dt><dd><p>Zwischensumme ohne Rabatt</p></dd><dt><span class="term">
427
                        <code class="varname">number</code>
428
                     </span></dt><dd><p>Artikelnummer</p></dd><dt><span class="term">
429
                        <code class="varname">ordnumber_oe</code>
430
                     </span></dt><dd><p>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></dd><dt><span class="term">
431
                        <code class="varname">p_discount</code>
432
                     </span></dt><dd><p>Rabatt in Prozent</p></dd><dt><span class="term">
433
                        <code class="varname">partnotes</code>
434
                     </span></dt><dd><p>Die beim Artikel gespeicherten Bemerkungen</p></dd><dt><span class="term">
435
                        <code class="varname">partsgroup</code>
436
                     </span></dt><dd><p>Warengruppe</p></dd><dt><span class="term">
437
                        <code class="varname">price_factor</code>
438
                     </span></dt><dd><p>Der Preisfaktor als Zahl, sofern einer eingestellt
439
                ist</p></dd><dt><span class="term">
440
                        <code class="varname">price_factor_name</code>
441
                     </span></dt><dd><p>Der Name des Preisfaktors, sofern einer eingestellt
442
                ist</p></dd><dt><span class="term">
443
                        <code class="varname">projectnumber</code>
444
                     </span></dt><dd><p>Projektnummer</p></dd><dt><span class="term">
445
                        <code class="varname">projectdescription</code>
446
                     </span></dt><dd><p>Projektbeschreibung</p></dd><dt><span class="term">
447
                        <code class="varname">qty</code>
448
                     </span></dt><dd><p>Anzahl</p></dd><dt><span class="term">
449
                        <code class="varname">reqdate</code>
450
                     </span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term">
451
                        <code class="varname">runningnumber</code>
452
                     </span></dt><dd><p>Position auf der Rechnung (1, 2, 3...)</p></dd><dt><span class="term">
453
                        <code class="varname">sellprice</code>
454
                     </span></dt><dd><p>Verkaufspreis</p></dd><dt><span class="term">
455
                        <code class="varname">serialnumber</code>
456
                     </span></dt><dd><p>Seriennummer</p></dd><dt><span class="term">
457
                        <code class="varname">tax_rate</code>
458
                     </span></dt><dd><p>Steuersatz</p></dd><dt><span class="term">
459
                        <code class="varname">transdate_do</code>
460
                     </span></dt><dd><p>Datum des Lieferscheins, wenn die Rechnung im Rahmen des Workflows aus einem Lieferschein stammte.</p></dd><dt><span class="term">
461
                        <code class="varname">transdate_oe</code>
462
                     </span></dt><dd><p>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.</p></dd><dt><span class="term">
463
                        <code class="varname">transdate_quo</code>
464
                     </span></dt><dd><p>Datum des Angebots, wenn die Position im Rahmen des Workflows aus einem Angebot stammte.</p></dd><dt><span class="term">
465
                        <code class="varname">unit</code>
466
                     </span></dt><dd><p>Einheit</p></dd><dt><span class="term">
467
                        <code class="varname">weight</code>
468
                     </span></dt><dd><p>Gewicht</p></dd></dl></div><p>Für jeden Posten gibt es ein Unterarray mit den Informationen
469
          über Lieferanten und Lieferantenartikelnummer. Diese müssen mit
470
          einer <code class="function">foreach</code>-Schleife ausgegeben werden, da
471
          für jeden Artikel mehrere Lieferanteninformationen hinterlegt sein
472
          können. Die Variablen dafür lauten:</p><div class="variablelist"><dl><dt><span class="term">
473
                        <code class="varname">make</code>
474
                     </span></dt><dd><p>Lieferant</p></dd><dt><span class="term">
475
                        <code class="varname">model</code>
476
                     </span></dt><dd><p>Lieferantenartikelnummer</p></dd></dl></div></div><div class="sect3" title="3.3.8.3. Variablen für die einzelnen Zahlungseingänge"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-zahlungen"></a>3.3.8.3. Variablen für die einzelnen Zahlungseingänge</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
477
                        <code class="varname">payment</code>
478
                     </span></dt><dd><p>Betrag</p></dd><dt><span class="term">
479
                        <code class="varname">paymentaccount</code>
480
                     </span></dt><dd><p>Konto</p></dd><dt><span class="term">
481
                        <code class="varname">paymentdate</code>
482
                     </span></dt><dd><p>Datum</p></dd><dt><span class="term">
483
                        <code class="varname">paymentmemo</code>
484
                     </span></dt><dd><p>Memo</p></dd><dt><span class="term">
485
                        <code class="varname">paymentsource</code>
486
                     </span></dt><dd><p>Beleg</p></dd></dl></div></div><div class="sect3" title="3.3.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.benutzerdefinierte-variablen-vc"></a>3.3.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen</h4></div></div></div><p>Die vom Benutzer definierten Variablen für Kunden und
487
          Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen
488
          ebenfalls zur Verfügung. Ihre Namen setzen sich aus dem Präfix
489
          <code class="varname">vc_cvar_</code> und dem vom Benutzer festgelegten
490
          Variablennamen zusammen.</p><p>Beispiel: Der Benutzer hat eine Variable namens
491
          <code class="varname">number_of_employees</code> definiert, die die Anzahl der
492
          Mitarbeiter des Unternehmens enthält. Diese Variable steht dann
493
          unter dem Namen <code class="varname">vc_cvar_number_of_employees</code> zur
494
          Verfügung.</p></div></div><div class="sect2" title="3.3.9. Variablen in Mahnungen und Rechnungen über Mahngebühren"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dunning"></a>3.3.9. Variablen in Mahnungen und Rechnungen über Mahngebühren</h3></div></div></div><div class="sect3" title="3.3.9.1. Namen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-vorlagennamen"></a>3.3.9.1. Namen der Vorlagen</h4></div></div></div><p>Die Namen der Vorlagen werden im System-Menü vom Benutzer
495
          eingegeben. Wird für ein Mahnlevel die Option zur automatischen
496
          Erstellung einer Rechnung über die Mahngebühren und Zinsen
497
          aktiviert, so wird der Name der Vorlage für diese Rechnung aus dem
498
          Vorlagenname für diese Mahnstufe mit dem Zusatz
499
          <code class="constant">_invoice</code> gebildet. Weiterhin werden die Kürzel
500
          für die ausgewählte Sprache und den ausgewählten Drucker
501
          angehängt.</p></div><div class="sect3" title="3.3.9.2. Allgemeine Variablen in Mahnungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-allgemein"></a>3.3.9.2. Allgemeine Variablen in Mahnungen</h4></div></div></div><p>Die Variablen des Verkäufers stehen wie gewohnt als
502
          <code class="varname">employee_...</code> zur Verfügung. Die Adressdaten des
503
          Kunden stehen als Variablen <code class="varname">name</code>,
504
          <code class="varname">street</code>, <code class="varname">zipcode</code>,
505
          <code class="varname">city</code>, <code class="varname">country</code>,
506
          <code class="varname">department_1</code>, <code class="varname">department_2</code>,
507
          und <code class="varname">email</code> zur Verfügung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term">
508
                        <code class="varname">dunning_date</code>
509
                     </span></dt><dd><p>Datum der Mahnung</p></dd><dt><span class="term">
510
                        <code class="varname">dunning_duedate</code>
511
                     </span></dt><dd><p>Fälligkeitsdatum für diese Mahhnung</p></dd><dt><span class="term">
512
                        <code class="varname">dunning_id</code>
513
                     </span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term">
514
                        <code class="varname">fee</code>
515
                     </span></dt><dd><p>Kummulative Mahngebühren</p></dd><dt><span class="term">
516
                        <code class="varname">interest_rate</code>
517
                     </span></dt><dd><p>Zinssatz per anno in Prozent</p></dd><dt><span class="term">
518
                        <code class="varname">total_amount</code>
519
                     </span></dt><dd><p>Gesamter noch zu zahlender Betrag als
520
                <code class="function">fee</code> + <code class="function">total_interest</code>
521
                + <code class="function">total_open_amount</code>
522
                        </p></dd><dt><span class="term">
523
                        <code class="varname">total_interest</code>
524
                     </span></dt><dd><p>Zinsen per anno über alle Rechnungen</p></dd><dt><span class="term">
525
                        <code class="varname">total_open_amount</code>
526
                     </span></dt><dd><p>Summe über alle offene Beträge der Rechnungen</p></dd></dl></div></div><div class="sect3" title="3.3.9.3. Variablen für jede gemahnte Rechnung in einer Mahnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-details"></a>3.3.9.3. Variablen für jede gemahnte Rechnung in einer Mahnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
527
                        <code class="varname">dn_amount</code>
528
                     </span></dt><dd><p>Rechnungssumme (brutto)</p></dd><dt><span class="term">
529
                        <code class="varname">dn_duedate</code>
530
                     </span></dt><dd><p>Originales Fälligkeitsdatum der Rechnung</p></dd><dt><span class="term">
531
                        <code class="varname">dn_dunning_date</code>
532
                     </span></dt><dd><p>Datum der Mahnung</p></dd><dt><span class="term">
533
                        <code class="varname">dn_dunning_duedate</code>
534
                     </span></dt><dd><p>Fälligkeitsdatum der Mahnung</p></dd><dt><span class="term">
535
                        <code class="varname">dn_fee</code>
536
                     </span></dt><dd><p>Kummulative Mahngebühr</p></dd><dt><span class="term">
537
                        <code class="varname">dn_interest</code>
538
                     </span></dt><dd><p>Zinsen per anno für diese Rechnung</p></dd><dt><span class="term">
539
                        <code class="varname">dn_invnumber</code>
540
                     </span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term">
541
                        <code class="varname">dn_linetotal</code>
542
                     </span></dt><dd><p>Noch zu zahlender Betrag (ergibt sich aus
543
                <code class="varname">dn_open_amount</code> + <code class="varname">dn_fee</code>
544
                + <code class="varname">dn_interest</code>)</p></dd><dt><span class="term">
545
                        <code class="varname">dn_netamount</code>
546
                     </span></dt><dd><p>Rechnungssumme (netto)</p></dd><dt><span class="term">
547
                        <code class="varname">dn_open_amount</code>
548
                     </span></dt><dd><p>Offener Rechnungsbetrag</p></dd><dt><span class="term">
549
                        <code class="varname">dn_ordnumber</code>
550
                     </span></dt><dd><p>Bestellnummer</p></dd><dt><span class="term">
551
                        <code class="varname">dn_transdate</code>
552
                     </span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">
553
                        <code class="varname">dn_curr</code>
554
                     </span></dt><dd><p>Währung, in der die Rechnung erstellt wurde. (Die
555
                Rechnungsbeträge sind aber immer in der Hauptwährung)</p></dd></dl></div></div><div class="sect3" title="3.3.9.4. Variablen in automatisch erzeugten Rechnungen über Mahngebühren"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-invoice"></a>3.3.9.4. Variablen in automatisch erzeugten Rechnungen über
556
          Mahngebühren</h4></div></div></div><p>Die Variablen des Verkäufers stehen wie gewohnt als
557
          <code class="varname">employee_...</code> zur Verfügung. Die Adressdaten des
558
          Kunden stehen als Variablen <code class="varname">name</code>,
559
          <code class="varname">street</code>, <code class="varname">zipcode</code>,
560
          <code class="varname">city</code>, <code class="varname">country</code>,
561
          <code class="varname">department_1</code>, <code class="varname">department_2</code>,
562
          und <code class="varname">email</code> zur Verfügung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term">
563
                        <code class="varname">duedate</code>
564
                     </span></dt><dd><p>Fälligkeitsdatum der Rechnung</p></dd><dt><span class="term">
565
                        <code class="varname">dunning_id</code>
566
                     </span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term">
567
                        <code class="varname">fee</code>
568
                     </span></dt><dd><p>Mahngebühren</p></dd><dt><span class="term">
569
                        <code class="varname">interest</code>
570
                     </span></dt><dd><p>Zinsen</p></dd><dt><span class="term">
571
                        <code class="varname">invamount</code>
572
                     </span></dt><dd><p>Rechnungssumme (ergibt sich aus <code class="varname">fee</code> +
573
                <code class="varname">interest</code>)</p></dd><dt><span class="term">
574
                        <code class="varname">invdate</code>
575
                     </span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">
576
                        <code class="varname">invnumber</code>
577
                     </span></dt><dd><p>Rechnungsnummer</p></dd></dl></div></div></div><div class="sect2" title="3.3.10. Variablen in anderen Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen"></a>3.3.10. Variablen in anderen Vorlagen</h3></div></div></div><div class="sect3" title="3.3.10.1. Einführung"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5076"></a>3.3.10.1. Einführung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ähnlich wie in der
578
          Rechnung. Allerdings heißen die Variablen, die mit
579
          <code class="varname">inv</code> beginnen, jetzt anders. Bei den Angeboten
580
          fangen sie mit <code class="varname">quo</code> für "quotation" an:
581
          <code class="varname">quodate</code> für Angebotsdatum etc. Bei Bestellungen
582
          wiederum fangen sie mit <code class="varname">ord</code> für "order" an:
583
          <code class="varname">ordnumber</code> für Bestellnummer etc.</p><p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht
584
          vorhanden wie z.B. die für bereits verbuchte Zahlungseingänge. Dies
585
          sind Variablen, die vom Geschäftsablauf her in der entsprechenden
586
          Vorlage keine Bedeutung haben oder noch nicht belegt sein
587
          können.</p><p>Im Folgenden werden nur wichtige Unterschiede zu den Variablen
588
          in Rechnungen aufgeführt.</p></div><div class="sect3" title="3.3.10.2. Angebote und Preisanfragen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-quotations"></a>3.3.10.2. Angebote und Preisanfragen</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
589
                        <code class="varname">quonumber</code>
590
                     </span></dt><dd><p>Angebots- bzw. Anfragenummer</p></dd><dt><span class="term">
591
                        <code class="varname">reqdate</code>
592
                     </span></dt><dd><p>Gültigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei
593
                Preisanfragen)</p></dd><dt><span class="term">
594
                        <code class="varname">transdate</code>
595
                     </span></dt><dd><p>Angebots- bzw. Anfragedatum</p></dd></dl></div></div><div class="sect3" title="3.3.10.3. Auftragsbestätigungen und Lieferantenaufträge"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-orders"></a>3.3.10.3. Auftragsbestätigungen und Lieferantenaufträge</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
596
                        <code class="varname">ordnumber</code>
597
                     </span></dt><dd><p>Auftragsnummer</p></dd><dt><span class="term">
598
                        <code class="varname">reqdate</code>
599
                     </span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term">
600
                        <code class="varname">transdate</code>
601
                     </span></dt><dd><p>Auftragsdatum</p></dd></dl></div></div><div class="sect3" title="3.3.10.4. Lieferscheine (Verkauf und Einkauf)"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-delivery-orders"></a>3.3.10.4. Lieferscheine (Verkauf und Einkauf)</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
602
                        <code class="varname">cusordnumber</code>
603
                     </span></dt><dd><p>Bestellnummer des Kunden (im Verkauf) bzw. Bestellnummer
604
                des Lieferanten (im Einkauf)</p></dd><dt><span class="term">
605
                        <code class="varname">donumber</code>
606
                     </span></dt><dd><p>Lieferscheinnummer</p></dd><dt><span class="term">
607
                        <code class="varname">transdate</code>
608
                     </span></dt><dd><p>Lieferscheindatum</p></dd></dl></div><p>Für jede Position eines Lieferscheines gibt es ein Unterarray
609
          mit den Informationen darüber, von welchem Lager und Lagerplatz aus
610
          die Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
611
          Lagerplatz sie eingelagert wurden. Diese müssen mittels einer
612
          <code class="function">foreach</code>-Schleife ausgegeben werden. Diese
613
          Variablen sind:</p><div class="variablelist"><dl><dt><span class="term">
614
                        <code class="varname">si_bin</code>
615
                     </span></dt><dd><p>Lagerplatz</p></dd><dt><span class="term">
616
                        <code class="varname">si_chargenumber</code>
617
                     </span></dt><dd><p>Chargennummer</p></dd><dt><span class="term">
618
                        <code class="varname">si_bestbefore</code>
619
                     </span></dt><dd><p>Mindesthaltbarkeit</p></dd><dt><span class="term">
620
                        <code class="varname">si_number</code>
621
                     </span></dt><dd><p>Artikelnummer</p></dd><dt><span class="term">
622
                        <code class="varname">si_qty</code>
623
                     </span></dt><dd><p>Anzahl bzw. Menge</p></dd><dt><span class="term">
624
                        <code class="varname">si_runningnumber</code>
625
                     </span></dt><dd><p>Positionsnummer (1, 2, 3 etc)</p></dd><dt><span class="term">
626
                        <code class="varname">si_unit</code>
627
                     </span></dt><dd><p>Einheit</p></dd><dt><span class="term">
628
                        <code class="varname">si_warehouse</code>
629
                     </span></dt><dd><p>Lager</p></dd></dl></div></div><div class="sect3" title="3.3.10.5. Variablen für Sammelrechnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-statement"></a>3.3.10.5. Variablen für Sammelrechnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
630
                        <code class="varname">c0total</code>
631
                     </span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit &lt; 30
632
                Tage</p></dd><dt><span class="term">
633
                        <code class="varname">c30total</code>
634
                     </span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit &gt;= 30
635
                und &lt; 60 Tage</p></dd><dt><span class="term">
636
                        <code class="varname">c60total</code>
637
                     </span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit &gt;= 60
638
                und &lt; 90 Tage</p></dd><dt><span class="term">
639
                        <code class="varname">c90total</code>
640
                     </span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit &gt;= 90
641
                Tage</p></dd><dt><span class="term">
642
                        <code class="varname">total</code>
643
                     </span></dt><dd><p>Gesamtbetrag aller Rechnungen</p></dd></dl></div><p>Variablen für jede Rechnungsposition in Sammelrechnung:</p><div class="variablelist"><dl><dt><span class="term">
644
                        <code class="varname">invnumber</code>
645
                     </span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term">
646
                        <code class="varname">invdate</code>
647
                     </span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">
648
                        <code class="varname">duedate</code>
649
                     </span></dt><dd><p>Fälligkeitsdatum</p></dd><dt><span class="term">
650
                        <code class="varname">amount</code>
651
                     </span></dt><dd><p>Summe der Rechnung</p></dd><dt><span class="term">
652
                        <code class="varname">open</code>
653
                     </span></dt><dd><p>Noch offener Betrag der Rechnung</p></dd><dt><span class="term">
654
                        <code class="varname">c0</code>
655
                     </span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit &lt; 30
656
                Tage</p></dd><dt><span class="term">
657
                        <code class="varname">c30</code>
658
                     </span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit &gt;= 30 und
659
                &lt; 60 Tage</p></dd><dt><span class="term">
660
                        <code class="varname">c60</code>
661
                     </span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit &gt;= 60 und
662
                &lt; 90 Tage</p></dd><dt><span class="term">
663
                        <code class="varname">c90</code>
664
                     </span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit &gt;= 90
665
                Tage</p></dd></dl></div></div></div><div class="sect2" title="3.3.11. Blöcke, bedingte Anweisungen und Schleifen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke"></a>3.3.11. Blöcke, bedingte Anweisungen und Schleifen</h3></div></div></div><div class="sect3" title="3.3.11.1. Einführung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.einfuehrung"></a>3.3.11.1. Einführung</h4></div></div></div><p>Der Parser kennt neben den Variablen einige weitere
666
          Konstrukte, die gesondert behandelt werden. Diese sind wie
667
          Variablennamen in spezieller Weise markiert:
668
          <span class="command"><strong>&lt;%anweisung%&gt; ... &lt;%end%&gt;</strong></span>
669
               </p><p>Anmerkung zum <span class="command"><strong>&lt;%end%&gt;</strong></span>: Der besseren
670
          Verständlichkeit halber kann man nach dem <span class="command"><strong>end</strong></span>
671
          noch beliebig weitere Wörter schreiben, um so zu markieren, welche
672
          Anweisung (z.B. <span class="command"><strong>if</strong></span> oder
673
          <span class="command"><strong>foreach</strong></span>) damit abgeschlossen wird.</p><p>Beispiel: Lautet der Beginn eines Blockes z.B.
674
          <span class="command"><strong>&lt;%if type == "sales_quotation"%&gt;</strong></span>, so könnte
675
          er mit <span class="command"><strong>&lt;%end%&gt;</strong></span> genauso abgeschlossen werden
676
          wie mit <span class="command"><strong>&lt;%end if%&gt;</strong></span> oder auch
677
          <span class="command"><strong>&lt;%end type == "sales_quotation"%&gt;</strong></span>.</p></div><div class="sect3" title="3.3.11.2. Der if-Block"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.if"></a>3.3.11.2. Der if-Block</h4></div></div></div><pre class="programlisting">&lt;%if variablenname%&gt;
678
...
679
&lt;%end%&gt;</pre><p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if"
680
          und dem "end" werden nur ausgegeben, wenn die Variable
681
          <code class="varname">variablenname</code> gesetzt und ungleich 0 ist.</p><p>Handelt es sich bei der benannten Variable um ein Array, also um einen Variablennamen, über den man mit
682
          <span class="command"><strong>&lt;%foreach variablenname%&gt;</strong></span> iteriert, so wird mit diesem Konstrukt darauf getestet, ob das Array Elemente
683
          enthält. Somit würde im folgenden Beispiel nur dann eine Liste von Zahlungseingängen samt ihrer Überschrift "Zahlungseingänge"
684
          ausgegeben, wenn tatsächlich welche getätigt wurden:</p><pre class="programlisting">&lt;%if payment%&gt;
685
Zahlungseingänge:
686
 &lt;%foreach payment%&gt;
687
   Am &lt;%paymentdate%&gt;: &lt;%payment%&gt; €
688
 &lt;%end foreach%&gt;
689
&lt;%end if%&gt;</pre><p>Die Bedingung kann auch negiert werden, indem das Wort
690
          <code class="function">not</code> nach dem <code class="filename">if</code> verwendet
691
          wird. Beispiel:</p><pre class="programlisting">&lt;%if not cp_greeting%&gt;
692
...
693
&lt;%end%&gt;</pre><p>Zusätzlich zu dem einfachen Test, ob eine Variable gesetzt ist
694
          oder nicht, bietet dieser Block auch die Möglichkeit, den Inhalt
695
          einer Variablen mit einer festen Zeichenkette oder einer anderen
696
          Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette
697
          oder einer anderen Variablen vorgenommen wird, hängt davon ab, ob
698
          die rechte Seite des Vergleichsoperators in Anführungszeichen
699
          gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit
700
          anderer Variablen). Zwei Beispiele, die beide Vergleiche
701
          zeigen:</p><pre class="programlisting">&lt;%if var1 == "Wert"%&gt;</pre><p>Testet die Variable <code class="varname">var1</code> auf
702
          übereinstimmung mit der Zeichenkette <code class="constant">Wert</code>.
703
          Mittels <code class="function">!=</code> anstelle von <code class="function">==</code>
704
          würde auf Ungleichheit getestet.</p><pre class="programlisting">&lt;%if var1 == var2%&gt;</pre><p>Testet die Variable <code class="varname">var1</code> auf
705
          übereinstimmung mit der Variablen <code class="varname">var2</code>. Mittel
706
          <code class="function">!=</code> anstelle von <code class="function">==</code> würde
707
          auf Ungleichheit getestet.</p><p>Erfahrere Benutzer können neben der Tests auf (Un-)Gleichheit
708
          auch Tests auf Übereinstimmung mit regulären Ausdrücken ohne
709
          Berücksichtung der Groß- und Kleinschreibung durchführen. Dazu dient
710
          dieselbe Syntax wie oben nur mit <code class="function">=~</code> und
711
          <code class="function">!~</code> als Vergleichsoperatoren.</p><p>Beispiel für einen Test, ob die Variable
712
          <code class="varname">intnotes</code> (interne Bemerkungen) das Wort
713
          <code class="constant">schwierig</code> enthält:</p><pre class="programlisting">&lt;%if intnotes =~ "schwierig"%&gt;</pre></div><div class="sect3" title="3.3.11.3. Der foreach-Block"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.foreach"></a>3.3.11.3. Der foreach-Block</h4></div></div></div><pre class="programlisting">&lt;%foreach variablenname%&gt;
714
...
715
&lt;%end%&gt;</pre><p>Fügt die Zeilen zwischen den beiden Anweisungen so oft ein,
716
          wie das Perl-Array der Variablen <code class="varname">variablenname</code>
717
          Elemente enthät. Dieses Konstrukt wird zur Ausgabe der einzelnen
718
          Posten einer Rechnung / eines Angebots sowie zur Ausgabe der Steuern
719
          benutzt. In jedem Durchlauf werden die <a class="link" href="ch03s03.html#dokumentenvorlagen-und-variablen.invoice-posten" title="3.3.8.2. Variablen für jeden Posten auf der Rechnung">zeilenbezogenen
720
          Variablen</a> jeweils auf den Wert für die aktuelle Position
721
          gesetzt.</p><p>Die Syntax sieht normalerweise wie folgt aus:</p><pre class="programlisting">&lt;%foreach number%&gt;
722
Position: &lt;%runningnumber%&gt;
723
Anzahl: &lt;%qty%&gt;
724
Artikelnummer: &lt;%number%&gt;
725
Beschreibung: &lt;%description%&gt;
726
...
727
&lt;%end%&gt;</pre><p>Besonderheit in OpenDocument-Vorlagen: Tritt ein
728
          <code class="function">&lt;%foreach%&gt;</code>-Block innerhalb einer
729
          Tabellenzelle auf, so wird die komplette Tabellenzeile so oft
730
          wiederholt wie notwendig. Tritt er außerhalb auf, so wird nur der
731
          Inhalt zwischen <code class="function">&lt;%foreach%&gt;</code> und
732
          <code class="function">&lt;%end%&gt;</code> wiederholt, nicht aber die
733
          komplette Zeile, in der er steht.</p></div></div><div class="sect2" title="3.3.12. Markup-Code zur Textformatierung innerhalb von Formularen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.markup"></a>3.3.12. Markup-Code zur Textformatierung innerhalb von
734
        Formularen</h3></div></div></div><p>Wenn der Benutzer innhalb von Formularen in kivitendo Text
735
        anders formatiert haben möchte, so ist dies begrenzt möglich.
736
        kivitendo unterstützt die Textformatierung mit HTML-ähnlichen Tags.
737
        Der Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung
738
        Teile des Texts zwischen Start- und Endtags setzen. Dieser Teil wird
739
        dann automatisch in Anweisungen für das ausgewählte Vorlagenformat
740
        (HTML oder PDF über LaTeX) umgesetzt.</p><p>Die unterstützen Formatierungen sind:</p><div class="variablelist"><dl><dt><span class="term">&lt;b&gt;Text&lt;/b&gt;</span></dt><dd><p>Text wird in Fettdruck gesetzt.</p></dd><dt><span class="term">&lt;i&gt;Text&lt;/i&gt;</span></dt><dd><p>Text wird kursiv gesetzt.</p></dd><dt><span class="term">&lt;u&gt;Text&lt;/u&gt;</span></dt><dd><p>Text wird unterstrichen.</p></dd><dt><span class="term">&lt;s&gt;Text&lt;/s&gt;</span></dt><dd><p>Text wird durchgestrichen. Diese Formatierung ist nicht
741
              bei der Ausgabe als PDF über LaTeX verfügbar.</p></dd><dt><span class="term">&lt;bullet&gt;</span></dt><dd><p>Erzeugt einen ausgefüllten Kreis für Aufzählungen (siehe
742
              unten).</p></dd></dl></div><p>Der Befehl <span class="command"><strong>&lt;bullet&gt;</strong></span> funktioniert
743
        momentan auch nur in Latex-Vorlagen.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s02.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch03s04.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.2. Bankerweiterung&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;3.4. Excel-Vorlagen</td></tr></table></div></body></html>

Auch abrufbar als: Unified diff