kivitendo/doc/excel_templates.txt @ 973541d4
| 90815a31 | Joachim Zach | Table of Contents
|
||
-----------------
|
||||
Inhalt der Anleitung
|
||||
1 Zusammenfassung
|
||||
2 Bedienung
|
||||
3 Exceltemplate Syntax
|
||||
| 05c6840d | Moritz Bunkus | 4 Einschränkungen
|
||
| 90815a31 | Joachim Zach | |||
Zusammenfassung
|
||||
---------------
|
||||
Dieses Dokument beschreibt den Mechanismus, mit dem Exceltemplates abgearbeitet
|
||||
| 05c6840d | Moritz Bunkus | werden, und die Einschränkungen die damit einhergehen.
|
||
| 90815a31 | Joachim Zach | |||
Bedienung
|
||||
---------
|
||||
Der Excel Mechanismus muss in der Konfigurationsdatei aktiviert werden. Die
|
||||
| 05c6840d | Moritz Bunkus | Konfigurationsoption heißt:
|
||
| 90815a31 | Joachim Zach | |||
$excel_templates = 1;
|
||||
Eine Excelvorlage kann dann unter dem Namen einer beliebigen anderen Vorlage mit
|
||||
der Endung .xls gespeichert werden. In den normalen Verkaufsmasken taucht nun
|
||||
| 05c6840d | Moritz Bunkus | "Excel" als auswählbares Format auf, und kann von da an bnutzt weren wie Latex
|
||
| 90815a31 | Joachim Zach | oder OpenOffice Vorlagen.
|
||
Der Sonderfall der Angebote aus der Kundenmaske ist ebenfalls eine
|
||||
Angebotsvorlage, und wird unter dem internen Namen der Angebote
|
||||
"sales_quotation.xls" gespeichert.
|
||||
Exceltemplate Syntax
|
||||
--------------------
|
||||
Einfache Syntax: <<varname>>
|
||||
Wobei "<<" und ">>" die Delimiter sind. Da Excel auf festen Breiten besteht,
|
||||
| 05c6840d | Moritz Bunkus | kann der Tag künstlich verlängert werden, indem weitere "<" oder ">" gegefügt
|
||
| 90815a31 | Joachim Zach | werden. Der Tag muss nicht symmetrisch sein.
|
||
Beispiel: <<<<<varname>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
|
||||
| 05c6840d | Moritz Bunkus | Um die Limitierung der festen Breite zu reduzieren, können weitere Variablen in
|
||
| 90815a31 | Joachim Zach | einem Block interpoliert werden. Whitespace wird dazwishen dann erhalten.
|
||
Beispiel: <<<<<varname1 varname2 varname3>>>>>>>>>>>>>>>>>>>>>>>>>>
|
||||
| 05c6840d | Moritz Bunkus | Die Variablen werden interpoliert, und linksbündig mit Leerzeichen auf die
|
||
gewünschte Länge aufgefüllt. Ist der String zu lang, werden überzählige Zeichen
|
||||
| 90815a31 | Joachim Zach | abgeschnitten.
|
||
| 05c6840d | Moritz Bunkus | Es ist ausserdem möglich Daten rechtsbündig darzustellen, wenn der Block mit
|
||
einem Leerzeichen anfängt.
|
||||
| 90815a31 | Joachim Zach | |||
Beispiel: <<<<<< varname>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
|
||||
| 05c6840d | Moritz Bunkus | würde rechtsbündig triggern. Wenn bei rechtsbündiger Ausrichtung Text
|
||
| 90815a31 | Joachim Zach | abgeschnitten werden muss, wird er vom linken Ende entfernt.
|
||
| 05c6840d | Moritz Bunkus | Einschränkungen
|
||
| 90815a31 | Joachim Zach | ---------------
|
||
| 05c6840d | Moritz Bunkus | Das Excelformat bis 2002 ist ein binäres Format, und kann nicht mit vertretbarem
|
||
Aufwand editiert werden. Der Templatemechanismus beschränkt sich daher darauf,
|
||||
| 90815a31 | Joachim Zach | Textstellen _exakt_ durch einen anderen Text zu ersetzen.
|
||
Aus dem gleichen Grund sind die Templatekonstrukte <% if %> und <% foreach %>
|
||||
nicht vorhanden. Der Delimiter <% %> kommt in den Headerinformationen evtl vor,
|
||||
deshalb wurde auf den sichereren "<<"/">>" gewechselt.
|