Dokumentation zum Makroeinsatz in OpenDocument Vorlagen mit Anleitung zur Konfigurati...
[kivitendo-erp.git] / doc / html / ch02s13.html
index 236dbaa..276e3af 100644 (file)
       reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
       werden muss. Der Nachteil ist, dass diese Methode Python und die
       Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2
-      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 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 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
+      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
+        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 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 OpenOffice neu gestartet und die Konvertierung
       mit Hilfe eines Makros durchgeführt. Dieses Makro muss in der
       Dokumentenvorlage enthalten sein und
       users/.openoffice</code>
          </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><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>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s14.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.12. Drucken mit kivitendo&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.14. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:
+      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="d0e2131"></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="d0e2144"></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="d0e2149"></a>2.13.1.2. Vorbereitungen im Adminbereich</h4></div></div></div><p>Damit beim Erstellen von Rechnungen und Aufträgen neben der
+          Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit
+          Einzahlungsschein) auswählbar sind, muss für jedes Vorlagen-Suffix
+          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
+              der Auftrags- bzw. Rechnungsmaske als Auswahl angezeigt (z.B.
+              mit Einzahlungsschein Bank xy)</p></li><li class="listitem"><p>Druckbefehl -&gt; beliebiger Text (hat für das Erzeugen
+              von Aufträgen oder Rechnungen als odt-Datei keine Bedeutung,
+              darf aber nicht leer sein)</p></li><li class="listitem"><p>Vorlagenkürzel -&gt; besr bzw. selbst gewähltes
+              Vorlagensuffix (muss genau der Zeichenfolge entsprechen, die
+              zwischen "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="d0e2173"></a>2.13.1.3. Benutzereinstellungen</h4></div></div></div><p>Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung
+          im Rechnungs- bzw. Auftragsformular angezeigt haben möchte, kann
+          dies persönlich für sich bei den Benutzereinstellungen
+          konfigurieren:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Programm -&gt; Benutzereinstellungen -&gt;
+              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
+              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
+          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></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="d0e2258"></a>2.13.1.5. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer
+          odt-Rechnung (analog bei Auftrag)</h4></div></div></div><p>Im Fussbereich der Rechnungsmaske muss neben Rechnung,
+          OpenDocument/OASIS und Bildschirm die im Adminbereich erstellte
+          Druckerbeschreibung ausgewählt werden, falls diese nicht bereits bei
+          den Benutzereinstellungen als persönlicher Standard gewählt
+          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
+          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 -&gt; Optionen -&gt; Sicherheit -&gt;
+              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><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>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s14.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.12. Drucken mit kivitendo&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.14. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:
       EUR</td></tr></table></div></body></html>
\ No newline at end of file