<li><a href="dokumentenvorlagen-und-variablen.html#zuordnung_dateinamen">
Zuordnung von Dateinamen zu den Funktionen</a></li>
+ <li><a href="dokumentenvorlagen-und-variablen.html#tag_style">
+ Anfang und Ende der Tags verändern</a></li>
+
<li><a href="dokumentenvorlagen-und-variablen.html#allgemeine_variablen">
Allgemeine Variablen, die in allen Vorlagen vorhanden sind</a><br>
<li><a href="dokumentenvorlagen-und-variablen.html#allgemein_stammdaten">
Stammdaten von Kunden und Lieferanten</a></li>
+ <li><a href="dokumentenvorlagen-und-variablen.html#allgemein_bearbeiter">
+ Informationen über den Bearbeiter</a></li>
+
<li><a href="dokumentenvorlagen-und-variablen.html#allgemein_verkaeufer">
Informationen über den Verkäufer</a></li>
</ol>
</li>
+ <li><a href="dokumentenvorlagen-und-variablen.html#dunning">
+ Variablen in Mahnungen und Rechnungen über Mahngebühren</a>
+
+ <ol>
+ <li><a href="dokumentenvorlagen-und-variablen.html#dunning_vorlagennamen">
+ Namen der Vorlagen</a></li>
+
+ <li><a href="dokumentenvorlagen-und-variablen.html#dunning_allgemein">
+ Allgemeine Variablen in Mahnungen</a></li>
+
+ <li><a href="dokumentenvorlagen-und-variablen.html#dunning_details">
+ Variablen für jede gemahnte Rechnung in einer Mahnung</a></li>
+
+ <li><a href="dokumentenvorlagen-und-variablen.html#dunning_invoice">
+ Variablen in automatisch erzeugten Rechnungen über Mahngebühren</a></li>
+ </ol>
+ </li>
+
<li><a href="dokumentenvorlagen-und-variablen.html#anderevorlagen">
Variablen in anderen Vorlagen</a></li>
Blöcke, bedingte Anweisungen und Schleifen</a>
<ol>
- <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_einschr_latex">
- Einschänkungen für Blöcke in LaTeX-Vorlagen</a></li>
-
- <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_einschr_opendocument">
- Einschänkungen für Blöcke in OpenDocument-Vorlagen</a></li>
-
- <li><a href="dokumentenvorlagen-und-variablen.html#bloecke_include">
- Die <code>include</code>-Anweisung</a></li>
-
<li><a href="dokumentenvorlagen-und-variablen.html#bloecke_ifnot">
Der <code>if not</code>-Block</a></li>
<p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und aller
zur Bearbeitung verfügbaren Variablen. Eine Variable wird in
einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
- <code><%variablenname%></code> verwendet wird.</p>
+ <code><%variablenname%></code> verwendet wird. Für LaTeX-
+ und HTML-Vorlagen kann man die Form dieser Tags auch
+ <a href="dokumentenvorlagen-und-variablen.html#tag_style">
+ verändern</a>.
+ </p>
<p>Früher wurde hier nur über LaTeX gesprochen. Inzwischen
unterstützt Lx-Office aber auch OpenDocument-Vorlagen. Sofern
zum Inhaltsverzeichnis</a></small><br>
<hr>
+ <h2><a name="tag_style">
+ Anfang und Ende der Tags verändern</a></h2>
+
+ <p>Der Standardstil für Tags sieht vor, dass ein Tag mit dem
+ Kleinerzeichen und einem Prozentzeichen beginnt und mit dem
+ Prozentzeichen und dem Größerzeichen endet,
+ beispielsweise <code><%customer%></code>. Da diese Form aber
+ z.B. in LaTeX zu Problemen führen kann, weil das Prozentzeichen
+ dort Kommentare einleitet, kann pro HTML- oder
+ LaTeX-Dokumentenvorlage der Stil umgestellt werden.</p>
+
+ <p>Dazu werden in die Datei Zeilen geschrieben, die mit dem für
+ das Format gültigen Kommentarzeichen anfangen,
+ dann <code>config:</code> enthalten, die entsprechende Option setzen
+ und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen
+ enden. Beispiel für LaTeX:</p>
+
+ <p><code>% config: tag-style=($ $)</code></p>
+
+ <p>Dies würde Lx-Office dazu veranlassen, Variablen zu ersetzen,
+ wenn sie wie folgt aussehen: <code>($customer$)</code>. Das
+ äquivalente Beispiel für HTML-Dokumentenvorlagen sieht so
+ aus:</p>
+
+ <p><code><!-- config: tag-stye=($ $)></code></p>
+
+ <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
+ zum Inhaltsverzeichnis</a></small><br>
+ <hr>
+
<h2><a name="zuordnung_dateinamen">
Zuordnung von den Dateinamen zu den Funktionen</a></h2>
</tr>
<tr>
<td><code>business</code></td>
- <td>Kundentyp</td>
+ <td>Kunden-/Lieferantentyp</td>
</tr>
<tr>
<td><code>city</code></td>
<td>Kreditlimit</td>
</tr>
<tr>
- <td><code>customernumber</code></td>
- <td>Kundennummer; nur für Kunden</td>
+ <td><code>customeremail</code></td>
+ <td>Email des Kunden; nur für Kunden</td>
+ </tr>
+ <tr>
+ <td><code>customerfax</code></td>
+ <td>Faxnummer des Kunden; nur für Kunden</td>
</tr>
<tr>
<td><code>customernotes</code></td>
<td>Bemerkungen beim Kunden; nur für Kunden</td>
</tr>
+ <tr>
+ <td><code>customernumber</code></td>
+ <td>Kundennummer; nur für Kunden</td>
+ </tr>
+ <tr>
+ <td><code>customerphone</code></td>
+ <td>Telefonnummer des Kunden; nur für Kunden</td>
+ </tr>
<tr>
<td><code>discount</code></td>
<td>Rabatt</td>
<td><code>name</code></td>
<td>Firmenname</td>
</tr>
+ <tr>
+ <td><code>payment_terms</code></td>
+ <td>Zahlungskonditionen</td>
+ </tr>
<tr>
<td><code>phone</code></td>
<td>Telefonnummer</td>
<td><code>taxnumber</code></td>
<td>Steuernummer</td>
</tr>
- <tr>
- <td><code>terms</code></td>
- <td>Zahlungsziel</td>
- </tr>
<tr>
<td><code>vendoremail</code></td>
<td>Email des Lieferanten; nur für Lieferanten</td>
sondern schlicht Kopien der Lieferdatenvariablen sind
(z.B. <code>shiptocontact</code>).</p>
- <h3><a name="allgemein_verkaeufer">
- Informationen über den Verkäufer:</a></h3>
+ <h3><a name="allgemein_bearbeiter">
+ Informationen über den Bearbeiter:</a></h3>
<p>
<table border="1">
<td><code>employee_company</code></td>
<td>Firmenname</td>
</tr>
+ <tr>
+ <td><code>employee_co_ustid</code></td>
+ <td>Usatzsteuer-Identifikationsnummer</td>
+ </tr>
+ <tr>
+ <td><code>employee_duns</code></td>
+ <td>DUNS-Nummer</td>
+ </tr>
<tr>
<td><code>employee_email</code></td>
<td>Email</td>
<td><code>employee_signature</code></td>
<td>Signatur</td>
</tr>
+ <tr>
+ <td><code>employee_taxnumber</code></td>
+ <td>Steuernummer</td>
+ </tr>
<tr>
<td><code>employee_tel</code></td>
<td>Telefonnummer</td>
</table>
</p>
+ <h3><a name="allgemein_verkaeufer">
+ Informationen über den Verkäfer (nur bei Verkaufsmasken):</a></h3>
+
+ <p>
+ <table border="1">
+ <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+ <tr>
+ <td><code>salesman_address</code></td>
+ <td>Adressfeld</td>
+ </tr>
+ <tr>
+ <td><code>salesman_businessnumber</code></td>
+ <td>Firmennummer</td>
+ </tr>
+ <tr>
+ <td><code>salesman_company</code></td>
+ <td>Firmenname</td>
+ </tr>
+ <tr>
+ <td><code>salesman_co_ustid</code></td>
+ <td>Usatzsteuer-Identifikationsnummer</td>
+ </tr>
+ <tr>
+ <td><code>salesman_duns</code></td>
+ <td>DUNS-Nummer</td>
+ </tr>
+ <tr>
+ <td><code>salesman_email</code></td>
+ <td>Email</td>
+ </tr>
+ <tr>
+ <td><code>salesman_fax</code></td>
+ <td>Fax</td>
+ </tr>
+ <tr>
+ <td><code>salesman_name</code></td>
+ <td>voller Name</td>
+ </tr>
+ <tr>
+ <td><code>salesman_signature</code></td>
+ <td>Signatur</td>
+ </tr>
+ <tr>
+ <td><code>salesman_taxnumber</code></td>
+ <td>Steuernummer</td>
+ </tr>
+ <tr>
+ <td><code>salesman_tel</code></td>
+ <td>Telefonnummer</td>
+ </tr>
+ </table>
+ </p>
+
<h3><a name="allgemein_steuern">
Variablen für die einzelnen Steuern:</a></h3>
<td><code>duedate</code></td>
<td>Fälligkeitsdatum</td>
</tr>
+ <tr>
+ <td><code>globalprojectnumber</code></td>
+ <td>Projektnummer des ganzen Beleges</td>
+ </tr>
<tr>
<td><code>intnotes</code></td>
<td>Interne Bemerkungen</td>
<td><code>notes</code></td>
<td>Bemerkungen der Rechnung</td>
</tr>
+ <tr>
+ <td><code>orddate</code></td>
+ <td>Auftragsdatum</td>
+ </tr>
<tr>
<td><code>ordnumber</code></td>
<td>Auftragsnummer, wenn die Rechnung aus einem Auftrag erstellt wurde</td>
</tr>
+ <tr>
+ <td><code>payment_terms</code></td>
+ <td>Zahlungskonditionen</td>
+ </tr>
+ <tr>
+ <td><code>quodate</code></td>
+ <td>Angebotsdatum</td>
+ </tr>
<tr>
<td><code>quonumber</code></td>
<td>Angebotsnummer</td>
<td><code>total</code></td>
<td>Restsumme der Rechnung (Summe abzüglich bereits bezahlter Posten)</td>
</tr>
+ <tr>
+ <td><code>transaction_description</code></td>
+ <td>Vorgangsbezeichnung</td>
+ </tr>
<tr>
<td><code>transdate</code></td>
<td>Auftragsdatum wenn die Rechnung aus einem Auftrag erstellt wurde</td>
<td><code>partsgroup</code></td>
<td>Warengruppe</td>
</tr>
+ <tr>
+ <td><code>price_factor</code></td>
+ <td>Der Preisfaktor als Zahl, sofern einer eingestellt ist</td>
+ </tr>
+ <tr>
+ <td><code>price_factor_name</code></td>
+ <td>Der Name des Preisfaktors, sofern einer eingestellt ist</td>
+ </tr>
<tr>
<td><code>projectnumber</code></td>
<td>Projektnummer</td>
zum Inhaltsverzeichnis</a></small><br>
<hr>
+ <h2><a name="dunning">Variablen in Mahnungen und Rechnungen über Mahngebühren</a></h2>
+
+ <h3><a name="dunning_vorlagennamen">Namen der Vorlagen</a></h3>
+
+ <p>Die Namen der Vorlagen werden im System-Menü vom Benutzer
+ eingegeben. Wird für ein Mahnlevel die Option zur automatischen
+ Erstellung einer Rechnung über die Mahngebühren und Zinsen
+ aktiviert, so wird der Name der Vorlage für diese Rechnung aus
+ dem Vorlagenname für diese Mahnstufe mit dem
+ Zusatz <code>_invoice</code> gebildet. Weiterhin werden die
+ Kürzel für die ausgewählte Sprache und den
+ ausgewählten Drucker angehängt.</p>
+
+ <h3><a name="dunning_allgemein">Allgemeine Variablen in Mahnungen:</a></h3>
+
+ <p>Die Variablen des Verkäufers stehen wie gewohnt
+ als <code>employee_...</code> zur Verfügung. Die Adressdaten des
+ Kunden stehen als Variablen <code>name</code>, <code>street</code>,
+ <code>zipcode</code>, <code>city</code>, <code>country</code>,
+ <code>department_1</code>, <code>department_2</code>, und
+ <code>email</code> zur Verfügung.
+ </p>
+
+ <p>Weitere Variablen beinhalten:</p>
+
+ <p>
+ <table border="1">
+ <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+ <tr>
+ <td><code>dunning_date</code></td>
+ <td>Datum der Mahnung</td>
+ </tr>
+ <tr>
+ <td><code>dunning_duedate</code></td>
+ <td>Fälligkeitsdatum für diese Mahhnung</td>
+ </tr>
+ <tr>
+ <td><code>fee</code></td>
+ <td>Kummulative Mahngebühren</td>
+ </tr>
+ <tr>
+ <td><code>interest_rate</code></td>
+ <td>Zinssatz per anno in Prozent</td>
+ </tr>
+ <tr>
+ <td><code>total_amount</code></td>
+ <td>Gesamter noch zu zahlender Betrag als <code>fee</code> + <code>total_interest</code> + <code>total_open_amount</code></td>
+ </tr>
+ <tr>
+ <td><code>total_interest</code></td>
+ <td>Zinsen per anno über alle Rechnungen</td>
+ </tr>
+ <tr>
+ <td><code>total_open_amount</code></td>
+ <td>Summe über alle offene Beträge der Rechnungen</td>
+ </tr>
+ </table>
+ </p>
+
+ <h3><a name="dunning_details">
+ Variablen für jede gemahnte Rechnung in einer Mahnung:</a></h3>
+
+ <p>
+ <table border="1">
+ <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+ <tr>
+ <td><code>dn_amount</code></td>
+ <td>Rechnungssumme (brutto)</td>
+ </tr>
+ <tr>
+ <td><code>dn_duedate</code></td>
+ <td>Originales Fälligkeitsdatum der Rechnung</td>
+ </tr>
+ <tr>
+ <td><code>dn_dunning_date</code></td>
+ <td>Datum der Mahnung</td>
+ </tr>
+ <tr>
+ <td><code>dn_dunning_duedate</code></td>
+ <td>Fälligkeitsdatum der Mahnung</td>
+ </tr>
+ <tr>
+ <td><code>dn_fee</code></td>
+ <td>Kummulative Mahngebühr</td>
+ </tr>
+ <tr>
+ <td><code>dn_interest</code></td>
+ <td>Zinsen per anno für diese Rechnung</td>
+ </tr>
+ <tr>
+ <td><code>dn_invnumber</code></td>
+ <td>Rechnungsnummer</td>
+ </tr>
+ <tr>
+ <td><code>dn_linetotal</code></td>
+ <td>Noch zu zahlender Betrag (ergibt sich aus <code>dn_open_amount + dn_fee + dn_interest</code>)</td>
+ </tr>
+ <tr>
+ <td><code>dn_netamount</code></td>
+ <td>Rechnungssumme (netto)</td>
+ </tr>
+ <tr>
+ <td><code>dn_open_amount</code></td>
+ <td>Offener Rechnungsbetrag</td>
+ </tr>
+ <tr>
+ <td><code>dn_ordnumber</code></td>
+ <td>Bestellnummer</td>
+ </tr>
+ <tr>
+ <td><code>dn_transdate</code></td>
+ <td>Rechnungsdatum</td>
+ </tr>
+ </table>
+ </p>
+
+ <h3><a name="dunning_invoice">Variablen in automatisch erzeugten
+ Rechnungen über Mahngebühren</a></h3>
+
+ <p>Die Variablen des Verkäufers stehen wie gewohnt
+ als <code>employee_...</code> zur Verfügung. Die Adressdaten des
+ Kunden stehen als Variablen <code>name</code>, <code>street</code>,
+ <code>zipcode</code>, <code>city</code>, <code>country</code>,
+ <code>department_1</code>, <code>department_2</code>, und
+ <code>email</code> zur Verfügung.
+ </p>
+
+ <p>Weitere Variablen beinhalten:</p>
+
+ <p>
+ <table border="1">
+ <tr><th>Variablenname</th><th>Bedeutung</th></tr>
+ <tr>
+ <td><code>duedate</code></td>
+ <td>Fälligkeitsdatum der Rechnung</td>
+ </tr>
+ <tr>
+ <td><code>dunning_id</code></td>
+ <td>Mahnungsnummer</td>
+ </tr>
+ <tr>
+ <td><code>fee</code></td>
+ <td>Mahngebühren</td>
+ </tr>
+ <tr>
+ <td><code>interest</code></td>
+ <td>Zinsen</td>
+ </tr>
+ <tr>
+ <td><code>invamount</code></td>
+ <td>Rechnungssumme (ergibt sich aus <code>fee + interest</code>)</td>
+ </tr>
+ <tr>
+ <td><code>invdate</code></td>
+ <td>Rechnungsdatum</td>
+ </tr>
+ <tr>
+ <td><code>invnumber</code></td>
+ <td>Rechnungsnummer</td>
+ </tr>
+ </table>
+ </p>
+
+ <small><a href="dokumentenvorlagen-und-variablen.html#inhaltsverzeichnis">
+ zum Inhaltsverzeichnis</a></small><br>
+ <hr>
+
<h2><a name="anderevorlagen">
Variablen in anderen Vorlagen</a></h2>
gesondert behandelt werden. Diese sind wie Variablennamen in spezieller
Weise markiert: <code><%anweisung%></code></p>
- <h3><a name="bloecke_einschr_latex">
- Einschänkungen für Blöcke in LaTeX-Vorlagen</a></h3>
-
- <p>Achtung: Blöcke können in LaTeX-Vorlagen momentan nicht
- verschachtelt werden. Das bedeutet, dass innerhalb einer
- <code><%foreach%></code>-Schleife keine
- <code><%if%></code>-Abfragen verwendet werden können. Dieses
- kann man aber mit LaTeX-Bordmitteln selber nachgebildet werden. Dazu muss
- im Vorspann das Paket <code>ifthen</code> eingebunden werden. Das Konstrukt
- selber sieht dann wie folgt aus:</p>
-
- <p class="blue"><code>\ifthenelse{\equal{<%variable%>}{}}{}{Dieser
- Text erscheint nur, wenn <%variable%> nicht leer ist.}</code></p>
-
- <h3><a name="bloecke_einschr_opendocument">
- Einschänkungen für Blöcke in OpenDocument-Vorlagen</a></h3>
-
- <p>Die eben erwähnten Einschränkungen für
- LaTeX-Vorlagen gelten in abgeschwächter Form auch für
- OpenDocument-Vorlagen. Auch bei OpenDocument-Vorlagen können
- Blöcke nicht verschachtelt werden. Einzige Ausnahme ist, dass
- <code><if></code> und
- <code><ifnot></code>-Blöcke innerhalb von
- <code><foreach></code>-Blöcken auftreten
- dürfen.</p>
-
- <h3><a name="bloecke_include">Die <code>include</code>-Anweisung</a></h3>
-
- <p class="blue"><code><%include dateiname.ext%></code></p>
-
- <p>Dieser Block funktioniert nur in LaTeX- und HTML-Vorlagen.</p>
-
- <p>Fügt den Inhalt einer Datei an der entsprechenden Stelle ein. Der
- eingefügte Text wird ganz normal durch den Parser behandelt und kann
- Variablen und Blöcke enthalten.</p>
-
<h3><a name="bloecke_ifnot">Der <code>if not</code>-Block</a></h3>
<p class="blue"><code><%if not variablenname%><br>
...<br>
- <%end if></code></p>
+ <%end></code></p>
<p>Eine normale "if-not-then"-Bedingung. Die Zeilen zwischen dem "if not" und
dem "end" werden nur ausgegeben, wenn die Variable "variablenname" nicht
<p class="blue"><code><%if variablenname%><br>
...<br>
- <%end if></code></p>
+ <%end></code></p>
<p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" und dem
"end" werden nur ausgegeben, wenn die Variable "variablenname" gesetzt und
<p class="blue"><code><%foreach variablenname%><br>
...<br>
- <%end foreach></code></p>
+ <%end></code></p>
<p>Fügt die Zeilen zwischen den beiden Anweisungen so oft ein, wie das
Perl-Array der Variablen "variablenname" Elemente enthät. Dieses
Artikelnummer: <%number%><br>
Beschreibung: <%description%><br>
...<br>
- <%end foreach></code></p>
+ <%end></code></p>
<p>Besonderheit in OpenDocument-Vorlagen: Tritt ein
- <code><foreach></code>-Blcok innerhalb einer Tabellenzelle
+ <code><foreach></code>-Block innerhalb einer Tabellenzelle
auf, so wird die komplette Tabellenzeile so oft wiederholt wie
notwendig. Tritt er außerhalb auf, so wird nur der Inhalt
- zwischen <code><foreach></code> und <code><end
- foreach></code> wiederholt, nicht aber die komplette Zeile, in
- der er steht.</p>
+ zwischen <code><foreach></code> und <code><end></code>
+ wiederholt, nicht aber die komplette Zeile, in der er steht.</p>
<h3><a name="bloecke_pagebreak">Der <code>pagebreak</code>-Block</a></h3>
<p class="blue"><code><%pagebreak ZpZ ZeS ZzS%><br>
...<br>
- <%end pagebreak%></code></p>
+ <%end></code></p>
<p>Dieser Block existiert nur in LaTeX-Vorlagen.</p>
projects / kivitendo-erp.git / blobdiff