2 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3 <title>2.12. OpenDocument-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.0.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s11.html" title="2.11. Drucken mit kivitendo"><link rel="next" href="ch02s13.html" title="2.13. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung: EUR"></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">2.12. OpenDocument-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s11.html">Zurück</a> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <a accesskey="n" href="ch02s13.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.12. OpenDocument-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="OpenDocument-Vorlagen"></a>2.12. OpenDocument-Vorlagen</h2></div></div></div><p>kivitendo unterstützt die Verwendung von Vorlagen im
4 OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt.
5 kivitendo kann dabei sowohl neue OpenDocument-Dokumente als auch aus
6 diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von
7 OpenDocument-Vorlagen zu aktivieren muss in der Datei
8 <code class="filename">config/kivitendo.conf</code> die Variable
9 <code class="literal">opendocument</code> im Abschnitt
10 <code class="literal">print_templates</code> auf ‘<code class="literal">1</code>’ stehen.
11 Dieses ist die Standardeinstellung.</p><p>Weiterhin muss in der Datei
12 <code class="filename">config/kivitendo.conf</code> die Variable
13 <code class="literal">dbcharset</code> im Abschnitt <code class="literal">system</code> auf
14 die Zeichenkodierung gesetzt werden, die auch bei der Speicherung der
15 Daten in der Datenbank verwendet wird. Diese ist in den meisten Fällen
16 "UTF-8".</p><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
17 weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
18 OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
19 neben OpenOffice.org ab Version 2 auch der “X virtual frame buffer”
20 (xvfb) installiert werden. Bei Debian ist er im Paket “xvfb” enthalten.
21 Andere Distributionen enthalten ihn in anderen Paketen.</p><p>Nach der Installation müssen in der Datei
22 <code class="filename">config/kivitendo.conf</code> zwei weitere Variablen
23 angepasst werden: <code class="literal">openofficeorg_writer</code> muss den
24 vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
25 <code class="literal">xvfb</code> muss den Pfad zum “X virtual frame buffer”
26 enthalten. Beide stehen im Abschnitt
27 <code class="literal">applications</code>.</p><p>Zusätzlich gibt es zwei verschiedene Arten, wie kivitendo mit
28 OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die
29 Variable <code class="literal">$openofficeorg_daemon</code> gesetzt ist, startet
30 ein OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet
31 bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz
32 benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich
33 reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
34 werden muss. Der Nachteil ist, dass diese Methode Python und die
35 Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2
36 sind.</p><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">Anmerkung</th></tr><tr><td align="left" valign="top"><p>
37 Für die Verbindung zu OpenOffice wird normalerweise der Python-Interpreter <code class="filename">/usr/bin/python</code> benutzt. Sollte
38 dies nicht der richtige sein, so kann man mit zwei Konfigurationsvariablen entscheiden, welcher Python-Interpreter genutzt
39 wird. Mit der Option <code class="literal">python_uno</code> aus dem Abschnitt <code class="literal">applications</code> wird der Interpreter selber
40 festgelegt; sie steht standardmäßig auf dem eben erwähnten Wert <code class="literal">/usr/bin/python</code>.
42 Zusätzlich ist es möglich, Pfade anzugeben, in denen Python neben seinen normalen Suchpfaden ebenfalls nach Modulen gesucht wird,
43 z.B. falls sich diese in einem gesonderten OpenOffice-Verzeichnis befinden. Diese zweite Variable heißt
44 <code class="literal">python_uno_path</code> und befindet sich im Abschnitt <code class="literal">environment</code>. Sie ist standardmäßig
45 leer. Werden hier mehrere Pfade angegeben, so müssen diese durch Doppelpunkte voneinander getrennt werden. Der Inhalt wird an den
46 Python-Interpreter über die Umgebungsvariable <code class="literal">PYTHONPATH</code> übergeben.
47 </p></td></tr></table></div><p>Ist <code class="literal">$openofficeorg_daemon</code> nicht gesetzt, so
48 wird für jedes Dokument OpenOffice neu gestartet und die Konvertierung
49 mit Hilfe eines Makros durchgeführt. Dieses Makro muss in der
50 Dokumentenvorlage enthalten sein und
51 “Standard.Conversion.ConvertSelfToPDF()” heißen. Die Beispielvorlage
52 ‘<code class="literal">templates/mastertemplates/German/invoice.odt</code>’
53 enthält ein solches Makro, das in jeder anderen Dokumentenvorlage
54 ebenfalls enthalten sein muss.</p><p>Als letztes muss herausgefunden werden, welchen Namen
55 OpenOffice.org Writer dem Verzeichnis mit den Benutzereinstellungen
56 gibt. Unter Debian ist dies momentan
57 <code class="literal">~/.openoffice.org2</code>. Sollte der Name bei Ihrer
58 OpenOffice.org-Installation anders sein, so muss das Verzeichnis
59 <code class="literal">users/.openoffice.org2</code> entsprechend umbenannt werden.
60 Ist der Name z.B. einfach nur <code class="literal">.openoffice</code>, so wäre
61 folgender Befehl auszuführen:</p><p>
62 <code class="literal">mv users/.openoffice.org2
63 users/.openoffice</code>
64 </p><p>Dieses Verzeichnis, wie auch das komplette
65 <code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar
66 sein. Dieses wurde bereits erledigt (siehe <a class="xref" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber
67 erneut überprüft werden, wenn die Konvertierung nach PDF
68 fehlschlägt.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s11.html">Zurück</a> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <a accesskey="n" href="ch02s13.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.11. Drucken mit kivitendo </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.13. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:
69 EUR</td></tr></table></div></body></html>