2 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3 <title>2.13. 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.4.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s12.html" title="2.12. Drucken mit kivitendo"><link rel="next" href="ch02s14.html" title="2.14. 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.13. OpenDocument-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s12.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="ch02s14.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.13. OpenDocument-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="OpenDocument-Vorlagen"></a>2.13. 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>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
12 weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
13 OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
14 neben OpenOffice.org ab Version 2 auch der “X virtual frame buffer”
15 (xvfb) installiert werden. Bei Debian ist er im Paket “xvfb” enthalten.
16 Andere Distributionen enthalten ihn in anderen Paketen.</p><p>Nach der Installation müssen in der Datei
17 <code class="filename">config/kivitendo.conf</code> zwei weitere Variablen
18 angepasst werden: <code class="literal">openofficeorg_writer</code> muss den
19 vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
20 <code class="literal">xvfb</code> muss den Pfad zum “X virtual frame buffer”
21 enthalten. Beide stehen im Abschnitt
22 <code class="literal">applications</code>.</p><p>Zusätzlich gibt es zwei verschiedene Arten, wie kivitendo mit
23 OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die
24 Variable <code class="literal">$openofficeorg_daemon</code> gesetzt ist, startet
25 ein OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet
26 bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz
27 benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich
28 reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
29 werden muss. Der Nachteil ist, dass diese Methode Python und die
30 Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2
31 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>Für die Verbindung zu OpenOffice wird normalerweise der
32 Python-Interpreter <code class="filename">/usr/bin/python</code> benutzt.
33 Sollte dies nicht der richtige sein, so kann man mit zwei
34 Konfigurationsvariablen entscheiden, welcher Python-Interpreter
35 genutzt wird. Mit der Option <code class="literal">python_uno</code> aus dem
36 Abschnitt <code class="literal">applications</code> wird der Interpreter selber
37 festgelegt; sie steht standardmäßig auf dem eben erwähnten Wert
38 <code class="literal">/usr/bin/python</code>.</p><p>Zusätzlich ist es möglich, Pfade anzugeben, in denen Python
39 neben seinen normalen Suchpfaden ebenfalls nach Modulen gesucht wird,
40 z.B. falls sich diese in einem gesonderten OpenOffice-Verzeichnis
41 befinden. Diese zweite Variable heißt
42 <code class="literal">python_uno_path</code> und befindet sich im Abschnitt
43 <code class="literal">environment</code>. Sie ist standardmäßig leer. Werden
44 hier mehrere Pfade angegeben, so müssen diese durch Doppelpunkte
45 voneinander getrennt werden. Der Inhalt wird an den Python-Interpreter
46 über die Umgebungsvariable <code class="literal">PYTHONPATH</code>
47 übergeben.</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 erneut
67 überprüft werden, wenn die Konvertierung nach PDF fehlschlägt.</p><div class="sect2" title="2.13.1. OpenDocument (odt) Druckvorlagen mit Makros"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2131"></a>2.13.1. OpenDocument (odt) Druckvorlagen mit Makros</h3></div></div></div><p>OpenDocument Vorlagen können Makros enthalten, welche komplexere
68 Aufgaben erfüllen.</p><p>Der Vorlagensatz "rev-odt" enthält solche Vorlagen mit <span class="bold"><strong>Schweizer Bank-Einzahlungsscheinen (BESR)</strong></span>.
69 Diese Makros haben die Aufgabe, die in den Einzahlungsscheinen
70 benötigte Referenznummer und Kodierzeile zu erzeugen. Hier eine kurze
71 Beschreibung, wie die Makros aufgebaut sind, und was bei ihrer Nutzung
72 zu beachten ist (<span class="bold"><strong>in fett sind nötige einmalige
73 Anpassungen aufgeführt</strong></span>):</p><div class="sect3" title="2.13.1.1. Bezeichnung der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2144"></a>2.13.1.1. Bezeichnung der Vorlagen</h4></div></div></div><p>Rechnung: invoice_besr.odt, Auftrag:
74 sales_order_besr.odt</p></div><div class="sect3" title="2.13.1.2. Vorbereitungen im Adminbereich"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2149"></a>2.13.1.2. Vorbereitungen im Adminbereich</h4></div></div></div><p>Damit beim Erstellen von Rechnungen und Aufträgen neben der
75 Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit
76 Einzahlungsschein) auswählbar sind, muss für jedes Vorlagen-Suffix
77 ein Drucker eingerichtet werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Druckeradministration -> Drucker hinzufügen</p></li><li class="listitem"><p>Mandant wählen</p></li><li class="listitem"><p>Druckerbeschreibung -> aussagekräftiger Text: wird in
78 der Auftrags- bzw. Rechnungsmaske als Auswahl angezeigt (z.B.
79 mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Druckbefehl -> beliebiger Text (hat für das Erzeugen
80 von Aufträgen oder Rechnungen als odt-Datei keine Bedeutung,
81 darf aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel -> besr bzw. selbst gewähltes
82 Vorlagensuffix (muss genau der Zeichenfolge entsprechen, die
83 zwischen "invoice_" bzw. "sales_order_" und ".odt"
84 steht.)</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.1.3. Benutzereinstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2173"></a>2.13.1.3. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
85 im Rechnungs- bzw. Auftragsformular angezeigt haben möchte, kann
86 dies persönlich für sich bei den Benutzereinstellungen
87 konfigurieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Programm -> Benutzereinstellungen ->
88 Druckoptionen</p></li><li class="listitem"><p>Standardvorlagenformat -> OpenDocument/OASIS</p></li><li class="listitem"><p>Standardausgabekanal -> Bildschirm</p></li><li class="listitem"><p>Standarddrucker -> gewünschte Druckerbeschreibung
89 auswählen (z.B. mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Anzahl Kopien -> leer</p></li><li class="listitem"><p>speichern</p></li></ul></div></div><div class="sect3" title="2.13.1.4. Aufbau und nötige Anpassungen der Vorlagen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2197"></a>2.13.1.4. Aufbau und nötige Anpassungen der Vorlagen</h4></div></div></div><p>In der Vorlage sind als Modul "BESR" 4 Makros gespeichert, die
90 aus dem von kivitendo erzeugten odt-Dokument die korrekte
91 Referenznummer inklusive Prüfziffer sowie die Kodierzeile in
92 OCRB-Schrift erzeugen und am richtigen Ort ins Dokument
93 schreiben.</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Für den Einzahlungsschein ist die letzte Seite des
94 Dokuments reserviert</p></li><li class="listitem"><p>Direkt über dem Einzahlungsschein enthält die Vorlage eine
95 Zeile mit folgenden Angaben (<span class="bold"><strong>Bank-Konto-Identifikationsnummer und
96 Postkonto-Nummer der Bank müssen gemäss Angaben der jeweiligen
97 Bank angepasst werden</strong></span>):</p><div class="itemizedlist"><ul class="itemizedlist" type="circle"><li class="listitem"><p>DDDREF: 4 Werte zum Bilden der Referenznummer
98 (jeweils durch einen Leerschlag getrennt): </p><div class="itemizedlist"><ul class="itemizedlist" type="square"><li class="listitem"><p>erster Wert: <span class="bold"><strong>Bank-Konto-Identifikation</strong></span>
99 (nur Ziffern, maximal 6), <span class="bold"><strong>muss
100 angepasst werden</strong></span>.</p></li><li class="listitem"><p>zweiter Wert: <%customernumber%>
101 (Kundennummer: nur Ziffern, maximal 6)</p></li><li class="listitem"><p>dritter Wert: <%ordnumber%>
102 (Auftragsnummer bei Auftragsvorlage
103 sales_oder_besr.odt, sonst 0) maximal 7 Ziffern,
104 führende Buchstaben werden vom Makro entfernt</p></li><li class="listitem"><p>vierter Wert: <%invnumber%>
105 (Rechnungsnummer bei Rechnungsvorlage
106 invoice_besr.odt, sonst 0) maximal 7 Ziffern,
107 führende Buchstaben werden vom Makro entfernt</p></li></ul></div><p>
108 </p></li><li class="listitem"><p>DDDKONTO: <span class="bold"><strong>Postkonto-Nummer der
109 Bank, muss angepasst werden</strong></span>.</p></li><li class="listitem"><p>DDDBETRAG: <%total%> Einzahlungsbetrag oder 0,
110 falls Einzahlungsschein ohne Betrag</p></li></ul></div><p>
111 </p></li><li class="listitem"><p>
112 <span class="bold"><strong>Im Einzahlungsschein selbst müssen
113 der Name und die Adresse der Bank, die Postkonto-Nummer der
114 Bank, sowie der eigene Firmenname und die Firmenadresse
115 angepasst werden.</strong></span> Dabei ist darauf zu achten, dass
116 sich die Positionen der Postkonto-Nummern der Bank, sowie der
117 Zeichenfolgen dddfr, DDDREF1, DDDREF2, 609, DDDKODIERZEILE nicht
118 verschieben.</p></li></ul></div><div class="screenshot"><div class="mediaobject"><img src="images/Einzahlungsschein_Makro.png"></div></div></div><div class="sect3" title="2.13.1.5. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer odt-Rechnung (analog bei Auftrag)"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2258"></a>2.13.1.5. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer
119 odt-Rechnung (analog bei Auftrag)</h4></div></div></div><p>Im Fussbereich der Rechnungsmaske muss neben Rechnung,
120 OpenDocument/OASIS und Bildschirm die im Adminbereich erstellte
121 Druckerbeschreibung ausgewählt werden, falls diese nicht bereits bei
122 den Benutzereinstellungen als persönlicher Standard gewählt
123 wurde.</p></div><div class="sect3" title="2.13.1.6. Makroeinstellungen in LibreOffice anpassen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2263"></a>2.13.1.6. Makroeinstellungen in LibreOffice anpassen</h4></div></div></div><p>Falls beim Öffnen einer von kivitendo erzeugten odt-Rechnung
124 die Meldung kommt, dass Makros aus Sicherheitsgründen nicht
125 ausgeführt werden, so müssen folgende Einstellungen in LibreOffice
126 angepasst werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Extras -> Optionen -> Sicherheit ->
127 Makrosicherheit</p></li><li class="listitem"><p>Sicherheitslevel auf "Mittel" einstellen (Diese
128 Einstellung muss auf jedem Computer durchgeführt werden, mit dem
129 von kivitendo erzeugte odt-Rechnungen oder Aufträge geöffnet
130 werden.)</p></li><li class="listitem"><p>Beim Öffnen einer odt-Rechnung oder eines odt-Auftrags bei
131 der entsprechenden Nachfrage "Makros ausführen" auswählen.
133 <span class="bold"><strong>Wichtig</strong></span>: die Makros sind
134 so eingestellt, dass sie beim Öffnen der Vorlagen selbst nicht
135 ausgeführt werden. Das heisst für das Ansehen und Bearbeiten der
136 Vorlagen sind keine speziellen Einstellungen in LibreOffice
137 nötig.</p></li></ul></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s12.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="ch02s14.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.12. 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.14. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:
138 EUR</td></tr></table></div></body></html>