Globale Variablen für Druckvorlagen nach %::lx_office_conf verschoben
[kivitendo-erp.git] / doc / dokumentenvorlagen-und-variablen.html
1 <html>
2  <head>
3   <title>Dokumentenvorlagen und verf&uuml;gbare Variablen</title>
4   <style type="text/css">
5   <!--
6 .blue {
7            color: #000000;
8            background-color: #b0ecff;
9            border: 1px solid blue;
10            padding-left: 2px;
11            padding-right: 2px;
12            }
13
14 table {
15         color: #000000;
16         background-color: #fae8b8;
17         border: 1px solid #be5303;
18         border-collapse: collapse;
19         }
20
21 td {
22      border: 1px solid #be5303;
23      padding: 3px;
24      }
25     -->
26   </style>
27
28  </head>
29
30 <body>
31
32  <h1>Dokumentenvorlagen und verf&uuml;gbare Variablen</h1>
33
34  <p>geschrieben von <a href="mailto:m.bunkus@linet-services.de">Moritz
35    Bunkus</a>. Version: $Id$ </p>
36
37  <hr>
38
39  <h2><a name="inhaltsverzeichnis">Inhaltsverzeichnis</a></h2>
40
41  <ol>
42   <li><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
43     Inhaltsverzeichnis</a></li>
44
45   <li><a href="dokumentenvorlagen-und-variablen.html#einfuehrung">Einf&uuml;hrung</a>
46   </li>
47
48   <li><a href="dokumentenvorlagen-und-variablen.html#zuordnung_dateinamen">
49     Zuordnung von Dateinamen zu den Funktionen</a></li>
50
51   <li><a href="dokumentenvorlagen-und-variablen.html#tag_style">
52     Anfang und Ende der Tags ver&auml;ndern</a></li>
53
54   <li><a href="dokumentenvorlagen-und-variablen.html#allgemeine_variablen">
55     Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a><br>
56
57    <ol>
58     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_stammdaten">
59       Stammdaten von Kunden und Lieferanten</a></li>
60
61     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_bearbeiter">
62       Informationen &uuml;ber den Bearbeiter</a></li>
63
64     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_verkaeufer">
65       Informationen &uuml;ber den Verk&auml;ufer</a></li>
66
67     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_steuern">
68       Variablen f&uuml;r jede Steuer</a></li>
69    </ol>
70   </li>
71
72   <li><a href="dokumentenvorlagen-und-variablen.html#invoice">
73     Variablen in Rechnungen</a>
74
75    <ol>
76     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_allgemein">
77       Allgemeine Variablen</a></li>
78
79     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_posten">
80       Variablen f&uuml;r jeden Posten auf der Rechnung</a></li>
81
82     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_zahlungen">
83       Variablen f&uuml;r die Zahlungseing&auml;nge</a></li>
84
85     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_benutzerdefinierte_variablen_vc">
86       Benutzerdefinierte Kunden- und Lieferantenvariablen</a></li>
87    </ol>
88   </li>
89
90   <li><a href="dokumentenvorlagen-und-variablen.html#dunning">
91     Variablen in Mahnungen und Rechnungen &uuml;ber Mahngeb&uuml;hren</a>
92
93    <ol>
94     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_vorlagennamen">
95       Namen der Vorlagen</a></li>
96
97     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_allgemein">
98       Allgemeine Variablen in Mahnungen</a></li>
99
100     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_details">
101       Variablen f&uuml;r jede gemahnte Rechnung in einer Mahnung</a></li>
102
103     <li><a href="dokumentenvorlagen-und-variablen.html#dunning_invoice">
104       Variablen in automatisch erzeugten Rechnungen &uuml;ber Mahngeb&uuml;hren</a></li>
105    </ol>
106   </li>
107
108   <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
109     Variablen in anderen Vorlagen</a>
110
111    <ol>
112     <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_quotations">Angebote und Preisanfragen</a></li>
113     <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_orders">Auftragsbest&auml;tigungen und Lieferantenauftr&auml;ge</a></li>
114     <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_delivery_orders">Lieferscheine (Verkauf und Einkauf)</a></li>
115    </ol>
116   </li>
117
118   <li><a href="dokumentenvorlagen-und-variablen.html#bloecke">
119     Bl&ouml;cke, bedingte Anweisungen und Schleifen</a>
120
121    <ol>
122     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_if">
123       Der <code>if</code>-Block</a></li>
124
125     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_foreach">
126       Die <code>foreach</code>-Schleife</a></li>
127
128     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
129       Der <code>pagebreak</code>-Block</a></li>
130    </ol>
131   </li>
132
133   <li><a href="dokumentenvorlagen-und-variablen.html#markup">
134     Markup-Code, der innerhalb von Formularen zur Textformatierung verwendet
135     werden kann</a></li>
136
137  </ol>
138
139  <hr>
140
141  <h2><a name="einfuehrung">Einf&uuml;hrung</a></h2>
142
143  <p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und aller
144   zur Bearbeitung verf&uuml;gbaren Variablen. Eine Variable wird in
145   einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
146   <code>&lt;%variablenname%&gt;</code> verwendet wird. F&uuml;r LaTeX-
147   und HTML-Vorlagen kann man die Form dieser Tags auch
148   <a href="dokumentenvorlagen-und-variablen.html#tag_style">
149    ver&auml;ndern</a>.
150  </p>
151
152  <p>Fr&uuml;her wurde hier nur &uuml;ber LaTeX gesprochen. Inzwischen
153   unterst&uuml;tzt Lx-Office aber auch OpenDocument-Vorlagen. Sofern
154   es nicht ausdr&uuml;cklich eingeschr&auml;nkt wird, gilt das im
155   Folgenden gesagte f&uuml;r alle Vorlagenarten.</p>
156
157  <p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
158   verf&uuml;gbar als hier aufgelistet werden. Die meisten davon k&ouml;nnen
159   allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
160   werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann diese wie
161   folgt erhalten werden:</p>
162
163  <ol>
164
165   <li><code>SL/Form.pm</code> &ouml;ffnen und am Anfang die Zeile
166    <pre>"use Data::Dumper;"</pre> einf&uuml;gen.</li>
167
168   <li>In <code>Form.pm</code> die Funktion <code>parse_template</code>
169    suchen und hier die Zeile <pre>print(STDERR Dumper($self));</pre>
170    einf&uuml;gen.</li>
171
172   <li>Einmal per Browser die gew&uuml;nschte Vorlage "benutzen", z.B. ein PDF
173    f&uuml;r eine Rechnung erzeugen.</li>
174
175   <li>Im <code>error.log</code> vom Apache steht die Ausgabe der Variablen
176    <code>$self</code> in der Form <code>'key' =&gt; 'value',</code>. Alle
177    <code>key</code>s sind verf&uuml;gbar.</li>
178
179  </ol>
180
181  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
182    zum Inhaltsverzeichnis</a></small><br>
183  <hr>
184
185  <h2><a name="tag_style">
186    Anfang und Ende der Tags ver&auml;ndern</a></h2>
187
188  <p>Der Standardstil f&uuml;r Tags sieht vor, dass ein Tag mit dem
189   Kleinerzeichen und einem Prozentzeichen beginnt und mit dem
190   Prozentzeichen und dem Gr&ouml;&szlig;erzeichen endet,
191   beispielsweise <code>&lt;%customer%&gt;</code>. Da diese Form aber
192   z.B. in LaTeX zu Problemen f&uuml;hren kann, weil das Prozentzeichen
193   dort Kommentare einleitet, kann pro HTML- oder
194   LaTeX-Dokumentenvorlage der Stil umgestellt werden.</p>
195
196  <p>Dazu werden in die Datei Zeilen geschrieben, die mit dem f&uuml;r
197   das Format g&uuml;ltigen Kommentarzeichen anfangen,
198   dann <code>config:</code> enthalten, die entsprechende Option setzen
199   und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen
200   enden. Beispiel f&uuml;r LaTeX:</p>
201
202  <p><code>% config: tag-style=($ $)</code></p>
203
204  <p>Dies w&uuml;rde Lx-Office dazu veranlassen, Variablen zu ersetzen,
205   wenn sie wie folgt aussehen: <code>($customer$)</code>. Das
206   &auml;quivalente Beispiel f&uuml;r HTML-Dokumentenvorlagen sieht so
207   aus:</p>
208
209  <p><code>&lt;!-- config: tag-style=($ $) --&gt;</code></p>
210
211  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
212    zum Inhaltsverzeichnis</a></small><br>
213  <hr>
214
215  <h2><a name="zuordnung_dateinamen">
216    Zuordnung von den Dateinamen zu den Funktionen</a></h2>
217
218  <p>Diese folgende kurze Auflistung zeigt, welche Vorlage bei welcher
219   Funktion ausgelesen wird. Dabei ist die Dateiendung &quot;.ext&quot;
220   geeignet zu ersetzen: &quot;.tex&quot; f&uuml; LaTeX-Vorlagen und
221   &quot;.odt&quot; f&uuml;r OpenDocument-Vorlagen.</p>
222
223  <p>
224   <table border="1">
225    <tr>
226     <th>Dateiname</th>
227     <th>Bedeutung</th>
228    </tr>
229    <tr>
230     <td><code>bin_list.ext</code></td>
231     <td>Lagerliste</td>
232    </tr>
233    <tr>
234     <td><code>check.ext</code></td>
235     <td>?</td>
236    </tr>
237    <tr>
238     <td><code>invoice.ext</code></td>
239     <td>Rechnung</td>
240    </tr>
241    <tr>
242     <td><code>packing_list.ext</code></td>
243     <td>Packliste</td>
244    </tr>
245    <tr>
246     <td><code>pick_list.ext</code></td>
247     <td>Sammelliste</td>
248    </tr>
249    <tr>
250     <td><code>purchase_delivery_order.ext</code></td>
251     <td>Lieferschein (Einkauf)</td>
252    </tr>
253    <tr>
254     <td><code>purcharse_order.ext</code></td>
255     <td>Bestellung an Lieferanten</td>
256    </tr>
257    <tr>
258     <td><code>request_quotation.ext</code></td>
259     <td>Anfrage an Lieferanten</td>
260    </tr>
261    <tr>
262     <td><code>sales_delivery_order.ext</code></td>
263     <td>Lieferschein (Verkauf)</td>
264    </tr>
265    <tr>
266     <td><code>sales_order.ext</code></td>
267     <td>Bestellung</td>
268    </tr>
269    <tr>
270     <td><code>sales_quotation.ext</code></td>
271     <td>Angebot an Kunden</td>
272    </tr>
273    <tr>
274     <td><code>zahlungserinnerung.ext</code></td>
275     <td>Mahnung (Dateiname im Programm konfigurierbar)</td>
276    </tr>
277    <tr>
278     <td><code>zahlungserinnerung_invoice.ext</code></td>
279     <td>Rechnung &uuml;ber Mahngeb&uuml;hren (Dateiname im Programm konfigurierbar)</td>
280    </tr>
281   </table>
282  </p>
283
284  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
285    zum Inhaltsverzeichnis</a></small><br>
286  <hr>
287
288  <h2><a name="allgemeine_variablen">
289    Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a></h2>
290
291  <h3><a name="allgemein_stammdaten">
292    Stammdaten von Kunden und Lieferanten:</a></h3>
293
294  <p>
295   <table border="1">
296    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
297    <tr>
298     <td><code>account_number</code></td>
299     <td>Kontonummer</td>
300    </tr>
301    <tr>
302     <td><code>bank</code></td>
303     <td>Name der Bank</td>
304    </tr>
305    <tr>
306     <td><code>bank_code</code></td>
307     <td>Bankleitzahl</td>
308    </tr>
309    <tr>
310     <td><code>bic</code></td>
311     <td>Bank-Identifikations-Code (Bank Identifier Code, BIC)</td>
312    </tr>
313    <tr>
314     <td><code>business</code></td>
315     <td>Kunden-/Lieferantentyp</td>
316    </tr>
317    <tr>
318     <td><code>city</code></td>
319     <td>Stadt</td>
320    </tr>
321    <tr>
322     <td><code>contact</code></td>
323     <td>Kontakt</td>
324    </tr>
325    <tr>
326     <td><code>country</code></td>
327     <td>Land</td>
328    </tr>
329    <tr>
330     <td><code>cp_email</code></td>
331     <td>Email des Ansprechpartners</td>
332    </tr>
333    <tr>
334     <td><code>cp_givenname</code></td>
335     <td>Vorname des Ansprechpartners</td>
336    </tr>
337    <tr>
338     <td><code>cp_greeting</code></td>
339     <td>Anrede des Ansprechpartners</td>
340    </tr>
341    <tr>
342     <td><code>cp_name</code></td>
343     <td>Name des Ansprechpartners</td>
344    </tr>
345    <tr>
346     <td><code>cp_phone1</code></td>
347     <td>Telefonnummer 1 des Ansprechpartners</td>
348    </tr>
349    <tr>
350     <td><code>cp_phone2</code></td>
351     <td>Telefonnummer 2 des Ansprechpartners</td>
352    </tr>
353    <tr>
354     <td><code>cp_title</code></td>
355     <td>Titel des Ansprechpartners</td>
356    </tr>
357    <tr>
358     <td><code>creditlimit</code></td>
359     <td>Kreditlimit</td>
360    </tr>
361    <tr>
362     <td><code>customeremail</code></td>
363     <td>Email des Kunden; nur f&uuml;r Kunden</td>
364    </tr>
365    <tr>
366     <td><code>customerfax</code></td>
367     <td>Faxnummer des Kunden; nur f&uuml;r Kunden</td>
368    </tr>
369    <tr>
370     <td><code>customernotes</code></td>
371     <td>Bemerkungen beim Kunden; nur f&uuml;r Kunden</td>
372    </tr>
373    <tr>
374     <td><code>customernumber</code></td>
375     <td>Kundennummer; nur f&uuml;r Kunden</td>
376    </tr>
377    <tr>
378     <td><code>customerphone</code></td>
379     <td>Telefonnummer des Kunden; nur f&uuml;r Kunden</td>
380    </tr>
381    <tr>
382     <td><code>discount</code></td>
383     <td>Rabatt</td>
384    </tr>
385    <tr>
386     <td><code>email</code></td>
387     <td>Emailadresse</td>
388    </tr>
389    <tr>
390     <td><code>fax</code></td>
391     <td>Faxnummer</td>
392    </tr>
393    <tr>
394     <td><code>homepage</code></td>
395     <td>Homepage</td>
396    </tr>
397    <tr>
398     <td><code>iban</code></td>
399     <td>Internationale Kontonummer (International Bank Account Number, IBAN)</td>
400    </tr>
401    <tr>
402     <td><code>language</code></td>
403     <td>Sprache</td>
404    </tr>
405    <tr>
406     <td><code>name</code></td>
407     <td>Firmenname</td>
408    </tr>
409    <tr>
410     <td><code>payment_terms</code></td>
411     <td>Zahlungskonditionen</td>
412    </tr>
413    <tr>
414     <td><code>phone</code></td>
415     <td>Telefonnummer</td>
416    </tr>
417    <tr>
418     <td><code>shiptocity</code></td>
419     <td>Stadt (Lieferadresse)
420      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
421    </tr>
422    <tr>
423     <td><code>shiptocontact</code></td>
424     <td>Kontakt (Lieferadresse)
425      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
426    </tr>
427    <tr>
428     <td><code>shiptocountry</code></td>
429     <td>Land (Lieferadresse)
430      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
431    </tr>
432    <tr>
433     <td><code>shiptodepartment1</code></td>
434     <td>Abteilung 1 (Lieferadresse)
435      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
436    </tr>
437    <tr>
438     <td><code>shiptodepartment2</code></td>
439     <td>Abteilung 2 (Lieferadresse)
440      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
441    </tr>
442    <tr>
443     <td><code>shiptoemail</code></td>
444     <td>Email (Lieferadresse)
445      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
446    </tr>
447    <tr>
448     <td><code>shiptofax</code></td>
449     <td>Fax (Lieferadresse)
450      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
451    </tr>
452    <tr>
453     <td><code>shiptoname</code></td>
454     <td>Firmenname (Lieferadresse)
455      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
456    </tr>
457    <tr>
458     <td><code>shiptophone</code></td>
459     <td>Telefonnummer (Lieferadresse)
460      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
461    </tr>
462    <tr>
463     <td><code>shiptostreet</code></td>
464     <td>Stra&szlig;e und Hausnummer (Lieferadresse)
465      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
466    </tr>
467    <tr>
468     <td><code>shiptozipcode</code></td>
469     <td>Postleitzahl (Lieferadresse)
470      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
471    </tr>
472    <tr>
473     <td><code>street</code></td>
474     <td>Stra&szlig;e und Hausnummer</td>
475    </tr>
476    <tr>
477     <td><code>taxnumber</code></td>
478     <td>Steuernummer</td>
479    </tr>
480    <tr>
481     <td><code>ustid</code></td>
482     <td>Usatzsteuer-Identifikationsnummer</td>
483    </tr>
484    <tr>
485    <tr>
486     <td><code>vendoremail</code></td>
487     <td>Email des Lieferanten; nur f&uuml;r Lieferanten</td>
488    </tr>
489    <tr>
490     <td><code>vendorfax</code></td>
491     <td>Faxnummer des Lieferanten; nur f&uuml;r Lieferanten</td>
492    </tr>
493    <tr>
494     <td><code>vendornotes</code></td>
495     <td>Bemerkungen beim Lieferanten; nur f&uuml;r Lieferanten</td>
496    </tr>
497    <tr>
498     <td><code>vendornumber</code></td>
499     <td>Lieferantennummer; nur f&uuml;r Lieferanten</td>
500    </tr>
501    <tr>
502     <td><code>vendorphone</code></td>
503     <td>Telefonnummer des Lieferanten; nur f&uuml;r Lieferanten</td>
504    </tr>
505    <tr>
506     <td><code>zipcode</code></td>
507     <td>Postleitzahl</td>
508    </tr>
509   </table>
510  </p>
511
512  <p><a name="anmerkung_shipto"><em>Anmerkung</em></a>: Sind die
513   <code>shipto*</code>-Felder in den Stammdaten nicht eingetragen, so haben
514   die Variablen <code>shipto*</code> den gleichen Wert wie die die
515   entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich einige
516   <code>shipto*</code>-Variablen so nicht in den Stammdaten wiederfinden
517   sondern schlicht Kopien der Lieferdatenvariablen sind
518   (z.B. <code>shiptocontact</code>).</p>
519
520  <h3><a name="allgemein_bearbeiter">
521    Informationen &uuml;ber den Bearbeiter:</a></h3>
522
523  <p>
524   <table border="1">
525    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
526    <tr>
527     <td><code>employee_address</code></td>
528     <td>Adressfeld</td>
529    </tr>
530    <tr>
531     <td><code>employee_businessnumber</code></td>
532     <td>Firmennummer</td>
533    </tr>
534    <tr>
535     <td><code>employee_company</code></td>
536     <td>Firmenname</td>
537    </tr>
538    <tr>
539     <td><code>employee_co_ustid</code></td>
540     <td>Usatzsteuer-Identifikationsnummer</td>
541    </tr>
542    <tr>
543     <td><code>employee_duns</code></td>
544     <td>DUNS-Nummer</td>
545    </tr>
546    <tr>
547     <td><code>employee_email</code></td>
548     <td>Email</td>
549    </tr>
550    <tr>
551     <td><code>employee_fax</code></td>
552     <td>Fax</td>
553    </tr>
554    <tr>
555     <td><code>employee_name</code></td>
556     <td>voller Name</td>
557    </tr>
558    <tr>
559     <td><code>employee_signature</code></td>
560     <td>Signatur</td>
561    </tr>
562    <tr>
563     <td><code>employee_taxnumber</code></td>
564     <td>Steuernummer</td>
565    </tr>
566    <tr>
567     <td><code>employee_tel</code></td>
568     <td>Telefonnummer</td>
569    </tr>
570   </table>
571  </p>
572
573  <h3><a name="allgemein_verkaeufer">
574    Informationen &uuml;ber den Verk&auml;ufer (nur bei Verkaufsmasken):</a></h3>
575
576  <p>
577   <table border="1">
578    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
579    <tr>
580     <td><code>salesman_address</code></td>
581     <td>Adressfeld</td>
582    </tr>
583    <tr>
584     <td><code>salesman_businessnumber</code></td>
585     <td>Firmennummer</td>
586    </tr>
587    <tr>
588     <td><code>salesman_company</code></td>
589     <td>Firmenname</td>
590    </tr>
591    <tr>
592     <td><code>salesman_co_ustid</code></td>
593     <td>Usatzsteuer-Identifikationsnummer</td>
594    </tr>
595    <tr>
596     <td><code>salesman_duns</code></td>
597     <td>DUNS-Nummer</td>
598    </tr>
599    <tr>
600     <td><code>salesman_email</code></td>
601     <td>Email</td>
602    </tr>
603    <tr>
604     <td><code>salesman_fax</code></td>
605     <td>Fax</td>
606    </tr>
607    <tr>
608     <td><code>salesman_name</code></td>
609     <td>voller Name</td>
610    </tr>
611    <tr>
612     <td><code>salesman_signature</code></td>
613     <td>Signatur</td>
614    </tr>
615    <tr>
616     <td><code>salesman_taxnumber</code></td>
617     <td>Steuernummer</td>
618    </tr>
619    <tr>
620     <td><code>salesman_tel</code></td>
621     <td>Telefonnummer</td>
622    </tr>
623   </table>
624  </p>
625
626  <h3><a name="allgemein_steuern">
627    Variablen f&uuml;r die einzelnen Steuern:</a></h3>
628
629  <p>
630   <table border="1">
631    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
632    <tr>
633     <td><code>tax</code></td>
634     <td>Steuer</td>
635    </tr>
636    <tr>
637     <td><code>taxbase</code></td>
638     <td>zu versteuernder Betrag</td>
639    </tr>
640    <tr>
641     <td><code>taxdescription</code></td>
642     <td>Name der Steuer</td>
643    </tr>
644    <tr>
645     <td><code>taxrate</code></td>
646     <td>Steuersatz</td>
647    </tr>
648   </table>
649  </p>
650
651  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
652    zum Inhaltsverzeichnis</a></small><br>
653  <hr>
654
655  <h2><a name="invoice">Variablen in Rechnungen</a></h2>
656
657  <h3><a name="invoice_allgemein">Allgemeine Variablen:</a></h3>
658
659  <p>
660   <table border="1">
661    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
662    <tr>
663     <td><code>creditremaining</code></td>
664     <td>Verbleibender Kredit</td>
665    </tr>
666    <tr>
667     <td><code>currency</code></td>
668     <td>W&auml;hrung</td>
669    </tr>
670    <tr>
671     <td><code>cusordnumber</code></td>
672     <td>Bestellnummer beim Kunden</td>
673    </tr>
674    <tr>
675     <td><code>deliverydate</code></td>
676     <td>Lieferdatum</td>
677    </tr>
678    <tr>
679     <td><code>duedate</code></td>
680     <td>F&auml;lligkeitsdatum</td>
681    </tr>
682    <tr>
683     <td><code>globalprojectnumber</code></td>
684     <td>Projektnummer des ganzen Beleges</td>
685    </tr>
686    <tr>
687     <td><code>globalprojectdescription</code></td>
688     <td>Projekbeschreibung des ganzen Beleges</td>
689    </tr>
690    <tr>
691     <td><code>intnotes</code></td>
692     <td>Interne Bemerkungen</td>
693    </tr>
694    <tr>
695     <td><code>invdate</code></td>
696     <td>Rechnungsdatum</td>
697    </tr>
698    <tr>
699     <td><code>invnumber</code></td>
700     <td>Rechnungsnummer</td>
701    </tr>
702    <tr>
703     <td><code>invtotal</code></td>
704     <td>gesamter Rechnungsbetrag</td>
705    </tr>
706    <tr>
707     <td><code>notes</code></td>
708     <td>Bemerkungen der Rechnung</td>
709    </tr>
710    <tr>
711     <td><code>orddate</code></td>
712     <td>Auftragsdatum</td>
713    </tr>
714    <tr>
715     <td><code>ordnumber</code></td>
716     <td>Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde</td>
717    </tr>
718    <tr>
719     <td><code>payment_terms</code></td>
720     <td>Zahlungskonditionen</td>
721    </tr>
722    <tr>
723     <td><code>quodate</code></td>
724     <td>Angebotsdatum</td>
725    </tr>
726    <tr>
727     <td><code>quonumber</code></td>
728     <td>Angebotsnummer</td>
729    </tr>
730    <tr>
731     <td><code>shippingpoint</code></td>
732     <td>Versandort</td>
733    </tr>
734    <tr>
735     <td><code>shipvia</code></td>
736     <td>Transportmittel</td>
737    </tr>
738    <tr>
739     <td><code>subtotal</code></td>
740     <td>Zwischensumme aller Posten ohne Steuern</td>
741    </tr>
742    <tr>
743     <td><code>sumcarriedforward</code></td>
744     <td>Zwischensumme aller bisher ausgegebenen Posten. Sollte nur in einem
745      <a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
746       <code>pagebreak</code></a>-Block verwendet werden.</td>
747    </tr>
748    <tr>
749     <td><code>total</code></td>
750     <td>Restsumme der Rechnung (Summe abz&uuml;glich bereits bezahlter Posten)</td>
751    </tr>
752    <tr>
753     <td><code>transaction_description</code></td>
754     <td>Vorgangsbezeichnung</td>
755    </tr>
756    <tr>
757     <td><code>transdate</code></td>
758     <td>Auftragsdatum wenn die Rechnung aus einem Auftrag erstellt wurde</td>
759    </tr>
760   </table>
761  </p>
762
763  <h3><a name="invoice_posten">
764    Variablen f&uuml;r jeden Posten auf der Rechnung:</a></h3>
765
766  <p>
767   <table border="1">
768    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
769    <tr>
770     <td><code>bin</code></td>
771     <td>Stellage</td>
772    </tr>
773    <tr>
774     <td><code>description</code></td>
775     <td>Artikelbeschreibung</td>
776    </tr>
777    <tr>
778     <td><code>discount</code></td>
779     <td>Rabatt als Betrag</td>
780    </tr>
781    <tr>
782     <td><code>discount_sub</code></td>
783     <td>Zwischensumme mit Rabatt</td>
784    </tr>
785    <tr>
786     <td><code>drawing</code></td>
787     <td>Zeichnung</td>
788    </tr>
789    <tr>
790     <td><code>ean</code></td>
791     <td>EAN-Code</td>
792    </tr>
793    <tr>
794     <td><code>image</code></td>
795     <td>Grafik</td>
796    </tr>
797    <tr>
798     <td><code>linetotal</code></td>
799     <td>Zeilensumme (Anzahl * Einzelpreis)</td>
800    </tr>
801    <tr>
802     <td><code>longdescription</code></td>
803     <td>Langtext</td>
804    </tr>
805    <tr>
806     <td><code>microfiche</code></td>
807     <td>Mikrofilm</td>
808    </tr>
809    <tr>
810     <td><code>netprice</code></td>
811     <td>Nettopreis</td>
812    </tr>
813    <tr>
814     <td><code>nodiscount_linetotal</code></td>
815     <td>Zeilensumme ohne Rabatt</td>
816    </tr>
817    <tr>
818     <td><code>nodiscount_sub</code></td>
819     <td>Zwischensumme ohne Rabatt</td>
820    </tr>
821    <tr>
822     <td><code>number</code></td>
823     <td>Artikelnummer</td>
824    </tr>
825    <tr>
826     <td><code>ordnumber_oe</code></td>
827     <td>Auftragsnummer des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
828    </tr>
829    <tr>
830    <td><code>p_discount</code></td>
831     <td>Rabatt in Prozent</td>
832    </tr>
833    <tr>
834     <td><code>partnotes</code></td>
835     <td>Die beim Artikel gespeicherten Bemerkungen</td>
836    </tr>
837    <tr>
838     <td><code>partsgroup</code></td>
839     <td>Warengruppe</td>
840    </tr>
841    <tr>
842     <td><code>price_factor</code></td>
843     <td>Der Preisfaktor als Zahl, sofern einer eingestellt ist</td>
844    </tr>
845    <tr>
846     <td><code>price_factor_name</code></td>
847     <td>Der Name des Preisfaktors, sofern einer eingestellt ist</td>
848    </tr>
849    <tr>
850     <td><code>projectnumber</code></td>
851     <td>Projektnummer</td>
852    </tr>
853    <tr>
854     <td><code>projectdescription</code></td>
855     <td>Projektbeschreibung</td>
856    </tr>
857    <tr>
858     <td><code>qty</code></td>
859     <td>Anzahl</td>
860    </tr>
861    <tr>
862     <td><code>reqdate</code></td>
863     <td>Lieferdatum</td>
864    </tr>
865    <tr>
866     <td><code>runningnumber</code></td>
867     <td>Position auf der Rechnung (1, 2, 3...)</td>
868    </tr>
869    <tr>
870     <td><code>sellprice</code></td>
871     <td>Verkaufspreis</td>
872    </tr>
873    <tr>
874     <td><code>serialnumber</code></td>
875     <td>Seriennummer</td>
876    </tr>
877    <tr>
878     <td><code>transdate_oe</code></td>
879     <td>Auftragsdatum des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
880    </tr>
881    <tr>
882     <td><code>unit</code></td>
883     <td>Einheit</td>
884    </tr>
885    <tr>
886     <td><code>weight</code></td>
887     <td>Gewicht</td>
888    </tr>
889   </table>
890  </p>
891
892  <p>F&uuml;r jeden Posten gibt es ein Unterarray mit den Informationen &uuml;ber
893   Lieferanten und Lieferantenartikelnummer. Diese m&uuml;ssen mit
894   einer <code>foreach</code>-Schleife ausgegeben werden, da f&uuml;r jeden
895   Artikel mehrere Lieferanteninformationen hinterlegt sein k&ouml;nnen. Die
896   Variablen daf&uuml;r lauten:</p>
897
898  <p>
899   <table border="1">
900    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
901    <tr>
902     <td><code>make</code></td>
903     <td>Lieferant</td>
904    </tr>
905    <tr>
906     <td><code>model</code></td>
907     <td>Lieferantenartikelnummer</td>
908    </tr>
909   </table>
910  </p>
911
912  <h3><a name="invoice_zahlungen">
913    Variablen f&uuml;r die einzelnen Zahlungseing&auml;nge:</a></h3>
914
915  <p>
916   <table border="1">
917    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
918    <tr>
919     <td><code>payment</code></td>
920     <td>Betrag</td>
921    </tr>
922    <tr>
923     <td><code>paymentaccount</code></td>
924     <td>Konto</td>
925    </tr>
926    <tr>
927     <td><code>paymentdate</code></td>
928     <td>Datum</td>
929    </tr>
930    <tr>
931     <td><code>paymentmemo</code></td>
932     <td>Memo</td>
933    </tr>
934    <tr>
935     <td><code>paymentsource</code></td>
936     <td>Beleg</td>
937    </tr>
938   </table>
939  </p>
940
941  <h3><a name="invoice_benutzerdefinierte_variablen_vc">
942    Benutzerdefinierte Kunden- und Lieferantenvariablen:</a></h3>
943
944  <p>
945   Die vom Benutzer definierten Variablen f&uuml;r Kunden und
946   Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen
947   ebenfalls zur Verf&uuml;gung. Ihre Namen setzen sich aus dem
948   Pr&auml;fix <code>vc_cvar_</code> und dem vom Benutzer festgelegten
949   Variablennamen zusammen.</p>
950
951  <p>Beispiel: Der Benutzer hat eine Variable
952   namens <code>number_of_employees</code> definiert, die die Anzahl
953   der Mitarbeiter des Unternehmens enth&auml;lt. Diese Variable steht
954   dann unter dem Namen <code>vc_cvar_number_of_employees</code> zur
955   Verf&uuml;gung.</p>
956
957  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
958    zum Inhaltsverzeichnis</a></small><br>
959  <hr>
960
961  <h2><a name="dunning">Variablen in Mahnungen und Rechnungen &uuml;ber Mahngeb&uuml;hren</a></h2>
962
963  <h3><a name="dunning_vorlagennamen">Namen der Vorlagen</a></h3>
964
965  <p>Die Namen der Vorlagen werden im System-Men&uuml; vom Benutzer
966   eingegeben. Wird f&uuml;r ein Mahnlevel die Option zur automatischen
967   Erstellung einer Rechnung &uuml;ber die Mahngeb&uuml;hren und Zinsen
968   aktiviert, so wird der Name der Vorlage f&uuml;r diese Rechnung aus
969   dem Vorlagenname f&uuml;r diese Mahnstufe mit dem
970   Zusatz <code>_invoice</code> gebildet. Weiterhin werden die
971   K&uuml;rzel f&uuml;r die ausgew&auml;hlte Sprache und den
972   ausgew&auml;hlten Drucker angeh&auml;ngt.</p>
973
974  <h3><a name="dunning_allgemein">Allgemeine Variablen in Mahnungen:</a></h3>
975
976  <p>Die Variablen des Verk&auml;ufers stehen wie gewohnt
977   als <code>employee_...</code> zur Verf&uuml;gung. Die Adressdaten des
978   Kunden stehen als Variablen <code>name</code>, <code>street</code>,
979   <code>zipcode</code>, <code>city</code>, <code>country</code>,
980   <code>department_1</code>, <code>department_2</code>, und
981   <code>email</code> zur Verf&uuml;gung.
982  </p>
983
984  <p>Weitere Variablen beinhalten:</p>
985
986  <p>
987   <table border="1">
988    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
989    <tr>
990     <td><code>dunning_date</code></td>
991     <td>Datum der Mahnung</td>
992    </tr>
993    <tr>
994     <td><code>dunning_duedate</code></td>
995     <td>F&auml;lligkeitsdatum f&uuml;r diese Mahhnung</td>
996    </tr>
997    <tr>
998     <td><code>dunning_id</code></td>
999     <td>Mahnungsnummer</td>
1000    </tr>
1001    <tr>
1002     <td><code>fee</code></td>
1003     <td>Kummulative Mahngeb&uuml;hren</td>
1004    </tr>
1005    <tr>
1006     <td><code>interest_rate</code></td>
1007     <td>Zinssatz per anno in Prozent</td>
1008    </tr>
1009    <tr>
1010     <td><code>total_amount</code></td>
1011     <td>Gesamter noch zu zahlender Betrag als <code>fee</code> + <code>total_interest</code> + <code>total_open_amount</code></td>
1012    </tr>
1013    <tr>
1014     <td><code>total_interest</code></td>
1015     <td>Zinsen per anno &uuml;ber alle Rechnungen</td>
1016    </tr>
1017    <tr>
1018     <td><code>total_open_amount</code></td>
1019     <td>Summe &uuml;ber alle offene Betr&auml;ge der Rechnungen</td>
1020    </tr>
1021   </table>
1022  </p>
1023
1024  <h3><a name="dunning_details">
1025    Variablen f&uuml;r jede gemahnte Rechnung in einer Mahnung:</a></h3>
1026
1027  <p>
1028   <table border="1">
1029    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1030    <tr>
1031     <td><code>dn_amount</code></td>
1032     <td>Rechnungssumme (brutto)</td>
1033    </tr>
1034    <tr>
1035     <td><code>dn_duedate</code></td>
1036     <td>Originales F&auml;lligkeitsdatum der Rechnung</td>
1037    </tr>
1038    <tr>
1039     <td><code>dn_dunning_date</code></td>
1040     <td>Datum der Mahnung</td>
1041    </tr>
1042    <tr>
1043     <td><code>dn_dunning_duedate</code></td>
1044     <td>F&auml;lligkeitsdatum der Mahnung</td>
1045    </tr>
1046    <tr>
1047     <td><code>dn_fee</code></td>
1048     <td>Kummulative Mahngeb&uuml;hr</td>
1049    </tr>
1050    <tr>
1051     <td><code>dn_interest</code></td>
1052     <td>Zinsen per anno f&uuml;r diese Rechnung</td>
1053    </tr>
1054    <tr>
1055     <td><code>dn_invnumber</code></td>
1056     <td>Rechnungsnummer</td>
1057    </tr>
1058    <tr>
1059     <td><code>dn_linetotal</code></td>
1060     <td>Noch zu zahlender Betrag (ergibt sich aus <code>dn_open_amount + dn_fee + dn_interest</code>)</td>
1061    </tr>
1062    <tr>
1063     <td><code>dn_netamount</code></td>
1064     <td>Rechnungssumme (netto)</td>
1065    </tr>
1066    <tr>
1067     <td><code>dn_open_amount</code></td>
1068     <td>Offener Rechnungsbetrag</td>
1069    </tr>
1070    <tr>
1071     <td><code>dn_ordnumber</code></td>
1072     <td>Bestellnummer</td>
1073    </tr>
1074    <tr>
1075     <td><code>dn_transdate</code></td>
1076     <td>Rechnungsdatum</td>
1077    </tr>
1078   </table>
1079  </p>
1080
1081  <h3><a name="dunning_invoice">Variablen in automatisch erzeugten
1082    Rechnungen &uuml;ber Mahngeb&uuml;hren</a></h3>
1083
1084  <p>Die Variablen des Verk&auml;ufers stehen wie gewohnt
1085   als <code>employee_...</code> zur Verf&uuml;gung. Die Adressdaten des
1086   Kunden stehen als Variablen <code>name</code>, <code>street</code>,
1087   <code>zipcode</code>, <code>city</code>, <code>country</code>,
1088   <code>department_1</code>, <code>department_2</code>, und
1089   <code>email</code> zur Verf&uuml;gung.
1090  </p>
1091
1092  <p>Weitere Variablen beinhalten:</p>
1093
1094  <p>
1095   <table border="1">
1096    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1097    <tr>
1098     <td><code>duedate</code></td>
1099     <td>F&auml;lligkeitsdatum der Rechnung</td>
1100    </tr>
1101    <tr>
1102     <td><code>dunning_id</code></td>
1103     <td>Mahnungsnummer</td>
1104    </tr>
1105    <tr>
1106     <td><code>fee</code></td>
1107     <td>Mahngeb&uuml;hren</td>
1108    </tr>
1109    <tr>
1110     <td><code>interest</code></td>
1111     <td>Zinsen</td>
1112    </tr>
1113    <tr>
1114     <td><code>invamount</code></td>
1115     <td>Rechnungssumme (ergibt sich aus <code>fee + interest</code>)</td>
1116    </tr>
1117    <tr>
1118     <td><code>invdate</code></td>
1119     <td>Rechnungsdatum</td>
1120    </tr>
1121    <tr>
1122     <td><code>invnumber</code></td>
1123     <td>Rechnungsnummer</td>
1124    </tr>
1125   </table>
1126  </p>
1127
1128  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1129    zum Inhaltsverzeichnis</a></small><br>
1130  <hr>
1131
1132  <h2><a name="anderevorlagen">
1133    Variablen in anderen Vorlagen</a></h2>
1134
1135  <p>Die Variablen in anderen Vorlagen sind &auml;hnlich wie in der
1136   Rechnung. Allerdings hei&szlig;en die Variablen, die mit <code>inv</code>
1137   beginnen, jetzt anders. Bei den Angeboten fangen sie mit <code>quo</code>
1138   f&uuml;r "quotation" an: <code>quodate</code> f&uuml;r Angebotsdatum
1139   etc. Bei Bestellungen wiederum fangen sie mit <code>ord</code> f&uuml;r
1140   "order" an: <code>ordnumber</code> f&uuml;r Bestellnummer etc.</p>
1141
1142  <p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht vorhanden wie
1143   z.B. die f&uuml;r bereits verbuchte Zahlungseing&auml;nge. Dies sind
1144   Variablen, die vom Gesch&auml;ftsablauf her in der entsprechenden Vorlage
1145   keine Bedeutung haben oder noch nicht belegt sein k&ouml;nnen.</p>
1146
1147  <p>Im Folgenden werden nur wichtige Unterschiede zu den Variablen in
1148   Rechnungen aufgef&uuml;hrt.</p>
1149
1150  <h3><a name="anderevorlagen_quotations">Angebote und Preisanfragen</a></h3>
1151
1152  <p>
1153   <table border="1">
1154    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1155    <tr>
1156     <td><code>quonumber</code></td>
1157     <td>Angebots- bzw. Anfragenummer</td>
1158    </tr>
1159    <tr>
1160     <td><code>reqdate</code></td>
1161     <td>G&uuml;ltigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei Preisanfragen)</td>
1162    </tr>
1163    <tr>
1164     <td><code>transdate</code></td>
1165     <td>Angebots- bzw. Anfragedatum</td>
1166    </tr>
1167   </table>
1168  </p>
1169
1170  <h3><a name="anderevorlagen_orders">Auftragsbest&auml;tigungen und Lieferantenauftr&auml;ge</a></h3>
1171
1172  <p>
1173   <table border="1">
1174    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1175    <tr>
1176     <td><code>ordnumber</code></td>
1177     <td>Auftragsnummer</td>
1178    </tr>
1179    <tr>
1180     <td><code>reqdate</code></td>
1181     <td>Lieferdatum</td>
1182    </tr>
1183    <tr>
1184     <td><code>transdate</code></td>
1185     <td>Auftragsdatum</td>
1186    </tr>
1187   </table>
1188  </p>
1189
1190  <h3><a name="anderevorlagen_delivery_orders">Lieferscheine (Verkauf und Einkauf)</a></h3>
1191
1192  <p>
1193   <table border="1">
1194    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1195    <tr>
1196     <td><code>cusordnumber</code></td>
1197     <td>Bestellnummer des Kunden (im Verkauf) bzw. Bestellnummer des Lieferanten (im Einkauf)</td>
1198    </tr>
1199    <tr>
1200     <td><code>donumber</code></td>
1201     <td>Lieferscheinnummer</td>
1202    </tr>
1203    <tr>
1204     <td><code>transdate</code></td>
1205     <td>Lieferscheindatum</td>
1206    </tr>
1207   </table>
1208  </p>
1209
1210  <p>F&uuml;r jede Position eines Lieferscheines gibt es ein Unterarray mit
1211   den Informationen dar&uuml;ber, von welchem Lager und Lagerplatz aus die
1212   Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
1213   Lagerplatz sie eingelagert wurden. Diese m&uuml;ssen mittels
1214   einer <code>foreach</code>-Schleife ausgegeben werden. Diese
1215   Variablen sind:</p>
1216
1217  <p>
1218   <table border="1">
1219    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1220    <tr>
1221     <td><code>si_bin</code></td>
1222     <td>Lagerplatz</td>
1223    </tr>
1224    <tr>
1225     <td><code>si_chargenumber</code></td>
1226     <td>Chargennummer</td>
1227    </tr>
1228    <tr>
1229     <td><code>si_bestbefore</code></td>
1230     <td>Mindesthaltbarkeit</td>
1231    </tr>
1232    <tr>
1233     <td><code>si_number</code></td>
1234     <td>Artikelnummer</td>
1235    </tr>
1236    <tr>
1237     <td><code>si_qty</code></td>
1238     <td>Anzahl bzw. Menge</td>
1239    </tr>
1240    <tr>
1241     <td><code>si_runningnumber</code></td>
1242     <td>Positionsnummer (1, 2, 3 etc)</td>
1243    </tr>
1244    <tr>
1245     <td><code>si_unit</code></td>
1246     <td>Einheit</td>
1247    </tr>
1248    <tr>
1249     <td><code>si_warehouse</code></td>
1250     <td>Lager</td>
1251    </tr>
1252   </table>
1253  </p>
1254
1255  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1256    zum Inhaltsverzeichnis</a></small><br>
1257  <hr>
1258
1259  <h2><a name="bloecke">
1260    Bl&ouml;cke, bedingte Anweisungen und Schleifen</a></h2>
1261
1262  <p>Der Parser kennt neben den Variablen einige weitere Konstrukte,
1263   die gesondert behandelt werden. Diese sind wie Variablennamen in
1264   spezieller Weise markiert: <code>&lt;%anweisung%&gt;
1265   ... &lt;%end%&gt;</code></p>
1266
1267  <p>Anmerkung zum <code>&lt;%end%&gt;</code>: Der besseren
1268   Verständlichkeit halber kann man nach dem <code>end</code> noch
1269   beliebig weitere Wörter schreiben, um so zu markieren, welche
1270   Anweisung (z.B. <code>if</code> oder <code>foreach</code>) damit
1271   abgeschlossen wird.</p>
1272
1273  <p>Beispiel: Lautet der Beginn eines Blockes
1274    z.B. <code class="blue">&lt;%if type ==
1275    &quot;sales_quotation&quot;%&gt;</code>, so könnte er mit
1276   <code class="blue">&lt;%end%&gt;</code> genauso abgeschlossen werden
1277   wie mit
1278   <code class="blue">&lt;%end if%&gt;</code> oder auch
1279   <code class="blue">&lt;%end type ==
1280   &quot;sales_quotation&quot;%&gt;</code>.</p>
1281
1282  <h3><a name="bloecke_if">Der <code>if</code>-Block</a></h3>
1283
1284  <p class="blue"><code>&lt;%if variablenname%&gt;<br>
1285    ...<br>
1286    &lt;%end%&gt;</code></p>
1287
1288  <p>Eine normale &quot;if-then&quot;-Bedingung. Die Zeilen zwischen
1289   dem &quot;if&quot; und dem &quot;end&quot; werden nur ausgegeben,
1290   wenn die Variable &quot;variablenname&quot; gesetzt und ungleich 0
1291   ist.</p>
1292
1293  <p>Die Bedingung kann auch negiert werden, indem das Wort
1294   &quot;not&quot; nach dem &quot;if&quot; verwendet
1295   wird. Beispiel: <code class="blue">&lt;%if not
1296   cp_greeting%&gt;</code></p>
1297
1298  <p>Zusätzlich zu dem einfachen Test, ob eine Variable gesetzt ist
1299   oder nicht, bietet dieser Block auch die Möglichkeit, den Inhalt
1300   einer Variablen mit einer festen Zeichenkette oder einer anderen
1301   Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette
1302   oder einer anderen Variablen vorgenommen wird, hängt davon ab, ob
1303   die rechte Seite des Vergleichsoperators in Anführungszeichen
1304   gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit
1305   anderer Variablen). Zwei Beispiele, die beide Vergleiche zeigen:</p>
1306
1307  <p><code class="blue">&lt;%if var1 == &quot;Wert&quot;%&gt;</code>
1308   testet die Variable &quot;var1&quot; auf Übereinstimmung mit der
1309   Zeichenkette &quot;Wert&quot;. Mittels &quot;!=&quot; anstelle von
1310   &quot;==&quot; würde auf Ungleichheit getestet.</p>
1311
1312  <p><code class="blue">&lt;%if var1 == var2%&gt;</code> testet die
1313   Variable &quot;var1&quot; auf Übereinstimmung mit der Variablen
1314   &quot;var2&quot;. Mittels &quot;!=&quot; anstelle von &quot;==&quot;
1315   würde auf Ungleichheit getestet.</p>
1316
1317  <p>Erfahrere Benutzer können neben der Tests auf (Un-)Gleichheit auch
1318   Tests auf Übereinstimmung mit regulären Ausdrücken ohne
1319   Berücksichtung der Groß- und Kleinschreibung durchführen. Dazu dient
1320   dieselbe Syntax wie oben nur mit &quot;=~&quot; und &quot;!~&quot;
1321   als Vergleichsoperatoren.</p>
1322
1323  <p>Beispiel für einen Test, ob die Variable &quot;intnotes&quot;
1324   (interne Bemerkungen) das Wort &quot;schwierig&quot; enthält:
1325   <code class="blue">&lt;%if intnotes =~
1326   &quot;schwierig&quot;%&gt;</code></p>
1327
1328  <h3><a name="bloecke_foreach">Die <code>foreach</code>-Schleife</a></h3>
1329
1330  <p class="blue"><code>&lt;%foreach variablenname%&gt;<br>
1331    ...<br>
1332    &lt;%end%&gt;</code></p>
1333
1334  <p>F&uuml;gt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
1335   Perl-Array der Variablen "variablenname" Elemente enth&auml;t. Dieses
1336   Konstrukt wird zur Ausgabe der einzelnen Posten einer Rechnung / eines
1337   Angebots sowie zur Ausgabe der Steuern benutzt. In jedem Durchlauf werden
1338   die <a href="dokumentenvorlagen-und-variablen.html#invoice_posten">zeilenbezogenen
1339   Variablen</a> jeweils auf den Wert f&uuml;r die aktuelle Position
1340   gesetzt.</p>
1341
1342  <p>Die Syntax sieht normalerweise wie folgt aus:</p>
1343
1344  <p class="blue"><code>&lt;%foreach number%&gt;<br>
1345    Position: &lt;%runningnumber%&gt;<br>
1346    Anzahl: &lt;%qty%&gt;<br>
1347    Artikelnummer: &lt;%number%&gt;<br>
1348    Beschreibung: &lt;%description%&gt;<br>
1349    ...<br>
1350    &lt;%end%&gt;</code></p>
1351
1352  <p>Besonderheit in OpenDocument-Vorlagen: Tritt ein
1353   <code>&lt;%foreach%&gt;</code>-Block innerhalb einer Tabellenzelle
1354   auf, so wird die komplette Tabellenzeile so oft wiederholt wie
1355   notwendig. Tritt er au&szlig;erhalb auf, so wird nur der Inhalt
1356   zwischen <code>&lt;%foreach%&gt;</code> und <code>&lt;%end%&gt;</code>
1357   wiederholt, nicht aber die komplette Zeile, in der er steht.</p>
1358
1359  <h3><a name="bloecke_pagebreak">Der <code>pagebreak</code>-Block</a></h3>
1360
1361  <p class="blue"><code>&lt;%pagebreak ZpZ ZeS ZzS%&gt;<br>
1362    ...<br>
1363    &lt;%end%&gt;</code></p>
1364
1365  <p>Dieser Block existiert nur in LaTeX-Vorlagen.</p>
1366
1367  <p>Dieser Block legt das Verhalten beim manuellen Einf&uuml;gen eines
1368   Seitenumbruchs fest. Normalerweise bricht LaTeX die Seiten selber um. Beim
1369   Rechnungsdruck ist das oft nicht gew&uuml;nscht, oder man m&ouml;chte im
1370   Falle eines Seitenumbruchs den &Uuml;bertrag etc. mit ausgeben. Deswegen
1371   versucht der Parser, manuell Seitenumbr&uuml;che einzuf&uuml;gen,
1372   w&auml;hrend er einen <code>foreach</code>-Block auswertet, weil hier die
1373   manuellen Seitenumbr&uuml;che erforderlich werden. Daf&uuml;r ben&ouml;tigt
1374   der Parser aber drei Informationen:</p>
1375
1376  <p>
1377   <ol>
1378    <li>Wieviele Zeichen passen bei der Variablen "description" pro Posten
1379     in eine Zeile? Das ist der Parameter "ZpZ" (Zeichen pro Zeile).</li>
1380    <li>Wieviele Zeilen/Posten passen auf die erste Seite? Das
1381     ist der Parameter "ZeS" (Zeilen erste Seite).</li>
1382    <li>Wieviele Zeilen/Posten passen auf die zweite und alle nachfolgenden
1383     Seiten? Das ist der Parameter "ZzS" (Zeilen zweite Seite).</li>
1384   </ol>
1385  </p>
1386
1387  <p>Diese Parameter sind drei Zahlen, die manuell durch Verwendung von langen
1388   Warenbezeichnungen und Rechnungen mit vielen Posten bestimmt werden
1389   m&uuml;ssen.</p>
1390
1391  <p>&Uuml;blicherweise wird in diesem Block zuerst die aktuelle Tabelle
1392   geschlossen, eventuell Text eingef&uuml;gt (z.B. "Fortsetzung auf der
1393   n&auml;chsten Seite"), dann ein Seitenumbruch erzwungen, eventuell Text
1394   eingef&uuml;gt (z.B. "&Uuml;bertrag von der vorherigen Seite:
1395   &lt;%sumcarriedforward%&gt; EUR") und die Tabelle wieder ge&ouml;ffnet.</p>
1396
1397  <p>Wird kein manueller Seitenumbruch gew&uuml;scht, so kann dieser Block
1398   komplett entfallen.</p>
1399
1400  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1401    zum Inhaltsverzeichnis</a></small><br>
1402  <hr>
1403
1404  <h2><a name="markup">
1405    Markup-Code, der innerhalb von Formularen zur Textformatierung
1406    verwendet werden kann</a></h2>
1407
1408  <p>Wenn der Benutzer innhalb von Formularen in Lx-Office Text anders
1409   formatiert haben m&ouml;chte, so ist dies begrenzt m&ouml;glich. Lx-Office
1410   unterst&uuml;tzt die Textformatierung mit HTML-&auml;hnlichen Tags. Der
1411   Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung Teile des
1412   Texts zwischen Start- und Endtags setzen. Dieser Teil wird dann automatisch
1413   in Anweisungen f&uuml;r das ausgew&auml;hlte Vorlagenformat (HTML oder
1414   PDF &uuml;ber LaTeX) umgesetzt.</p>
1415
1416  <p>Die unterst&uuml;tzen Formatierungen sind:</p>
1417
1418  <p>
1419   <table border="1">
1420    <tr><th>Formatierung</th><th>Auswirkung</th></tr>
1421    <tr>
1422     <td><code>&lt;b&gt;Text&lt;/b&gt;</code></td>
1423     <td>Text wird in <b>fettdruck</b> gesetzt.</td>
1424    </tr>
1425    <tr>
1426     <td><code>&lt;i&gt;Text&lt;/i&gt;</code></td>
1427     <td>Text wird <i>kursiv</i> gesetzt.</td>
1428    </tr>
1429    <tr>
1430     <td><code>&lt;u&gt;Text&lt;/u&gt;</code></td>
1431     <td>Text wird <u>unterstrichen</u>.</td>
1432    </tr>
1433    <tr>
1434     <td><code>&lt;s&gt;Text&lt;/s&gt;</code></td>
1435     <td>Text wird <s>durchgestrichen</s>. Diese Formatierung ist nicht bei der
1436      Ausgabe als PDF &uuml;ber LaTeX verf&uuml;gbar.</td>
1437    </tr>
1438    <tr>
1439     <td><code>&lt;pagebreak&gt;</code></td>
1440     <td>Erzwingt einen Seitenumbruch (siehe unten).</td>
1441    </tr>
1442   </table>
1443  </p>
1444
1445  <p>Eine Besonderheit ist der Befehl <code>&lt;pagebreak&gt;</code>,
1446   der nur in LaTeX-Vorlagen funktioniert und in anderen Vorlagen
1447   einfach gel&ouml;scht wird. Dieser erzwingt unabh&auml;ngig von der
1448   im <a
1449   href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">pagebreak-Block</a>
1450   voreingestellten Werte einen Seitenumbruch nach der aktuellen
1451   Rechnungsposition. Dementsprechend funktioniert er nur innerhalb von
1452   <code>&lt;%foreach...%&gt;</code>-Schleifen. Weiterhin ben&ouml;tigt
1453   er kein Endtag.</p>
1454
1455  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1456    zum Inhaltsverzeichnis</a></small><br>
1457  <hr>
1458
1459 </body>
1460 </html>