projekt kivitendo

      auch aus diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von

      OpenDocument-Vorlagen zu aktivieren muss in der Datei

      <code class="filename">config/kivitendo.conf</code> die Variable

      <code class="literal">opendocument</code> im Abschnitt

      <code class="literal">print_templates</code> auf ‘<code class="literal">1</code>’ stehen.

      Dieses ist die Standardeinstellung.</p><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei

      weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF

      LibreOffice oder OpenOffice benötigt. Soll dieses Feature genutzt

      werden, so muss neben LibreOffice oder OpenOffice auch der “X virtual

      frame buffer” (xvfb) installiert werden. Bei Debian ist er im Paket

      “xvfb” enthalten. Andere Distributionen enthalten ihn in anderen

      Paketen.</p><p>Nach der Installation müssen in der Datei

      <code class="filename">config/kivitendo.conf</code> im Abschnitt

      <code class="literal">applications</code> zwei weitere Variablen angepasst

      werden:</p><p>

            <code class="literal">openofficeorg_writer</code> muss den vollständigen

      Pfad zu LibreOffice oder OpenOffice enthalten. Dabei dürfen keine

      Anführungszeichen eingesetzt werden.</p><p>Beispiel für Debian oder Ubuntu:</p><pre class="programlisting">openofficeorg_writer = /usr/bin/libreoffice</pre><p>

            <code class="literal">xvfb</code> muss den Pfad zum “X virtual frame buffer”

      enthalten.</p><p>Zusätzlich gibt es zwei verschiedene Arten, wie kivitendo mit

      LibreOffice bzw. OpenOffice kommuniziert. Die erste Variante, die

      benutzt wird, wenn die Variable <code class="literal">$openofficeorg_daemon</code>

      gesetzt ist, startet ein LibreOffice oder OpenOffice, das auch nach der

      Umwandlung des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen

      wird dann diese laufende Instanz benutzt. Der Vorteil ist, dass die Zeit

      zur Umwandlung deutlich reduziert wird, weil nicht für jedes Dokument

      ein LibreOffice bzw. OpenOffice gestartet werden muss. Der Nachteil ist,

      dass diese Methode Python und die Python-UNO-Bindings benötigt, die

      Bestandteil von LibreOffice bzw. OpenOffice 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 LibreOffice bzw. OpenOffice wird

        normalerweise der Python-Interpreter

        <code class="filename">/usr/bin/python</code> benutzt. Sollte dies nicht der

        richtige sein, so kann man mit zwei Konfigurationsvariablen

        entscheiden, welcher Python-Interpreter genutzt wird. Mit der Option

        <code class="literal">python_uno</code> aus dem Abschnitt

        <code class="literal">applications</code> wird der Interpreter selber

        festgelegt; sie steht standardmäßig auf dem eben erwähnten Wert

        <code class="literal">/usr/bin/python</code>.</p><p>Zusätzlich ist es möglich, Pfade anzugeben, in denen Python

        neben seinen normalen Suchpfaden ebenfalls nach Modulen gesucht wird,

        z.B. falls sich diese in einem gesonderten LibreOffice- bzw.

        OpenOffice-Verzeichnis befinden. Diese zweite Variable heißt

        <code class="literal">python_uno_path</code> und befindet sich im Abschnitt

        <code class="literal">environment</code>. Sie ist standardmäßig leer. Werden

        hier mehrere Pfade angegeben, so müssen diese durch Doppelpunkte

        voneinander getrennt werden. Der Inhalt wird an den Python-Interpreter

        über die Umgebungsvariable <code class="literal">PYTHONPATH</code>

        übergeben.</p></td></tr></table></div><p>Ist <code class="literal">$openofficeorg_daemon</code> nicht gesetzt, so

      wird für jedes Dokument LibreOffice bzw. OpenOffice neu gestartet und

      die Konvertierung mit Hilfe eines Makros durchgeführt. Dieses Makro muss

      in der Dokumentenvorlage enthalten sein und

      “Standard.Conversion.ConvertSelfToPDF()” heißen. Die Beispielvorlage

      ‘<code class="literal">templates/print/rev-odt/invoice.odt</code>’ enthält ein

      solches Makro, das in jeder anderen Dokumentenvorlage ebenfalls

      enthalten sein muss.</p><p>Als letztes muss herausgefunden werden, welchen Namen OpenOffice

      bzw. LibreOffice dem Verzeichnis mit den Benutzereinstellungen gibt.

      Unter Debian ist dies momentan <code class="literal">~/.config/libreoffice</code>.

      kivitendo verwendet das Verzeichnis

      <code class="literal">users/.openoffice.org2</code>. Eventuell muss dieses

      Verzeichnis umbenannt werden.</p><p>Dieses Verzeichnis, wie auch das komplette

      <code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar

      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

      ü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="d0e2491"></a>2.13.1. OpenDocument (odt) Druckvorlagen mit Makros</h3></div></div></div><p>OpenDocument Vorlagen können Makros enthalten, welche komplexere

        Aufgaben erfüllen.</p><p>Der Vorlagensatz "rev-odt" enthält solche Vorlagen mit <span class="bold"><strong>Schweizer Bank-Einzahlungsscheinen (BESR)</strong></span>.

        Diese Makros haben die Aufgabe, die in den Einzahlungsscheinen

        benötigte Referenznummer und Kodierzeile zu erzeugen. Hier eine kurze

        Beschreibung, wie die Makros aufgebaut sind, und was bei ihrer Nutzung

        zu beachten ist (<span class="bold"><strong>in fett sind nötige einmalige

        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="d0e2504"></a>2.13.1.1. Bezeichnung der Vorlagen</h4></div></div></div><p>Rechnung: invoice_besr.odt, Auftrag:

          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="opendocument-druckvorlagen-mit-makros.vorbereitungen"></a>2.13.1.2. Vorbereitungen im Adminbereich</h4></div></div></div><p>Damit beim Erstellen von Rechnungen und Aufträgen neben der

              "invoice_" bzw. "sales_order_" und ".odt" 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="d0e2533"></a>2.13.1.3. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung

              (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="d0e2557"></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

          aus dem von kivitendo erzeugten odt-Dokument die korrekte

          Referenznummer inklusive Prüfziffer sowie die Kodierzeile in

          OCRB-Schrift erzeugen und am richtigen Ort ins Dokument

          schreiben.</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Für den Einzahlungsschein ist die letzte Seite des

              Dokuments reserviert</p></li><li class="listitem"><p>Direkt über dem Einzahlungsschein enthält die Vorlage eine

              Zeile mit folgenden Angaben (<span class="bold"><strong>Bank-Konto-Identifikationsnummer und

              Postkonto-Nummer der Bank müssen gemäss Angaben der jeweiligen

              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

                    (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>

                          (nur Ziffern, maximal 6), <span class="bold"><strong>muss

                          angepasst werden</strong></span>.</p></li><li class="listitem"><p>zweiter Wert: &lt;%customernumber%&gt;

                          (Kundennummer: nur Ziffern, maximal 6)</p></li><li class="listitem"><p>dritter Wert: &lt;%ordnumber%&gt;

                          (Auftragsnummer bei Auftragsvorlage

                          sales_oder_besr.odt, sonst 0) maximal 7 Ziffern,

                          führende Buchstaben werden vom Makro entfernt</p></li><li class="listitem"><p>vierter Wert: &lt;%invnumber%&gt;

                          (Rechnungsnummer bei Rechnungsvorlage

                          invoice_besr.odt, sonst 0) maximal 7 Ziffern,

                          führende Buchstaben werden vom Makro entfernt</p></li></ul></div><p>

                              </p></li><li class="listitem"><p>DDDKONTO: <span class="bold"><strong>Postkonto-Nummer der

                    Bank, muss angepasst werden</strong></span>.</p></li><li class="listitem"><p>DDDBETRAG: &lt;%total%&gt; Einzahlungsbetrag oder 0,

                    falls Einzahlungsschein ohne Betrag</p></li><li class="listitem"><p>DDDEND: muss am Ende der Zeile vorhanden sein</p></li></ul></div><p>

                     </p></li><li class="listitem"><p>

                        <span class="bold"><strong>Im Einzahlungsschein selbst müssen

              der Name und die Adresse der Bank, die Postkonto-Nummer der

              Bank, sowie der eigene Firmenname und die Firmenadresse

              angepasst werden.</strong></span> Dabei ist darauf zu achten, dass

              sich die Positionen der Postkonto-Nummern der Bank, sowie der

              Zeichenfolgen dddfr, DDDREF1, DDDREF2, 609, DDDKODIERZEILE nicht

              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="d0e2621"></a>2.13.1.5. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer

          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="d0e2626"></a>2.13.1.6. Makroeinstellungen in LibreOffice anpassen</h4></div></div></div><p>Falls beim Öffnen einer von kivitendo erzeugten odt-Rechnung

          die Meldung kommt, dass Makros aus Sicherheitsgründen nicht

          ausgeführt werden, so müssen folgende Einstellungen in LibreOffice

          angepasst werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Extras → Optionen → Sicherheit → Makrosicherheit</p></li><li class="listitem"><p>Sicherheitslevel auf "Mittel" einstellen (Diese

              Einstellung muss auf jedem Computer durchgeführt werden, mit dem

              von kivitendo erzeugte odt-Rechnungen oder Aufträge geöffnet

              werden.)</p></li><li class="listitem"><p>Beim Öffnen einer odt-Rechnung oder eines odt-Auftrags bei

              der entsprechenden Nachfrage "Makros ausführen"

              auswählen.</p><p>

                        <span class="bold"><strong>Wichtig</strong></span>: die Makros sind

              so eingestellt, dass sie beim Öffnen der Vorlagen selbst nicht

              ausgeführt werden. Das heisst für das Ansehen und Bearbeiten der

              Vorlagen sind keine speziellen Einstellungen in LibreOffice

              nötig.</p></li></ul></div></div></div><div class="sect2" title="2.13.2. Schweizer QR-Rechnung mit OpenDocument Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="d0e2646"></a>2.13.2. Schweizer QR-Rechnung mit OpenDocument Vorlagen</h3></div></div></div><p>Mit der Version 3.6.0 unterstützt Kivitendo die Erstellung von

                  </p></li></ul></div><div class="sect3" title="2.13.2.1. Einstellungen"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2667"></a>2.13.2.1. Einstellungen</h4></div></div></div><div class="sect4" title="2.13.2.1.1. Mandantenkonfiguration"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2670"></a>2.13.2.1.1. Mandantenkonfiguration</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Mandantenkonfiguration →

            wählen.</p></div><div class="sect4" title="2.13.2.1.2. Konfiguration der Bankkonten"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2684"></a>2.13.2.1.2. Konfiguration der Bankkonten</h5></div></div></div><p>Unter <span class="emphasis"><em>System → Bankkonten</em></span> muss bei

            verwendet.</p></div><div class="sect4" title="2.13.2.1.3. Rechnungen ohne Betrag"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2718"></a>2.13.2.1.3. Rechnungen ohne Betrag</h5></div></div></div><p>Für Rechnungen ohne Betrag (z.B. Spenden) kann, in der

            Vorlage muss separat angepasst und ausgewählt werden.</p></div></div><div class="sect3" title="2.13.2.2. Adressdaten"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2728"></a>2.13.2.2. Adressdaten</h4></div></div></div><p>Die Adressdaten zum Zahlungsempfänger werden aus der

          Adressfelder, 2 Zeilen).</p></div><div class="sect3" title="2.13.2.3. Referenznummer"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2749"></a>2.13.2.3. Referenznummer</h4></div></div></div><p>Die Referenznummer wird in Kivitendo erzeugt und setzt sich

          führenden Nullen aufgefüllt.</p></div><div class="sect3" title="2.13.2.4. Vorlage"><div class="titlepage"><div><div><h4 class="title"><a name="d0e2769"></a>2.13.2.4. Vorlage</h4></div></div></div><p>Der Vorlagensatz "rev-odt" enthält die Vorlage

          mit dem Vorlagenkürzel <code class="literal">qr</code> (siehe <a class="xref" href="ch02s13.html#opendocument-druckvorlagen-mit-makros.vorbereitungen" title="2.13.1.2. Vorbereitungen im Adminbereich">Abschnitt&nbsp;2.13.1.2, „Vorbereitungen im Adminbereich“</a>).

          Beispielvorlage.</p><div class="sect4" title="2.13.2.4.1. Zusätzliche Variablen für Vorlage"><div class="titlepage"><div><div><h5 class="title"><a name="d0e2799"></a>2.13.2.4.1. Zusätzliche Variablen für Vorlage</h5></div></div></div><p>Zusätzlich zu den in der Vorlage standardmässig verfügbaren