kivitendo/doc/html/ch03s02.html @ 062940d9
| f8309cb7 | Moritz Bunkus | <html><head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
|
||||
<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="Lx-Office: 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
|
||||
aller zur Bearbeitung verf?gbaren Variablen. Eine Variable wird in
|
||||
einer Vorlage durch ihren Inhalt ersetzt, wenn sie in der Form
|
||||
<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
|
||||
unterst?tzt Lx-Office aber auch OpenDocument-Vorlagen. Sofern es nicht
|
||||
ausdr?cklich eingeschr?nkt wird, gilt das im Folgenden gesagte f?r
|
||||
alle Vorlagenarten.</p><p>Insgesamt sind technisch gesehen eine ganze Menge mehr Variablen
|
||||
verf?gbar als hier aufgelistet werden. Die meisten davon k?nnen
|
||||
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>
|
||||
<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
|
||||
<code class="function">parse_template</code> suchen und hier die Zeile
|
||||
<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
|
||||
der Variablen <code class="varname">$self</code> in der Form <code class="varname">'key'
|
||||
=> 'value',</code>. Alle <code class="varname">key</code>s sind
|
||||
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
|
||||
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
|
||||
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
|
||||
den Wert ohne Formatierung, also ohne Tausendertrennzeichen mit
|
||||
mit einem Punkt als Dezimaltrennzeichen aus. N?tzlich z.B., wenn
|
||||
damit in der Vorlage z.B. von LaTeX gerechnet werden soll.</p></li><li class="listitem"><p>
|
||||
<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
|
||||
und Kontrollstrukturen verwendet werden. Ihr Inhalt wird dabei nach
|
||||
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
|
||||
Kleinerzeichen und einem Prozentzeichen beginnt und mit dem
|
||||
Prozentzeichen und dem Gr??erzeichen endet, beispielsweise
|
||||
<code class="function"><%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 class="function">config:</code> enthalten, die entsprechende Option
|
||||
setzen und bei HTML-Dokumentenvorlagen mit dem Kommentarendzeichen
|
||||
enden. Beispiel f?r LaTeX:</p><pre class="programlisting">% config: tag-style=($ $)</pre><p>Dies w?rde Lx-Office dazu veranlassen, Variablen zu ersetzen,
|
||||
wenn sie wie folgt aussehen: <code class="function">($customer$)</code>. Das
|
||||
?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
|
||||
welcher Funktion ausgelesen wird. Dabei ist die Dateiendung
|
||||
"<code class="filename">.ext</code>" geeignet zu ersetzen:
|
||||
"<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">
|
||||
<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>
|
||||
</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
|
||||
eingearbeitet. So wird aus der Vorlage
|
||||
<code class="filename">sales_order.ext</code> bei Sprache
|
||||
<code class="function">de</code> und Druckerk?rzel <code class="function">lpr2</code>
|
||||
der Vorlagenname <code class="filename">sales_order_de_lpr2.ext</code>.
|
||||
Zus?tzlich k?nnen f?r E-Mails andere Vorlagen erstellt werden, diese
|
||||
bekommen dann noch das K?rzel <code 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
|
||||
kann eine Standarddatei <code class="filename">default.ext</code> hinterlegt
|
||||
werden. Diese wird verwendet, wenn keine der anderen Varianten
|
||||
gefunden wird.</p><p>Die vollst?ndige Suchreihenfolge f?r einen Verkaufsauftrag mit
|
||||
der Sprache "de" und dem Drucker "lpr2", der per E-Mail im Format PDF
|
||||
verschickt wird, ist:</p><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>
|
||||
</p></li></ol></div><p>Die kurzen Varianten dieser Vorlagentitel m?ssen dann entweder
|
||||
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
|
||||
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
|
||||
Vorlagenautoren, die aus einer zentralen Layoutvorlage die einzelnen
|
||||
Formulare einbinden m?chten.</p><div class="variablelist"><dl><dt><span class="term">
|
||||
<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
|
||||
Verkaufsauftrag enth?lt hier
|
||||
<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>
|
||||
</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">
|
||||
<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
|
||||
interessant f?r Vorlagen die mit unformatierten Werten
|
||||
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
|
||||
interessant f?r Vorlagen die mit unformatierten Werten
|
||||
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
|
||||
<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">
|
||||
<code class="varname">template_meta.printer.description</code>
|
||||
</span></dt><dd><p>Beschreibung des ausgew?hlten Druckers</p></dd><dt><span class="term">
|
||||
<code class="varname">template_meta.printer.template_code</code>
|
||||
</span></dt><dd><p>Vorlagen?rzel des ausgew?hlten Druckers, identisch mit
|
||||
dem K?rzel das im Dateinamen verwendetet wird.</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">
|
||||
<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">
|
||||
<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>
|
||||
</span></dt><dd><p>Email des Kunden; nur f?r Kunden</p></dd><dt><span class="term">
|
||||
<code class="varname">customerfax</code>
|
||||
</span></dt><dd><p>Faxnummer des Kunden; nur f?r Kunden</p></dd><dt><span class="term">
|
||||
<code class="varname">customernotes</code>
|
||||
</span></dt><dd><p>Bemerkungen beim Kunden; nur f?r Kunden</p></dd><dt><span class="term">
|
||||
<code class="varname">customernumber</code>
|
||||
</span></dt><dd><p>Kundennummer; nur f?r Kunden</p></dd><dt><span class="term">
|
||||
<code class="varname">customerphone</code>
|
||||
</span></dt><dd><p>Telefonnummer des Kunden; nur f?r Kunden</p></dd><dt><span class="term">
|
||||
<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>
|
||||
</span></dt><dd><p>Stra?e und Hausnummer (Lieferadresse) <a class="link" href="ch03s02.html#dokumentenvorlagen-und-variablen.anmerkung-shipto" title="Anmerkung">*</a>
|
||||
</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>
|
||||
</span></dt><dd><p>Stra?e und Hausnummer</p></dd><dt><span class="term">
|
||||
<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>
|
||||
</span></dt><dd><p>Email des Lieferanten; nur f?r Lieferanten</p></dd><dt><span class="term">
|
||||
<code class="varname">vendorfax</code>
|
||||
</span></dt><dd><p>Faxnummer des Lieferanten; nur f?r Lieferanten</p></dd><dt><span class="term">
|
||||
<code class="varname">vendornotes</code>
|
||||
</span></dt><dd><p>Bemerkungen beim Lieferanten; nur f?r Lieferanten</p></dd><dt><span class="term">
|
||||
<code class="varname">vendornumber</code>
|
||||
</span></dt><dd><p>Lieferantennummer; nur f?r Lieferanten</p></dd><dt><span class="term">
|
||||
<code class="varname">vendorphone</code>
|
||||
</span></dt><dd><p>Telefonnummer des Lieferanten; nur f?r
|
||||
Lieferanten</p></dd><dt><span class="term">
|
||||
<code class="varname">zipcode</code>
|
||||
</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
|
||||
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.
|
||||
<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">
|
||||
<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>
|
||||
</span></dt><dd><p>Telefonnummer</p></dd></dl></div></div><div class="sect3" title="3.2.7.4. Informationen ?ber den Bearbeiter"><div class="titlepage"><div><div><h4 class="title"><a name="dokumentenvorlagen-und-variablen.allgemein-verkaeufer"></a>3.2.7.4. Informationen ?ber den Bearbeiter</h4></div></div></div><div class="variablelist"><dl><dt><span class="term">
|
||||
<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>
|
||||
</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">
|
||||
<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>
|
||||
</span></dt><dd><p>Steuersatz</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">
|
||||
<code class="varname">creditremaining</code>
|
||||
</span></dt><dd><p>Verbleibender Kredit</p></dd><dt><span class="term">
|
||||
<code class="varname">currency</code>
|
||||
</span></dt><dd><p>W?hrung</p></dd><dt><span class="term">
|
||||
<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>
|
||||
</span></dt><dd><p>F?lligkeitsdatum</p></dd><dt><span class="term">
|
||||
<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>
|
||||
</span></dt><dd><p>Restsumme der Rechnung (Summe abz?glich bereits
|
||||
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
|
||||
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">
|
||||
<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>
|
||||
</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
|
||||
einer <code class="function">foreach</code>-Schleife ausgegeben werden, da
|
||||
f?r jeden Artikel mehrere Lieferanteninformationen hinterlegt sein
|
||||
k?nnen. Die Variablen daf?r lauten:</p><div class="variablelist"><dl><dt><span class="term">
|
||||
<code class="varname">make</code>
|
||||
</span></dt><dd><p>Lieferant</p></dd><dt><span class="term">
|
||||
<code class="varname">model</code>
|
||||
</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">
|
||||
<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>
|
||||
</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
|
||||
Lieferanten stehen beim Ausdruck von Einkaufs- und Verkaufsbelegen
|
||||
ebenfalls zur Verf?gung. Ihre Namen setzen sich aus dem Pr?fix
|
||||
<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
|
||||
Mitarbeiter des Unternehmens enth?lt. Diese Variable steht dann
|
||||
unter dem Namen <code class="varname">vc_cvar_number_of_employees</code> zur
|
||||
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
|
||||
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>,
|
||||
und <code class="varname">email</code> zur Verf?gung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term">
|
||||
<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>
|
||||
</span></dt><dd><p>F?lligkeitsdatum f?r diese Mahhnung</p></dd><dt><span class="term">
|
||||
<code class="varname">dunning_id</code>
|
||||
</span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">fee</code>
|
||||
</span></dt><dd><p>Kummulative Mahngeb?hren</p></dd><dt><span class="term">
|
||||
<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>
|
||||
</span></dt><dd><p>Zinsen per anno ?ber alle Rechnungen</p></dd><dt><span class="term">
|
||||
<code class="varname">total_open_amount</code>
|
||||
</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">
|
||||
<code class="varname">dn_amount</code>
|
||||
</span></dt><dd><p>Rechnungssumme (brutto)</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_duedate</code>
|
||||
</span></dt><dd><p>Originales F?lligkeitsdatum der Rechnung</p></dd><dt><span class="term">
|
||||
<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>
|
||||
</span></dt><dd><p>F?lligkeitsdatum der Mahnung</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_fee</code>
|
||||
</span></dt><dd><p>Kummulative Mahngeb?hr</p></dd><dt><span class="term">
|
||||
<code class="varname">dn_interest</code>
|
||||
</span></dt><dd><p>Zinsen per anno f?r diese Rechnung</p></dd><dt><span class="term">
|
||||
<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>
|
||||
</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
|
||||
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>,
|
||||
und <code class="varname">email</code> zur Verf?gung.</p><p>Weitere Variablen beinhalten:</p><div class="variablelist"><dl><dt><span class="term">
|
||||
<code class="varname">duedate</code>
|
||||
</span></dt><dd><p>F?lligkeitsdatum der Rechnung</p></dd><dt><span class="term">
|
||||
<code class="varname">dunning_id</code>
|
||||
</span></dt><dd><p>Mahnungsnummer</p></dd><dt><span class="term">
|
||||
<code class="varname">fee</code>
|
||||
</span></dt><dd><p>Mahngeb?hren</p></dd><dt><span class="term">
|
||||
<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>
|
||||
| 9785598b | Moritz Bunkus | </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="d0e3744"></a>3.2.10.1. Einf?hrung</h4></div></div></div><p>Die Variablen in anderen Vorlagen sind ?hnlich wie in der
|
||
| f8309cb7 | Moritz Bunkus | Rechnung. Allerdings hei?en die Variablen, die mit
|
||
<code class="varname">inv</code> beginnen, jetzt anders. Bei den Angeboten
|
||||
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
|
||||
Vorlage keine Bedeutung haben oder noch nicht belegt sein
|
||||
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">
|
||||
<code class="varname">quonumber</code>
|
||||
</span></dt><dd><p>Angebots- bzw. Anfragenummer</p></dd><dt><span class="term">
|
||||
<code class="varname">reqdate</code>
|
||||
</span></dt><dd><p>G?ltigkeitsdatum (bei Angeboten) bzw. Lieferdatum (bei
|
||||
Preisanfragen)</p></dd><dt><span class="term">
|
||||
<code class="varname">transdate</code>
|
||||
</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">
|
||||
<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>
|
||||
</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
|
||||
die Waren verschickt wurden (Verkaufslieferscheine) bzw. auf welchen
|
||||
Lagerplatz sie eingelagert wurden. Diese m?ssen mittels einer
|
||||
<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>
|
||||
</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">
|
||||
<code class="varname">c0total</code>
|
||||
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit F?lligkeit < 30
|
||||
Tage</p></dd><dt><span class="term">
|
||||
<code class="varname">c30total</code>
|
||||
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit F?lligkeit >= 30
|
||||
und < 60 Tage</p></dd><dt><span class="term">
|
||||
<code class="varname">c60total</code>
|
||||
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit F?lligkeit >= 60
|
||||
und < 90 Tage</p></dd><dt><span class="term">
|
||||
<code class="varname">c90total</code>
|
||||
</span></dt><dd><p>Gesamtbetrag aller Rechnungen mit F?lligkeit >= 90
|
||||
Tage</p></dd><dt><span class="term">
|
||||
<code class="varname">total</code>
|
||||
</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">
|
||||
<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>
|
||||
</span></dt><dd><p>F?lligkeitsdatum</p></dd><dt><span class="term">
|
||||
<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>
|
||||
</span></dt><dd><p>Noch offener Rechnungsbetrag mit F?lligkeit < 30
|
||||
Tage</p></dd><dt><span class="term">
|
||||
<code class="varname">c30</code>
|
||||
</span></dt><dd><p>Noch offener Rechnungsbetrag mit F?lligkeit >= 30 und
|
||||
< 60 Tage</p></dd><dt><span class="term">
|
||||
<code class="varname">c60</code>
|
||||
</span></dt><dd><p>Noch offener Rechnungsbetrag mit F?lligkeit >= 60 und
|
||||
< 90 Tage</p></dd><dt><span class="term">
|
||||
<code class="varname">c90</code>
|
||||
</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
|
||||
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
|
||||
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
|
||||
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.
|
||||
<span class="command"><strong><%if type == "sales_quotation"%></strong></span>, so k?nnte
|
||||
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
|
||||
<code class="varname">variablenname</code> gesetzt und ungleich 0 ist.</p><p>Die Bedingung kann auch negiert werden, indem das Wort
|
||||
<code class="function">not</code> nach dem <code class="filename">if</code> verwendet
|
||||
wird. Beispiel:</p><pre class="programlisting"><%if not cp_greeting%>
|
||||
...
|
||||
<%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
|
||||
einer Variablen mit einer festen Zeichenkette oder einer anderen
|
||||
Variablen zu vergleichen. Ob der Vergleich mit einer Zeichenkette
|
||||
oder einer anderen Variablen vorgenommen wird, h?ngt davon ab, ob
|
||||
die rechte Seite des Vergleichsoperators in Anf?hrungszeichen
|
||||
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
|
||||
?bereinstimmung mit der Zeichenkette <code class="constant">Wert</code>.
|
||||
Mittels <code class="function">!=</code> anstelle von <code class="function">==</code>
|
||||
w?rde auf Ungleichheit getestet.</p><pre class="programlisting">%if var1 == var2%></pre><p>Testet die Variable <code class="varname">var1</code> auf
|
||||
?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
|
||||
dieselbe Syntax wie oben nur mit <code class="function">=~</code> und
|
||||
<code class="function">!~</code> als Vergleichsoperatoren.</p><p>Beispiel f?r einen Test, ob die Variable
|
||||
<code class="varname">intnotes</code> (interne Bemerkungen) das Wort
|
||||
<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%>
|
||||
...
|
||||
<%end%></pre><p>F?gt die Zeilen zwischen den beiden Anweisungen so oft ein,
|
||||
wie das Perl-Array der Variablen <code class="varname">variablenname</code>
|
||||
Elemente enth?t. Dieses Konstrukt wird zur Ausgabe der einzelnen
|
||||
Posten einer Rechnung / eines Angebots sowie zur Ausgabe der Steuern
|
||||
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
|
||||
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
|
||||
wiederholt wie notwendig. Tritt er au?erhalb auf, so wird nur der
|
||||
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
|
||||
Formularen</h3></div></div></div><p>Wenn der Benutzer innhalb von Formularen in Lx-Office Text
|
||||
anders formatiert haben m?chte, so ist dies begrenzt m?glich.
|
||||
Lx-Office unterst?tzt die Textformatierung mit HTML-?hnlichen Tags.
|
||||
Der Benutzer kann z.B. bei der Artikelbeschreibung auf einer Rechnung
|
||||
Teile des Texts zwischen Start- und Endtags setzen. Dieser Teil wird
|
||||
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
|
||||
unten).</p></dd></dl></div><p>Der Befehl <span class="command"><strong><bullet></strong></span> funktioniert
|
||||
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>
|