Projekt

Allgemein

Profil

« Zurück | Weiter » 

Revision 0e14ae06

Von Andreas Zenklusen vor mehr als 8 Jahren hinzugefügt

  • ID 0e14ae06e360e5560c691ddfc66068de3c0ed8f8
  • Vorgänger 450d6798
  • Nachfolger edceffec

Dokumentation zum Makroeinsatz in OpenDocument Vorlagen mit Anleitung zur Konfiguration für den Druck von CH-Einzahlungsscheinen

Unterschiede anzeigen:

doc/html/ch02s13.html
28 28
      reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
29 29
      werden muss. Der Nachteil ist, dass diese Methode Python und die
30 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>
32
          Für die Verbindung zu OpenOffice wird normalerweise der Python-Interpreter <code class="filename">/usr/bin/python</code> benutzt. Sollte
33
          dies nicht der richtige sein, so kann man mit zwei Konfigurationsvariablen entscheiden, welcher Python-Interpreter genutzt
34
          wird. Mit der Option <code class="literal">python_uno</code> aus dem Abschnitt <code class="literal">applications</code> wird der Interpreter selber
35
          festgelegt; sie steht standardmäßig auf dem eben erwähnten Wert <code class="literal">/usr/bin/python</code>.
36
        </p><p>
37
          Zusätzlich ist es möglich, Pfade anzugeben, in denen Python neben seinen normalen Suchpfaden ebenfalls nach Modulen gesucht wird,
38
          z.B. falls sich diese in einem gesonderten OpenOffice-Verzeichnis befinden. Diese zweite Variable heißt
39
          <code class="literal">python_uno_path</code> und befindet sich im Abschnitt <code class="literal">environment</code>. Sie ist standardmäßig
40
          leer. Werden hier mehrere Pfade angegeben, so müssen diese durch Doppelpunkte voneinander getrennt werden. Der Inhalt wird an den
41
          Python-Interpreter über die Umgebungsvariable <code class="literal">PYTHONPATH</code> übergeben.
42
        </p></td></tr></table></div><p>Ist <code class="literal">$openofficeorg_daemon</code> nicht gesetzt, so
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
43 48
      wird für jedes Dokument OpenOffice neu gestartet und die Konvertierung
44 49
      mit Hilfe eines Makros durchgeführt. Dieses Makro muss in der
45 50
      Dokumentenvorlage enthalten sein und
......
58 63
      users/.openoffice</code>
59 64
         </p><p>Dieses Verzeichnis, wie auch das komplette
60 65
      <code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar
61
      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
62
      erneut überprüft werden, wenn die Konvertierung nach PDF
63
      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:
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 -&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
78
              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
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 -&gt; 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 -&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
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: &lt;%customernumber%&gt;
101
                          (Kundennummer: nur Ziffern, maximal 6)</p></li><li class="listitem"><p>dritter Wert: &lt;%ordnumber%&gt;
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: &lt;%invnumber%&gt;
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: &lt;%total%&gt; 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 -&gt; Optionen -&gt; Sicherheit -&gt;
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.
132
              </p><p>
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>&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:
64 138
      EUR</td></tr></table></div></body></html>

Auch abrufbar als: Unified diff