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