kivitendo/doc/excel_templates.txt @ 12237492
| 90815a31 | Joachim Zach | Table of Contents
|
|
-----------------
|
|||
Inhalt der Anleitung
|
|||
1 Zusammenfassung
|
|||
2 Bedienung
|
|||
3 Exceltemplate Syntax
|
|||
4 Einschr?nkungen
|
|||
Zusammenfassung
|
|||
---------------
|
|||
Dieses Dokument beschreibt den Mechanismus, mit dem Exceltemplates abgearbeitet
|
|||
werden, und die Einschr?nkungen die damit einhergehen.
|
|||
Bedienung
|
|||
---------
|
|||
Der Excel Mechanismus muss in der Konfigurationsdatei aktiviert werden. Die
|
|||
Konfigurationsoption hei?t:
|
|||
$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
|
|||
"Excel" als ausw?hlbares Format auf, und kann von da an bnutzt weren wie Latex
|
|||
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,
|
|||
kann der Tag k?nstlich verl?ngert werden, indem weitere "<" oder ">" gegef?gt
|
|||
werden. Der Tag muss nicht symmetrisch sein.
|
|||
Beispiel: <<<<<varname>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
|
|||
Um die Limitierung der festen Breite zu reduzieren, k?nnen weitere Variablen in
|
|||
einem Block interpoliert werden. Whitespace wird dazwishen dann erhalten.
|
|||
Beispiel: <<<<<varname1 varname2 varname3>>>>>>>>>>>>>>>>>>>>>>>>>>
|
|||
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
|
|||
abgeschnitten.
|
|||
Es ist ausserdem m?glich Daten rechtsb?ndig darzustellen, wenn der Block mit
|
|||
einem Leerzeichen anf?ngt.
|
|||
Beispiel: <<<<<< varname>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
|
|||
w?rde rechtsb?ndig triggern. Wenn bei rechtsb?ndiger Ausrichtung Text
|
|||
abgeschnitten werden muss, wird er vom linken Ende entfernt.
|
|||
Einschr?nkungen
|
|||
---------------
|
|||
Das Excelformat bis 2002 ist ein bin?res Format, und kann nicht mit vertretbarem
|
|||
Aufwand editiert werden. Der Templatemechanismus beschr?nkt sich daher darauf,
|
|||
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.
|