3 <title>LaTeX-Vorlagen und verfügbare Variablen</title>
4 <style type="text/css">
8 background-color: #b0ecff;
9 border: 1px solid blue;
16 background-color: #fae8b8;
17 border: 1px solid #be5303;
18 border-collapse: collapse;
22 border: 1px solid #be5303;
32 <h1>LaTeX-Vorlagen und verfügbare Variablen</h1>
34 <p>geschrieben von <a href="mailto:m.bunkus@linet-services.de">Moritz
35 Bunkus</a>. Version: $Id$ </p>
39 <h2><a name="inhaltsverzeichnis">Inhaltsverzeichnis</a></h2>
42 <li><a href="latex-template-variablen.html#inhaltsverzeichnis">
43 Inhaltsverzeichnis</a></li>
45 <li><a href="latex-template-variablen.html#einfuehrung">Einführung</a>
48 <li><a href="latex-template-variablen.html#zuordnung_dateinamen">
49 Zuordnung von Dateinamen zu den Funktionen</a></li>
51 <li><a href="latex-template-variablen.html#allgemeine_variablen">
52 Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a><br>
55 <li><a href="latex-template-variablen.html#allgemein_stammdaten">
56 Stammdaten von Kunden und Lieferanten</a></li>
58 <li><a href="latex-template-variablen.html#allgemein_verkaeufer">
59 Informationen über den Verkäufer</a></li>
61 <li><a href="latex-template-variablen.html#allgemein_steuern">
62 Variablen für jede Steuer</a></li>
66 <li><a href="latex-template-variablen.html#invoice">
67 Variablen in Rechnungen</a>
70 <li><a href="latex-template-variablen.html#invoice_allgemein">
71 Allgemeine Variablen</a></li>
73 <li><a href="latex-template-variablen.html#invoice_posten">
74 Variablen für jeden Posten auf der Rechnung</a></li>
76 <li><a href="latex-template-variablen.html#invoice_zahlungen">
77 Variablen für die Zahlungseingänge</a></li>
81 <li><a href="latex-template-variablen.html#anderevorlagen">
82 Variablen in anderen Vorlagen</a></li>
84 <li><a href="latex-template-variablen.html#bloecke">
85 Blöcke, bedingte Anweisungen und Schleifen</a>
88 <li><a href="latex-template-variablen.html#bloecke_include">
89 Die <code>include</code>-Anweisung</a></li>
91 <li><a href="latex-template-variablen.html#bloecke_ifnot">
92 Der <code>if not</code>-Block</a></li>
94 <li><a href="latex-template-variablen.html#bloecke_if">
95 Der <code>if</code>-Block</a></li>
97 <li><a href="latex-template-variablen.html#bloecke_foreach">
98 Die <code>foreach</code>-Schleife</a></li>
100 <li><a href="latex-template-variablen.html#bloecke_pagebreak">
101 Der <code>pagebreak</code>-Block</a></li>
105 <li><a href="latex-template-variablen.html#markup">
106 Markup-Code, der innerhalb von Formularen zur Textformatierung verwendet
113 <h2><a name="einfuehrung">Einführung</a></h2>
115 <p>Dies ist eine Auflistung der Standard-LaTeX-Vorlagen und aller zur
116 Bearbeitung verfügbare Variablen. Eine Variable wird in einer Vorlage
117 durch ihren Inhalt ersetzt, wenn sie in der Form
118 <code><%variablenname%></code> verwendet wird.</p>
120 <p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
121 verfügbar als hier aufgelistet werden. Die meisten davon können
122 allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
123 werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann diese wie
124 folgt erhalten werden:</p>
128 <li><code>SL/Form.pm</code> öffnen und am Anfang die Zeile
129 <pre>"use Data::Dumper;"</pre> einfügen.</li>
131 <li>In <code>Form.pm</code> die Funktion <code>parse_template</code>
132 suchen und hier die Zeile <pre>print(STDERR Dumper($self));</pre>
135 <li>Einmal per Browser die gewünschte Vorlage "benutzen", z.B. ein PDF
136 für eine Rechnung erzeugen.</li>
138 <li>Im <code>error.log</code> vom Apache steht die Ausgabe der Variablen
139 <code>$self</code> in der Form <code>'key' => 'value',</code>. Alle
140 <code>key</code>s sind verfügbar.</li>
144 <small><a href="latex-template-variablen.html#inhaltsverzeichnis">
145 zum Inhaltsverzeichnis</a></small><br>
148 <h2><a name="zuordnung_dateinamen">
149 Zuordnung von den Dateinamen zu den Funktionen</a></h2>
151 <p>Diese kurze Auflistung zeigt, welche Vorlage bei welcher Funktion
155 <li><code>bin_list.tex</code> -- Lagerliste</li>
156 <li><code>check.tex</code> -- ?</li>
157 <li><code>invoice.tex</code> -- Rechnung</li>
158 <li><code>packing_list.tex</code> -- Verpackungsliste</li>
159 <li><code>pick_list.tex</code> -- Sammelliste</li>
160 <li><code>purcharse_order.tex</code> -- Bestellung an Lieferanten</li>
161 <li><code>request_quotation.tex</code> -- Anfrage an Lieferanten</li>
162 <li><code>sales_order.tex</code> -- Bestellung</li>
163 <li><code>sales_quotation.tex</code> -- Angebot an Kunden</li>
166 <small><a href="latex-template-variablen.html#inhaltsverzeichnis">
167 zum Inhaltsverzeichnis</a></small><br>
170 <h2><a name="allgemeine_variablen">
171 Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a></h2>
173 <h3><a name="allgemein_stammdaten">
174 Stammdaten von Kunden und Lieferanten:</a></h3>
178 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
180 <td><code>account_number</code></td>
184 <td><code>bank</code></td>
185 <td>Name der Bank</td>
188 <td><code>bank_code</code></td>
189 <td>Bankleitzahl</td>
192 <td><code>business</code></td>
196 <td><code>city</code></td>
200 <td><code>contact</code></td>
204 <td><code>country</code></td>
208 <td><code>cp_email</code></td>
209 <td>Email des Ansprechpartners</td>
212 <td><code>cp_givenname</code></td>
213 <td>Vorname des Ansprechpartners</td>
216 <td><code>cp_greeting</code></td>
217 <td>Anrede des Ansprechpartners</td>
220 <td><code>cp_name</code></td>
221 <td>Name des Ansprechpartners</td>
224 <td><code>cp_phone1</code></td>
225 <td>Telefonnummer 1 des Ansprechpartners</td>
228 <td><code>cp_phone2</code></td>
229 <td>Telefonnummer 2 des Ansprechpartners</td>
232 <td><code>cp_title</code></td>
233 <td>Titel des Ansprechpartners</td>
236 <td><code>creditlimit</code></td>
240 <td><code>customernumber</code></td>
241 <td>Kundennummer; nur für Kunden</td>
244 <td><code>customernotes</code></td>
245 <td>Bemerkungen beim Kunden; nur für Kunden</td>
248 <td><code>discount</code></td>
252 <td><code>email</code></td>
253 <td>Emailadresse</td>
256 <td><code>fax</code></td>
260 <td><code>homepage</code></td>
264 <td><code>language</code></td>
268 <td><code>name</code></td>
272 <td><code>phone</code></td>
273 <td>Telefonnummer</td>
276 <td><code>shiptocity</code></td>
277 <td>Stadt (Lieferadresse)
278 <a href="latex-template-variablen.html#anmerkung_shipto">*</a></td>
281 <td><code>shiptocontact</code></td>
282 <td>Kontakt (Lieferadresse)
283 <a href="latex-template-variablen.html#anmerkung_shipto">*</a></td>
286 <td><code>shiptocountry</code></td>
287 <td>Land (Lieferadresse)
288 <a href="latex-template-variablen.html#anmerkung_shipto">*</a></td>
291 <td><code>shiptoemail</code></td>
292 <td>Email (Lieferadresse)
293 <a href="latex-template-variablen.html#anmerkung_shipto">*</a></td>
296 <td><code>shiptofax</code></td>
297 <td>Fax (Lieferadresse)
298 <a href="latex-template-variablen.html#anmerkung_shipto">*</a></td>
301 <td><code>shiptoname</code></td>
302 <td>Firmenname (Lieferadresse)
303 <a href="latex-template-variablen.html#anmerkung_shipto">*</a></td>
306 <td><code>shiptophone</code></td>
307 <td>Telefonnummer (Lieferadresse)
308 <a href="latex-template-variablen.html#anmerkung_shipto">*</a></td>
311 <td><code>shiptostreet</code></td>
312 <td>Straße und Hausnummer (Lieferadresse)
313 <a href="latex-template-variablen.html#anmerkung_shipto">*</a></td>
316 <td><code>shiptozipcode</code></td>
317 <td>Postleitzahl (Lieferadresse)
318 <a href="latex-template-variablen.html#anmerkung_shipto">*</a></td>
321 <td><code>street</code></td>
322 <td>Straße und Hausnummer</td>
325 <td><code>taxnumber</code></td>
326 <td>Steuernummer</td>
329 <td><code>terms</code></td>
330 <td>Zahlungsziel</td>
333 <td><code>vendoremail</code></td>
334 <td>Email des Lieferanten; nur für Lieferanten</td>
337 <td><code>vendorfax</code></td>
338 <td>Faxnummer des Lieferanten; nur für Lieferanten</td>
341 <td><code>vendornotes</code></td>
342 <td>Bemerkungen beim Lieferanten; nur für Lieferanten</td>
345 <td><code>vendornumber</code></td>
346 <td>Lieferantennummer; nur für Lieferanten</td>
349 <td><code>vendorphone</code></td>
350 <td>Telefonnummer des Lieferanten; nur für Lieferanten</td>
353 <td><code>zipcode</code></td>
354 <td>Postleitzahl</td>
359 <p><a name="anmerkung_shipto"><em>Anmerkung</em></a>: Sind die
360 <code>shipto*</code>-Felder in den Stammdaten nicht eingetragen, so haben
361 die Variablen <code>shipto*</code> den gleichen Wert wie die die
362 entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich einige
363 <code>shipto*</code>-Variablen so nicht in den Stammdaten wiederfinden
364 sondern schlicht Kopien der Lieferdatenvariablen sind
365 (z.B. <code>shiptocontact</code>).</p>
367 <h3><a name="allgemein_verkaeufer">
368 Informationen über den Verkäufer:</a></h3>
372 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
374 <td><code>employee_email</code></td>
378 <td><code>employee_fax</code></td>
382 <td><code>employee_name</code></td>
386 <td><code>employee_signature</code></td>
390 <td><code>employee_tel</code></td>
391 <td>Telefonnummer</td>
396 <h3><a name="allgemein_steuern">
397 Variablen für die einzelnen Steuern:</a></h3>
401 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
403 <td><code>tax</code></td>
407 <td><code>taxbase</code></td>
408 <td>zu versteuernder Betrag</td>
411 <td><code>taxdescription</code></td>
412 <td>Name der Steuer</td>
415 <td><code>taxrate</code></td>
421 <small><a href="latex-template-variablen.html#inhaltsverzeichnis">
422 zum Inhaltsverzeichnis</a></small><br>
425 <h2><a name="invoice">Variablen in Rechnungen</a></h2>
427 <h3><a name="invoice_allgemein">Allgemeine Variablen:</a></h3>
431 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
433 <td><code>creditremaining</code></td>
434 <td>Verbleibender Kredit</td>
437 <td><code>currency</code></td>
441 <td><code>cusordnumber</code></td>
442 <td>Bestellnummer beim Kunden</td>
445 <td><code>deliverydate</code></td>
449 <td><code>duedate</code></td>
450 <td>Fälligkeitsdatum</td>
453 <td><code>intnotes</code></td>
454 <td>Interne Bemerkungen</td>
457 <td><code>invdate</code></td>
458 <td>Rechnungsdatum</td>
461 <td><code>invnumber</code></td>
462 <td>Rechnungsnummer</td>
465 <td><code>invtotal</code></td>
466 <td>gesamter Rechnungsbetrag</td>
469 <td><code>notes</code></td>
470 <td>Bemerkungen der Rechnung</td>
473 <td><code>ordnumber</code></td>
474 <td>Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde</td>
477 <td><code>quonumber</code></td>
478 <td>Angebotsnummer</td>
481 <td><code>shippingpoint</code></td>
485 <td><code>shipvia</code></td>
486 <td>Transportmittel</td>
489 <td><code>subtotal</code></td>
490 <td>Zwischensumme aller Posten ohne Steuern</td>
493 <td><code>sumcarriedforward</code></td>
494 <td>Zwischensumme aller bisher ausgegebenen Posten. Sollte nur in einem
495 <a href="latex-template-variablen.html#bloecke_pagebreak">
496 <code>pagebreak</code></a>-Block verwendet werden.</td>
499 <td><code>total</code></td>
500 <td>Restsumme der Rechnung (Summe abzüglich bereits bezahlter Posten)</td>
503 <td><code>transdate</code></td>
504 <td>Auftragsdatum wenn die Rechnung aus einem Auftrag erstellt wurde</td>
509 <h3><a name="invoice_posten">
510 Variablen für jeden Posten auf der Rechnung:</a></h3>
514 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
516 <td><code>assembly</code></td>
520 <td><code>bin</code></td>
524 <td><code>deliverydate_oe</code></td>
528 <td><code>description</code></td>
529 <td>Artikelbeschreibung</td>
532 <td><code>discount</code></td>
533 <td>Rabatt als Betrag</td>
536 <td><code>linetotal</code></td>
537 <td>Zeilensumme (Anzahl * Einzelpreis)</td>
540 <td><code>listprice</code></td>
544 <td><code>netprice</code></td>
548 <td><code>number</code></td>
549 <td>Artikelnummer</td>
552 <td><code>ordnumber_oe</code></td>
553 <td>Auftragsnummer des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
556 <td><code>p_discount</code></td>
557 <td>Rabatt in Prozent</td>
559 <td><code>partnotes</code></td>
560 <td>Die beim Artikel gespeicherten Bemerkungen</td>
563 <td><code>partsgroup</code></td>
567 <td><code>projectnumber</code></td>
568 <td>Projektnummer</td>
571 <td><code>qty</code></td>
575 <td><code>runningnumber</code></td>
576 <td>Position auf der Rechnung (1, 2, 3...)</td>
579 <td><code>sellprice</code></td>
580 <td>Verkaufspreis</td>
583 <td><code>serialnumber</code></td>
584 <td>Seriennummer</td>
587 <td><code>transdate_oe</code></td>
588 <td>Auftragsdatum des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
591 <td><code>unit</code></td>
597 <h3><a name="invoice_zahlungen">
598 Variablen für die einzelnen Zahlungseingänge:</a></h3>
602 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
604 <td><code>datepaid</code></td>
608 <td><code>memo</code></td>
612 <td><code>paid</code></td>
616 <td><code>source</code></td>
620 <td><code>exchangerate</code></td>
624 <td><code>forex</code></td>
630 <small><a href="latex-template-variablen.html#inhaltsverzeichnis">
631 zum Inhaltsverzeichnis</a></small><br>
634 <h2><a name="anderevorlagen">
635 Variablen in anderen Vorlagen</a></h2>
637 <p>Die Variablen in anderen Vorlagen sind ähnlich wie in der
638 Rechnung. Allerdings heißen die Variablen, die mit <code>inv</code>
639 beginnen, jetzt anders. Bei den Angeboten fangen sie mit <code>quo</code>
640 für "quotation" an: <code>quodate</code> für Angebotsdatum
641 etc. Bei Bestellungen wiederum fangen sie mit <code>ord</code> für
642 "order" an: <code>ordnumber</code> für Bestellnummer etc.</p>
644 <p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht vorhanden wie
645 z.B. die für bereits verbuchte Zahlungseingänge. Dies sind
646 Variablen, die vom Geschäftsablauf her in der entsprechenden Vorlage
647 keine Bedeutung haben oder noch nicht belegt sein können.</p>
649 <small><a href="latex-template-variablen.html#inhaltsverzeichnis">
650 zum Inhaltsverzeichnis</a></small><br>
653 <h2><a name="bloecke">
654 Blöcke, bedingte Anweisungen und Schleifen</a></h2>
656 <p>Der Parser kennt neben den Variablen einige weitere Konstrukte, die
657 gesondert behandelt werden. Diese sind wie Variablennamen in spezieller
658 Weise markiert: <code><%anweisung%></code></p>
660 <p><b>Achtung: Blöcke können momentan nicht verschachtelt
661 werden.</b> Das bedeutet, dass innerhalb einer
662 <code><%foreach%></code>-Schleife keine
663 <code><%if%></code>-Abfragen verwendet werden können. Dieses
664 kann man aber mit LaTeX-Bordmitteln selber nachgebildet werden. Dazu muss
665 im Vorspann das Paket <code>ifthen</code> eingebunden werden. Das Konstrukt
666 selber sieht dann wie folgt aus:</p>
668 <p class="blue"><code>\ifthenelse{\equal{<%variable%>}{}}{}{Dieser
669 Text erscheint nur, wenn <%variable%> nicht leer ist.}</code></p>
671 <h3><a name="bloecke_include">Die <code>include</code>-Anweisung</a></h3>
673 <p class="blue"><code><%include dateiname.ext%></code></p>
675 <p>Fügt den Inhalt einer Datei an der entsprechenden Stelle ein. Der
676 eingefügte Text wird ganz normal durch den Parser behandelt und kann
677 Variablen und Blöcke enthalten.</p>
679 <h3><a name="bloecke_ifnot">Der <code>if not</code>-Block</a></h3>
681 <p class="blue"><code><%if not variablenname%><br>
683 <%end if></code></p>
685 <p>Eine normale "if-not-then"-Bedingung. Die Zeilen zwischen dem "if not" und
686 dem "end" werden nur ausgegeben, wenn die Variable "variablenname" nicht
687 gesetzt oder gleich 0 ist.</p>
689 <h3><a name="bloecke_if">Der <code>if</code>-Block</a></h3>
691 <p class="blue"><code><%if variablenname%><br>
693 <%end if></code></p>
695 <p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" und dem
696 "end" werden nur ausgegeben, wenn die Variable "variablenname" gesetzt und
699 <h3><a name="bloecke_foreach">Die <code>foreach</code>-Schleife</a></h3>
701 <p class="blue"><code><%foreach variablenname%><br>
703 <%end foreach></code></p>
705 <p>Fügt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
706 Perl-Array der Variablen "variablenname" Elemente enthät. Dieses
707 Konstrukt wird zur Ausgabe der einzelnen Posten einer Rechnung / eines
708 Angebots sowie zur Ausgabe der Steuern benutzt. In jedem Durchlauf werden
709 die <a href="latex-template-variablen.html#invoice_posten">zeilenbezogenen
710 Variablen</a> jeweils auf den Wert für die aktuelle Position
713 <p>Die Syntax sieht normalerweise wie folgt aus:</p>
715 <p class="blue"><code><%foreach number%><br>
716 Position: <%runningnumber%><br>
717 Anzahl: <%qty%><br>
718 Artikelnummer: <%number%><br>
719 Beschreibung: <%description%><br>
721 <%end foreach></code></p>
723 <h3><a name="bloecke_pagebreak">Der <code>pagebreak</code>-Block</a></h3>
725 <p class="blue"><code><%pagebreak ZpZ ZeS ZzS%><br>
727 <%end pagebreak%></code></p>
729 <p>Dieser Block legt das Verhalten beim manuellen Einfügen eines
730 Seitenumbruchs fest. Normalerweise bricht LaTeX die Seiten selber um. Beim
731 Rechnungsdruck ist das oft nicht gewünscht, oder man möchte im
732 Falle eines Seitenumbruchs den Übertrag etc. mit ausgeben. Deswegen
733 versucht der Parser, manuell Seitenumbrüche einzufügen,
734 während er einen <code>foreach</code>-Block auswertet, weil hier die
735 manuellen Seitenumbrüche erforderlich werden. Dafür benötigt
736 der Parser aber drei Informationen:</p>
740 <li>Wieviele Zeichen passen bei der Variablen "description" pro Posten
741 in eine Zeile? Das ist der Parameter "ZpZ" (Zeichen pro Zeile).</li>
742 <li>Wieviele Zeilen/Posten passen auf die erste Seite? Das
743 ist der Parameter "ZeS" (Zeilen erste Seite).</li>
744 <li>Wieviele Zeilen/Posten passen auf die zweite und alle nachfolgenden
745 Seiten? Das ist der Parameter "ZzS" (Zeilen zweite Seite).</li>
749 <p>Diese Parameter sind drei Zahlen, die manuell durch Verwendung von langen
750 Warenbezeichnungen und Rechnungen mit vielen Posten bestimmt werden
753 <p>Üblicherweise wird in diesem Block zuerst die aktuelle Tabelle
754 geschlossen, eventuell Text eingefügt (z.B. "Fortsetzung auf der
755 nächsten Seite"), dann ein Seitenumbruch erzwungen, eventuell Text
756 eingefügt (z.B. "Übertrag von der vorherigen Seite:
757 <%sumcarriedforward%> EUR") und die Tabelle wieder geöffnet.</p>
759 <p>Wird kein manueller Seitenumbruch gewüscht, so kann dieser Block
760 komplett entfallen.</p>
762 <small><a href="latex-template-variablen.html#inhaltsverzeichnis">
763 zum Inhaltsverzeichnis</a></small><br>
766 <h2><a name="markup">
767 Markup-Code, der innerhalb von Formularen zur Textformatierung
768 verwendet werden kann</a></h2>
770 <p>Wenn der Benutzer innhalb von Formularen in Lx-Office Text anders
771 formatiert haben möchte, so ist dies begrenzt möglich. Lx-Office
772 unterstützt die Textformatierung mit HTML-ähnlichen Tags. Der
773 Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung Teile des
774 Texts zwischen Start- und Endtags setzen. Dieser Teil wird dann automatisch
775 in Anweisungen für das ausgewählte Vorlagenformat (HTML oder
776 PDF über LaTeX) umgesetzt.</p>
778 <p>Die unterstützen Formatierungen sind:</p>
782 <tr><th>Formatierung</th><th>Auswirkung</th></tr>
784 <td><code><b>Text</b></code></td>
785 <td>Text wird in <b>fettdruck</b> gesetzt.</td>
788 <td><code><u>Text</u></code></td>
789 <td>Text wird <u>unterstrichen</u>.</td>
792 <td><code><s>Text</s></code></td>
793 <td>Text wird <s>durchgestrichen</s>. Diese Formatierung ist nicht bei der
794 Ausgabe als PDF über LaTeX verfügbar.</td>
797 <td><code><pagebreak></code></td>
798 <td>Erzwingt einen Seitenumbruch (siehe unten).</td>
803 <p>Eine Besonderheit ist der Befehl <code><pagebreak></code>. Dieser
804 erzwingt unabhängig von der im <a
805 href="latex-template-variablen.html#bloecke_pagebreak">pagebreak-Block</a>
806 voreingestellten Werte einen Seitenumbruch nach der aktuellen
807 Rechnungsposition. Dementsprechend funktioniert er nur innerhalb von
808 <code><foreach...></code>-Schleifen. Weiterhin benötigt er kein
811 <small><a href="latex-template-variablen.html#inhaltsverzeichnis">
812 zum Inhaltsverzeichnis</a></small><br>