Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision 2e917eea

Von Andreas Rudin vor mehr als 8 Jahren hinzugefügt

  • ID 2e917eea0cfb61fa57cc9a36e9872b001f821112
  • Vorgänger 6fbc8268
  • Nachfolger 69140e01

Dokumentation-Erweiterung und -Anpasung CH-Modus, OpenDocument-Vorlagen

Unterschiede anzeigen:

doc/html/ch02s13.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3 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>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<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.
4
      OpenDocument-Format, wie es LibreOffice oder OpenOffice (ab Version 2) erzeugen.
5 5
      kivitendo kann dabei sowohl neue OpenDocument-Dokumente als auch aus
6 6
      diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von
7 7
      OpenDocument-Vorlagen zu aktivieren muss in der Datei
......
10 10
      <code class="literal">print_templates</code> auf ‘<code class="literal">1</code>’ stehen.
11 11
      Dieses ist die Standardeinstellung.</p><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
12 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”
13
      LibreOffice oder OpenOffice benötigt. Soll dieses Feature genutzt werden, so muss
14
      neben LibreOffice oder OpenOffice auch der “X virtual frame buffer”
15 15
      (xvfb) installiert werden. Bei Debian ist er im Paket “xvfb” enthalten.
16 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.
17
      <code class="filename">config/kivitendo.conf</code> im Abschnitt
18
      <code class="literal">applications</code> zwei weitere Variablen
19
      angepasst werden:</p><p>
20
            <code class="literal">openofficeorg_writer</code> muss den
21
      vollständigen Pfad zu LibreOffice oder OpenOffice enthalten.
22
      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>
23
            <code class="literal">xvfb</code> muss den Pfad zum “X virtual frame buffer”
24
      enthalten.</p><p>Zusätzlich gibt es zwei verschiedene Arten, wie kivitendo mit
25
      LibreOffice bzw. OpenOffice kommuniziert. Die erste Variante, die benutzt 
26
      wird, wenn die Variable <code class="literal">$openofficeorg_daemon</code> gesetzt 
27
      ist, startet ein LibreOffice oder OpenOffice, das auch nach der Umwandlung 
28
      des Dokumentes gestartet bleibt. Bei weiteren Umwandlungen wird dann diese 
29
      laufende Instanz benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung 
30
      deutlich reduziert wird, weil nicht für jedes Dokument ein LibreOffice bzw. 
31
      OpenOffice gestartet werden muss. Der Nachteil ist, dass diese Methode 
32
      Python und die Python-UNO-Bindings benötigt, die Bestandteil von LibreOffice 
33
      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 
34
        normalerweise der Python-Interpreter
35
        <code class="filename">/usr/bin/python</code> benutzt.
33 36
        Sollte dies nicht der richtige sein, so kann man mit zwei
34 37
        Konfigurationsvariablen entscheiden, welcher Python-Interpreter
35 38
        genutzt wird. Mit der Option <code class="literal">python_uno</code> aus dem
......
37 40
        festgelegt; sie steht standardmäßig auf dem eben erwähnten Wert
38 41
        <code class="literal">/usr/bin/python</code>.</p><p>Zusätzlich ist es möglich, Pfade anzugeben, in denen Python
39 42
        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
43
        z.B. falls sich diese in einem gesonderten LibreOffice- bzw. 
44
        OpenOffice-Verzeichnis befinden. Diese zweite Variable heißt
42 45
        <code class="literal">python_uno_path</code> und befindet sich im Abschnitt
43 46
        <code class="literal">environment</code>. Sie ist standardmäßig leer. Werden
44 47
        hier mehrere Pfade angegeben, so müssen diese durch Doppelpunkte
45 48
        voneinander getrennt werden. Der Inhalt wird an den Python-Interpreter
46 49
        über die Umgebungsvariable <code class="literal">PYTHONPATH</code>
47 50
        ü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
      wird für jedes Dokument LibreOffice bzw. OpenOffice neu gestartet 
52
      und die Konvertierung mit Hilfe eines Makros durchgeführt. Dieses 
53
      Makro muss in der Dokumentenvorlage enthalten sein und
51 54
      “Standard.Conversion.ConvertSelfToPDF()” heißen. Die Beispielvorlage
52
      ‘<code class="literal">templates/mastertemplates/German/invoice.odt</code>’
55
      ‘<code class="literal">templates/print/rev-odt/invoice.odt</code>’
53 56
      enthält ein solches Makro, das in jeder anderen Dokumentenvorlage
54 57
      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
58
      OpenOffice bzw. LibreOffice dem Verzeichnis mit den Benutzereinstellungen
59
      gibt. Unter Debian ist dies momentan 
60
      <code class="literal">~/.config/libreoffice</code>. kivitendo verwendet das 
61
      Verzeichnis <code class="literal">users/.openoffice.org2</code>.
62
      Eventuell muss dieses Verzeichnis umbenannt werden.</p><p>Dieses Verzeichnis, wie auch das komplette
65 63
      <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
64
      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 
65
      erneut überprüft werden, wenn die Konvertierung nach PDF 
66
      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="d0e2161"></a>2.13.1. OpenDocument (odt) Druckvorlagen mit Makros</h3></div></div></div><p>OpenDocument Vorlagen können Makros enthalten, welche komplexere
68 67
        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 68
        Diese Makros haben die Aufgabe, die in den Einzahlungsscheinen
70 69
        benötigte Referenznummer und Kodierzeile zu erzeugen. Hier eine kurze
71 70
        Beschreibung, wie die Makros aufgebaut sind, und was bei ihrer Nutzung
72 71
        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
72
        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="d0e2174"></a>2.13.1.1. Bezeichnung der Vorlagen</h4></div></div></div><p>Rechnung: invoice_besr.odt, Auftrag:
73
          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="d0e2179"></a>2.13.1.2. Vorbereitungen im Adminbereich</h4></div></div></div><p>Damit beim Erstellen von Rechnungen und Aufträgen neben der
75 74
          Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit
76 75
          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 -&gt; Drucker hinzufügen</p></li><li class="listitem"><p>Mandant wählen</p></li><li class="listitem"><p>Druckerbeschreibung -&gt; aussagekräftiger Text: wird in
76
          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 77
              der Auftrags- bzw. Rechnungsmaske als Auswahl angezeigt (z.B.
79
              mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Druckbefehl -&gt; beliebiger Text (hat für das Erzeugen
78
              mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Druckbefehl  beliebiger Text (hat für das Erzeugen
80 79
              von Aufträgen oder Rechnungen als odt-Datei keine Bedeutung,
81
              darf aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel -&gt; besr bzw. selbst gewähltes
80
              darf aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel  besr bzw. selbst gewähltes
82 81
              Vorlagensuffix (muss genau der Zeichenfolge entsprechen, die
83 82
              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
83
              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="d0e2203"></a>2.13.1.3. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
85 84
          im Rechnungs- bzw. Auftragsformular angezeigt haben möchte, kann
86 85
          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 -&gt; Benutzereinstellungen -&gt;
88
              Druckoptionen</p></li><li class="listitem"><p>Standardvorlagenformat -&gt; OpenDocument/OASIS</p></li><li class="listitem"><p>Standardausgabekanal -&gt; Bildschirm</p></li><li class="listitem"><p>Standarddrucker -&gt; gewünschte Druckerbeschreibung
89
              auswählen (z.B. mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Anzahl Kopien -&gt; 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
86
          konfigurieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Programm → Benutzereinstellungen →
87
              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
88
              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="d0e2227"></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 89
          aus dem von kivitendo erzeugten odt-Dokument die korrekte
91 90
          Referenznummer inklusive Prüfziffer sowie die Kodierzeile in
92 91
          OCRB-Schrift erzeugen und am richtigen Ort ins Dokument
......
107 106
                          führende Buchstaben werden vom Makro entfernt</p></li></ul></div><p>
108 107
                              </p></li><li class="listitem"><p>DDDKONTO: <span class="bold"><strong>Postkonto-Nummer der
109 108
                    Bank, muss angepasst werden</strong></span>.</p></li><li class="listitem"><p>DDDBETRAG: &lt;%total%&gt; Einzahlungsbetrag oder 0,
110
                    falls Einzahlungsschein ohne Betrag</p></li></ul></div><p>
109
                    falls Einzahlungsschein ohne Betrag</p></li><li class="listitem"><p>DDDEND: muss am Ende der Zeile vorhanden sein</p></li></ul></div><p>
111 110
                     </p></li><li class="listitem"><p>
112 111
                        <span class="bold"><strong>Im Einzahlungsschein selbst müssen
113 112
              der Name und die Adresse der Bank, die Postkonto-Nummer der
......
115 114
              angepasst werden.</strong></span> Dabei ist darauf zu achten, dass
116 115
              sich die Positionen der Postkonto-Nummern der Bank, sowie der
117 116
              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
117
              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="d0e2291"></a>2.13.1.5. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer
119 118
          odt-Rechnung (analog bei Auftrag)</h4></div></div></div><p>Im Fussbereich der Rechnungsmaske muss neben Rechnung,
120 119
          OpenDocument/OASIS und Bildschirm die im Adminbereich erstellte
121 120
          Druckerbeschreibung ausgewählt werden, falls diese nicht bereits bei
122 121
          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
122
          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="d0e2296"></a>2.13.1.6. Makroeinstellungen in LibreOffice anpassen</h4></div></div></div><p>Falls beim Öffnen einer von kivitendo erzeugten odt-Rechnung
124 123
          die Meldung kommt, dass Makros aus Sicherheitsgründen nicht
125 124
          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 -&gt; Optionen -&gt; Sicherheit -&gt;
125
          angepasst werden:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Extras → Optionen → Sicherheit →
127 126
              Makrosicherheit</p></li><li class="listitem"><p>Sicherheitslevel auf "Mittel" einstellen (Diese
128 127
              Einstellung muss auf jedem Computer durchgeführt werden, mit dem
129 128
              von kivitendo erzeugte odt-Rechnungen oder Aufträge geöffnet

Auch abrufbar als: Unified diff