Revision cb484787
Von Kivitendo Admin vor mehr als 9 Jahren hinzugefügt
| doc/html/ch03s02.html | ||
|---|---|---|
| 1 | 1 |
<html><head> |
| 2 | 2 |
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> |
| 3 |
<title>3.2. 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.2.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="next" href="ch03s03.html" title="3.3. 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.2. Dokumentenvorlagen und verfügbare Variablen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Zurück</a> </td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right"> <a accesskey="n" href="ch03s03.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.2. Dokumentenvorlagen und verfügbare Variablen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="dokumentenvorlagen-und-variablen"></a>3.2. Dokumentenvorlagen und verfügbare Variablen</h2></div></div></div><div class="sect2" title="3.2.1. Einführung"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.einf%C3%BChrung"></a>3.2.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"><%variablenname%></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="ch03s02.html#dokumentenvorlagen-und-variablen.tag-style" title="3.2.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 |
=> 'value',</code>. Alle <code class="varname">key</code>s sind |
|
| 23 |
verfügbar.</p></li></ul></div></div><div class="sect2" title="3.2.2. Variablen ausgeben"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.variablen-ausgeben"></a>3.2.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"><%variablenname%></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"><%variablenname FLAG1 FLAG2%></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"><%quototal NOFORMAT%></pre></div><div class="sect2" title="3.2.3. Verwendung in Druckbefehlen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.verwendung-in-druckbefehlen"></a>3.2.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 <%if cp_phone2%><%cp_phone2%><%else%><%cp_phone1%><%end%></pre></div><div class="sect2" title="3.2.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.2.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"><%customer%></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"><!-- config: tag-style=($ $) --></pre></div><div class="sect2" title="3.2.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.2.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.2.6. Sprache, Drucker und E-Mail"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dateinamen-erweitert"></a>3.2.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="ch03s02.html#dokumentenvorlagen-und-variablen.allgemeine-variablen.meta" title="3.2.7.1. Metainformationen zur angeforderten Vorlage">Metainformationen zur angeforderten Vorlage</a>.</p></div><div class="sect2" title="3.2.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.2.7. Allgemeine Variablen, die in allen Vorlagen vorhanden |
|
| 112 |
sind</h3></div></div></div><div class="sect3" title="3.2.7.1. Metainformationen zur angeforderten Vorlage"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen.meta"></a>3.2.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="ch03s02.html#dokumentenvorlagen-und-variablen.zuordnung-dateinamen" title="3.2.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.2.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.2.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="ch03s02.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="ch03s02.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="ch03s02.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="ch03s02.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="ch03s02.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="ch03s02.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="ch03s02.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="ch03s02.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="ch03s02.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="ch03s02.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="ch03s02.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.2.7.3. Informationen über den Bearbeiter"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-bearbeiter"></a>3.2.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.2.7.4. Informationen über den Verkäufer"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-verkaeufer"></a>3.2.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.2.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.2.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.2.7.6. Variablen für Lieferbedingungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-lieferbedingungen"></a>3.2.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.2.8. Variablen in Rechnungen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.invoice"></a>3.2.8. Variablen in Rechnungen</h3></div></div></div><div class="sect3" title="3.2.8.1. Allgemeine Variablen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-allgemein"></a>3.2.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.2.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.2.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">discount</code> |
|
| 402 |
</span></dt><dd><p>Rabatt als Betrag</p></dd><dt><span class="term"> |
|
| 403 |
<code class="varname">discount_sub</code> |
|
| 404 |
</span></dt><dd><p>Zwischensumme mit Rabatt</p></dd><dt><span class="term"> |
|
| 405 |
<code class="varname">drawing</code> |
|
| 406 |
</span></dt><dd><p>Zeichnung</p></dd><dt><span class="term"> |
|
| 407 |
<code class="varname">ean</code> |
|
| 408 |
</span></dt><dd><p>EAN-Code</p></dd><dt><span class="term"> |
|
| 409 |
<code class="varname">image</code> |
|
| 410 |
</span></dt><dd><p>Grafik</p></dd><dt><span class="term"> |
|
| 411 |
<code class="varname">linetotal</code> |
|
| 412 |
</span></dt><dd><p>Zeilensumme (Anzahl * Einzelpreis)</p></dd><dt><span class="term"> |
|
| 413 |
<code class="varname">longdescription</code> |
|
| 414 |
</span></dt><dd><p>Langtext</p></dd><dt><span class="term"> |
|
| 415 |
<code class="varname">microfiche</code> |
|
| 416 |
</span></dt><dd><p>Mikrofilm</p></dd><dt><span class="term"> |
|
| 417 |
<code class="varname">netprice</code> |
|
| 418 |
</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"> |
|
| 419 |
<code class="varname">nodiscount_linetotal</code> |
|
| 420 |
</span></dt><dd><p>Zeilensumme ohne Rabatt</p></dd><dt><span class="term"> |
|
| 421 |
<code class="varname">nodiscount_sub</code> |
|
| 422 |
</span></dt><dd><p>Zwischensumme ohne Rabatt</p></dd><dt><span class="term"> |
|
| 423 |
<code class="varname">number</code> |
|
| 424 |
</span></dt><dd><p>Artikelnummer</p></dd><dt><span class="term"> |
|
| 425 |
<code class="varname">ordnumber_oe</code> |
|
| 426 |
</span></dt><dd><p>Auftragsnummer des Originalauftrags, wenn die Rechnung |
|
| 427 |
aus einem Sammelauftrag erstellt wurde</p></dd><dt><span class="term"> |
|
| 428 |
<code class="varname">donumber_do</code> |
|
| 429 |
</span></dt><dd><p>Lieferscheinnummer desjenigen Lieferscheins, aus dem die Position stammt, sofern die Rechnung aus einem oder |
|
| 430 |
mehreren Lieferscheinen erstellt wurde</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_oe</code> |
|
| 460 |
</span></dt><dd><p>Auftragsdatum des Originalauftrags, wenn die Rechnung |
|
| 461 |
aus einem Sammelauftrag erstellt wurde</p></dd><dt><span class="term"> |
|
| 462 |
<code class="varname">unit</code> |
|
| 463 |
</span></dt><dd><p>Einheit</p></dd><dt><span class="term"> |
|
| 464 |
<code class="varname">weight</code> |
|
| 465 |
</span></dt><dd><p>Gewicht</p></dd></dl></div><p>Für jeden Posten gibt es ein Unterarray mit den Informationen |
|
| 466 |
über Lieferanten und Lieferantenartikelnummer. Diese müssen mit |
|
| 467 |
einer <code class="function">foreach</code>-Schleife ausgegeben werden, da |
|
| 468 |
für jeden Artikel mehrere Lieferanteninformationen hinterlegt sein |
|
| 469 |
können. Die Variablen dafür lauten:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 470 |
<code class="varname">make</code> |
|
| 471 |
</span></dt><dd><p>Lieferant</p></dd><dt><span class="term"> |
|
| 472 |
<code class="varname">model</code> |
|
| 473 |
</span></dt><dd><p>Lieferantenartikelnummer</p></dd></dl></div></div><div class="sect3" title="3.2.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.2.8.3. Variablen für die einzelnen Zahlungseingänge</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 474 |
<code class="varname">payment</code> |
|
| 475 |
</span></dt><dd><p>Betrag</p></dd><dt><span class="term"> |
|
| 476 |
<code class="varname">paymentaccount</code> |
|
| 477 |
</span></dt><dd><p>Konto</p></dd><dt><span class="term"> |
|
| 478 |
<code class="varname">paymentdate</code> |
|
| 479 |
</span></dt><dd><p>Datum</p></dd><dt><span class="term"> |
|
| 480 |
<code class="varname">paymentmemo</code> |
|
| 481 |
</span></dt><dd><p>Memo</p></dd><dt><span class="term"> |
|
| 482 |
<code class="varname">paymentsource</code> |
|
| 483 |
</span></dt><dd><p>Beleg</p></dd></dl></div></div><div class="sect3" title="3.2.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.benutzerdefinierte-variablen-vc"></a>3.2.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen</h4></div></div></div><p>Die vom Benutzer definierten Variablen für Kunden und |
|
| 484 |
Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen |
|
| 485 |
ebenfalls zur Verfügung. Ihre Namen setzen sich aus dem Präfix |
|
| 486 |
<code class="varname">vc_cvar_</code> und dem vom Benutzer festgelegten |
|
| 487 |
Variablennamen zusammen.</p><p>Beispiel: Der Benutzer hat eine Variable namens |
|
| 488 |
<code class="varname">number_of_employees</code> definiert, die die Anzahl der |
|
| 489 |
Mitarbeiter des Unternehmens enthält. Diese Variable steht dann |
|
| 490 |
unter dem Namen <code class="varname">vc_cvar_number_of_employees</code> zur |
|
| 491 |
Verfügung.</p></div></div><div class="sect2" title="3.2.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.2.9. Variablen in Mahnungen und Rechnungen über Mahngebühren</h3></div></div></div><div class="sect3" title="3.2.9.1. Namen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-vorlagennamen"></a>3.2.9.1. Namen der Vorlagen</h4></div></div></div><p>Die Namen der Vorlagen werden im System-Menü vom Benutzer |
|
| 492 |
eingegeben. Wird für ein Mahnlevel die Option zur automatischen |
|
| 493 |
Erstellung einer Rechnung über die Mahngebühren und Zinsen |
|
| 494 |
aktiviert, so wird der Name der Vorlage für diese Rechnung aus dem |
|
| 495 |
Vorlagenname für diese Mahnstufe mit dem Zusatz |
|
| 496 |
<code class="constant">_invoice</code> gebildet. Weiterhin werden die Kürzel |
|
| 497 |
für die ausgewählte Sprache und den ausgewählten Drucker |
|
| 498 |
angehängt.</p></div><div class="sect3" title="3.2.9.2. Allgemeine Variablen in Mahnungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-allgemein"></a>3.2.9.2. Allgemeine Variablen in Mahnungen</h4></div></div></div><p>Die Variablen des Verkäufers stehen wie gewohnt als |
|
| 499 |
<code class="varname">employee_...</code> zur Verfügung. Die Adressdaten des |
|
| 500 |
Kunden stehen als Variablen <code class="varname">name</code>, |
|
| 501 |
<code class="varname">street</code>, <code class="varname">zipcode</code>, |
|
| 502 |
<code class="varname">city</code>, <code class="varname">country</code>, |
|
| 503 |
<code class="varname">department_1</code>, <code class="varname">department_2</code>, |
|
| 504 |
und <code class="varname">email</code> zur Verfügung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 505 |
<code class="varname">dunning_date</code> |
|
| 506 |
</span></dt><dd><p>Datum der Mahnung</p></dd><dt><span class="term"> |
|
| 507 |
<code class="varname">dunning_duedate</code> |
|
| 508 |
</span></dt><dd><p>Fälligkeitsdatum für diese Mahhnung</p></dd><dt><span class="term"> |
|
| 509 |
<code class="varname">dunning_id</code> |
|
| 510 |
</span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term"> |
|
| 511 |
<code class="varname">fee</code> |
|
| 512 |
</span></dt><dd><p>Kummulative Mahngebühren</p></dd><dt><span class="term"> |
|
| 513 |
<code class="varname">interest_rate</code> |
|
| 514 |
</span></dt><dd><p>Zinssatz per anno in Prozent</p></dd><dt><span class="term"> |
|
| 515 |
<code class="varname">total_amount</code> |
|
| 516 |
</span></dt><dd><p>Gesamter noch zu zahlender Betrag als |
|
| 517 |
<code class="function">fee</code> + <code class="function">total_interest</code> |
|
| 518 |
+ <code class="function">total_open_amount</code> |
|
| 519 |
</p></dd><dt><span class="term"> |
|
| 520 |
<code class="varname">total_interest</code> |
|
| 521 |
</span></dt><dd><p>Zinsen per anno über alle Rechnungen</p></dd><dt><span class="term"> |
|
| 522 |
<code class="varname">total_open_amount</code> |
|
| 523 |
</span></dt><dd><p>Summe über alle offene Beträge der Rechnungen</p></dd></dl></div></div><div class="sect3" title="3.2.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.2.9.3. Variablen für jede gemahnte Rechnung in einer Mahnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 524 |
<code class="varname">dn_amount</code> |
|
| 525 |
</span></dt><dd><p>Rechnungssumme (brutto)</p></dd><dt><span class="term"> |
|
| 526 |
<code class="varname">dn_duedate</code> |
|
| 527 |
</span></dt><dd><p>Originales Fälligkeitsdatum der Rechnung</p></dd><dt><span class="term"> |
|
| 528 |
<code class="varname">dn_dunning_date</code> |
|
| 529 |
</span></dt><dd><p>Datum der Mahnung</p></dd><dt><span class="term"> |
|
| 530 |
<code class="varname">dn_dunning_duedate</code> |
|
| 531 |
</span></dt><dd><p>Fälligkeitsdatum der Mahnung</p></dd><dt><span class="term"> |
|
| 532 |
<code class="varname">dn_fee</code> |
|
| 533 |
</span></dt><dd><p>Kummulative Mahngebühr</p></dd><dt><span class="term"> |
|
| 534 |
<code class="varname">dn_interest</code> |
|
| 535 |
</span></dt><dd><p>Zinsen per anno für diese Rechnung</p></dd><dt><span class="term"> |
|
| 536 |
<code class="varname">dn_invnumber</code> |
|
| 537 |
</span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term"> |
|
| 538 |
<code class="varname">dn_linetotal</code> |
|
| 539 |
</span></dt><dd><p>Noch zu zahlender Betrag (ergibt sich aus |
|
| 540 |
<code class="varname">dn_open_amount</code> + <code class="varname">dn_fee</code> |
|
| 541 |
+ <code class="varname">dn_interest</code>)</p></dd><dt><span class="term"> |
|
| 542 |
<code class="varname">dn_netamount</code> |
|
| 543 |
</span></dt><dd><p>Rechnungssumme (netto)</p></dd><dt><span class="term"> |
|
| 544 |
<code class="varname">dn_open_amount</code> |
|
| 545 |
</span></dt><dd><p>Offener Rechnungsbetrag</p></dd><dt><span class="term"> |
|
| 546 |
<code class="varname">dn_ordnumber</code> |
|
| 547 |
</span></dt><dd><p>Bestellnummer</p></dd><dt><span class="term"> |
|
| 548 |
<code class="varname">dn_transdate</code> |
|
| 549 |
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term"> |
|
| 550 |
<code class="varname">dn_curr</code> |
|
| 551 |
</span></dt><dd><p>Währung, in der die Rechnung erstellt wurde. (Die |
|
| 552 |
Rechnungsbeträge sind aber immer in der Hauptwährung)</p></dd></dl></div></div><div class="sect3" title="3.2.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.2.9.4. Variablen in automatisch erzeugten Rechnungen über |
|
| 553 |
Mahngebühren</h4></div></div></div><p>Die Variablen des Verkäufers stehen wie gewohnt als |
|
| 554 |
<code class="varname">employee_...</code> zur Verfügung. Die Adressdaten des |
|
| 555 |
Kunden stehen als Variablen <code class="varname">name</code>, |
|
| 556 |
<code class="varname">street</code>, <code class="varname">zipcode</code>, |
|
| 557 |
<code class="varname">city</code>, <code class="varname">country</code>, |
|
| 558 |
<code class="varname">department_1</code>, <code class="varname">department_2</code>, |
|
| 559 |
und <code class="varname">email</code> zur Verfügung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 560 |
<code class="varname">duedate</code> |
|
| 561 |
</span></dt><dd><p>Fälligkeitsdatum der Rechnung</p></dd><dt><span class="term"> |
|
| 562 |
<code class="varname">dunning_id</code> |
|
| 563 |
</span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term"> |
|
| 564 |
<code class="varname">fee</code> |
|
| 565 |
</span></dt><dd><p>Mahngebühren</p></dd><dt><span class="term"> |
|
| 566 |
<code class="varname">interest</code> |
|
| 567 |
</span></dt><dd><p>Zinsen</p></dd><dt><span class="term"> |
|
| 568 |
<code class="varname">invamount</code> |
|
| 569 |
</span></dt><dd><p>Rechnungssumme (ergibt sich aus <code class="varname">fee</code> + |
|
| 570 |
<code class="varname">interest</code>)</p></dd><dt><span class="term"> |
|
| 571 |
<code class="varname">invdate</code> |
|
| 572 |
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term"> |
|
| 573 |
<code class="varname">invnumber</code> |
|
| 574 |
</span></dt><dd><p>Rechnungsnummer</p></dd></dl></div></div></div><div class="sect2" title="3.2.10. Variablen in anderen Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen"></a>3.2.10. Variablen in anderen Vorlagen</h3></div></div></div><div class="sect3" title="3.2.10.1. Einführung"><div class="titlepage"><div><div><h4 class="title"><a name="d0e5020"></a>3.2.10.1. Einführung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ähnlich wie in der |
|
| 575 |
Rechnung. Allerdings heißen die Variablen, die mit |
|
| 576 |
<code class="varname">inv</code> beginnen, jetzt anders. Bei den Angeboten |
|
| 577 |
fangen sie mit <code class="varname">quo</code> für "quotation" an: |
|
| 578 |
<code class="varname">quodate</code> für Angebotsdatum etc. Bei Bestellungen |
|
| 579 |
wiederum fangen sie mit <code class="varname">ord</code> für "order" an: |
|
| 580 |
<code class="varname">ordnumber</code> für Bestellnummer etc.</p><p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht |
|
| 581 |
vorhanden wie z.B. die für bereits verbuchte Zahlungseingänge. Dies |
|
| 582 |
sind Variablen, die vom Geschäftsablauf her in der entsprechenden |
|
| 583 |
Vorlage keine Bedeutung haben oder noch nicht belegt sein |
|
| 584 |
können.</p><p>Im Folgenden werden nur wichtige Unterschiede zu den Variablen |
|
| 585 |
in Rechnungen aufgeführt.</p></div><div class="sect3" title="3.2.10.2. Angebote und Preisanfragen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-quotations"></a>3.2.10.2. Angebote und Preisanfragen</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 586 |
<code class="varname">quonumber</code> |
|
| 587 |
</span></dt><dd><p>Angebots- bzw. Anfragenummer</p></dd><dt><span class="term"> |
|
| 588 |
<code class="varname">reqdate</code> |
|
| 589 |
</span></dt><dd><p>Gültigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei |
|
| 590 |
Preisanfragen)</p></dd><dt><span class="term"> |
|
| 591 |
<code class="varname">transdate</code> |
|
| 592 |
</span></dt><dd><p>Angebots- bzw. Anfragedatum</p></dd></dl></div></div><div class="sect3" title="3.2.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.2.10.3. Auftragsbestätigungen und Lieferantenaufträge</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 593 |
<code class="varname">ordnumber</code> |
|
| 594 |
</span></dt><dd><p>Auftragsnummer</p></dd><dt><span class="term"> |
|
| 595 |
<code class="varname">reqdate</code> |
|
| 596 |
</span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term"> |
|
| 597 |
<code class="varname">transdate</code> |
|
| 598 |
</span></dt><dd><p>Auftragsdatum</p></dd></dl></div></div><div class="sect3" title="3.2.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.2.10.4. Lieferscheine (Verkauf und Einkauf)</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 599 |
<code class="varname">cusordnumber</code> |
|
| 600 |
</span></dt><dd><p>Bestellnummer des Kunden (im Verkauf) bzw. Bestellnummer |
|
| 601 |
des Lieferanten (im Einkauf)</p></dd><dt><span class="term"> |
|
| 602 |
<code class="varname">donumber</code> |
|
| 603 |
</span></dt><dd><p>Lieferscheinnummer</p></dd><dt><span class="term"> |
|
| 604 |
<code class="varname">transdate</code> |
|
| 605 |
</span></dt><dd><p>Lieferscheindatum</p></dd></dl></div><p>Für jede Position eines Lieferscheines gibt es ein Unterarray |
|
| 606 |
mit den Informationen darüber, von welchem Lager und Lagerplatz aus |
|
| 607 |
die Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen |
|
| 608 |
Lagerplatz sie eingelagert wurden. Diese müssen mittels einer |
|
| 609 |
<code class="function">foreach</code>-Schleife ausgegeben werden. Diese |
|
| 610 |
Variablen sind:</p><div class="variablelist"><dl><dt><span class="term"> |
|
| 611 |
<code class="varname">si_bin</code> |
|
| 612 |
</span></dt><dd><p>Lagerplatz</p></dd><dt><span class="term"> |
|
| 613 |
<code class="varname">si_chargenumber</code> |
|
| 614 |
</span></dt><dd><p>Chargennummer</p></dd><dt><span class="term"> |
|
| 615 |
<code class="varname">si_bestbefore</code> |
|
| 616 |
</span></dt><dd><p>Mindesthaltbarkeit</p></dd><dt><span class="term"> |
|
| 617 |
<code class="varname">si_number</code> |
|
| 618 |
</span></dt><dd><p>Artikelnummer</p></dd><dt><span class="term"> |
|
| 619 |
<code class="varname">si_qty</code> |
|
| 620 |
</span></dt><dd><p>Anzahl bzw. Menge</p></dd><dt><span class="term"> |
|
| 621 |
<code class="varname">si_runningnumber</code> |
|
| 622 |
</span></dt><dd><p>Positionsnummer (1, 2, 3 etc)</p></dd><dt><span class="term"> |
|
| 623 |
<code class="varname">si_unit</code> |
|
| 624 |
</span></dt><dd><p>Einheit</p></dd><dt><span class="term"> |
|
| 625 |
<code class="varname">si_warehouse</code> |
|
| 626 |
</span></dt><dd><p>Lager</p></dd></dl></div></div><div class="sect3" title="3.2.10.5. Variablen für Sammelrechnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-statement"></a>3.2.10.5. Variablen für Sammelrechnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term"> |
|
| 627 |
<code class="varname">c0total</code> |
|
| 628 |
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit < 30 |
|
| 629 |
Tage</p></dd><dt><span class="term"> |
|
| 630 |
<code class="varname">c30total</code> |
|
| 631 |
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit >= 30 |
|
| 632 |
und < 60 Tage</p></dd><dt><span class="term"> |
|
| 633 |
<code class="varname">c60total</code> |
|
| 634 |
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit >= 60 |
|
| 635 |
und < 90 Tage</p></dd><dt><span class="term"> |
|
| 636 |
<code class="varname">c90total</code> |
|
| 637 |
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit >= 90 |
|
| 638 |
Tage</p></dd><dt><span class="term"> |
|
| 639 |
<code class="varname">total</code> |
|
| 640 |
</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"> |
|
| 641 |
<code class="varname">invnumber</code> |
|
| 642 |
</span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term"> |
|
| 643 |
<code class="varname">invdate</code> |
|
| 644 |
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term"> |
|
| 645 |
<code class="varname">duedate</code> |
|
| 646 |
</span></dt><dd><p>Fälligkeitsdatum</p></dd><dt><span class="term"> |
|
| 647 |
<code class="varname">amount</code> |
|
| 648 |
</span></dt><dd><p>Summe der Rechnung</p></dd><dt><span class="term"> |
|
| 649 |
<code class="varname">open</code> |
|
| 650 |
</span></dt><dd><p>Noch offener Betrag der Rechnung</p></dd><dt><span class="term"> |
|
| 651 |
<code class="varname">c0</code> |
|
| 652 |
</span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit < 30 |
|
| 653 |
Tage</p></dd><dt><span class="term"> |
|
| 654 |
<code class="varname">c30</code> |
|
| 655 |
</span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit >= 30 und |
|
| 656 |
< 60 Tage</p></dd><dt><span class="term"> |
|
| 657 |
<code class="varname">c60</code> |
|
| 658 |
</span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit >= 60 und |
|
| 659 |
< 90 Tage</p></dd><dt><span class="term"> |
|
| 660 |
<code class="varname">c90</code> |
|
| 661 |
</span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit >= 90 |
|
| 662 |
Tage</p></dd></dl></div></div></div><div class="sect2" title="3.2.11. Blöcke, bedingte Anweisungen und Schleifen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke"></a>3.2.11. Blöcke, bedingte Anweisungen und Schleifen</h3></div></div></div><div class="sect3" title="3.2.11.1. Einfürhung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.einfuehrung"></a>3.2.11.1. Einfürhung</h4></div></div></div><p>Der Parser kennt neben den Variablen einige weitere |
|
| 663 |
Konstrukte, die gesondert behandelt werden. Diese sind wie |
|
| 664 |
Variablennamen in spezieller Weise markiert: |
|
| 665 |
<span class="command"><strong><%anweisung%> ... <%end%></strong></span> |
|
| 666 |
</p><p>Anmerkung zum <span class="command"><strong><%end%></strong></span>: Der besseren |
|
| 667 |
Verständlichkeit halber kann man nach dem <span class="command"><strong>end</strong></span> |
|
| 668 |
noch beliebig weitere Wörter schreiben, um so zu markieren, welche |
|
| 669 |
Anweisung (z.B. <span class="command"><strong>if</strong></span> oder |
|
| 670 |
<span class="command"><strong>foreach</strong></span>) damit abgeschlossen wird.</p><p>Beispiel: Lautet der Beginn eines Blockes z.B. |
|
| 671 |
<span class="command"><strong><%if type == "sales_quotation"%></strong></span>, so könnte |
|
| 672 |
er mit <span class="command"><strong><%end%></strong></span> genauso abgeschlossen werden |
|
| 673 |
wie mit <span class="command"><strong><%end if%></strong></span> oder auch |
|
| 674 |
<span class="command"><strong><%end type == "sales_quotation"%></strong></span>.</p></div><div class="sect3" title="3.2.11.2. Der if-Block"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.if"></a>3.2.11.2. Der if-Block</h4></div></div></div><pre class="programlisting"><%if variablenname%> |
|
| 675 |
... |
|
| 676 |
<%end%></pre><p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" |
|
| 677 |
und dem "end" werden nur ausgegeben, wenn die Variable |
|
| 678 |
<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 |
|
| 679 |
<span class="command"><strong><%foreach variablenname%></strong></span> iteriert, so wird mit diesem Konstrukt darauf getestet, ob das Array Elemente |
|
| 680 |
enthält. Somit würde im folgenden Beispiel nur dann eine Liste von Zahlungseingängen samt ihrer Überschrift "Zahlungseingänge" |
|
| 681 |
ausgegeben, wenn tatsächlich welche getätigt wurden:</p><pre class="programlisting"><%if payment%> |
|
| 682 |
Zahlungseingänge: |
|
| 683 |
<%foreach payment%> |
|
| 684 |
Am <%paymentdate%>: <%payment%> € |
|
| 685 |
<%end foreach%> |
|
| 686 |
<%end if%></pre><p>Die Bedingung kann auch negiert werden, indem das Wort |
|
| 687 |
<code class="function">not</code> nach dem <code class="filename">if</code> verwendet |
|
| 688 |
wird. Beispiel:</p><pre class="programlisting"><%if not cp_greeting%> |
|
| 689 |
... |
|
| 690 |
<%end%></pre><p>Zusätzlich zu dem einfachen Test, ob eine Variable gesetzt ist |
|
| 691 |
oder nicht, bietet dieser Block auch die Möglichkeit, den Inhalt |
|
| 692 |
einer Variablen mit einer festen Zeichenkette oder einer anderen |
|
| 693 |
Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette |
|
| 694 |
oder einer anderen Variablen vorgenommen wird, hängt davon ab, ob |
|
| 695 |
die rechte Seite des Vergleichsoperators in Anführungszeichen |
|
| 696 |
gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit |
|
| 697 |
anderer Variablen). Zwei Beispiele, die beide Vergleiche |
|
| 698 |
zeigen:</p><pre class="programlisting"><%if var1 == "Wert"%></pre><p>Testet die Variable <code class="varname">var1</code> auf |
|
| 699 |
übereinstimmung mit der Zeichenkette <code class="constant">Wert</code>. |
|
| 700 |
Mittels <code class="function">!=</code> anstelle von <code class="function">==</code> |
|
| 701 |
würde auf Ungleichheit getestet.</p><pre class="programlisting"><%if var1 == var2%></pre><p>Testet die Variable <code class="varname">var1</code> auf |
|
| 702 |
übereinstimmung mit der Variablen <code class="varname">var2</code>. Mittel |
|
| 703 |
<code class="function">!=</code> anstelle von <code class="function">==</code> würde |
|
| 704 |
auf Ungleichheit getestet.</p><p>Erfahrere Benutzer können neben der Tests auf (Un-)Gleichheit |
|
| 705 |
auch Tests auf übereinstimmung mit regulären Ausdrücken ohne |
|
| 706 |
Berücksichtung der Groß- und Kleinschreibung durchführen. Dazu dient |
|
| 707 |
dieselbe Syntax wie oben nur mit <code class="function">=~</code> und |
|
| 708 |
<code class="function">!~</code> als Vergleichsoperatoren.</p><p>Beispiel für einen Test, ob die Variable |
|
| 709 |
<code class="varname">intnotes</code> (interne Bemerkungen) das Wort |
|
| 710 |
<code class="constant">schwierig</code> enthält:</p><pre class="programlisting"><%if intnotes =~ "schwierig"%></pre></div><div class="sect3" title="3.2.11.3. Der foreach-Block"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.foreach"></a>3.2.11.3. Der foreach-Block</h4></div></div></div><pre class="programlisting"><%foreach variablenname%> |
|
| 711 |
... |
|
| 712 |
<%end%></pre><p>Fügt die Zeilen zwischen den beiden Anweisungen so oft ein, |
|
| 713 |
wie das Perl-Array der Variablen <code class="varname">variablenname</code> |
|
| 714 |
Elemente enthät. Dieses Konstrukt wird zur Ausgabe der einzelnen |
|
| 715 |
Posten einer Rechnung / eines Angebots sowie zur Ausgabe der Steuern |
|
| 716 |
benutzt. In jedem Durchlauf werden die <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.invoice-posten" title="3.2.8.2. Variablen für jeden Posten auf der Rechnung">zeilenbezogenen |
|
| 717 |
Variablen</a> jeweils auf den Wert für die aktuelle Position |
|
| 718 |
gesetzt.</p><p>Die Syntax sieht normalerweise wie folgt aus:</p><pre class="programlisting"><%foreach number%> |
|
| 719 |
Position: <%runningnumber%> |
|
| 720 |
Anzahl: <%qty%> |
|
| 721 |
Artikelnummer: <%number%> |
|
| 722 |
Beschreibung: <%description%> |
|
| 723 |
... |
|
| 724 |
<%end%></pre><p>Besonderheit in OpenDocument-Vorlagen: Tritt ein |
|
| 725 |
<code class="function"><%foreach%></code>-Block innerhalb einer |
|
| 726 |
Tabellenzelle auf, so wird die komplette Tabellenzeile so oft |
|
| 727 |
wiederholt wie notwendig. Tritt er außerhalb auf, so wird nur der |
|
| 728 |
Inhalt zwischen <code class="function"><%foreach%></code> und |
|
| 729 |
<code class="function"><%end%></code> wiederholt, nicht aber die |
|
| 730 |
komplette Zeile, in der er steht.</p></div></div><div class="sect2" title="3.2.12. Markup-Code zur Textformatierung innerhalb von Formularen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.markup"></a>3.2.12. Markup-Code zur Textformatierung innerhalb von |
|
| 731 |
Formularen</h3></div></div></div><p>Wenn der Benutzer innhalb von Formularen in kivitendo Text |
|
| 732 |
anders formatiert haben möchte, so ist dies begrenzt möglich. |
|
| 733 |
kivitendo unterstützt die Textformatierung mit HTML-ähnlichen Tags. |
|
| 734 |
Der Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung |
|
| 735 |
Teile des Texts zwischen Start- und Endtags setzen. Dieser Teil wird |
|
| 736 |
dann automatisch in Anweisungen für das ausgewählte Vorlagenformat |
|
| 737 |
(HTML oder PDF über LaTeX) umgesetzt.</p><p>Die unterstützen Formatierungen sind:</p><div class="variablelist"><dl><dt><span class="term"><b>Text</b></span></dt><dd><p>Text wird in Fettdruck gesetzt.</p></dd><dt><span class="term"><i>Text</i></span></dt><dd><p>Text wird kursiv gesetzt.</p></dd><dt><span class="term"><u>Text</u></span></dt><dd><p>Text wird unterstrichen.</p></dd><dt><span class="term"><s>Text</s></span></dt><dd><p>Text wird durchgestrichen. Diese Formatierung ist nicht |
|
| 738 |
bei der Ausgabe als PDF über LaTeX verfügbar.</p></dd><dt><span class="term"><bullet></span></dt><dd><p>Erzeugt einen ausgefüllten Kreis für Aufzählungen (siehe |
|
| 739 |
unten).</p></dd></dl></div><p>Der Befehl <span class="command"><strong><bullet></strong></span> funktioniert |
|
| 740 |
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="ch03.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03s03.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Kapitel 3. Features und Funktionen </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 3.3. Excel-Vorlagen</td></tr></table></div></body></html> |
|
| 3 |
<title>3.2. Bankerweiterung</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="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="next" href="ch03s03.html" title="3.3. Dokumentenvorlagen und verfügbare Variablen"></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.2. Bankerweiterung</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Zurück</a> </td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right"> <a accesskey="n" href="ch03s03.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.2. Bankerweiterung"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="features.bank"></a>3.2. Bankerweiterung</h2></div></div></div><div class="sect2" title="3.2.1. Einführung"><div class="titlepage"><div><div><h3 class="title"><a name="features.bank.introduction"></a>3.2.1. Einführung</h3></div></div></div><p>Die Beschreibung der Bankerweiterung befindet sich derzeit noch im Wiki und soll von dort später hierhin übernommen werden:</p><p> |
|
| 4 |
<a class="ulink" href="http://redmine.kivitendo-premium.de/projects/forum/wiki/Bankerweiterung" target="_top">http://redmine.kivitendo-premium.de/projects/forum/wiki/Bankerweiterung</a> |
|
| 5 |
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03s03.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Kapitel 3. Features und Funktionen </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 3.3. Dokumentenvorlagen und verfügbare Variablen</td></tr></table></div></body></html> |
|
Auch abrufbar als: Unified diff
Dokumentation aktualisiert (html und pdf)