2 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3 <title>3.4. Excel-Vorlagen</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.5.3: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch03.html" title="Kapitel 3. Features und Funktionen"><link rel="prev" href="ch03s03.html" title="3.3. Dokumentenvorlagen und verfügbare Variablen"><link rel="next" href="ch03s05.html" title="3.5. Mandantenkonfiguration Lager"></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.4. Excel-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch03s03.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="ch03s05.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="3.4. Excel-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="excel-templates"></a>3.4. Excel-Vorlagen</h2></div></div></div><div class="sect2" title="3.4.1. Zusammenfassung"><div class="titlepage"><div><div><h3 class="title"><a name="excel-templates.summary"></a>3.4.1. Zusammenfassung</h3></div></div></div><p>Dieses Dokument beschreibt den Mechanismus, mit dem
4 Exceltemplates abgearbeitet werden, und die Einschränkungen, die damit
5 einhergehen.</p></div><div class="sect2" title="3.4.2. Bedienung"><div class="titlepage"><div><div><h3 class="title"><a name="excel-templates.usage"></a>3.4.2. Bedienung</h3></div></div></div><p>Der Excel Mechanismus muss in der Konfigurationsdatei aktiviert
6 werden. Die Konfigurationsoption heißt <code class="varname">excel_templates =
7 1</code> im Abschnitt <code class="varname">[print_templates]</code>.</p><p>Eine Excelvorlage kann dann unter dem Namen einer beliebigen
8 anderen Vorlage mit der Endung <code class="filename">.xls</code> gespeichert
9 werden. In den normalen Verkaufsmasken taucht nun
10 <code class="constant">Excel</code> als auswählbares Format auf und kann von da
11 an wie LaTeX- oder OpenOffice-Vorlagen benutzt werden.</p><p>Der Sonderfall der Angebote aus der Kundenmaske ist ebenfalls
12 eine Angebotsvorlage und wird unter dem internen Namen der Angebote
13 <code class="filename">sales_quotation.xls</code> gespeichert.</p></div><div class="sect2" title="3.4.3. Variablensyntax"><div class="titlepage"><div><div><h3 class="title"><a name="excel-templates.syntax"></a>3.4.3. Variablensyntax</h3></div></div></div><p>Einfache Syntax:
14 <span class="command"><strong><<varname>></strong></span>
15 </p><p>Dabei sind <code class="constant"><<</code> und
16 <code class="constant">>></code> die Delimiter. Da Excel auf festen
17 Breiten besteht, kann der Tag künstlich verlängert werden, indem
18 weitere <code class="constant"><</code> oder <code class="constant">></code>
19 eingefügt werden. Der Tag muss nicht symmetrisch sein.
20 Beispiel:</p><pre class="programlisting"><<<<<varname>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>></pre><p>Um die Limitierung der festen Breite zu reduzieren, können
21 weitere Variablen in einem Block interpoliert werden. Whitespace wird
22 dazwishen dann erhalten. Beispiel:</p><pre class="programlisting"><<<<<varname1 varname2 varname3>>>>>>>>>>>>>>>>>>>>>>>>>></pre><p>Die Variablen werden interpoliert, und linksbündig mit
23 Leerzeichen auf die gewünschte Länge aufgefüllt. Ist der String zu
24 lang, werden überzählige Zeichen abgeschnitten.</p><p>Es ist ausserdem möglich, Daten rechtsbündig darzustellen, wenn
25 der Block mit einem Leerzeichen anfängt. Beispiel:</p><pre class="programlisting"><<<<<< varname>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>></pre><p>Dies würde rechtsbündig triggern. Wenn bei rechtsbündiger
26 Ausrichtung Text abgeschnitten werden muss, wird er vom linken Ende
27 entfernt.</p></div><div class="sect2" title="3.4.4. Einschränkungen"><div class="titlepage"><div><div><h3 class="title"><a name="excel-templates.limitations"></a>3.4.4. Einschränkungen</h3></div></div></div><p>Das Excelformat bis 2002 ist ein binäres Format, und kann nicht
28 mit vertretbarem Aufwand editiert werden. Der Templatemechanismus
29 beschränkt sich daher darauf, Textstellen exakt durch einen anderen
30 Text zu ersetzen.</p><p>Aus dem gleichen Grund sind die Kontrolllstrukturen
31 <span class="command"><strong><%if%></strong></span> und
32 <span class="command"><strong><%foreach%></strong></span> nicht vorhanden. Der Delimiter
33 <code class="constant"><% %></code> kommt in den Headerinformationen
34 evtl. vor. Deshalb wurde auf den sichereren Delimiter
35 <code class="constant"><<</code> und <code class="constant">>></code>
36 gewechselt.</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch03s03.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="ch03s05.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">3.3. Dokumentenvorlagen und verfügbare Variablen </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 3.5. Mandantenkonfiguration Lager</td></tr></table></div></body></html>
projects / mfinanz.git / blob