Beim Verschicken von Einkaufs- und Verkaufsbelegen per Email nur dann speichern,...
[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#allgemeine_variablen">
52     Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a><br>
53
54    <ol>
55     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_stammdaten">
56       Stammdaten von Kunden und Lieferanten</a></li>
57
58     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_bearbeiter">
59       Informationen &uuml;ber den Bearbeiter</a></li>
60
61     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_verkaeufer">
62       Informationen &uuml;ber den Verk&auml;ufer</a></li>
63
64     <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_steuern">
65       Variablen f&uuml;r jede Steuer</a></li>
66    </ol>
67   </li>
68
69   <li><a href="dokumentenvorlagen-und-variablen.html#invoice">
70     Variablen in Rechnungen</a>
71
72    <ol>
73     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_allgemein">
74       Allgemeine Variablen</a></li>
75
76     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_posten">
77       Variablen f&uuml;r jeden Posten auf der Rechnung</a></li>
78
79     <li><a href="dokumentenvorlagen-und-variablen.html#invoice_zahlungen">
80       Variablen f&uuml;r die Zahlungseing&auml;nge</a></li>
81    </ol>
82   </li>
83
84   <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
85     Variablen in anderen Vorlagen</a></li>
86
87   <li><a href="dokumentenvorlagen-und-variablen.html#bloecke">
88     Bl&ouml;cke, bedingte Anweisungen und Schleifen</a>
89
90    <ol>
91     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_ifnot">
92       Der <code>if not</code>-Block</a></li>
93
94     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_if">
95       Der <code>if</code>-Block</a></li>
96
97     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_foreach">
98       Die <code>foreach</code>-Schleife</a></li>
99
100     <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
101       Der <code>pagebreak</code>-Block</a></li>
102    </ol>
103   </li>
104
105   <li><a href="dokumentenvorlagen-und-variablen.html#markup">
106     Markup-Code, der innerhalb von Formularen zur Textformatierung verwendet
107     werden kann</a></li>
108
109  </ol>
110
111  <hr>
112
113  <h2><a name="einfuehrung">Einf&uuml;hrung</a></h2>
114
115  <p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und aller
116   zur Bearbeitung verf&uuml;gbaren Variablen. Eine Variable wird in
117   einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
118   <code>&lt;%variablenname%&gt;</code> verwendet wird.</p>
119
120  <p>Fr&uuml;her wurde hier nur &uuml;ber LaTeX gesprochen. Inzwischen
121   unterst&uuml;tzt Lx-Office aber auch OpenDocument-Vorlagen. Sofern
122   es nicht ausdr&uuml;cklich eingeschr&auml;nkt wird, gilt das im
123   Folgenden gesagte f&uuml;r alle Vorlagenarten.</p>
124
125  <p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
126   verf&uuml;gbar als hier aufgelistet werden. Die meisten davon k&ouml;nnen
127   allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
128   werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann diese wie
129   folgt erhalten werden:</p>
130
131  <ol>
132
133   <li><code>SL/Form.pm</code> &ouml;ffnen und am Anfang die Zeile
134    <pre>"use Data::Dumper;"</pre> einf&uuml;gen.</li>
135
136   <li>In <code>Form.pm</code> die Funktion <code>parse_template</code>
137    suchen und hier die Zeile <pre>print(STDERR Dumper($self));</pre>
138    einf&uuml;gen.</li>
139
140   <li>Einmal per Browser die gew&uuml;nschte Vorlage "benutzen", z.B. ein PDF
141    f&uuml;r eine Rechnung erzeugen.</li>
142
143   <li>Im <code>error.log</code> vom Apache steht die Ausgabe der Variablen
144    <code>$self</code> in der Form <code>'key' =&gt; 'value',</code>. Alle
145    <code>key</code>s sind verf&uuml;gbar.</li>
146
147  </ol>
148
149  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
150    zum Inhaltsverzeichnis</a></small><br>
151  <hr>
152
153  <h2><a name="zuordnung_dateinamen">
154    Zuordnung von den Dateinamen zu den Funktionen</a></h2>
155
156  <p>Diese folgende kurze Auflistung zeigt, welche Vorlage bei welcher
157   Funktion ausgelesen wird. Dabei ist die Dateiendung &quot;.ext&quot;
158   geeignet zu ersetzen: &quot;.tex&quot; f&uuml; LaTeX-Vorlagen und
159   &quot;.odt&quot; f&uuml;r OpenDocument-Vorlagen.</p>
160
161  <ul>
162   <li><code>bin_list.ext</code> -- Lagerliste</li>
163   <li><code>check.ext</code> -- ?</li>
164   <li><code>invoice.ext</code> -- Rechnung</li>
165   <li><code>packing_list.ext</code> -- Verpackungsliste</li>
166   <li><code>pick_list.ext</code> -- Sammelliste</li>
167   <li><code>purcharse_order.ext</code> -- Bestellung an Lieferanten</li>
168   <li><code>request_quotation.ext</code> -- Anfrage an Lieferanten</li>
169   <li><code>sales_order.ext</code> -- Bestellung</li>
170   <li><code>sales_quotation.ext</code> -- Angebot an Kunden</li>
171  </ul>
172
173  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
174    zum Inhaltsverzeichnis</a></small><br>
175  <hr>
176
177  <h2><a name="allgemeine_variablen">
178    Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a></h2>
179
180  <h3><a name="allgemein_stammdaten">
181    Stammdaten von Kunden und Lieferanten:</a></h3>
182
183  <p>
184   <table border="1">
185    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
186    <tr>
187     <td><code>account_number</code></td>
188     <td>Kontonummer</td>
189    </tr>
190    <tr>
191     <td><code>bank</code></td>
192     <td>Name der Bank</td>
193    </tr>
194    <tr>
195     <td><code>bank_code</code></td>
196     <td>Bankleitzahl</td>
197    </tr>
198    <tr>
199     <td><code>business</code></td>
200     <td>Kunden-/Lieferantentyp</td>
201    </tr>
202    <tr>
203     <td><code>city</code></td>
204     <td>Stadt</td>
205    </tr>
206    <tr>
207     <td><code>contact</code></td>
208     <td>Kontakt</td>
209    </tr>
210    <tr>
211     <td><code>country</code></td>
212     <td>Land</td>
213    </tr>
214    <tr>
215     <td><code>cp_email</code></td>
216     <td>Email des Ansprechpartners</td>
217    </tr>
218    <tr>
219     <td><code>cp_givenname</code></td>
220     <td>Vorname des Ansprechpartners</td>
221    </tr>
222    <tr>
223     <td><code>cp_greeting</code></td>
224     <td>Anrede des Ansprechpartners</td>
225    </tr>
226    <tr>
227     <td><code>cp_name</code></td>
228     <td>Name des Ansprechpartners</td>
229    </tr>
230    <tr>
231     <td><code>cp_phone1</code></td>
232     <td>Telefonnummer 1 des Ansprechpartners</td>
233    </tr>
234    <tr>
235     <td><code>cp_phone2</code></td>
236     <td>Telefonnummer 2 des Ansprechpartners</td>
237    </tr>
238    <tr>
239     <td><code>cp_title</code></td>
240     <td>Titel des Ansprechpartners</td>
241    </tr>
242    <tr>
243     <td><code>creditlimit</code></td>
244     <td>Kreditlimit</td>
245    </tr>
246    <tr>
247     <td><code>customeremail</code></td>
248     <td>Email des Kunden; nur f&uuml;r Kunden</td>
249    </tr>
250    <tr>
251     <td><code>customerfax</code></td>
252     <td>Faxnummer des Kunden; nur f&uuml;r Kunden</td>
253    </tr>
254    <tr>
255     <td><code>customernotes</code></td>
256     <td>Bemerkungen beim Kunden; nur f&uuml;r Kunden</td>
257    </tr>
258    <tr>
259     <td><code>customernumber</code></td>
260     <td>Kundennummer; nur f&uuml;r Kunden</td>
261    </tr>
262    <tr>
263     <td><code>customerphone</code></td>
264     <td>Telefonnummer des Kunden; nur f&uuml;r Kunden</td>
265    </tr>
266    <tr>
267     <td><code>discount</code></td>
268     <td>Rabatt</td>
269    </tr>
270    <tr>
271     <td><code>email</code></td>
272     <td>Emailadresse</td>
273    </tr>
274    <tr>
275     <td><code>fax</code></td>
276     <td>Faxnummer</td>
277    </tr>
278    <tr>
279     <td><code>homepage</code></td>
280     <td>Homepage</td>
281    </tr>
282    <tr>
283     <td><code>language</code></td>
284     <td>Sprache</td>
285    </tr>
286    <tr>
287     <td><code>name</code></td>
288     <td>Firmenname</td>
289    </tr>
290    <tr>
291     <td><code>payment_terms</code></td>
292     <td>Zahlungskonditionen</td>
293    </tr>
294    <tr>
295     <td><code>phone</code></td>
296     <td>Telefonnummer</td>
297    </tr>
298    <tr>
299     <td><code>shiptocity</code></td>
300     <td>Stadt (Lieferadresse)
301      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
302    </tr>
303    <tr>
304     <td><code>shiptocontact</code></td>
305     <td>Kontakt (Lieferadresse)
306      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
307    </tr>
308    <tr>
309     <td><code>shiptocountry</code></td>
310     <td>Land (Lieferadresse)
311      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
312    </tr>
313    <tr>
314     <td><code>shiptodepartment1</code></td>
315     <td>Abteilung 1 (Lieferadresse)
316      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
317    </tr>
318    <tr>
319     <td><code>shiptodepartment2</code></td>
320     <td>Abteilung 2 (Lieferadresse)
321      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
322    </tr>
323    <tr>
324     <td><code>shiptoemail</code></td>
325     <td>Email (Lieferadresse)
326      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
327    </tr>
328    <tr>
329     <td><code>shiptofax</code></td>
330     <td>Fax (Lieferadresse)
331      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
332    </tr>
333    <tr>
334     <td><code>shiptoname</code></td>
335     <td>Firmenname (Lieferadresse)
336      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
337    </tr>
338    <tr>
339     <td><code>shiptophone</code></td>
340     <td>Telefonnummer (Lieferadresse)
341      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
342    </tr>
343    <tr>
344     <td><code>shiptostreet</code></td>
345     <td>Straße und Hausnummer (Lieferadresse)
346      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
347    </tr>
348    <tr>
349     <td><code>shiptozipcode</code></td>
350     <td>Postleitzahl (Lieferadresse)
351      <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
352    </tr>
353    <tr>
354     <td><code>street</code></td>
355     <td>Straße und Hausnummer</td>
356    </tr>
357    <tr>
358     <td><code>taxnumber</code></td>
359     <td>Steuernummer</td>
360    </tr>
361    <tr>
362     <td><code>vendoremail</code></td>
363     <td>Email des Lieferanten; nur f&uuml;r Lieferanten</td>
364    </tr>
365    <tr>
366     <td><code>vendorfax</code></td>
367     <td>Faxnummer des Lieferanten; nur f&uuml;r Lieferanten</td>
368    </tr>
369    <tr>
370     <td><code>vendornotes</code></td>
371     <td>Bemerkungen beim Lieferanten; nur f&uuml;r Lieferanten</td>
372    </tr>
373    <tr>
374     <td><code>vendornumber</code></td>
375     <td>Lieferantennummer; nur f&uuml;r Lieferanten</td>
376    </tr>
377    <tr>
378     <td><code>vendorphone</code></td>
379     <td>Telefonnummer des Lieferanten; nur f&uuml;r Lieferanten</td>
380    </tr>
381    <tr>
382     <td><code>zipcode</code></td>
383     <td>Postleitzahl</td>
384    </tr>
385   </table>
386  </p>
387
388  <p><a name="anmerkung_shipto"><em>Anmerkung</em></a>: Sind die
389   <code>shipto*</code>-Felder in den Stammdaten nicht eingetragen, so haben
390   die Variablen <code>shipto*</code> den gleichen Wert wie die die
391   entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich einige
392   <code>shipto*</code>-Variablen so nicht in den Stammdaten wiederfinden
393   sondern schlicht Kopien der Lieferdatenvariablen sind
394   (z.B. <code>shiptocontact</code>).</p>
395
396  <h3><a name="allgemein_bearbeiter">
397    Informationen &uuml;ber den Bearbeiter:</a></h3>
398
399  <p>
400   <table border="1">
401    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
402    <tr>
403     <td><code>employee_address</code></td>
404     <td>Adressfeld</td>
405    </tr>
406    <tr>
407     <td><code>employee_businessnumber</code></td>
408     <td>Firmennummer</td>
409    </tr>
410    <tr>
411     <td><code>employee_company</code></td>
412     <td>Firmenname</td>
413    </tr>
414    <tr>
415     <td><code>employee_co_ustid</code></td>
416     <td>Usatzsteuer-Identifikationsnummer</td>
417    </tr>
418    <tr>
419     <td><code>employee_duns</code></td>
420     <td>DUNS-Nummer</td>
421    </tr>
422    <tr>
423     <td><code>employee_email</code></td>
424     <td>Email</td>
425    </tr>
426    <tr>
427     <td><code>employee_fax</code></td>
428     <td>Fax</td>
429    </tr>
430    <tr>
431     <td><code>employee_name</code></td>
432     <td>voller Name</td>
433    </tr>
434    <tr>
435     <td><code>employee_signature</code></td>
436     <td>Signatur</td>
437    </tr>
438    <tr>
439     <td><code>employee_taxnumber</code></td>
440     <td>Steuernummer</td>
441    </tr>
442    <tr>
443     <td><code>employee_tel</code></td>
444     <td>Telefonnummer</td>
445    </tr>
446   </table>
447  </p>
448
449  <h3><a name="allgemein_verkaeufer">
450    Informationen &uuml;ber den Verk&auml;fer (nur bei Verkaufsmasken):</a></h3>
451
452  <p>
453   <table border="1">
454    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
455    <tr>
456     <td><code>salesman_address</code></td>
457     <td>Adressfeld</td>
458    </tr>
459    <tr>
460     <td><code>salesman_businessnumber</code></td>
461     <td>Firmennummer</td>
462    </tr>
463    <tr>
464     <td><code>salesman_company</code></td>
465     <td>Firmenname</td>
466    </tr>
467    <tr>
468     <td><code>salesman_co_ustid</code></td>
469     <td>Usatzsteuer-Identifikationsnummer</td>
470    </tr>
471    <tr>
472     <td><code>salesman_duns</code></td>
473     <td>DUNS-Nummer</td>
474    </tr>
475    <tr>
476     <td><code>salesman_email</code></td>
477     <td>Email</td>
478    </tr>
479    <tr>
480     <td><code>salesman_fax</code></td>
481     <td>Fax</td>
482    </tr>
483    <tr>
484     <td><code>salesman_name</code></td>
485     <td>voller Name</td>
486    </tr>
487    <tr>
488     <td><code>salesman_signature</code></td>
489     <td>Signatur</td>
490    </tr>
491    <tr>
492     <td><code>salesman_taxnumber</code></td>
493     <td>Steuernummer</td>
494    </tr>
495    <tr>
496     <td><code>salesman_tel</code></td>
497     <td>Telefonnummer</td>
498    </tr>
499   </table>
500  </p>
501
502  <h3><a name="allgemein_steuern">
503    Variablen f&uuml;r die einzelnen Steuern:</a></h3>
504
505  <p>
506   <table border="1">
507    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
508    <tr>
509     <td><code>tax</code></td>
510     <td>Steuer</td>
511    </tr>
512    <tr>
513     <td><code>taxbase</code></td>
514     <td>zu versteuernder Betrag</td>
515    </tr>
516    <tr>
517     <td><code>taxdescription</code></td>
518     <td>Name der Steuer</td>
519    </tr>
520    <tr>
521     <td><code>taxrate</code></td>
522     <td>Steuersatz</td>
523    </tr>
524   </table>
525  </p>
526
527  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
528    zum Inhaltsverzeichnis</a></small><br>
529  <hr>
530
531  <h2><a name="invoice">Variablen in Rechnungen</a></h2>
532
533  <h3><a name="invoice_allgemein">Allgemeine Variablen:</a></h3>
534
535  <p>
536   <table border="1">
537    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
538    <tr>
539     <td><code>creditremaining</code></td>
540     <td>Verbleibender Kredit</td>
541    </tr>
542    <tr>
543     <td><code>currency</code></td>
544     <td>Währung</td>
545    </tr>
546    <tr>
547     <td><code>cusordnumber</code></td>
548     <td>Bestellnummer beim Kunden</td>
549    </tr>
550    <tr>
551     <td><code>deliverydate</code></td>
552     <td>Lieferdatum</td>
553    </tr>
554    <tr>
555     <td><code>duedate</code></td>
556     <td>Fälligkeitsdatum</td>
557    </tr>
558    <tr>
559     <td><code>globalprojectnumber</code></td>
560     <td>Projektnummer des ganzen Beleges</td>
561    </tr>
562    <tr>
563     <td><code>intnotes</code></td>
564     <td>Interne Bemerkungen</td>
565    </tr>
566    <tr>
567     <td><code>invdate</code></td>
568     <td>Rechnungsdatum</td>
569    </tr>
570    <tr>
571     <td><code>invnumber</code></td>
572     <td>Rechnungsnummer</td>
573    </tr>
574    <tr>
575     <td><code>invtotal</code></td>
576     <td>gesamter Rechnungsbetrag</td>
577    </tr>
578    <tr>
579     <td><code>notes</code></td>
580     <td>Bemerkungen der Rechnung</td>
581    </tr>
582    <tr>
583     <td><code>orddate</code></td>
584     <td>Auftragsdatum</td>
585    </tr>
586    <tr>
587     <td><code>ordnumber</code></td>
588     <td>Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde</td>
589    </tr>
590    <tr>
591     <td><code>payment_terms</code></td>
592     <td>Zahlungskonditionen</td>
593    </tr>
594    <tr>
595     <td><code>quodate</code></td>
596     <td>Angebotsdatum</td>
597    </tr>
598    <tr>
599     <td><code>quonumber</code></td>
600     <td>Angebotsnummer</td>
601    </tr>
602    <tr>
603     <td><code>shippingpoint</code></td>
604     <td>Versandort</td>
605    </tr>
606    <tr>
607     <td><code>shipvia</code></td>
608     <td>Transportmittel</td>
609    </tr>
610    <tr>
611     <td><code>subtotal</code></td>
612     <td>Zwischensumme aller Posten ohne Steuern</td>
613    </tr>
614    <tr>
615     <td><code>sumcarriedforward</code></td>
616     <td>Zwischensumme aller bisher ausgegebenen Posten. Sollte nur in einem
617      <a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
618       <code>pagebreak</code></a>-Block verwendet werden.</td>
619    </tr>
620    <tr>
621     <td><code>total</code></td>
622     <td>Restsumme der Rechnung (Summe abz&uuml;glich bereits bezahlter Posten)</td>
623    </tr>
624    <tr>
625     <td><code>transdate</code></td>
626     <td>Auftragsdatum wenn die Rechnung aus einem Auftrag erstellt wurde</td>
627    </tr>
628   </table>
629  </p>
630
631  <h3><a name="invoice_posten">
632    Variablen f&uuml;r jeden Posten auf der Rechnung:</a></h3>
633
634  <p>
635   <table border="1">
636    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
637    <tr>
638     <td><code>assembly</code></td>
639     <td>Erzeugnis</td>
640    </tr>
641    <tr>
642     <td><code>bin</code></td>
643     <td>Stellage</td>
644    </tr>
645    <tr>
646     <td><code>deliverydate_oe</code></td>
647     <td>Lieferdatum</td>
648    </tr>
649    <tr>
650     <td><code>description</code></td>
651     <td>Artikelbeschreibung</td>
652    </tr>
653    <tr>
654     <td><code>discount</code></td>
655     <td>Rabatt als Betrag</td>
656    </tr>
657    <tr>
658     <td><code>linetotal</code></td>
659     <td>Zeilensumme (Anzahl * Einzelpreis)</td>
660    </tr>
661    <tr>
662     <td><code>listprice</code></td>
663     <td>Listenpreis</td>
664    </tr>
665    <tr>
666     <td><code>netprice</code></td>
667     <td>Nettopreis</td>
668    </tr>
669    <tr>
670     <td><code>number</code></td>
671     <td>Artikelnummer</td>
672    </tr>
673    <tr>
674     <td><code>ordnumber_oe</code></td>
675     <td>Auftragsnummer des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
676    </tr>
677    <tr>
678    <td><code>p_discount</code></td>
679     <td>Rabatt in Prozent</td>
680    </tr>
681    <tr>
682     <td><code>partnotes</code></td>
683     <td>Die beim Artikel gespeicherten Bemerkungen</td>
684    </tr>
685    <tr>
686     <td><code>partsgroup</code></td>
687     <td>Warengruppe</td>
688    </tr>
689    <tr>
690     <td><code>projectnumber</code></td>
691     <td>Projektnummer</td>
692    </tr>
693    <tr>
694     <td><code>qty</code></td>
695     <td>Anzahl</td>
696    </tr>
697    <tr>
698     <td><code>runningnumber</code></td>
699     <td>Position auf der Rechnung (1, 2, 3...)</td>
700    </tr>
701    <tr>
702     <td><code>sellprice</code></td>
703     <td>Verkaufspreis</td>
704    </tr>
705    <tr>
706     <td><code>serialnumber</code></td>
707     <td>Seriennummer</td>
708    </tr>
709    <tr>
710     <td><code>transdate_oe</code></td>
711     <td>Auftragsdatum des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
712    </tr>
713    <tr>
714     <td><code>unit</code></td>
715     <td>Einheit</td>
716    </tr>
717   </table>
718  </p>
719
720  <h3><a name="invoice_zahlungen">
721    Variablen f&uuml;r die einzelnen Zahlungseingänge:</a></h3>
722
723  <p>
724   <table border="1">
725    <tr><th>Variablenname</th><th>Bedeutung</th></tr>
726    <tr>
727     <td><code>datepaid</code></td>
728     <td>Datum</td>
729    </tr>
730    <tr>
731     <td><code>memo</code></td>
732     <td>Memo</td>
733    </tr>
734    <tr>
735     <td><code>paid</code></td>
736     <td>Betrag</td>
737    </tr>
738    <tr>
739     <td><code>source</code></td>
740     <td>Beleg</td>
741    </tr>
742    <tr>
743     <td><code>exchangerate</code></td>
744     <td>Wechselkurs</td>
745    </tr>
746    <tr>
747     <td><code>forex</code></td>
748     <td>Konto</td>
749    </tr>
750   </table>
751  </p>
752
753  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
754    zum Inhaltsverzeichnis</a></small><br>
755  <hr>
756
757  <h2><a name="anderevorlagen">
758    Variablen in anderen Vorlagen</a></h2>
759
760  <p>Die Variablen in anderen Vorlagen sind &auml;hnlich wie in der
761   Rechnung. Allerdings hei&szlig;en die Variablen, die mit <code>inv</code>
762   beginnen, jetzt anders. Bei den Angeboten fangen sie mit <code>quo</code>
763   f&uuml;r "quotation" an: <code>quodate</code> f&uuml;r Angebotsdatum
764   etc. Bei Bestellungen wiederum fangen sie mit <code>ord</code> f&uuml;r
765   "order" an: <code>ordnumber</code> f&uuml;r Bestellnummer etc.</p>
766
767  <p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht vorhanden wie
768   z.B. die f&uuml;r bereits verbuchte Zahlungseing&auml;nge. Dies sind
769   Variablen, die vom Gesch&auml;ftsablauf her in der entsprechenden Vorlage
770   keine Bedeutung haben oder noch nicht belegt sein k&ouml;nnen.</p>
771
772  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
773    zum Inhaltsverzeichnis</a></small><br>
774  <hr>
775
776  <h2><a name="bloecke">
777    Bl&ouml;cke, bedingte Anweisungen und Schleifen</a></h2>
778
779  <p>Der Parser kennt neben den Variablen einige weitere Konstrukte, die
780   gesondert behandelt werden. Diese sind wie Variablennamen in spezieller
781   Weise markiert: <code>&lt;%anweisung%&gt;</code></p>
782
783  <h3><a name="bloecke_ifnot">Der <code>if not</code>-Block</a></h3>
784
785  <p class="blue"><code>&lt;%if not variablenname%&gt;<br>
786    ...<br>
787    &lt;%end&gt;</code></p>
788
789  <p>Eine normale "if-not-then"-Bedingung. Die Zeilen zwischen dem "if not" und
790   dem "end" werden nur ausgegeben, wenn die Variable "variablenname" nicht
791   gesetzt oder gleich 0 ist.</p>
792
793  <h3><a name="bloecke_if">Der <code>if</code>-Block</a></h3>
794
795  <p class="blue"><code>&lt;%if variablenname%&gt;<br>
796    ...<br>
797    &lt;%end&gt;</code></p>
798
799  <p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" und dem
800   "end" werden nur ausgegeben, wenn die Variable "variablenname" gesetzt und
801   ungleich 0 ist.</p>
802
803  <h3><a name="bloecke_foreach">Die <code>foreach</code>-Schleife</a></h3>
804
805  <p class="blue"><code>&lt;%foreach variablenname%&gt;<br>
806    ...<br>
807    &lt;%end&gt;</code></p>
808
809  <p>F&uuml;gt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
810   Perl-Array der Variablen "variablenname" Elemente enth&auml;t. Dieses
811   Konstrukt wird zur Ausgabe der einzelnen Posten einer Rechnung / eines
812   Angebots sowie zur Ausgabe der Steuern benutzt. In jedem Durchlauf werden
813   die <a href="dokumentenvorlagen-und-variablen.html#invoice_posten">zeilenbezogenen
814   Variablen</a> jeweils auf den Wert f&uuml;r die aktuelle Position
815   gesetzt.</p>
816
817  <p>Die Syntax sieht normalerweise wie folgt aus:</p>
818
819  <p class="blue"><code>&lt;%foreach number%&gt;<br>
820    Position: &lt;%runningnumber%&gt;<br>
821    Anzahl: &lt;%qty%&gt;<br>
822    Artikelnummer: &lt;%number%&gt;<br>
823    Beschreibung: &lt;%description%&gt;<br>
824    ...<br>
825    &lt;%end&gt;</code></p>
826
827  <p>Besonderheit in OpenDocument-Vorlagen: Tritt ein
828   <code>&lt;foreach&gt;</code>-Block innerhalb einer Tabellenzelle
829   auf, so wird die komplette Tabellenzeile so oft wiederholt wie
830   notwendig. Tritt er au&szlig;erhalb auf, so wird nur der Inhalt
831   zwischen <code>&lt;foreach&gt;</code> und <code>&lt;end&gt;</code>
832   wiederholt, nicht aber die komplette Zeile, in der er steht.</p>
833
834  <h3><a name="bloecke_pagebreak">Der <code>pagebreak</code>-Block</a></h3>
835
836  <p class="blue"><code>&lt;%pagebreak ZpZ ZeS ZzS%&gt;<br>
837    ...<br>
838    &lt;%end&gt;</code></p>
839
840  <p>Dieser Block existiert nur in LaTeX-Vorlagen.</p>
841
842  <p>Dieser Block legt das Verhalten beim manuellen Einf&uuml;gen eines
843   Seitenumbruchs fest. Normalerweise bricht LaTeX die Seiten selber um. Beim
844   Rechnungsdruck ist das oft nicht gew&uuml;nscht, oder man m&ouml;chte im
845   Falle eines Seitenumbruchs den &Uuml;bertrag etc. mit ausgeben. Deswegen
846   versucht der Parser, manuell Seitenumbr&uuml;che einzuf&uuml;gen,
847   w&auml;hrend er einen <code>foreach</code>-Block auswertet, weil hier die
848   manuellen Seitenumbr&uuml;che erforderlich werden. Daf&uuml;r ben&ouml;tigt
849   der Parser aber drei Informationen:</p>
850
851  <p>
852   <ol>
853    <li>Wieviele Zeichen passen bei der Variablen "description" pro Posten
854     in eine Zeile? Das ist der Parameter "ZpZ" (Zeichen pro Zeile).</li>
855    <li>Wieviele Zeilen/Posten passen auf die erste Seite? Das
856     ist der Parameter "ZeS" (Zeilen erste Seite).</li>
857    <li>Wieviele Zeilen/Posten passen auf die zweite und alle nachfolgenden
858     Seiten? Das ist der Parameter "ZzS" (Zeilen zweite Seite).</li>
859   </ol>
860  </p>
861
862  <p>Diese Parameter sind drei Zahlen, die manuell durch Verwendung von langen
863   Warenbezeichnungen und Rechnungen mit vielen Posten bestimmt werden
864   m&uuml;ssen.</p>
865
866  <p>&Uuml;blicherweise wird in diesem Block zuerst die aktuelle Tabelle
867   geschlossen, eventuell Text eingef&uuml;gt (z.B. "Fortsetzung auf der
868   n&auml;chsten Seite"), dann ein Seitenumbruch erzwungen, eventuell Text
869   eingef&uuml;gt (z.B. "&Uuml;bertrag von der vorherigen Seite:
870   &lt;%sumcarriedforward%&gt; EUR") und die Tabelle wieder ge&ouml;ffnet.</p>
871
872  <p>Wird kein manueller Seitenumbruch gew&uuml;scht, so kann dieser Block
873   komplett entfallen.</p>
874
875  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
876    zum Inhaltsverzeichnis</a></small><br>
877  <hr>
878
879  <h2><a name="markup">
880    Markup-Code, der innerhalb von Formularen zur Textformatierung
881    verwendet werden kann</a></h2>
882
883  <p>Wenn der Benutzer innhalb von Formularen in Lx-Office Text anders
884   formatiert haben m&ouml;chte, so ist dies begrenzt m&ouml;glich. Lx-Office
885   unterst&uuml;tzt die Textformatierung mit HTML-&auml;hnlichen Tags. Der
886   Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung Teile des
887   Texts zwischen Start- und Endtags setzen. Dieser Teil wird dann automatisch
888   in Anweisungen f&uuml;r das ausgew&auml;hlte Vorlagenformat (HTML oder
889   PDF &uuml;ber LaTeX) umgesetzt.</p>
890
891  <p>Die unterst&uuml;tzen Formatierungen sind:</p>
892
893  <p>
894   <table border="1">
895    <tr><th>Formatierung</th><th>Auswirkung</th></tr>
896    <tr>
897     <td><code>&lt;b&gt;Text&lt;/b&gt;</code></td>
898     <td>Text wird in <b>fettdruck</b> gesetzt.</td>
899    </tr>
900    <tr>
901     <td><code>&lt;i&gt;Text&lt;/i&gt;</code></td>
902     <td>Text wird <i>kursiv</i> gesetzt.</td>
903    </tr>
904    <tr>
905     <td><code>&lt;u&gt;Text&lt;/u&gt;</code></td>
906     <td>Text wird <u>unterstrichen</u>.</td>
907    </tr>
908    <tr>
909     <td><code>&lt;s&gt;Text&lt;/s&gt;</code></td>
910     <td>Text wird <s>durchgestrichen</s>. Diese Formatierung ist nicht bei der
911      Ausgabe als PDF &uuml;ber LaTeX verf&uuml;gbar.</td>
912    </tr>
913    <tr>
914     <td><code>&lt;pagebreak&gt;</code></td>
915     <td>Erzwingt einen Seitenumbruch (siehe unten).</td>
916    </tr>
917   </table>
918  </p>
919
920  <p>Eine Besonderheit ist der Befehl <code>&lt;pagebreak&gt;</code>,
921   der nur in LaTeX-Vorlagen funktioniert und in anderen Vorlagen
922   einfach gel&ouml;scht wird. Dieser erzwingt unabh&auml;ngig von der
923   im <a
924   href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">pagebreak-Block</a>
925   voreingestellten Werte einen Seitenumbruch nach der aktuellen
926   Rechnungsposition. Dementsprechend funktioniert er nur innerhalb von
927   <code>&lt;foreach...&gt;</code>-Schleifen. Weiterhin ben&ouml;tigt er kein
928   Endtag.</p>
929
930  <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
931    zum Inhaltsverzeichnis</a></small><br>
932  <hr>
933
934 </body>
935 </html>