3 <title>Dokumentenvorlagen 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>Dokumentenvorlagen 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="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
43 Inhaltsverzeichnis</a></li>
45 <li><a href="dokumentenvorlagen-und-variablen.html#einfuehrung">Einführung</a>
48 <li><a href="dokumentenvorlagen-und-variablen.html#zuordnung_dateinamen">
49 Zuordnung von Dateinamen zu den Funktionen</a></li>
51 <li><a href="#variablen_ausgeben">Variablen ausgeben</a>
54 <li><a href="dokumentenvorlagen-und-variablen.html#tag_style">
55 Anfang und Ende der Tags verändern</a></li>
57 <li><a href="dokumentenvorlagen-und-variablen.html#allgemeine_variablen">
58 Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a><br>
61 <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_stammdaten">
62 Stammdaten von Kunden und Lieferanten</a></li>
64 <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_bearbeiter">
65 Informationen über den Bearbeiter</a></li>
67 <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_verkaeufer">
68 Informationen über den Verkäufer</a></li>
70 <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_steuern">
71 Variablen für jede Steuer</a></li>
75 <li><a href="dokumentenvorlagen-und-variablen.html#invoice">
76 Variablen in Rechnungen</a>
79 <li><a href="dokumentenvorlagen-und-variablen.html#invoice_allgemein">
80 Allgemeine Variablen</a></li>
82 <li><a href="dokumentenvorlagen-und-variablen.html#invoice_posten">
83 Variablen für jeden Posten auf der Rechnung</a></li>
85 <li><a href="dokumentenvorlagen-und-variablen.html#invoice_zahlungen">
86 Variablen für die Zahlungseingänge</a></li>
88 <li><a href="dokumentenvorlagen-und-variablen.html#invoice_benutzerdefinierte_variablen_vc">
89 Benutzerdefinierte Kunden- und Lieferantenvariablen</a></li>
93 <li><a href="dokumentenvorlagen-und-variablen.html#dunning">
94 Variablen in Mahnungen und Rechnungen über Mahngebühren</a>
97 <li><a href="dokumentenvorlagen-und-variablen.html#dunning_vorlagennamen">
98 Namen der Vorlagen</a></li>
100 <li><a href="dokumentenvorlagen-und-variablen.html#dunning_allgemein">
101 Allgemeine Variablen in Mahnungen</a></li>
103 <li><a href="dokumentenvorlagen-und-variablen.html#dunning_details">
104 Variablen für jede gemahnte Rechnung in einer Mahnung</a></li>
106 <li><a href="dokumentenvorlagen-und-variablen.html#dunning_invoice">
107 Variablen in automatisch erzeugten Rechnungen über Mahngebühren</a></li>
111 <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
112 Variablen in anderen Vorlagen</a>
115 <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_quotations">Angebote und Preisanfragen</a></li>
116 <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_orders">Auftragsbestätigungen und Lieferantenaufträge</a></li>
117 <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_delivery_orders">Lieferscheine (Verkauf und Einkauf)</a></li>
118 <li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen_statement">Sammelrechnung</a></li>
122 <li><a href="dokumentenvorlagen-und-variablen.html#bloecke">
123 Blöcke, bedingte Anweisungen und Schleifen</a>
126 <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_if">
127 Der <code>if</code>-Block</a></li>
129 <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_foreach">
130 Die <code>foreach</code>-Schleife</a></li>
132 <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
133 Der <code>pagebreak</code>-Block</a></li>
137 <li><a href="dokumentenvorlagen-und-variablen.html#markup">
138 Markup-Code, der innerhalb von Formularen zur Textformatierung verwendet
145 <h2><a name="einfuehrung">Einführung</a></h2>
147 <p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und aller
148 zur Bearbeitung verfügbaren Variablen. Eine Variable wird in
149 einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
150 <code><%variablenname%></code> verwendet wird. Für LaTeX-
151 und HTML-Vorlagen kann man die Form dieser Tags auch
152 <a href="dokumentenvorlagen-und-variablen.html#tag_style">
156 <p>Einige Zahlenwerte werden auch in unformatierter Form zur Verfügung
157 gestellt (also z.B. 35 statt 35,00 oder 12.3 statt 12,30). Der Dezimaltrenner
158 ist dabei also immer ein Punkt unabhaengig vom eingestellten Zahlenformat.
159 Diese Variabelen kann man mit der Erweiterung _nofmt (für no-format) aufrufen
160 (also z.B. netprice = 12,30 -- netprice_nofmt = 12.3). Variabeln die zusätzlich
161 unformatiert zur Verfügung stehen sind unten als variable[_nofmt] gelistet.
162 Die Eckigen Klammern weisen also auf eine optionale Verwändung der Erweiterung hin.
165 <p>Früher wurde hier nur über LaTeX gesprochen. Inzwischen
166 unterstützt Lx-Office aber auch OpenDocument-Vorlagen. Sofern
167 es nicht ausdrücklich eingeschränkt wird, gilt das im
168 Folgenden gesagte für alle Vorlagenarten.</p>
170 <p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
171 verfügbar als hier aufgelistet werden. Die meisten davon können
172 allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
173 werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann diese wie
174 folgt erhalten werden:</p>
178 <li><code>SL/Form.pm</code> öffnen und am Anfang die Zeile
179 <pre>"use Data::Dumper;"</pre> einfügen.</li>
181 <li>In <code>Form.pm</code> die Funktion <code>parse_template</code>
182 suchen und hier die Zeile <pre>print(STDERR Dumper($self));</pre>
185 <li>Einmal per Browser die gewünschte Vorlage "benutzen", z.B. ein PDF
186 für eine Rechnung erzeugen.</li>
188 <li>Im <code>error.log</code> vom Apache steht die Ausgabe der Variablen
189 <code>$self</code> in der Form <code>'key' => 'value',</code>. Alle
190 <code>key</code>s sind verfügbar.</li>
194 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
195 zum Inhaltsverzeichnis</a></small><br>
198 <h2><a name="variablen_ausgeben">Variablen ausgeben</a></h2>
200 <p>Um eine Variable auszugeben, müssen sie einfach nur zwischen die
201 Tags geschrieben werden, also
202 z.B. <code><%variablenname%></code>.</p>
205 Optional kann man auch mit Leerzeichen getrennte Flags angeben, die
206 man aber nur selten brauchen wird. Die Syntax sieht also so
207 aus: <code><%variablenname FLAG1 FLAG2%></code>. Momentan werden
208 die folgenden Flags unterstützt:
213 <code>NOFORMAT</code> gilt nur für Zahlenwerte und gibt den Wert
214 ohne Formatierung, also ohne Tausendertrennzeichen mit mit einem
215 Punkt als Dezimaltrennzeichen aus. Nützlich z.B., wenn damit in der
216 Vorlage z.B. von LaTeX gerechnet werden soll.
220 <code>NOESCAPE</code> unterdrückt das Escapen von Sonderzeichen für
221 die Vorlagensprache. Wenn also in einer Variablen bereits gültiger
222 LaTeX-Code steht und dieser von LaTeX auch ausgewertet und nicht
223 wortwörtlich angezeigt werden soll, so ist dieses Flag sinnvoll.
228 Beispiel: <code class="blue"><%quototal NOFORMAT%></code>
231 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
232 zum Inhaltsverzeichnis</a></small><br>
235 <h2><a name="tag_style">
236 Anfang und Ende der Tags verändern</a></h2>
238 <p>Der Standardstil für Tags sieht vor, dass ein Tag mit dem
239 Kleinerzeichen und einem Prozentzeichen beginnt und mit dem
240 Prozentzeichen und dem Größerzeichen endet,
241 beispielsweise <code><%customer%></code>. Da diese Form aber
242 z.B. in LaTeX zu Problemen führen kann, weil das Prozentzeichen
243 dort Kommentare einleitet, kann pro HTML- oder
244 LaTeX-Dokumentenvorlage der Stil umgestellt werden.</p>
246 <p>Dazu werden in die Datei Zeilen geschrieben, die mit dem für
247 das Format gültigen Kommentarzeichen anfangen,
248 dann <code>config:</code> enthalten, die entsprechende Option setzen
249 und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen
250 enden. Beispiel für LaTeX:</p>
252 <p><code>% config: tag-style=($ $)</code></p>
254 <p>Dies würde Lx-Office dazu veranlassen, Variablen zu ersetzen,
255 wenn sie wie folgt aussehen: <code>($customer$)</code>. Das
256 äquivalente Beispiel für HTML-Dokumentenvorlagen sieht so
259 <p><code><!-- config: tag-style=($ $) --></code></p>
261 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
262 zum Inhaltsverzeichnis</a></small><br>
265 <h2><a name="zuordnung_dateinamen">
266 Zuordnung von den Dateinamen zu den Funktionen</a></h2>
268 <p>Diese folgende kurze Auflistung zeigt, welche Vorlage bei welcher
269 Funktion ausgelesen wird. Dabei ist die Dateiendung ".ext"
270 geeignet zu ersetzen: ".tex" fü LaTeX-Vorlagen und
271 ".odt" für OpenDocument-Vorlagen.</p>
280 <td><code>bin_list.ext</code></td>
284 <td><code>check.ext</code></td>
288 <td><code>invoice.ext</code></td>
292 <td><code>packing_list.ext</code></td>
296 <td><code>pick_list.ext</code></td>
300 <td><code>purchase_delivery_order.ext</code></td>
301 <td>Lieferschein (Einkauf)</td>
304 <td><code>purcharse_order.ext</code></td>
305 <td>Bestellung an Lieferanten</td>
308 <td><code>request_quotation.ext</code></td>
309 <td>Anfrage an Lieferanten</td>
312 <td><code>sales_delivery_order.ext</code></td>
313 <td>Lieferschein (Verkauf)</td>
316 <td><code>sales_order.ext</code></td>
320 <td><code>sales_quotation.ext</code></td>
321 <td>Angebot an Kunden</td>
324 <td><code>zahlungserinnerung.ext</code></td>
325 <td>Mahnung (Dateiname im Programm konfigurierbar)</td>
328 <td><code>zahlungserinnerung_invoice.ext</code></td>
329 <td>Rechnung über Mahngebühren (Dateiname im Programm konfigurierbar)</td>
334 <a name="#dateinamen_erweitert"<h3>Sprache, Drucker und E-Mail</h3>
336 <p>Angeforderte Sprache und Druckerkürzel in den Dateinamen mit eingearbeitet. So wird aus der Vorlage <code>sales_order.ext</code> bei Sprache <code>de</code> und Druckerkürzel <code>lpr2</code> der Vorlagenname <code>sales_order_de_lpr2.ext</code>. Zusätzlich können für E-Mails andere Vorlagen erstellt werden, diese bekommen dann noch das Kürzel <code>_email</code>, der vollständige Vorlagenname wäre dann <code>sales_order_email_de_lpr2.ext</code>. In allen Fällen kann eine Standarddatei <code>default.ext</code> hinterlegt werden. Diese wird verwendet, wenn keine der anderen Varianten gefunden wird.</p>
338 <p>Die vollständige Suchreihenfolge für einen Verkaufsauftrag mit der Sprache "de" und dem Drucker "lpr2", der per E-Mail im Format PDF verschickt wird, ist:</p>
341 <tr><th>Reihenfolge der möglichen Vorlagennamen</th></tr>
342 <tr><td><code>sales_order_email_de_lpr2.tex</code></td></tr>
343 <tr><td><code>sales_order_de_lpr2.tex</code></td></tr>
344 <tr><td><code>sales_order.tex</code></td></tr>
345 <tr><td><code>default.tex</code></td></tr>
349 <p>Die kurzen Varianten dieser Vorlagentitel müssen dann entweder Standardwerte anzeigen, oder die angeforderten Werte selbst auswerten, siehe dazu <a href="#allgemein_meta">Metadaten in Vorlagen</a></p>
351 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
352 zum Inhaltsverzeichnis</a></small><br>
355 <h2><a name="allgemeine_variablen">
356 Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a></h2>
358 <h3><a name="allgemein_meta">
359 Metainformationen zur angeforderten Vorlage:</a></h3>
361 <p>Diese Variablen liefern Informationen darüber welche Variante einer Vorlage der Benutzer angefragt hat. Sie sind nützlich für Vorlagenautoren, die aus einer zentralen Layoutvorlage die einzelnen Formulare einbinden möchten.</p>
365 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
367 <td><code>template_meta.formname</code></td>
368 <td>Basisname der Vorlage. Identisch mit der <a href="#zuordnung_dateinamen">Zurordnung zu den Dateinamen</a> ohne die Erweiterung. Ein Verkaufsauftrag enthält hier <code>sales_order</code>.</td>
371 <td><code>template_meta.language.description</code></td>
372 <td>Beschreibung der verwendeten Sprache</td>
375 <td><code>template_meta.language.template_code</code></td>
376 <td>Vorlagenürzel der verwendeten Sprache, identisch mit dem Kürzel das im Dateinamen verwendetet wird.</td>
379 <td><code>template_meta.language.output_numberformat</code></td>
380 <td>Zahlenformat der verwendeten Sprache in der Form "1.000,00". <em>Experimentell!</em>. Nur interessant für Vorlagen die mit unformatierten Werten arbeiten.</td>
383 <td><code>template_meta.language.output_dateformat</code></td>
384 <td>Datumsformat der verwendeten Sprache in der Form "dd.mm.yyyy". <em>Experimentell!</em>. Nur interessant für Vorlagen die mit unformatierten Werten arbeiten.</td>
387 <td><code>template_meta.format</code></td>
388 <td>Das angeforderte Format. Kann im Moment die Werte <code>pdf</code>, <code>postscript</code>, <code>html</code>, <code>opendocument</code>, <code>opendocument_pdf</code> und <code>excel</code> enthalten.</td>
391 <td><code>template_meta.extension</code></td>
392 <td>Dateierweiterung, wie im Dateinamen. Wird aus <code>format</code> entschieden.</td>
395 <td><code>template_meta.media</code></td>
396 <td>Ausgabemedium. Kann zur Zeit die Werte <code>screen</code> für Bildschirm, <code>email</code> für E-Mmail (triggert das <code>_email</code> Kürzel im Dateinamen), <code>printer</code> für Drucker, und <code>queue</code> für Warteschlange enthalten.</td>
399 <td><code>template_meta.printer.description</code></td>
400 <td>Beschreibung des ausgewählten Druckers</td>
403 <td><code>template_meta.printer.template_code</code></td>
404 <td>Vorlagenürzel des ausgewählten Druckers, identisch mit dem Kürzel das im Dateinamen verwendetet wird.</td>
409 <h3><a name="allgemein_stammdaten">
410 Stammdaten von Kunden und Lieferanten:</a></h3>
414 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
416 <td><code>account_number</code></td>
420 <td><code>bank</code></td>
421 <td>Name der Bank</td>
424 <td><code>bank_code</code></td>
425 <td>Bankleitzahl</td>
428 <td><code>bic</code></td>
429 <td>Bank-Identifikations-Code (Bank Identifier Code, BIC)</td>
432 <td><code>business</code></td>
433 <td>Kunden-/Lieferantentyp</td>
436 <td><code>city</code></td>
440 <td><code>contact</code></td>
444 <td><code>country</code></td>
448 <td><code>cp_email</code></td>
449 <td>Email des Ansprechpartners</td>
452 <td><code>cp_givenname</code></td>
453 <td>Vorname des Ansprechpartners</td>
456 <td><code>cp_greeting</code></td>
457 <td>Anrede des Ansprechpartners</td>
460 <td><code>cp_name</code></td>
461 <td>Name des Ansprechpartners</td>
464 <td><code>cp_phone1</code></td>
465 <td>Telefonnummer 1 des Ansprechpartners</td>
468 <td><code>cp_phone2</code></td>
469 <td>Telefonnummer 2 des Ansprechpartners</td>
472 <td><code>cp_title</code></td>
473 <td>Titel des Ansprechpartners</td>
476 <td><code>creditlimit</code></td>
480 <td><code>customeremail</code></td>
481 <td>Email des Kunden; nur für Kunden</td>
484 <td><code>customerfax</code></td>
485 <td>Faxnummer des Kunden; nur für Kunden</td>
488 <td><code>customernotes</code></td>
489 <td>Bemerkungen beim Kunden; nur für Kunden</td>
492 <td><code>customernumber</code></td>
493 <td>Kundennummer; nur für Kunden</td>
496 <td><code>customerphone</code></td>
497 <td>Telefonnummer des Kunden; nur für Kunden</td>
500 <td><code>discount</code></td>
504 <td><code>email</code></td>
505 <td>Emailadresse</td>
508 <td><code>fax</code></td>
512 <td><code>homepage</code></td>
516 <td><code>iban</code></td>
517 <td>Internationale Kontonummer (International Bank Account Number, IBAN)</td>
520 <td><code>language</code></td>
524 <td><code>name</code></td>
528 <td><code>payment_description</code></td>
529 <td>Name der Zahlart</td>
532 <td><code>payment_terms</code></td>
533 <td>Zahlungskonditionen</td>
536 <td><code>phone</code></td>
537 <td>Telefonnummer</td>
540 <td><code>shiptocity</code></td>
541 <td>Stadt (Lieferadresse)
542 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
545 <td><code>shiptocontact</code></td>
546 <td>Kontakt (Lieferadresse)
547 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
550 <td><code>shiptocountry</code></td>
551 <td>Land (Lieferadresse)
552 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
555 <td><code>shiptodepartment1</code></td>
556 <td>Abteilung 1 (Lieferadresse)
557 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
560 <td><code>shiptodepartment2</code></td>
561 <td>Abteilung 2 (Lieferadresse)
562 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
565 <td><code>shiptoemail</code></td>
566 <td>Email (Lieferadresse)
567 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
570 <td><code>shiptofax</code></td>
571 <td>Fax (Lieferadresse)
572 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
575 <td><code>shiptoname</code></td>
576 <td>Firmenname (Lieferadresse)
577 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
580 <td><code>shiptophone</code></td>
581 <td>Telefonnummer (Lieferadresse)
582 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
585 <td><code>shiptostreet</code></td>
586 <td>Straße und Hausnummer (Lieferadresse)
587 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
590 <td><code>shiptozipcode</code></td>
591 <td>Postleitzahl (Lieferadresse)
592 <a href="dokumentenvorlagen-und-variablen.html#anmerkung_shipto">*</a></td>
595 <td><code>street</code></td>
596 <td>Straße und Hausnummer</td>
599 <td><code>taxnumber</code></td>
600 <td>Steuernummer</td>
603 <td><code>ustid</code></td>
604 <td>Usatzsteuer-Identifikationsnummer</td>
608 <td><code>vendoremail</code></td>
609 <td>Email des Lieferanten; nur für Lieferanten</td>
612 <td><code>vendorfax</code></td>
613 <td>Faxnummer des Lieferanten; nur für Lieferanten</td>
616 <td><code>vendornotes</code></td>
617 <td>Bemerkungen beim Lieferanten; nur für Lieferanten</td>
620 <td><code>vendornumber</code></td>
621 <td>Lieferantennummer; nur für Lieferanten</td>
624 <td><code>vendorphone</code></td>
625 <td>Telefonnummer des Lieferanten; nur für Lieferanten</td>
628 <td><code>zipcode</code></td>
629 <td>Postleitzahl</td>
634 <p><a name="anmerkung_shipto"><em>Anmerkung</em></a>: Sind die
635 <code>shipto*</code>-Felder in den Stammdaten nicht eingetragen, so haben
636 die Variablen <code>shipto*</code> den gleichen Wert wie die die
637 entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich einige
638 <code>shipto*</code>-Variablen so nicht in den Stammdaten wiederfinden
639 sondern schlicht Kopien der Lieferdatenvariablen sind
640 (z.B. <code>shiptocontact</code>).</p>
642 <h3><a name="allgemein_bearbeiter">
643 Informationen über den Bearbeiter:</a></h3>
647 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
649 <td><code>employee_address</code></td>
653 <td><code>employee_businessnumber</code></td>
654 <td>Firmennummer</td>
657 <td><code>employee_company</code></td>
661 <td><code>employee_co_ustid</code></td>
662 <td>Usatzsteuer-Identifikationsnummer</td>
665 <td><code>employee_duns</code></td>
669 <td><code>employee_email</code></td>
673 <td><code>employee_fax</code></td>
677 <td><code>employee_name</code></td>
681 <td><code>employee_signature</code></td>
685 <td><code>employee_taxnumber</code></td>
686 <td>Steuernummer</td>
689 <td><code>employee_tel</code></td>
690 <td>Telefonnummer</td>
695 <h3><a name="allgemein_verkaeufer">
696 Informationen über den Verkäufer (nur bei Verkaufsmasken):</a></h3>
700 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
702 <td><code>salesman_address</code></td>
706 <td><code>salesman_businessnumber</code></td>
707 <td>Firmennummer</td>
710 <td><code>salesman_company</code></td>
714 <td><code>salesman_co_ustid</code></td>
715 <td>Usatzsteuer-Identifikationsnummer</td>
718 <td><code>salesman_duns</code></td>
722 <td><code>salesman_email</code></td>
726 <td><code>salesman_fax</code></td>
730 <td><code>salesman_name</code></td>
734 <td><code>salesman_signature</code></td>
738 <td><code>salesman_taxnumber</code></td>
739 <td>Steuernummer</td>
742 <td><code>salesman_tel</code></td>
743 <td>Telefonnummer</td>
748 <h3><a name="allgemein_steuern">
749 Variablen für die einzelnen Steuern:</a></h3>
753 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
755 <td><code>tax</code></td>
759 <td><code>taxbase</code></td>
760 <td>zu versteuernder Betrag</td>
763 <td><code>taxdescription</code></td>
764 <td>Name der Steuer</td>
767 <td><code>taxrate</code></td>
773 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
774 zum Inhaltsverzeichnis</a></small><br>
777 <h2><a name="invoice">Variablen in Rechnungen</a></h2>
779 <h3><a name="invoice_allgemein">Allgemeine Variablen:</a></h3>
783 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
785 <td><code>creditremaining</code></td>
786 <td>Verbleibender Kredit</td>
789 <td><code>currency</code></td>
790 <td>Währung</td>
793 <td><code>cusordnumber</code></td>
794 <td>Bestellnummer beim Kunden</td>
797 <td><code>deliverydate</code></td>
801 <td><code>duedate</code></td>
802 <td>Fälligkeitsdatum</td>
805 <td><code>globalprojectnumber</code></td>
806 <td>Projektnummer des ganzen Beleges</td>
809 <td><code>globalprojectdescription</code></td>
810 <td>Projekbeschreibung des ganzen Beleges</td>
813 <td><code>intnotes</code></td>
814 <td>Interne Bemerkungen</td>
817 <td><code>invdate</code></td>
818 <td>Rechnungsdatum</td>
821 <td><code>invnumber</code></td>
822 <td>Rechnungsnummer</td>
825 <td><code>invtotal</code></td>
826 <td>gesamter Rechnungsbetrag</td>
829 <td><code>notes</code></td>
830 <td>Bemerkungen der Rechnung</td>
833 <td><code>orddate</code></td>
834 <td>Auftragsdatum</td>
837 <td><code>ordnumber</code></td>
838 <td>Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde</td>
841 <td><code>payment_description</code></td>
842 <td>Name der Zahlart</td>
845 <td><code>payment_terms</code></td>
846 <td>Zahlungskonditionen</td>
849 <td><code>quodate</code></td>
850 <td>Angebotsdatum</td>
853 <td><code>quonumber</code></td>
854 <td>Angebotsnummer</td>
857 <td><code>shippingpoint</code></td>
861 <td><code>shipvia</code></td>
862 <td>Transportmittel</td>
865 <td><code>subtotal[_nofmt]</code></td>
866 <td>Zwischensumme aller Posten ohne Steuern</td>
869 <td><code>sumcarriedforward</code></td>
870 <td>Zwischensumme aller bisher ausgegebenen Posten. Sollte nur in einem
871 <a href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">
872 <code>pagebreak</code></a>-Block verwendet werden.</td>
875 <td><code>total</code></td>
876 <td>Restsumme der Rechnung (Summe abzüglich bereits bezahlter Posten)</td>
879 <td><code>transaction_description</code></td>
880 <td>Vorgangsbezeichnung</td>
883 <td><code>transdate</code></td>
884 <td>Auftragsdatum wenn die Rechnung aus einem Auftrag erstellt wurde</td>
889 <h3><a name="invoice_posten">
890 Variablen für jeden Posten auf der Rechnung:</a></h3>
894 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
896 <td><code>bin</code></td>
900 <td><code>description</code></td>
901 <td>Artikelbeschreibung</td>
904 <td><code>discount[_nofmt]</code></td>
905 <td>Rabatt als Betrag</td>
908 <td><code>discount_sub[_nofmt]</code></td>
909 <td>Zwischensumme mit Rabatt</td>
912 <td><code>drawing</code></td>
916 <td><code>ean</code></td>
920 <td><code>image</code></td>
924 <td><code>linetotal[_nofmt]</code></td>
925 <td>Zeilensumme (Anzahl * Einzelpreis)</td>
928 <td><code>longdescription</code></td>
932 <td><code>microfiche</code></td>
936 <td><code>netprice[_nofmt]</code></td>
940 <td><code>nodiscount_linetotal[_nofmt]</code></td>
941 <td>Zeilensumme ohne Rabatt</td>
944 <td><code>nodiscount_sub[_nofmt]</code></td>
945 <td>Zwischensumme ohne Rabatt</td>
948 <td><code>number</code></td>
949 <td>Artikelnummer</td>
952 <td><code>ordnumber_oe</code></td>
953 <td>Auftragsnummer des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
956 <td><code>p_discount</code></td>
957 <td>Rabatt in Prozent</td>
960 <td><code>partnotes</code></td>
961 <td>Die beim Artikel gespeicherten Bemerkungen</td>
964 <td><code>partsgroup</code></td>
968 <td><code>price_factor</code></td>
969 <td>Der Preisfaktor als Zahl, sofern einer eingestellt ist</td>
972 <td><code>price_factor_name</code></td>
973 <td>Der Name des Preisfaktors, sofern einer eingestellt ist</td>
976 <td><code>projectnumber</code></td>
977 <td>Projektnummer</td>
980 <td><code>projectdescription</code></td>
981 <td>Projektbeschreibung</td>
984 <td><code>qty[_nofmt]</code></td>
988 <td><code>reqdate</code></td>
992 <td><code>runningnumber</code></td>
993 <td>Position auf der Rechnung (1, 2, 3...)</td>
996 <td><code>sellprice[_nofmt]</code></td>
997 <td>Verkaufspreis</td>
1000 <td><code>serialnumber</code></td>
1001 <td>Seriennummer</td>
1004 <td><code>tax_rate</code></td>
1008 <td><code>transdate_oe</code></td>
1009 <td>Auftragsdatum des Originalauftrags, wenn die Rechnung aus einem Sammelauftrag erstellt wurde</td>
1012 <td><code>unit</code></td>
1016 <td><code>weight</code></td>
1022 <p>Für jeden Posten gibt es ein Unterarray mit den Informationen über
1023 Lieferanten und Lieferantenartikelnummer. Diese müssen mit
1024 einer <code>foreach</code>-Schleife ausgegeben werden, da für jeden
1025 Artikel mehrere Lieferanteninformationen hinterlegt sein können. Die
1026 Variablen dafür lauten:</p>
1030 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1032 <td><code>make</code></td>
1036 <td><code>model</code></td>
1037 <td>Lieferantenartikelnummer</td>
1042 <h3><a name="invoice_zahlungen">
1043 Variablen für die einzelnen Zahlungseingänge:</a></h3>
1047 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1049 <td><code>payment</code></td>
1053 <td><code>paymentaccount</code></td>
1057 <td><code>paymentdate</code></td>
1061 <td><code>paymentmemo</code></td>
1065 <td><code>paymentsource</code></td>
1071 <h3><a name="invoice_benutzerdefinierte_variablen_vc">
1072 Benutzerdefinierte Kunden- und Lieferantenvariablen:</a></h3>
1075 Die vom Benutzer definierten Variablen für Kunden und
1076 Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen
1077 ebenfalls zur Verfügung. Ihre Namen setzen sich aus dem
1078 Präfix <code>vc_cvar_</code> und dem vom Benutzer festgelegten
1079 Variablennamen zusammen.</p>
1081 <p>Beispiel: Der Benutzer hat eine Variable
1082 namens <code>number_of_employees</code> definiert, die die Anzahl
1083 der Mitarbeiter des Unternehmens enthält. Diese Variable steht
1084 dann unter dem Namen <code>vc_cvar_number_of_employees</code> zur
1087 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1088 zum Inhaltsverzeichnis</a></small><br>
1091 <h2><a name="dunning">Variablen in Mahnungen und Rechnungen über Mahngebühren</a></h2>
1093 <h3><a name="dunning_vorlagennamen">Namen der Vorlagen</a></h3>
1095 <p>Die Namen der Vorlagen werden im System-Menü vom Benutzer
1096 eingegeben. Wird für ein Mahnlevel die Option zur automatischen
1097 Erstellung einer Rechnung über die Mahngebühren und Zinsen
1098 aktiviert, so wird der Name der Vorlage für diese Rechnung aus
1099 dem Vorlagenname für diese Mahnstufe mit dem
1100 Zusatz <code>_invoice</code> gebildet. Weiterhin werden die
1101 Kürzel für die ausgewählte Sprache und den
1102 ausgewählten Drucker angehängt.</p>
1104 <h3><a name="dunning_allgemein">Allgemeine Variablen in Mahnungen:</a></h3>
1106 <p>Die Variablen des Verkäufers stehen wie gewohnt
1107 als <code>employee_...</code> zur Verfügung. Die Adressdaten des
1108 Kunden stehen als Variablen <code>name</code>, <code>street</code>,
1109 <code>zipcode</code>, <code>city</code>, <code>country</code>,
1110 <code>department_1</code>, <code>department_2</code>, und
1111 <code>email</code> zur Verfügung.
1114 <p>Weitere Variablen beinhalten:</p>
1118 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1120 <td><code>dunning_date</code></td>
1121 <td>Datum der Mahnung</td>
1124 <td><code>dunning_duedate</code></td>
1125 <td>Fälligkeitsdatum für diese Mahhnung</td>
1128 <td><code>dunning_id</code></td>
1129 <td>Mahnungsnummer</td>
1132 <td><code>fee</code></td>
1133 <td>Kummulative Mahngebühren</td>
1136 <td><code>interest_rate</code></td>
1137 <td>Zinssatz per anno in Prozent</td>
1140 <td><code>total_amount</code></td>
1141 <td>Gesamter noch zu zahlender Betrag als <code>fee</code> + <code>total_interest</code> + <code>total_open_amount</code></td>
1144 <td><code>total_interest</code></td>
1145 <td>Zinsen per anno über alle Rechnungen</td>
1148 <td><code>total_open_amount</code></td>
1149 <td>Summe über alle offene Beträge der Rechnungen</td>
1154 <h3><a name="dunning_details">
1155 Variablen für jede gemahnte Rechnung in einer Mahnung:</a></h3>
1159 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1161 <td><code>dn_amount</code></td>
1162 <td>Rechnungssumme (brutto)</td>
1165 <td><code>dn_duedate</code></td>
1166 <td>Originales Fälligkeitsdatum der Rechnung</td>
1169 <td><code>dn_dunning_date</code></td>
1170 <td>Datum der Mahnung</td>
1173 <td><code>dn_dunning_duedate</code></td>
1174 <td>Fälligkeitsdatum der Mahnung</td>
1177 <td><code>dn_fee</code></td>
1178 <td>Kummulative Mahngebühr</td>
1181 <td><code>dn_interest</code></td>
1182 <td>Zinsen per anno für diese Rechnung</td>
1185 <td><code>dn_invnumber</code></td>
1186 <td>Rechnungsnummer</td>
1189 <td><code>dn_linetotal</code></td>
1190 <td>Noch zu zahlender Betrag (ergibt sich aus <code>dn_open_amount + dn_fee + dn_interest</code>)</td>
1193 <td><code>dn_netamount</code></td>
1194 <td>Rechnungssumme (netto)</td>
1197 <td><code>dn_open_amount</code></td>
1198 <td>Offener Rechnungsbetrag</td>
1201 <td><code>dn_ordnumber</code></td>
1202 <td>Bestellnummer</td>
1205 <td><code>dn_transdate</code></td>
1206 <td>Rechnungsdatum</td>
1211 <h3><a name="dunning_invoice">Variablen in automatisch erzeugten
1212 Rechnungen über Mahngebühren</a></h3>
1214 <p>Die Variablen des Verkäufers stehen wie gewohnt
1215 als <code>employee_...</code> zur Verfügung. Die Adressdaten des
1216 Kunden stehen als Variablen <code>name</code>, <code>street</code>,
1217 <code>zipcode</code>, <code>city</code>, <code>country</code>,
1218 <code>department_1</code>, <code>department_2</code>, und
1219 <code>email</code> zur Verfügung.
1222 <p>Weitere Variablen beinhalten:</p>
1226 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1228 <td><code>duedate</code></td>
1229 <td>Fälligkeitsdatum der Rechnung</td>
1232 <td><code>dunning_id</code></td>
1233 <td>Mahnungsnummer</td>
1236 <td><code>fee</code></td>
1237 <td>Mahngebühren</td>
1240 <td><code>interest</code></td>
1244 <td><code>invamount</code></td>
1245 <td>Rechnungssumme (ergibt sich aus <code>fee + interest</code>)</td>
1248 <td><code>invdate</code></td>
1249 <td>Rechnungsdatum</td>
1252 <td><code>invnumber</code></td>
1253 <td>Rechnungsnummer</td>
1258 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1259 zum Inhaltsverzeichnis</a></small><br>
1262 <h2><a name="anderevorlagen">
1263 Variablen in anderen Vorlagen</a></h2>
1265 <p>Die Variablen in anderen Vorlagen sind ähnlich wie in der
1266 Rechnung. Allerdings heißen die Variablen, die mit <code>inv</code>
1267 beginnen, jetzt anders. Bei den Angeboten fangen sie mit <code>quo</code>
1268 für "quotation" an: <code>quodate</code> für Angebotsdatum
1269 etc. Bei Bestellungen wiederum fangen sie mit <code>ord</code> für
1270 "order" an: <code>ordnumber</code> für Bestellnummer etc.</p>
1272 <p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht vorhanden wie
1273 z.B. die für bereits verbuchte Zahlungseingänge. Dies sind
1274 Variablen, die vom Geschäftsablauf her in der entsprechenden Vorlage
1275 keine Bedeutung haben oder noch nicht belegt sein können.</p>
1277 <p>Im Folgenden werden nur wichtige Unterschiede zu den Variablen in
1278 Rechnungen aufgeführt.</p>
1280 <h3><a name="anderevorlagen_quotations">Angebote und Preisanfragen</a></h3>
1284 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1286 <td><code>quonumber</code></td>
1287 <td>Angebots- bzw. Anfragenummer</td>
1290 <td><code>reqdate</code></td>
1291 <td>Gültigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei Preisanfragen)</td>
1294 <td><code>transdate</code></td>
1295 <td>Angebots- bzw. Anfragedatum</td>
1300 <h3><a name="anderevorlagen_orders">Auftragsbestätigungen und Lieferantenaufträge</a></h3>
1304 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1306 <td><code>ordnumber</code></td>
1307 <td>Auftragsnummer</td>
1310 <td><code>reqdate</code></td>
1311 <td>Lieferdatum</td>
1314 <td><code>transdate</code></td>
1315 <td>Auftragsdatum</td>
1320 <h3><a name="anderevorlagen_delivery_orders">Lieferscheine (Verkauf und Einkauf)</a></h3>
1324 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1326 <td><code>cusordnumber</code></td>
1327 <td>Bestellnummer des Kunden (im Verkauf) bzw. Bestellnummer des Lieferanten (im Einkauf)</td>
1330 <td><code>donumber</code></td>
1331 <td>Lieferscheinnummer</td>
1334 <td><code>transdate</code></td>
1335 <td>Lieferscheindatum</td>
1340 <p>Für jede Position eines Lieferscheines gibt es ein Unterarray mit
1341 den Informationen darüber, von welchem Lager und Lagerplatz aus die
1342 Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
1343 Lagerplatz sie eingelagert wurden. Diese müssen mittels
1344 einer <code>foreach</code>-Schleife ausgegeben werden. Diese
1348 <p>Für jede Position eines Lieferscheines gibt es ein Unterarray mit
1349 den Informationen darüber, von welchem Lager und Lagerplatz aus die
1350 Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
1351 Lagerplatz sie eingelagert wurden. Diese müssen mittels
1352 einer <code>foreach</code>-Schleife ausgegeben werden. Diese
1357 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1359 <td><code>si_bin</code></td>
1363 <td><code>si_chargenumber</code></td>
1364 <td>Chargennummer</td>
1367 <td><code>si_bestbefore</code></td>
1368 <td>Mindesthaltbarkeit</td>
1371 <td><code>si_number</code></td>
1372 <td>Artikelnummer</td>
1375 <td><code>si_qty</code></td>
1376 <td>Anzahl bzw. Menge</td>
1379 <td><code>si_runningnumber</code></td>
1380 <td>Positionsnummer (1, 2, 3 etc)</td>
1383 <td><code>si_unit</code></td>
1387 <td><code>si_warehouse</code></td>
1393 <h3><a name="anderevorlagen_statement">Sammelrechnung</a></h3>
1395 <h3> Variablen für Sammelrechnung:</h3>
1398 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1400 <td><code>c0total</code></td>
1401 <td>Gesamtbetrag aller Rechnungen mit Fälligkeit < 30 Tage</td>
1404 <td><code>c30total</code></td>
1405 <td>Gesamtbetrag aller Rechnungen mit Fälligkeit >= 30 und < 60 Tage</td>
1408 <td><code>c60total</code></td>
1409 <td>Gesamtbetrag aller Rechnungen mit Fälligkeit >= 60 und < 90 Tage</td>
1412 <td><code>c90total</code></td>
1413 <td>Gesamtbetrag aller Rechnungen mit Fälligkeit >= 90 Tage</td>
1416 <td><code>total</code></td>
1417 <td>Gesamtbetrag aller Rechnungen</td>
1422 <h3> Variablen für jede Rechnungsposition in Sammelrechnung:</h3>
1425 <tr><th>Variablenname</th><th>Bedeutung</th></tr>
1427 <td><code>invnumber</code></td>
1428 <td>Rechnungsnummer</td>
1431 <td><code>invdate</code></td>
1432 <td>Rechnungsdatum</td>
1435 <td><code>duedate</code></td>
1436 <td>Fälligkeitsdatum</td>
1439 <td><code>amount</code></td>
1440 <td>Summe der Rechnung</td>
1443 <td><code>open</code></td>
1444 <td>Noch offener Betrag der Rechnung</td>
1447 <td><code>c0</code></td>
1448 <td>Noch offener Rechnungsbetrag mit Fälligkeit < 30 Tage</td>
1451 <td><code>c30</code></td>
1452 <td>Noch offener Rechnungsbetrag mit Fälligkeit >= 30 und < 60 Tage</td>
1455 <td><code>c60</code></td>
1456 <td>Noch offener Rechnungsbetrag mit Fälligkeit >= 60 und < 90 Tage</td>
1459 <td><code>c90</code></td>
1460 <td>Noch offener Rechnungsbetrag mit Fälligkeit >= 90 Tage</td>
1468 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1469 zum Inhaltsverzeichnis</a></small><br>
1472 <h2><a name="bloecke">
1473 Blöcke, bedingte Anweisungen und Schleifen</a></h2>
1475 <p>Der Parser kennt neben den Variablen einige weitere Konstrukte,
1476 die gesondert behandelt werden. Diese sind wie Variablennamen in
1477 spezieller Weise markiert: <code><%anweisung%>
1478 ... <%end%></code></p>
1480 <p>Anmerkung zum <code><%end%></code>: Der besseren
1481 Verständlichkeit halber kann man nach dem <code>end</code> noch
1482 beliebig weitere Wörter schreiben, um so zu markieren, welche
1483 Anweisung (z.B. <code>if</code> oder <code>foreach</code>) damit
1484 abgeschlossen wird.</p>
1486 <p>Beispiel: Lautet der Beginn eines Blockes
1487 z.B. <code class="blue"><%if type ==
1488 "sales_quotation"%></code>, so könnte er mit
1489 <code class="blue"><%end%></code> genauso abgeschlossen werden
1491 <code class="blue"><%end if%></code> oder auch
1492 <code class="blue"><%end type ==
1493 "sales_quotation"%></code>.</p>
1495 <h3><a name="bloecke_if">Der <code>if</code>-Block</a></h3>
1497 <p class="blue"><code><%if variablenname%><br>
1499 <%end%></code></p>
1501 <p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen
1502 dem "if" und dem "end" werden nur ausgegeben,
1503 wenn die Variable "variablenname" gesetzt und ungleich 0
1506 <p>Die Bedingung kann auch negiert werden, indem das Wort
1507 "not" nach dem "if" verwendet
1508 wird. Beispiel: <code class="blue"><%if not
1509 cp_greeting%></code></p>
1511 <p>Zusätzlich zu dem einfachen Test, ob eine Variable gesetzt ist
1512 oder nicht, bietet dieser Block auch die Möglichkeit, den Inhalt
1513 einer Variablen mit einer festen Zeichenkette oder einer anderen
1514 Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette
1515 oder einer anderen Variablen vorgenommen wird, hängt davon ab, ob
1516 die rechte Seite des Vergleichsoperators in Anführungszeichen
1517 gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit
1518 anderer Variablen). Zwei Beispiele, die beide Vergleiche zeigen:</p>
1520 <p><code class="blue"><%if var1 == "Wert"%></code>
1521 testet die Variable "var1" auf Übereinstimmung mit der
1522 Zeichenkette "Wert". Mittels "!=" anstelle von
1523 "==" würde auf Ungleichheit getestet.</p>
1525 <p><code class="blue"><%if var1 == var2%></code> testet die
1526 Variable "var1" auf Übereinstimmung mit der Variablen
1527 "var2". Mittels "!=" anstelle von "=="
1528 würde auf Ungleichheit getestet.</p>
1530 <p>Erfahrere Benutzer können neben der Tests auf (Un-)Gleichheit auch
1531 Tests auf Übereinstimmung mit regulären Ausdrücken ohne
1532 Berücksichtung der Groß- und Kleinschreibung durchführen. Dazu dient
1533 dieselbe Syntax wie oben nur mit "=~" und "!~"
1534 als Vergleichsoperatoren.</p>
1536 <p>Beispiel für einen Test, ob die Variable "intnotes"
1537 (interne Bemerkungen) das Wort "schwierig" enthält:
1538 <code class="blue"><%if intnotes =~
1539 "schwierig"%></code></p>
1541 <h3><a name="bloecke_foreach">Die <code>foreach</code>-Schleife</a></h3>
1543 <p class="blue"><code><%foreach variablenname%><br>
1545 <%end%></code></p>
1547 <p>Fügt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
1548 Perl-Array der Variablen "variablenname" Elemente enthät. Dieses
1549 Konstrukt wird zur Ausgabe der einzelnen Posten einer Rechnung / eines
1550 Angebots sowie zur Ausgabe der Steuern benutzt. In jedem Durchlauf werden
1551 die <a href="dokumentenvorlagen-und-variablen.html#invoice_posten">zeilenbezogenen
1552 Variablen</a> jeweils auf den Wert für die aktuelle Position
1555 <p>Die Syntax sieht normalerweise wie folgt aus:</p>
1557 <p class="blue"><code><%foreach number%><br>
1558 Position: <%runningnumber%><br>
1559 Anzahl: <%qty%><br>
1560 Artikelnummer: <%number%><br>
1561 Beschreibung: <%description%><br>
1563 <%end%></code></p>
1565 <p>Besonderheit in OpenDocument-Vorlagen: Tritt ein
1566 <code><%foreach%></code>-Block innerhalb einer Tabellenzelle
1567 auf, so wird die komplette Tabellenzeile so oft wiederholt wie
1568 notwendig. Tritt er außerhalb auf, so wird nur der Inhalt
1569 zwischen <code><%foreach%></code> und <code><%end%></code>
1570 wiederholt, nicht aber die komplette Zeile, in der er steht.</p>
1572 <h3><a name="bloecke_pagebreak">Der <code>pagebreak</code>-Block</a></h3>
1574 <p class="blue"><code><%pagebreak ZpZ ZeS ZzS%><br>
1576 <%end%></code></p>
1578 <p>Dieser Block existiert nur in LaTeX-Vorlagen.</p>
1580 <p>Dieser Block legt das Verhalten beim manuellen Einfügen eines
1581 Seitenumbruchs fest. Normalerweise bricht LaTeX die Seiten selber um. Beim
1582 Rechnungsdruck ist das oft nicht gewünscht, oder man möchte im
1583 Falle eines Seitenumbruchs den Übertrag etc. mit ausgeben. Deswegen
1584 versucht der Parser, manuell Seitenumbrüche einzufügen,
1585 während er einen <code>foreach</code>-Block auswertet, weil hier die
1586 manuellen Seitenumbrüche erforderlich werden. Dafür benötigt
1587 der Parser aber drei Informationen:</p>
1591 <li>Wieviele Zeichen passen bei der Variablen "description" pro Posten
1592 in eine Zeile? Das ist der Parameter "ZpZ" (Zeichen pro Zeile).</li>
1593 <li>Wieviele Zeilen/Posten passen auf die erste Seite? Das
1594 ist der Parameter "ZeS" (Zeilen erste Seite).</li>
1595 <li>Wieviele Zeilen/Posten passen auf die zweite und alle nachfolgenden
1596 Seiten? Das ist der Parameter "ZzS" (Zeilen zweite Seite).</li>
1600 <p>Diese Parameter sind drei Zahlen, die manuell durch Verwendung von langen
1601 Warenbezeichnungen und Rechnungen mit vielen Posten bestimmt werden
1604 <p>Üblicherweise wird in diesem Block zuerst die aktuelle Tabelle
1605 geschlossen, eventuell Text eingefügt (z.B. "Fortsetzung auf der
1606 nächsten Seite"), dann ein Seitenumbruch erzwungen, eventuell Text
1607 eingefügt (z.B. "Übertrag von der vorherigen Seite:
1608 <%sumcarriedforward%> EUR") und die Tabelle wieder geöffnet.</p>
1610 <p>Wird kein manueller Seitenumbruch gewüscht, so kann dieser Block
1611 komplett entfallen.</p>
1613 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1614 zum Inhaltsverzeichnis</a></small><br>
1617 <h2><a name="markup">
1618 Markup-Code, der innerhalb von Formularen zur Textformatierung
1619 verwendet werden kann</a></h2>
1621 <p>Wenn der Benutzer innhalb von Formularen in Lx-Office Text anders
1622 formatiert haben möchte, so ist dies begrenzt möglich. Lx-Office
1623 unterstützt die Textformatierung mit HTML-ähnlichen Tags. Der
1624 Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung Teile des
1625 Texts zwischen Start- und Endtags setzen. Dieser Teil wird dann automatisch
1626 in Anweisungen für das ausgewählte Vorlagenformat (HTML oder
1627 PDF über LaTeX) umgesetzt.</p>
1629 <p>Die unterstützen Formatierungen sind:</p>
1633 <tr><th>Formatierung</th><th>Auswirkung</th></tr>
1635 <td><code><b>Text</b></code></td>
1636 <td>Text wird in <b>fettdruck</b> gesetzt.</td>
1639 <td><code><i>Text</i></code></td>
1640 <td>Text wird <i>kursiv</i> gesetzt.</td>
1643 <td><code><u>Text</u></code></td>
1644 <td>Text wird <u>unterstrichen</u>.</td>
1647 <td><code><s>Text</s></code></td>
1648 <td>Text wird <s>durchgestrichen</s>. Diese Formatierung ist nicht bei der
1649 Ausgabe als PDF über LaTeX verfügbar.</td>
1652 <td><code><pagebreak></code></td>
1653 <td>Erzwingt einen Seitenumbruch (siehe unten).</td>
1656 <td><code><bullet></code></td>
1657 <td>Erzeugt einen ausgefüllten Kreis für Aufzählungen (•) (siehe unten).</td>
1662 <p>Eine Besonderheit ist der Befehl <code><pagebreak></code>,
1663 der nur in LaTeX-Vorlagen funktioniert und in anderen Vorlagen
1664 einfach gelöscht wird. Dieser erzwingt unabhängig von der
1666 href="dokumentenvorlagen-und-variablen.html#bloecke_pagebreak">pagebreak-Block</a>
1667 voreingestellten Werte einen Seitenumbruch nach der aktuellen
1668 Rechnungsposition. Dementsprechend funktioniert er nur innerhalb von
1669 <code><%foreach...%></code>-Schleifen. Weiterhin benötigt
1672 <p>Auch <code><bullet></code> funktioniert momentan auch nur in Latex-Vorlagen.</p>
1674 <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
1675 zum Inhaltsverzeichnis</a></small><br>