kivitendo/doc/html/ch03s02.html @ 57d97e2b
| f8309cb7 | Moritz Bunkus | <html><head>
|
||
| 06cb6b12 | Moritz Bunkus | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
| d63ea7c6 | Jan Büren | <title>3.2. Dokumentenvorlagen und verfügbare Variablen</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.1.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="next" href="ch03s03.html" title="3.3. Excel-Vorlagen"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">3.2. Dokumentenvorlagen und verfügbare Variablen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03.html">Zurück</a> </td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right"> <a accesskey="n" href="ch03s03.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.2. Dokumentenvorlagen und verfügbare Variablen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="dokumentenvorlagen-und-variablen"></a>3.2. Dokumentenvorlagen und verfügbare Variablen</h2></div></div></div><div class="sect2" title="3.2.1. Einführung"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.einf%C3%BChrung"></a>3.2.1. Einführung</h3></div></div></div><p>Dies ist eine Auflistung der Standard-Dokumentenvorlagen und
|
||
| 06cb6b12 | Moritz Bunkus | aller zur Bearbeitung verfügbaren Variablen. Eine Variable wird in
|
||
| f8309cb7 | Moritz Bunkus | einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
|
||
| 06cb6b12 | Moritz Bunkus | <code class="function"><%variablenname%></code> verwendet wird. Für
|
||
LaTeX- und HTML-Vorlagen kann man die Form dieser Tags auch verändern
|
||||
(siehe <a class="xref" href="ch03s02.html#dokumentenvorlagen-und-variablen.tag-style" title="3.2.4. Anfang und Ende der Tags verändern">Anfang und Ende der Tags verändern</a>).</p><p>Früher wurde hier nur über LaTeX gesprochen. Inzwischen
|
||||
| 5fa26f9a | Moritz Bunkus | unterstützt kivitendo aber auch OpenDocument-Vorlagen. Sofern es nicht
|
||
| 06cb6b12 | Moritz Bunkus | ausdrücklich eingeschränkt wird, gilt das im Folgenden gesagte für
|
||
| f8309cb7 | Moritz Bunkus | alle Vorlagenarten.</p><p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
|
||
| 06cb6b12 | Moritz Bunkus | verfügbar als hier aufgelistet werden. Die meisten davon können
|
||
| f8309cb7 | Moritz Bunkus | allerdings innerhalb einer solchen Vorlage nicht sinnvoll verwendet
|
||
werden. Wenn eine Auflistung dieser Variablen gewollt ist, so kann
|
||||
diese wie folgt erhalten werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
|
||||
| 06cb6b12 | Moritz Bunkus | <code class="filename">SL/Form.pm</code> öffnen und am Anfang die
|
||
Zeile "<span class="command"><strong>use Data::Dumper;</strong></span>" einfügen.</p></li><li class="listitem"><p>In <code class="filename">Form.pm</code> die Funktion
|
||||
| f8309cb7 | Moritz Bunkus | <code class="function">parse_template</code> suchen und hier die Zeile
|
||
| 06cb6b12 | Moritz Bunkus | <span class="command"><strong>print(STDERR Dumper($self));</strong></span> einfügen.</p></li><li class="listitem"><p>Einmal per Browser die gewünschte Vorlage "benutzen", z.B.
|
||
ein PDF für eine Rechnung erzeugen.</p></li><li class="listitem"><p>Im <code class="filename">error.log</code> Apache steht die Ausgabe
|
||||
| f8309cb7 | Moritz Bunkus | der Variablen <code class="varname">$self</code> in der Form <code class="varname">'key'
|
||
=> 'value',</code>. Alle <code class="varname">key</code>s sind
|
||||
| 06cb6b12 | Moritz Bunkus | verfügbar.</p></li></ul></div></div><div class="sect2" title="3.2.2. Variablen ausgeben"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.variablen-ausgeben"></a>3.2.2. Variablen ausgeben</h3></div></div></div><p>Um eine Variable auszugeben, müssen sie einfach nur zwischen die
|
||
| f8309cb7 | Moritz Bunkus | Tags geschrieben werden, also z.B.
|
||
<code class="varname"><%variablenname%></code>.</p><p>Optional kann man auch mit Leerzeichen getrennte Flags angeben,
|
||||
die man aber nur selten brauchen wird. Die Syntax sieht also so aus:
|
||||
<code class="varname"><%variablenname FLAG1 FLAG2%></code>. Momentan
|
||||
| 06cb6b12 | Moritz Bunkus | werden die folgenden Flags unterstützt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
|
||
<code class="option">NOFORMAT</code> gilt nur für Zahlenwerte und gibt
|
||||
| f8309cb7 | Moritz Bunkus | den Wert ohne Formatierung, also ohne Tausendertrennzeichen mit
|
||
| 06cb6b12 | Moritz Bunkus | mit einem Punkt als Dezimaltrennzeichen aus. Nützlich z.B., wenn
|
||
| f8309cb7 | Moritz Bunkus | damit in der Vorlage z.B. von LaTeX gerechnet werden soll.</p></li><li class="listitem"><p>
|
||
| 06cb6b12 | Moritz Bunkus | <code class="option">NOESCAPE</code> unterdrückt das Escapen von
|
||
Sonderzeichen für die Vorlagensprache. Wenn also in einer
|
||||
Variablen bereits gültiger LaTeX-Code steht und dieser von LaTeX
|
||||
auch ausgewertet und nicht wortwörtlich angezeigt werden soll, so
|
||||
ist dieses Flag sinnvoll.</p></li></ul></div><p>Beispiel:</p><pre class="programlisting"><%quototal NOFORMAT%></pre></div><div class="sect2" title="3.2.3. Verwendung in Druckbefehlen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.verwendung-in-druckbefehlen"></a>3.2.3. Verwendung in Druckbefehlen</h3></div></div></div><p>In der Admininstration können Drucker definiert werden. Auch im
|
||||
dort eingebbaren Druckbefehl können die hier aufgelisteten Variablen
|
||||
| f8309cb7 | Moritz Bunkus | und Kontrollstrukturen verwendet werden. Ihr Inhalt wird dabei nach
|
||
| 06cb6b12 | Moritz Bunkus | den Regeln der gängigen Shells formatiert, sodass Sonderzeichen wie
|
||
<code class="function">`...`</code> nicht zu unerwünschtem Verhalten
|
||||
führen.</p><p>Dies erlaubt z.B. die Definition eines Faxes als Druckerbefehl,
|
||||
für das die Telefonnummer eines Ansprechpartners als Teil der
|
||||
Kommandozeile verwendet wird. Für ein fiktives Kommando könnte das
|
||||
z.B. wie folgt aussehen:</p><pre class="programlisting">send_fax --number <%if cp_phone2%><%cp_phone2%><%else%><%cp_phone1%><%end%></pre></div><div class="sect2" title="3.2.4. Anfang und Ende der Tags verändern"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.tag-style"></a>3.2.4. Anfang und Ende der Tags verändern</h3></div></div></div><p>Der Standardstil für Tags sieht vor, dass ein Tag mit dem
|
||||
| f8309cb7 | Moritz Bunkus | Kleinerzeichen und einem Prozentzeichen beginnt und mit dem
|
||
| 06cb6b12 | Moritz Bunkus | Prozentzeichen und dem Größerzeichen endet, beispielsweise
|
||
| f8309cb7 | Moritz Bunkus | <code class="function"><%customer%></code>. Da diese Form aber z.B. in
|
||
| 06cb6b12 | Moritz Bunkus | LaTeX zu Problemen führen kann, weil das Prozentzeichen dort
|
||
| f8309cb7 | Moritz Bunkus | Kommentare einleitet, kann pro HTML- oder LaTeX-Dokumentenvorlage der
|
||
| 06cb6b12 | Moritz Bunkus | Stil umgestellt werden.</p><p>Dazu werden in die Datei Zeilen geschrieben, die mit dem für das
|
||
Format gültigen Kommentarzeichen anfangen, dann
|
||||
| f8309cb7 | Moritz Bunkus | <code class="function">config:</code> enthalten, die entsprechende Option
|
||
setzen und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen
|
||||
| 5fa26f9a | Moritz Bunkus | enden. Beispiel für LaTeX:</p><pre class="programlisting">% config: tag-style=($ $)</pre><p>Dies würde kivitendo dazu veranlassen, Variablen zu ersetzen,
|
||
| f8309cb7 | Moritz Bunkus | wenn sie wie folgt aussehen: <code class="function">($customer$)</code>. Das
|
||
| 06cb6b12 | Moritz Bunkus | äquivalente Beispiel für HTML-Dokumentenvorlagen sieht so aus:</p><pre class="programlisting"><!-- config: tag-style=($ $) --></pre></div><div class="sect2" title="3.2.5. Zuordnung von den Dateinamen zu den Funktionen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.zuordnung-dateinamen"></a>3.2.5. Zuordnung von den Dateinamen zu den Funktionen</h3></div></div></div><p>Diese folgende kurze Auflistung zeigt, welche Vorlage bei
|
||
| f8309cb7 | Moritz Bunkus | welcher Funktion ausgelesen wird. Dabei ist die Dateiendung
|
||
"<code class="filename">.ext</code>" geeignet zu ersetzen:
|
||||
| 06cb6b12 | Moritz Bunkus | "<code class="filename">.tex</code>" für LaTeX-Vorlagen und
|
||
"<code class="filename">.odt</code>" für OpenDocument-Vorlagen.</p><div class="variablelist"><dl><dt><span class="term">
|
||||
| f8309cb7 | Moritz Bunkus | <code class="filename">bin_list.ext</code>
|
||
</span></dt><dd><p>Lagerliste</p></dd><dt><span class="term">
|
||||
<code class="filename">check.ext</code>
|
||||
</span></dt><dd><p>?</p></dd><dt><span class="term">
|
||||
<code class="filename">invoice.ext</code>
|
||||
</span></dt><dd><p>Rechnung</p></dd><dt><span class="term">
|
||||
<code class="filename">packing_list.ext</code>
|
||||
</span></dt><dd><p>Packliste</p></dd><dt><span class="term">
|
||||
<code class="filename">pick_list.ext</code>
|
||||
</span></dt><dd><p>Sammelliste</p></dd><dt><span class="term">
|
||||
<code class="filename">purchase_delivery_order.ext</code>
|
||||
</span></dt><dd><p>Lieferschein (Einkauf)</p></dd><dt><span class="term">
|
||||
<code class="filename">purcharse_order.ext</code>
|
||||
</span></dt><dd><p>Bestellung an Lieferanten</p></dd><dt><span class="term">
|
||||
<code class="filename">request_quotation.ext</code>
|
||||
</span></dt><dd><p>Anfrage an Lieferanten</p></dd><dt><span class="term">
|
||||
<code class="filename">sales_delivery_order.ext</code>
|
||||
</span></dt><dd><p>Lieferschein (Verkauf)</p></dd><dt><span class="term">
|
||||
<code class="filename">sales_order.ext</code>
|
||||
</span></dt><dd><p>Bestellung</p></dd><dt><span class="term">
|
||||
<code class="filename">sales_quotation.ext</code>
|
||||
</span></dt><dd><p>Angebot an Kunden</p></dd><dt><span class="term">
|
||||
<code class="filename">zahlungserinnerung.ext</code>
|
||||
</span></dt><dd><p>Mahnung (Dateiname im Programm konfigurierbar)</p></dd><dt><span class="term">
|
||||
<code class="filename">zahlungserinnerung_invoice.ext</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Rechnung über Mahngebühren (Dateiname im Programm
|
||
konfigurierbar)</p></dd></dl></div></div><div class="sect2" title="3.2.6. Sprache, Drucker und E-Mail"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dateinamen-erweitert"></a>3.2.6. Sprache, Drucker und E-Mail</h3></div></div></div><p>Angeforderte Sprache und Druckerkürzel in den Dateinamen mit
|
||||
| f8309cb7 | Moritz Bunkus | eingearbeitet. So wird aus der Vorlage
|
||
<code class="filename">sales_order.ext</code> bei Sprache
|
||||
| 06cb6b12 | Moritz Bunkus | <code class="function">de</code> und Druckerkürzel <code class="function">lpr2</code>
|
||
| f8309cb7 | Moritz Bunkus | der Vorlagenname <code class="filename">sales_order_de_lpr2.ext</code>.
|
||
| 06cb6b12 | Moritz Bunkus | Zusätzlich können für E-Mails andere Vorlagen erstellt werden, diese
|
||
bekommen dann noch das Kürzel <code class="filename">_email</code>, der
|
||||
vollständige Vorlagenname wäre dann
|
||||
<code class="filename">sales_order_email_de_lpr2.ext</code>. In allen Fällen
|
||||
| f8309cb7 | Moritz Bunkus | kann eine Standarddatei <code class="filename">default.ext</code> hinterlegt
|
||
werden. Diese wird verwendet, wenn keine der anderen Varianten
|
||||
| 06cb6b12 | Moritz Bunkus | gefunden wird.</p><p>Die vollständige Suchreihenfolge für einen Verkaufsauftrag mit
|
||
| f8309cb7 | Moritz Bunkus | der Sprache "de" und dem Drucker "lpr2", der per E-Mail im Format PDF
|
||
verschickt wird, ist:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
|
||||
<code class="filename">sales_order_email_de_lpr2.tex</code>
|
||||
</p></li><li class="listitem"><p>
|
||||
<code class="filename">sales_order_de_lpr2.tex</code>
|
||||
</p></li><li class="listitem"><p>
|
||||
<code class="filename">sales_order.tex</code>
|
||||
</p></li><li class="listitem"><p>
|
||||
<code class="filename">default.tex</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </p></li></ol></div><p>Die kurzen Varianten dieser Vorlagentitel müssen dann entweder
|
||
| f8309cb7 | Moritz Bunkus | Standardwerte anzeigen, oder die angeforderten Werte selbst auswerten,
|
||
siehe dazu <a class="xref" href="ch03s02.html#dokumentenvorlagen-und-variablen.allgemeine-variablen.meta" title="3.2.7.1. Metainformationen zur angeforderten Vorlage">Metainformationen zur angeforderten Vorlage</a>.</p></div><div class="sect2" title="3.2.7. Allgemeine Variablen, die in allen Vorlagen vorhanden sind"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen"></a>3.2.7. Allgemeine Variablen, die in allen Vorlagen vorhanden
|
||||
| 06cb6b12 | Moritz Bunkus | sind</h3></div></div></div><div class="sect3" title="3.2.7.1. Metainformationen zur angeforderten Vorlage"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen.meta"></a>3.2.7.1. Metainformationen zur angeforderten Vorlage</h4></div></div></div><p>Diese Variablen liefern Informationen darüber welche Variante
|
||
einer Vorlage der Benutzer angefragt hat. Sie sind nützlich für
|
||||
| f8309cb7 | Moritz Bunkus | Vorlagenautoren, die aus einer zentralen Layoutvorlage die einzelnen
|
||
| 06cb6b12 | Moritz Bunkus | Formulare einbinden möchten.</p><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">template_meta.formname</code>
|
||
</span></dt><dd><p>Basisname der Vorlage. Identisch mit der <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.zuordnung-dateinamen" title="3.2.5. Zuordnung von den Dateinamen zu den Funktionen">Zurordnung
|
||||
zu den Dateinamen</a> ohne die Erweiterung. Ein
|
||||
| 06cb6b12 | Moritz Bunkus | Verkaufsauftrag enthält hier
|
||
| f8309cb7 | Moritz Bunkus | <code class="constant">sales_order</code>.</p></dd><dt><span class="term">
|
||
<code class="varname">template_meta.language.description</code>
|
||||
</span></dt><dd><p>Beschreibung der verwendeten Sprache</p></dd><dt><span class="term">
|
||||
<code class="varname">template_meta.language.template_code</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Vorlagenürzel der verwendeten Sprache, identisch mit dem
|
||
Kürzel das im Dateinamen verwendetet wird.</p></dd><dt><span class="term">
|
||||
| f8309cb7 | Moritz Bunkus | <code class="varname">template_meta.language.output_numberformat</code>
|
||
</span></dt><dd><p>Zahlenformat der verwendeten Sprache in der Form
|
||||
"<code class="constant">1.000,00</code>". Experimentell! Nur
|
||||
| 06cb6b12 | Moritz Bunkus | interessant für Vorlagen die mit unformatierten Werten
|
||
| f8309cb7 | Moritz Bunkus | arbeiten.</p></dd><dt><span class="term">
|
||
<code class="varname">template_meta.language.output_dateformat</code>
|
||||
</span></dt><dd><p>Datumsformat der verwendeten Sprache in der Form
|
||||
"<code class="constant">dd.mm.yyyy</code>". Experimentell! Nur
|
||||
| 06cb6b12 | Moritz Bunkus | interessant für Vorlagen die mit unformatierten Werten
|
||
| f8309cb7 | Moritz Bunkus | arbeiten.</p></dd><dt><span class="term">
|
||
<code class="varname">template_meta.format</code>
|
||||
</span></dt><dd><p>Das angeforderte Format. Kann im Moment die Werte
|
||||
<code class="constant">pdf</code>, <code class="constant">postscript</code>,
|
||||
<code class="constant">html</code>, <code class="constant">opendocument</code>,
|
||||
<code class="constant">opendocument_pdf</code> und
|
||||
<code class="constant">excel</code> enthalten.</p></dd><dt><span class="term">
|
||||
<code class="varname">template_meta.extension</code>
|
||||
</span></dt><dd><p>Dateierweiterung, wie im Dateinamen. Wird aus
|
||||
<code class="constant">format</code> entschieden.</p></dd><dt><span class="term">
|
||||
<code class="varname">template_meta.media</code>
|
||||
</span></dt><dd><p>Ausgabemedium. Kann zur Zeit die Werte
|
||||
| 06cb6b12 | Moritz Bunkus | <code class="constant">screen</code> für Bildschirm,
|
||
<code class="constant">email</code> für E-Mmail (triggert das
|
||||
<code class="constant">_email</code> Kürzel im Dateinamen),
|
||||
<code class="constant">printer</code> für Drucker, und
|
||||
<code class="constant">queue</code> für Warteschlange enthalten.</p></dd><dt><span class="term">
|
||||
| f8309cb7 | Moritz Bunkus | <code class="varname">template_meta.printer.description</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Beschreibung des ausgewählten Druckers</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">template_meta.printer.template_code</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Vorlagenürzel des ausgewählten Druckers, identisch mit
|
||
| d7acc048 | Wulf Coulmann | dem Kürzel das im Dateinamen verwendetet wird.</p></dd><dt><span class="term">
|
||
<code class="varname">template_meta.tmpfile</code>
|
||||
</span></dt><dd><p>Datei-Prefix für temporäre Dateien.</p></dd></dl></div></div><div class="sect3" title="3.2.7.2. Stammdaten von Kunden und Lieferanten"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemeine-variablen.kunden-lieferanten"></a>3.2.7.2. Stammdaten von Kunden und Lieferanten</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||||
| f8309cb7 | Moritz Bunkus | <code class="varname">account_number</code>
|
||
</span></dt><dd><p>Kontonummer</p></dd><dt><span class="term">
|
||||
<code class="varname">bank</code>
|
||||
</span></dt><dd><p>Name der Bank</p></dd><dt><span class="term">
|
||||
<code class="varname">bank_code</code>
|
||||
</span></dt><dd><p>Bankleitzahl</p></dd><dt><span class="term">
|
||||
<code class="varname">bic</code>
|
||||
</span></dt><dd><p>Bank-Identifikations-Code (Bank Identifier Code,
|
||||
BIC)</p></dd><dt><span class="term">
|
||||
<code class="varname">business</code>
|
||||
</span></dt><dd><p>Kunden-/Lieferantentyp</p></dd><dt><span class="term">
|
||||
<code class="varname">city</code>
|
||||
</span></dt><dd><p>Stadt</p></dd><dt><span class="term">
|
||||
<code class="varname">contact</code>
|
||||
</span></dt><dd><p>Kontakt</p></dd><dt><span class="term">
|
||||
<code class="varname">country</code>
|
||||
</span></dt><dd><p>Land</p></dd><dt><span class="term">
|
||||
| 512bdfe4 | Wulf Coulmann | <code class="varname">c_vendor_id</code>
|
||
</span></dt><dd><p>Lieferantennummer beim Kunden (nur Kunden)</p></dd><dt><span class="term">
|
||||
<code class="varname">v_customer_id</code>
|
||||
</span></dt><dd><p>Kundennummer beim Lieferanten (nur Lieferanten)</p></dd><dt><span class="term">
|
||||
| f8309cb7 | Moritz Bunkus | <code class="varname">cp_email</code>
|
||
</span></dt><dd><p>Email des Ansprechpartners</p></dd><dt><span class="term">
|
||||
<code class="varname">cp_givenname</code>
|
||||
</span></dt><dd><p>Vorname des Ansprechpartners</p></dd><dt><span class="term">
|
||||
<code class="varname">cp_greeting</code>
|
||||
</span></dt><dd><p>Anrede des Ansprechpartners</p></dd><dt><span class="term">
|
||||
<code class="varname">cp_name</code>
|
||||
</span></dt><dd><p>Name des Ansprechpartners</p></dd><dt><span class="term">
|
||||
<code class="varname">cp_phone1</code>
|
||||
</span></dt><dd><p>Telefonnummer 1 des Ansprechpartners</p></dd><dt><span class="term">
|
||||
<code class="varname">cp_phone2</code>
|
||||
</span></dt><dd><p>Telefonnummer 2 des Ansprechpartners</p></dd><dt><span class="term">
|
||||
<code class="varname">cp_title</code>
|
||||
</span></dt><dd><p>Titel des Ansprechpartners</p></dd><dt><span class="term">
|
||||
<code class="varname">creditlimit</code>
|
||||
</span></dt><dd><p>Kreditlimit</p></dd><dt><span class="term">
|
||||
<code class="varname">customeremail</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Email des Kunden; nur für Kunden</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">customerfax</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Faxnummer des Kunden; nur für Kunden</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">customernotes</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Bemerkungen beim Kunden; nur für Kunden</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">customernumber</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Kundennummer; nur für Kunden</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">customerphone</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Telefonnummer des Kunden; nur für Kunden</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">discount</code>
|
||
</span></dt><dd><p>Rabatt</p></dd><dt><span class="term">
|
||||
<code class="varname">email</code>
|
||||
</span></dt><dd><p>Emailadresse</p></dd><dt><span class="term">
|
||||
<code class="varname">fax</code>
|
||||
</span></dt><dd><p>Faxnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">homepage</code>
|
||||
</span></dt><dd><p>Homepage</p></dd><dt><span class="term">
|
||||
<code class="varname">iban</code>
|
||||
</span></dt><dd><p>Internationale Kontonummer (International Bank Account
|
||||
Number, IBAN)</p></dd><dt><span class="term">
|
||||
<code class="varname">language</code>
|
||||
</span></dt><dd><p>Sprache</p></dd><dt><span class="term">
|
||||
<code class="varname">name</code>
|
||||
</span></dt><dd><p>Firmenname</p></dd><dt><span class="term">
|
||||
<code class="varname">payment_description</code>
|
||||
</span></dt><dd><p>Name der Zahlart</p></dd><dt><span class="term">
|
||||
<code class="varname">payment_terms</code>
|
||||
</span></dt><dd><p>Zahlungskonditionen</p></dd><dt><span class="term">
|
||||
<code class="varname">phone</code>
|
||||
</span></dt><dd><p>Telefonnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptocity</code>
|
||||
</span></dt><dd><p>Stadt (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptocontact</code>
|
||||
</span></dt><dd><p>Kontakt (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptocountry</code>
|
||||
</span></dt><dd><p>Land (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptodepartment1</code>
|
||||
</span></dt><dd><p>Abteilung 1 (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptodepartment2</code>
|
||||
</span></dt><dd><p>Abteilung 2 (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptoemail</code>
|
||||
</span></dt><dd><p>Email (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptofax</code>
|
||||
</span></dt><dd><p>Fax (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptoname</code>
|
||||
</span></dt><dd><p>Firmenname (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptophone</code>
|
||||
</span></dt><dd><p>Telefonnummer (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">shiptostreet</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Straße und Hausnummer (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||
| f8309cb7 | Moritz Bunkus | </p></dd><dt><span class="term">
|
||
<code class="varname">shiptozipcode</code>
|
||||
</span></dt><dd><p>Postleitzahl (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">street</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Straße und Hausnummer</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">taxnumber</code>
|
||
</span></dt><dd><p>Steuernummer</p></dd><dt><span class="term">
|
||||
<code class="varname">ustid</code>
|
||||
</span></dt><dd><p>Umsatzsteuer-Identifikationsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">vendoremail</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Email des Lieferanten; nur für Lieferanten</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">vendorfax</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Faxnummer des Lieferanten; nur für Lieferanten</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">vendornotes</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Bemerkungen beim Lieferanten; nur für Lieferanten</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">vendornumber</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Lieferantennummer; nur für Lieferanten</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">vendorphone</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Telefonnummer des Lieferanten; nur für
|
||
| f8309cb7 | Moritz Bunkus | Lieferanten</p></dd><dt><span class="term">
|
||
<code class="varname">zipcode</code>
|
||||
| eb06dc40 | Moritz Bunkus | </span></dt><dd><p>Postleitzahl</p></dd></dl></div><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left"><a name="dokumentenvorlagen-und-variablen.anmerkung-shipto"></a>Anmerkung</th></tr><tr><td align="left" valign="top"><p>Anmerkung: Sind die <code class="varname">shipto*</code>-Felder in den
|
||
| f8309cb7 | Moritz Bunkus | Stammdaten nicht eingetragen, so haben die Variablen
|
||
<code class="varname">shipto*</code> den gleichen Wert wie die die
|
||||
entsprechenden Variablen der Lieferdaten. Das bedeutet, dass sich
|
||||
einige <code class="varname">shipto*</code>-Variablen so nicht in den
|
||||
Stammdaten wiederfinden sondern schlicht Kopien der
|
||||
Lieferdatenvariablen sind (z.B.
|
||||
| 06cb6b12 | Moritz Bunkus | <code class="varname">shiptocontact</code>).</p></td></tr></table></div></div><div class="sect3" title="3.2.7.3. Informationen über den Bearbeiter"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-bearbeiter"></a>3.2.7.3. Informationen über den Bearbeiter</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">employee_address</code>
|
||
</span></dt><dd><p>Adressfeld</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_businessnumber</code>
|
||||
</span></dt><dd><p>Firmennummer</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_company</code>
|
||||
</span></dt><dd><p>Firmenname</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_co_ustid</code>
|
||||
</span></dt><dd><p>Usatzsteuer-Identifikationsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_duns</code>
|
||||
</span></dt><dd><p>DUNS-Nummer</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_email</code>
|
||||
</span></dt><dd><p>Email</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_fax</code>
|
||||
</span></dt><dd><p>Fax</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_name</code>
|
||||
</span></dt><dd><p>voller Name</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_signature</code>
|
||||
</span></dt><dd><p>Signatur</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_taxnumber</code>
|
||||
</span></dt><dd><p>Steuernummer</p></dd><dt><span class="term">
|
||||
<code class="varname">employee_tel</code>
|
||||
| 00a6b021 | Bernd Bleßmann | </span></dt><dd><p>Telefonnummer</p></dd></dl></div></div><div class="sect3" title="3.2.7.4. Informationen über den Verkäufer"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-verkaeufer"></a>3.2.7.4. Informationen über den Verkäufer</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">salesman_address</code>
|
||
</span></dt><dd><p>Adressfeld</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_businessnumber</code>
|
||||
</span></dt><dd><p>Firmennummer</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_company</code>
|
||||
</span></dt><dd><p>Firmenname</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_co_ustid</code>
|
||||
</span></dt><dd><p>Usatzsteuer-Identifikationsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_duns</code>
|
||||
</span></dt><dd><p>DUNS-Nummer</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_email</code>
|
||||
</span></dt><dd><p>Email</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_fax</code>
|
||||
</span></dt><dd><p>Fax</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_name</code>
|
||||
</span></dt><dd><p>voller Name</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_signature</code>
|
||||
</span></dt><dd><p>Signatur</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_taxnumber</code>
|
||||
</span></dt><dd><p>Steuernummer</p></dd><dt><span class="term">
|
||||
<code class="varname">salesman_tel</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Telefonnummer</p></dd></dl></div></div><div class="sect3" title="3.2.7.5. Variablen für die einzelnen Steuern"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-steuern"></a>3.2.7.5. Variablen für die einzelnen Steuern</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">tax</code>
|
||
</span></dt><dd><p>Steuer</p></dd><dt><span class="term">
|
||||
<code class="varname">taxbase</code>
|
||||
</span></dt><dd><p>zu versteuernder Betrag</p></dd><dt><span class="term">
|
||||
<code class="varname">taxdescription</code>
|
||||
</span></dt><dd><p>Name der Steuer</p></dd><dt><span class="term">
|
||||
<code class="varname">taxrate</code>
|
||||
| c53361bc | Bernd Bleßmann | </span></dt><dd><p>Steuersatz</p></dd></dl></div></div><div class="sect3" title="3.2.7.6. Variablen für Lieferbedingungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-lieferbedingungen"></a>3.2.7.6. Variablen für Lieferbedingungen</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
<code class="varname">delivery_term</code>
|
||||
</span></dt><dd><p>Datenbank-Objekt der Lieferbedingung</p></dd><dt><span class="term">
|
||||
<code class="varname">delivery_term.description</code>
|
||||
</span></dt><dd><p>Beschreibung der Lieferbedingung</p></dd><dt><span class="term">
|
||||
<code class="varname">delivery_term.long_description</code>
|
||||
</span></dt><dd><p>Langtext bzw. übersetzter Langtext der Lieferbedingung</p></dd></dl></div></div></div><div class="sect2" title="3.2.8. Variablen in Rechnungen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.invoice"></a>3.2.8. Variablen in Rechnungen</h3></div></div></div><div class="sect3" title="3.2.8.1. Allgemeine Variablen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-allgemein"></a>3.2.8.1. Allgemeine Variablen</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||||
| f8309cb7 | Moritz Bunkus | <code class="varname">creditremaining</code>
|
||
</span></dt><dd><p>Verbleibender Kredit</p></dd><dt><span class="term">
|
||||
<code class="varname">currency</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Währung</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">cusordnumber</code>
|
||
</span></dt><dd><p>Bestellnummer beim Kunden</p></dd><dt><span class="term">
|
||||
<code class="varname">deliverydate</code>
|
||||
</span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term">
|
||||
<code class="varname">duedate</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Fälligkeitsdatum</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">globalprojectnumber</code>
|
||
</span></dt><dd><p>Projektnummer des ganzen Beleges</p></dd><dt><span class="term">
|
||||
<code class="varname">globalprojectdescription</code>
|
||||
</span></dt><dd><p>Projekbeschreibung des ganzen Beleges</p></dd><dt><span class="term">
|
||||
<code class="varname">intnotes</code>
|
||||
</span></dt><dd><p>Interne Bemerkungen</p></dd><dt><span class="term">
|
||||
<code class="varname">invdate</code>
|
||||
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">
|
||||
<code class="varname">invnumber</code>
|
||||
</span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">invtotal</code>
|
||||
</span></dt><dd><p>gesamter Rechnungsbetrag</p></dd><dt><span class="term">
|
||||
<code class="varname">notes</code>
|
||||
</span></dt><dd><p>Bemerkungen der Rechnung</p></dd><dt><span class="term">
|
||||
<code class="varname">orddate</code>
|
||||
</span></dt><dd><p>Auftragsdatum</p></dd><dt><span class="term">
|
||||
<code class="varname">ordnumber</code>
|
||||
</span></dt><dd><p>Auftragsnummer, wenn die Rechnung aus einem Auftrag
|
||||
erstellt wurde</p></dd><dt><span class="term">
|
||||
<code class="varname">payment_description</code>
|
||||
</span></dt><dd><p>Name der Zahlart</p></dd><dt><span class="term">
|
||||
<code class="varname">payment_terms</code>
|
||||
</span></dt><dd><p>Zahlungskonditionen</p></dd><dt><span class="term">
|
||||
<code class="varname">quodate</code>
|
||||
</span></dt><dd><p>Angebotsdatum</p></dd><dt><span class="term">
|
||||
<code class="varname">quonumber</code>
|
||||
</span></dt><dd><p>Angebotsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">shippingpoint</code>
|
||||
</span></dt><dd><p>Versandort</p></dd><dt><span class="term">
|
||||
<code class="varname">shipvia</code>
|
||||
</span></dt><dd><p>Transportmittel</p></dd><dt><span class="term">
|
||||
<code class="varname">subtotal</code>
|
||||
</span></dt><dd><p>Zwischensumme aller Posten ohne Steuern</p></dd><dt><span class="term">
|
||||
<code class="varname">total</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Restsumme der Rechnung (Summe abzüglich bereits
|
||
| f8309cb7 | Moritz Bunkus | bezahlter Posten)</p></dd><dt><span class="term">
|
||
<code class="varname">transaction_description</code>
|
||||
</span></dt><dd><p>Vorgangsbezeichnung</p></dd><dt><span class="term">
|
||||
<code class="varname">transdate</code>
|
||||
</span></dt><dd><p>Auftragsdatum wenn die Rechnung aus einem Auftrag
|
||||
| 06cb6b12 | Moritz Bunkus | erstellt wurde</p></dd></dl></div></div><div class="sect3" title="3.2.8.2. Variablen für jeden Posten auf der Rechnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-posten"></a>3.2.8.2. Variablen für jeden Posten auf der Rechnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">bin</code>
|
||
</span></dt><dd><p>Stellage</p></dd><dt><span class="term">
|
||||
<code class="varname">description</code>
|
||||
</span></dt><dd><p>Artikelbeschreibung</p></dd><dt><span class="term">
|
||||
<code class="varname">discount</code>
|
||||
</span></dt><dd><p>Rabatt als Betrag</p></dd><dt><span class="term">
|
||||
<code class="varname">discount_sub</code>
|
||||
</span></dt><dd><p>Zwischensumme mit Rabatt</p></dd><dt><span class="term">
|
||||
<code class="varname">drawing</code>
|
||||
</span></dt><dd><p>Zeichnung</p></dd><dt><span class="term">
|
||||
<code class="varname">ean</code>
|
||||
</span></dt><dd><p>EAN-Code</p></dd><dt><span class="term">
|
||||
<code class="varname">image</code>
|
||||
</span></dt><dd><p>Grafik</p></dd><dt><span class="term">
|
||||
<code class="varname">linetotal</code>
|
||||
</span></dt><dd><p>Zeilensumme (Anzahl * Einzelpreis)</p></dd><dt><span class="term">
|
||||
<code class="varname">longdescription</code>
|
||||
</span></dt><dd><p>Langtext</p></dd><dt><span class="term">
|
||||
<code class="varname">microfiche</code>
|
||||
</span></dt><dd><p>Mikrofilm</p></dd><dt><span class="term">
|
||||
<code class="varname">netprice</code>
|
||||
</span></dt><dd><p>Nettopreis</p></dd><dt><span class="term">
|
||||
<code class="varname">nodiscount_linetotal</code>
|
||||
</span></dt><dd><p>Zeilensumme ohne Rabatt</p></dd><dt><span class="term">
|
||||
<code class="varname">nodiscount_sub</code>
|
||||
</span></dt><dd><p>Zwischensumme ohne Rabatt</p></dd><dt><span class="term">
|
||||
<code class="varname">number</code>
|
||||
</span></dt><dd><p>Artikelnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">ordnumber_oe</code>
|
||||
</span></dt><dd><p>Auftragsnummer des Originalauftrags, wenn die Rechnung
|
||||
aus einem Sammelauftrag erstellt wurde</p></dd><dt><span class="term">
|
||||
<code class="varname">p_discount</code>
|
||||
</span></dt><dd><p>Rabatt in Prozent</p></dd><dt><span class="term">
|
||||
<code class="varname">partnotes</code>
|
||||
</span></dt><dd><p>Die beim Artikel gespeicherten Bemerkungen</p></dd><dt><span class="term">
|
||||
<code class="varname">partsgroup</code>
|
||||
</span></dt><dd><p>Warengruppe</p></dd><dt><span class="term">
|
||||
<code class="varname">price_factor</code>
|
||||
</span></dt><dd><p>Der Preisfaktor als Zahl, sofern einer eingestellt
|
||||
ist</p></dd><dt><span class="term">
|
||||
<code class="varname">price_factor_name</code>
|
||||
</span></dt><dd><p>Der Name des Preisfaktors, sofern einer eingestellt
|
||||
ist</p></dd><dt><span class="term">
|
||||
<code class="varname">projectnumber</code>
|
||||
</span></dt><dd><p>Projektnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">projectdescription</code>
|
||||
</span></dt><dd><p>Projektbeschreibung</p></dd><dt><span class="term">
|
||||
<code class="varname">qty</code>
|
||||
</span></dt><dd><p>Anzahl</p></dd><dt><span class="term">
|
||||
<code class="varname">reqdate</code>
|
||||
</span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term">
|
||||
<code class="varname">runningnumber</code>
|
||||
</span></dt><dd><p>Position auf der Rechnung (1, 2, 3...)</p></dd><dt><span class="term">
|
||||
<code class="varname">sellprice</code>
|
||||
</span></dt><dd><p>Verkaufspreis</p></dd><dt><span class="term">
|
||||
<code class="varname">serialnumber</code>
|
||||
</span></dt><dd><p>Seriennummer</p></dd><dt><span class="term">
|
||||
<code class="varname">tax_rate</code>
|
||||
</span></dt><dd><p>Steuersatz</p></dd><dt><span class="term">
|
||||
<code class="varname">transdate_oe</code>
|
||||
</span></dt><dd><p>Auftragsdatum des Originalauftrags, wenn die Rechnung
|
||||
aus einem Sammelauftrag erstellt wurde</p></dd><dt><span class="term">
|
||||
<code class="varname">unit</code>
|
||||
</span></dt><dd><p>Einheit</p></dd><dt><span class="term">
|
||||
<code class="varname">weight</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Gewicht</p></dd></dl></div><p>Für jeden Posten gibt es ein Unterarray mit den Informationen
|
||
über Lieferanten und Lieferantenartikelnummer. Diese müssen mit
|
||||
| f8309cb7 | Moritz Bunkus | einer <code class="function">foreach</code>-Schleife ausgegeben werden, da
|
||
| 06cb6b12 | Moritz Bunkus | für jeden Artikel mehrere Lieferanteninformationen hinterlegt sein
|
||
können. Die Variablen dafür lauten:</p><div class="variablelist"><dl><dt><span class="term">
|
||||
| f8309cb7 | Moritz Bunkus | <code class="varname">make</code>
|
||
</span></dt><dd><p>Lieferant</p></dd><dt><span class="term">
|
||||
<code class="varname">model</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Lieferantenartikelnummer</p></dd></dl></div></div><div class="sect3" title="3.2.8.3. Variablen für die einzelnen Zahlungseingänge"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.invoice-zahlungen"></a>3.2.8.3. Variablen für die einzelnen Zahlungseingänge</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">payment</code>
|
||
</span></dt><dd><p>Betrag</p></dd><dt><span class="term">
|
||||
<code class="varname">paymentaccount</code>
|
||||
</span></dt><dd><p>Konto</p></dd><dt><span class="term">
|
||||
<code class="varname">paymentdate</code>
|
||||
</span></dt><dd><p>Datum</p></dd><dt><span class="term">
|
||||
<code class="varname">paymentmemo</code>
|
||||
</span></dt><dd><p>Memo</p></dd><dt><span class="term">
|
||||
<code class="varname">paymentsource</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Beleg</p></dd></dl></div></div><div class="sect3" title="3.2.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.benutzerdefinierte-variablen-vc"></a>3.2.8.4. Benutzerdefinierte Kunden- und Lieferantenvariablen</h4></div></div></div><p>Die vom Benutzer definierten Variablen für Kunden und
|
||
| f8309cb7 | Moritz Bunkus | Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen
|
||
| 06cb6b12 | Moritz Bunkus | ebenfalls zur Verfügung. Ihre Namen setzen sich aus dem Präfix
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">vc_cvar_</code> und dem vom Benutzer festgelegten
|
||
Variablennamen zusammen.</p><p>Beispiel: Der Benutzer hat eine Variable namens
|
||||
<code class="varname">number_of_employees</code> definiert, die die Anzahl der
|
||||
| 06cb6b12 | Moritz Bunkus | Mitarbeiter des Unternehmens enthält. Diese Variable steht dann
|
||
| f8309cb7 | Moritz Bunkus | unter dem Namen <code class="varname">vc_cvar_number_of_employees</code> zur
|
||
| 06cb6b12 | Moritz Bunkus | Verfügung.</p></div></div><div class="sect2" title="3.2.9. Variablen in Mahnungen und Rechnungen über Mahngebühren"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.dunning"></a>3.2.9. Variablen in Mahnungen und Rechnungen über Mahngebühren</h3></div></div></div><div class="sect3" title="3.2.9.1. Namen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-vorlagennamen"></a>3.2.9.1. Namen der Vorlagen</h4></div></div></div><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 class="constant">_invoice</code> gebildet. Weiterhin werden die Kürzel
|
||||
für die ausgewählte Sprache und den ausgewählten Drucker
|
||||
angehängt.</p></div><div class="sect3" title="3.2.9.2. Allgemeine Variablen in Mahnungen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-allgemein"></a>3.2.9.2. Allgemeine Variablen in Mahnungen</h4></div></div></div><p>Die Variablen des Verkäufers stehen wie gewohnt als
|
||||
<code class="varname">employee_...</code> zur Verfügung. Die Adressdaten des
|
||||
| f8309cb7 | Moritz Bunkus | Kunden stehen als Variablen <code class="varname">name</code>,
|
||
<code class="varname">street</code>, <code class="varname">zipcode</code>,
|
||||
<code class="varname">city</code>, <code class="varname">country</code>,
|
||||
<code class="varname">department_1</code>, <code class="varname">department_2</code>,
|
||||
| 06cb6b12 | Moritz Bunkus | und <code class="varname">email</code> zur Verfügung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">dunning_date</code>
|
||
</span></dt><dd><p>Datum der Mahnung</p></dd><dt><span class="term">
|
||||
<code class="varname">dunning_duedate</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Fälligkeitsdatum für diese Mahhnung</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">dunning_id</code>
|
||
</span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">fee</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Kummulative Mahngebühren</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">interest_rate</code>
|
||
</span></dt><dd><p>Zinssatz per anno in Prozent</p></dd><dt><span class="term">
|
||||
<code class="varname">total_amount</code>
|
||||
</span></dt><dd><p>Gesamter noch zu zahlender Betrag als
|
||||
<code class="function">fee</code> + <code class="function">total_interest</code>
|
||||
+ <code class="function">total_open_amount</code>
|
||||
</p></dd><dt><span class="term">
|
||||
<code class="varname">total_interest</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Zinsen per anno über alle Rechnungen</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">total_open_amount</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Summe über alle offene Beträge der Rechnungen</p></dd></dl></div></div><div class="sect3" title="3.2.9.3. Variablen für jede gemahnte Rechnung in einer Mahnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-details"></a>3.2.9.3. Variablen für jede gemahnte Rechnung in einer Mahnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">dn_amount</code>
|
||
</span></dt><dd><p>Rechnungssumme (brutto)</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_duedate</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Originales Fälligkeitsdatum der Rechnung</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">dn_dunning_date</code>
|
||
</span></dt><dd><p>Datum der Mahnung</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_dunning_duedate</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Fälligkeitsdatum der Mahnung</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">dn_fee</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Kummulative Mahngebühr</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">dn_interest</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Zinsen per anno für diese Rechnung</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">dn_invnumber</code>
|
||
</span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_linetotal</code>
|
||||
</span></dt><dd><p>Noch zu zahlender Betrag (ergibt sich aus
|
||||
<code class="varname">dn_open_amount</code> + <code class="varname">dn_fee</code>
|
||||
+ <code class="varname">dn_interest</code>)</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_netamount</code>
|
||||
</span></dt><dd><p>Rechnungssumme (netto)</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_open_amount</code>
|
||||
</span></dt><dd><p>Offener Rechnungsbetrag</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_ordnumber</code>
|
||||
</span></dt><dd><p>Bestellnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_transdate</code>
|
||||
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_curr</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Währung, in der die Rechnung erstellt wurde. (Die
|
||
Rechnungsbeträge sind aber immer in der Hauptwährung)</p></dd></dl></div></div><div class="sect3" title="3.2.9.4. Variablen in automatisch erzeugten Rechnungen über Mahngebühren"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.dunning-invoice"></a>3.2.9.4. Variablen in automatisch erzeugten Rechnungen über
|
||||
Mahngebühren</h4></div></div></div><p>Die Variablen des Verkäufers stehen wie gewohnt als
|
||||
<code class="varname">employee_...</code> zur Verfügung. Die Adressdaten des
|
||||
| f8309cb7 | Moritz Bunkus | Kunden stehen als Variablen <code class="varname">name</code>,
|
||
<code class="varname">street</code>, <code class="varname">zipcode</code>,
|
||||
<code class="varname">city</code>, <code class="varname">country</code>,
|
||||
<code class="varname">department_1</code>, <code class="varname">department_2</code>,
|
||||
| 06cb6b12 | Moritz Bunkus | und <code class="varname">email</code> zur Verfügung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">duedate</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Fälligkeitsdatum der Rechnung</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">dunning_id</code>
|
||
</span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">fee</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Mahngebühren</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">interest</code>
|
||
</span></dt><dd><p>Zinsen</p></dd><dt><span class="term">
|
||||
<code class="varname">invamount</code>
|
||||
</span></dt><dd><p>Rechnungssumme (ergibt sich aus <code class="varname">fee</code> +
|
||||
<code class="varname">interest</code>)</p></dd><dt><span class="term">
|
||||
<code class="varname">invdate</code>
|
||||
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">
|
||||
<code class="varname">invnumber</code>
|
||||
| d958c7f7 | Geoffrey Richardson | </span></dt><dd><p>Rechnungsnummer</p></dd></dl></div></div></div><div class="sect2" title="3.2.10. Variablen in anderen Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen"></a>3.2.10. Variablen in anderen Vorlagen</h3></div></div></div><div class="sect3" title="3.2.10.1. Einführung"><div class="titlepage"><div><div><h4 class="title"><a name="d0e4776"></a>3.2.10.1. Einführung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ähnlich wie in der
|
||
| 06cb6b12 | Moritz Bunkus | Rechnung. Allerdings heißen die Variablen, die mit
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">inv</code> beginnen, jetzt anders. Bei den Angeboten
|
||
| 06cb6b12 | Moritz Bunkus | fangen sie mit <code class="varname">quo</code> für "quotation" an:
|
||
<code class="varname">quodate</code> für Angebotsdatum etc. Bei Bestellungen
|
||||
wiederum fangen sie mit <code class="varname">ord</code> für "order" an:
|
||||
<code class="varname">ordnumber</code> für Bestellnummer etc.</p><p>Manche Variablen sind in anderen Vorlagen hingegen gar nicht
|
||||
vorhanden wie z.B. die für bereits verbuchte Zahlungseingänge. Dies
|
||||
sind Variablen, die vom Geschäftsablauf her in der entsprechenden
|
||||
| f8309cb7 | Moritz Bunkus | Vorlage keine Bedeutung haben oder noch nicht belegt sein
|
||
| 06cb6b12 | Moritz Bunkus | können.</p><p>Im Folgenden werden nur wichtige Unterschiede zu den Variablen
|
||
in Rechnungen aufgeführt.</p></div><div class="sect3" title="3.2.10.2. Angebote und Preisanfragen"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-quotations"></a>3.2.10.2. Angebote und Preisanfragen</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||||
| f8309cb7 | Moritz Bunkus | <code class="varname">quonumber</code>
|
||
</span></dt><dd><p>Angebots- bzw. Anfragenummer</p></dd><dt><span class="term">
|
||||
<code class="varname">reqdate</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Gültigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei
|
||
| f8309cb7 | Moritz Bunkus | Preisanfragen)</p></dd><dt><span class="term">
|
||
<code class="varname">transdate</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Angebots- bzw. Anfragedatum</p></dd></dl></div></div><div class="sect3" title="3.2.10.3. Auftragsbestätigungen und Lieferantenaufträge"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-orders"></a>3.2.10.3. Auftragsbestätigungen und Lieferantenaufträge</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">ordnumber</code>
|
||
</span></dt><dd><p>Auftragsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">reqdate</code>
|
||||
</span></dt><dd><p>Lieferdatum</p></dd><dt><span class="term">
|
||||
<code class="varname">transdate</code>
|
||||
</span></dt><dd><p>Auftragsdatum</p></dd></dl></div></div><div class="sect3" title="3.2.10.4. Lieferscheine (Verkauf und Einkauf)"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-delivery-orders"></a>3.2.10.4. Lieferscheine (Verkauf und Einkauf)</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||||
<code class="varname">cusordnumber</code>
|
||||
</span></dt><dd><p>Bestellnummer des Kunden (im Verkauf) bzw. Bestellnummer
|
||||
des Lieferanten (im Einkauf)</p></dd><dt><span class="term">
|
||||
<code class="varname">donumber</code>
|
||||
</span></dt><dd><p>Lieferscheinnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">transdate</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Lieferscheindatum</p></dd></dl></div><p>Für jede Position eines Lieferscheines gibt es ein Unterarray
|
||
mit den Informationen darüber, von welchem Lager und Lagerplatz aus
|
||||
| f8309cb7 | Moritz Bunkus | die Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
|
||
| 06cb6b12 | Moritz Bunkus | Lagerplatz sie eingelagert wurden. Diese müssen mittels einer
|
||
| f8309cb7 | Moritz Bunkus | <code class="function">foreach</code>-Schleife ausgegeben werden. Diese
|
||
Variablen sind:</p><div class="variablelist"><dl><dt><span class="term">
|
||||
<code class="varname">si_bin</code>
|
||||
</span></dt><dd><p>Lagerplatz</p></dd><dt><span class="term">
|
||||
<code class="varname">si_chargenumber</code>
|
||||
</span></dt><dd><p>Chargennummer</p></dd><dt><span class="term">
|
||||
<code class="varname">si_bestbefore</code>
|
||||
</span></dt><dd><p>Mindesthaltbarkeit</p></dd><dt><span class="term">
|
||||
<code class="varname">si_number</code>
|
||||
</span></dt><dd><p>Artikelnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">si_qty</code>
|
||||
</span></dt><dd><p>Anzahl bzw. Menge</p></dd><dt><span class="term">
|
||||
<code class="varname">si_runningnumber</code>
|
||||
</span></dt><dd><p>Positionsnummer (1, 2, 3 etc)</p></dd><dt><span class="term">
|
||||
<code class="varname">si_unit</code>
|
||||
</span></dt><dd><p>Einheit</p></dd><dt><span class="term">
|
||||
<code class="varname">si_warehouse</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Lager</p></dd></dl></div></div><div class="sect3" title="3.2.10.5. Variablen für Sammelrechnung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.andere-vorlagen-statement"></a>3.2.10.5. Variablen für Sammelrechnung</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">c0total</code>
|
||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit < 30
|
||
| f8309cb7 | Moritz Bunkus | Tage</p></dd><dt><span class="term">
|
||
<code class="varname">c30total</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit >= 30
|
||
| f8309cb7 | Moritz Bunkus | und < 60 Tage</p></dd><dt><span class="term">
|
||
<code class="varname">c60total</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit >= 60
|
||
| f8309cb7 | Moritz Bunkus | und < 90 Tage</p></dd><dt><span class="term">
|
||
<code class="varname">c90total</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Gesamtbetrag aller Rechnungen mit Fälligkeit >= 90
|
||
| f8309cb7 | Moritz Bunkus | Tage</p></dd><dt><span class="term">
|
||
<code class="varname">total</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Gesamtbetrag aller Rechnungen</p></dd></dl></div><p>Variablen für jede Rechnungsposition in Sammelrechnung:</p><div class="variablelist"><dl><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">invnumber</code>
|
||
</span></dt><dd><p>Rechnungsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">invdate</code>
|
||||
</span></dt><dd><p>Rechnungsdatum</p></dd><dt><span class="term">
|
||||
<code class="varname">duedate</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Fälligkeitsdatum</p></dd><dt><span class="term">
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">amount</code>
|
||
</span></dt><dd><p>Summe der Rechnung</p></dd><dt><span class="term">
|
||||
<code class="varname">open</code>
|
||||
</span></dt><dd><p>Noch offener Betrag der Rechnung</p></dd><dt><span class="term">
|
||||
<code class="varname">c0</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit < 30
|
||
| f8309cb7 | Moritz Bunkus | Tage</p></dd><dt><span class="term">
|
||
<code class="varname">c30</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit >= 30 und
|
||
| f8309cb7 | Moritz Bunkus | < 60 Tage</p></dd><dt><span class="term">
|
||
<code class="varname">c60</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit >= 60 und
|
||
| f8309cb7 | Moritz Bunkus | < 90 Tage</p></dd><dt><span class="term">
|
||
<code class="varname">c90</code>
|
||||
| 06cb6b12 | Moritz Bunkus | </span></dt><dd><p>Noch offener Rechnungsbetrag mit Fälligkeit >= 90
|
||
Tage</p></dd></dl></div></div></div><div class="sect2" title="3.2.11. Blöcke, bedingte Anweisungen und Schleifen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke"></a>3.2.11. Blöcke, bedingte Anweisungen und Schleifen</h3></div></div></div><div class="sect3" title="3.2.11.1. Einfürhung"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.einfuehrung"></a>3.2.11.1. Einfürhung</h4></div></div></div><p>Der Parser kennt neben den Variablen einige weitere
|
||||
| f8309cb7 | Moritz Bunkus | Konstrukte, die gesondert behandelt werden. Diese sind wie
|
||
Variablennamen in spezieller Weise markiert:
|
||||
<span class="command"><strong><%anweisung%> ... <%end%></strong></span>
|
||||
</p><p>Anmerkung zum <span class="command"><strong><%end%></strong></span>: Der besseren
|
||||
| 06cb6b12 | Moritz Bunkus | Verständlichkeit halber kann man nach dem <span class="command"><strong>end</strong></span>
|
||
noch beliebig weitere Wörter schreiben, um so zu markieren, welche
|
||||
| f8309cb7 | Moritz Bunkus | Anweisung (z.B. <span class="command"><strong>if</strong></span> oder
|
||
<span class="command"><strong>foreach</strong></span>) damit abgeschlossen wird.</p><p>Beispiel: Lautet der Beginn eines Blockes z.B.
|
||||
| 06cb6b12 | Moritz Bunkus | <span class="command"><strong><%if type == "sales_quotation"%></strong></span>, so könnte
|
||
| f8309cb7 | Moritz Bunkus | er mit <span class="command"><strong><%end%></strong></span> genauso abgeschlossen werden
|
||
wie mit <span class="command"><strong><%end if%></strong></span> oder auch
|
||||
<span class="command"><strong><%end type == "sales_quotation"%></strong></span>.</p></div><div class="sect3" title="3.2.11.2. Der if-Block"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.if"></a>3.2.11.2. Der if-Block</h4></div></div></div><pre class="programlisting"><%if variablenname%>
|
||||
...
|
||||
<%end%></pre><p>Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if"
|
||||
und dem "end" werden nur ausgegeben, wenn die Variable
|
||||
| d575e646 | Moritz Bunkus | <code class="varname">variablenname</code> gesetzt und ungleich 0 ist.</p><p>Handelt es sich bei der benannten Variable um ein Array, also um einen Variablennamen, über den man mit
|
||
<span class="command"><strong><%foreach variablenname%></strong></span> iteriert, so wird mit diesem Konstrukt darauf getestet, ob das Array Elemente
|
||||
enthält. Somit würde im folgenden Beispiel nur dann eine Liste von Zahlungseingängen samt ihrer Überschrift "Zahlungseingänge"
|
||||
ausgegeben, wenn tatsächlich welche getätigt wurden:</p><pre class="programlisting"><%if payment%>
|
||||
Zahlungseingänge:
|
||||
<%foreach payment%>
|
||||
Am <%paymentdate%>: <%payment%> €
|
||||
<%end foreach%>
|
||||
<%end if%></pre><p>Die Bedingung kann auch negiert werden, indem das Wort
|
||||
| f8309cb7 | Moritz Bunkus | <code class="function">not</code> nach dem <code class="filename">if</code> verwendet
|
||
wird. Beispiel:</p><pre class="programlisting"><%if not cp_greeting%>
|
||||
...
|
||||
| 06cb6b12 | Moritz Bunkus | <%end%></pre><p>Zusätzlich zu dem einfachen Test, ob eine Variable gesetzt ist
|
||
oder nicht, bietet dieser Block auch die Möglichkeit, den Inhalt
|
||||
| f8309cb7 | Moritz Bunkus | einer Variablen mit einer festen Zeichenkette oder einer anderen
|
||
Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette
|
||||
| 06cb6b12 | Moritz Bunkus | oder einer anderen Variablen vorgenommen wird, hängt davon ab, ob
|
||
die rechte Seite des Vergleichsoperators in Anführungszeichen
|
||||
| f8309cb7 | Moritz Bunkus | gesetzt wird (Vergleich mit Zeichenkette) oder nicht (Vergleich mit
|
||
anderer Variablen). Zwei Beispiele, die beide Vergleiche
|
||||
zeigen:</p><pre class="programlisting"><%if var1 == "Wert"%></pre><p>Testet die Variable <code class="varname">var1</code> auf
|
||||
| 06cb6b12 | Moritz Bunkus | übereinstimmung mit der Zeichenkette <code class="constant">Wert</code>.
|
||
| f8309cb7 | Moritz Bunkus | Mittels <code class="function">!=</code> anstelle von <code class="function">==</code>
|
||
| b68213ba | root | würde auf Ungleichheit getestet.</p><pre class="programlisting"><%if var1 == var2%></pre><p>Testet die Variable <code class="varname">var1</code> auf
|
||
| 06cb6b12 | Moritz Bunkus | übereinstimmung mit der Variablen <code class="varname">var2</code>. Mittel
|
||
<code class="function">!=</code> anstelle von <code class="function">==</code> würde
|
||||
auf Ungleichheit getestet.</p><p>Erfahrere Benutzer können neben der Tests auf (Un-)Gleichheit
|
||||
auch Tests auf übereinstimmung mit regulären Ausdrücken ohne
|
||||
Berücksichtung der Groß- und Kleinschreibung durchführen. Dazu dient
|
||||
| f8309cb7 | Moritz Bunkus | dieselbe Syntax wie oben nur mit <code class="function">=~</code> und
|
||
| 06cb6b12 | Moritz Bunkus | <code class="function">!~</code> als Vergleichsoperatoren.</p><p>Beispiel für einen Test, ob die Variable
|
||
| f8309cb7 | Moritz Bunkus | <code class="varname">intnotes</code> (interne Bemerkungen) das Wort
|
||
| 06cb6b12 | Moritz Bunkus | <code class="constant">schwierig</code> enthält:</p><pre class="programlisting"><%if intnotes =~ "schwierig"%></pre></div><div class="sect3" title="3.2.11.3. Der foreach-Block"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.bloecke.foreach"></a>3.2.11.3. Der foreach-Block</h4></div></div></div><pre class="programlisting"><%foreach variablenname%>
|
||
| f8309cb7 | Moritz Bunkus | ...
|
||
| 06cb6b12 | Moritz Bunkus | <%end%></pre><p>Fügt die Zeilen zwischen den beiden Anweisungen so oft ein,
|
||
| f8309cb7 | Moritz Bunkus | wie das Perl-Array der Variablen <code class="varname">variablenname</code>
|
||
| 06cb6b12 | Moritz Bunkus | Elemente enthät. Dieses Konstrukt wird zur Ausgabe der einzelnen
|
||
| f8309cb7 | Moritz Bunkus | Posten einer Rechnung / eines Angebots sowie zur Ausgabe der Steuern
|
||
| 06cb6b12 | Moritz Bunkus | benutzt. In jedem Durchlauf werden die <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.invoice-posten" title="3.2.8.2. Variablen für jeden Posten auf der Rechnung">zeilenbezogenen
|
||
Variablen</a> jeweils auf den Wert für die aktuelle Position
|
||||
| f8309cb7 | Moritz Bunkus | gesetzt.</p><p>Die Syntax sieht normalerweise wie folgt aus:</p><pre class="programlisting"><%foreach number%>
|
||
Position: <%runningnumber%>
|
||||
Anzahl: <%qty%>
|
||||
Artikelnummer: <%number%>
|
||||
Beschreibung: <%description%>
|
||||
...
|
||||
<%end%></pre><p>Besonderheit in OpenDocument-Vorlagen: Tritt ein
|
||||
<code class="function"><%foreach%></code>-Block innerhalb einer
|
||||
Tabellenzelle auf, so wird die komplette Tabellenzeile so oft
|
||||
| 06cb6b12 | Moritz Bunkus | wiederholt wie notwendig. Tritt er außerhalb auf, so wird nur der
|
||
| f8309cb7 | Moritz Bunkus | Inhalt zwischen <code class="function"><%foreach%></code> und
|
||
<code class="function"><%end%></code> wiederholt, nicht aber die
|
||||
komplette Zeile, in der er steht.</p></div></div><div class="sect2" title="3.2.12. Markup-Code zur Textformatierung innerhalb von Formularen"><div class="titlepage"><div><div><h3 class="title"><a name="dokumentenvorlagen-und-variablen.markup"></a>3.2.12. Markup-Code zur Textformatierung innerhalb von
|
||||
| 5fa26f9a | Moritz Bunkus | Formularen</h3></div></div></div><p>Wenn der Benutzer innhalb von Formularen in kivitendo Text
|
||
| 06cb6b12 | Moritz Bunkus | anders formatiert haben möchte, so ist dies begrenzt möglich.
|
||
| 5fa26f9a | Moritz Bunkus | kivitendo unterstützt die Textformatierung mit HTML-ähnlichen Tags.
|
||
| f8309cb7 | Moritz Bunkus | Der Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung
|
||
Teile des Texts zwischen Start- und Endtags setzen. Dieser Teil wird
|
||||
| 06cb6b12 | Moritz Bunkus | dann automatisch in Anweisungen für das ausgewählte Vorlagenformat
|
||
(HTML oder PDF über LaTeX) umgesetzt.</p><p>Die unterstützen Formatierungen sind:</p><div class="variablelist"><dl><dt><span class="term"><b>Text</b></span></dt><dd><p>Text wird in Fettdruck gesetzt.</p></dd><dt><span class="term"><i>Text</i></span></dt><dd><p>Text wird kursiv gesetzt.</p></dd><dt><span class="term"><u>Text</u></span></dt><dd><p>Text wird unterstrichen.</p></dd><dt><span class="term"><s>Text</s></span></dt><dd><p>Text wird durchgestrichen. Diese Formatierung ist nicht
|
||||
bei der Ausgabe als PDF über LaTeX verfügbar.</p></dd><dt><span class="term"><bullet></span></dt><dd><p>Erzeugt einen ausgefüllten Kreis für Aufzählungen (siehe
|
||||
| f8309cb7 | Moritz Bunkus | unten).</p></dd></dl></div><p>Der Befehl <span class="command"><strong><bullet></strong></span> funktioniert
|
||
| 06cb6b12 | Moritz Bunkus | momentan auch nur in Latex-Vorlagen.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch03s03.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">Kapitel 3. Features und Funktionen </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 3.3. Excel-Vorlagen</td></tr></table></div></body></html>
|