bc85bbb55e8b35fb78c953acdfee8a206ac51506
[kivitendo-erp.git] / ch03s04.html
1 <html><head>
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.3.0: 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>&nbsp;</td><th width="60%" align="center">Kapitel 3. Features und Funktionen</th><td width="20%" align="right">&nbsp;<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>&lt;&lt;varname&gt;&gt;</strong></span>
15             </p><p>Dabei sind <code class="constant">&lt;&lt;</code> und
16         <code class="constant">&gt;&gt;</code> die Delimiter. Da Excel auf festen
17         Breiten besteht, kann der Tag künstlich verlängert werden, indem
18         weitere <code class="constant">&lt;</code> oder <code class="constant">&gt;</code>
19         eingefügt werden. Der Tag muss nicht symmetrisch sein.
20         Beispiel:</p><pre class="programlisting">&lt;&lt;&lt;&lt;&lt;varname&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;</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">&lt;&lt;&lt;&lt;&lt;varname1 varname2   varname3&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;</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">&lt;&lt;&lt;&lt;&lt;&lt;            varname&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;&gt;</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>&lt;%if%&gt;</strong></span> und
32         <span class="command"><strong>&lt;%foreach%&gt;</strong></span> nicht vorhanden. Der Delimiter
33         <code class="constant">&lt;% %&gt;</code> kommt in den Headerinformationen
34         evtl. vor. Deshalb wurde auf den sichereren Delimiter
35         <code class="constant">&lt;&lt;</code> und <code class="constant">&gt;&gt;</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>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch03.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<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&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;3.5. Mandantenkonfiguration Lager</td></tr></table></div></body></html>