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/ch02s12.html
1 1
<html><head>
2 2
      <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
3
   <title>2.12. Drucken mit kivitendo</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="ch02s11.html" title="2.11. E-Mail-Versand aus kivitendo heraus"><link rel="next" href="ch02s13.html" title="2.13. OpenDocument-Vorlagen"></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.12. Drucken mit kivitendo</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s11.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="ch02s13.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.12. Drucken mit kivitendo"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Drucken-mit-kivitendo"></a>2.12. Drucken mit kivitendo</h2></div></div></div><p>Das Drucksystem von kivitendo benutzt von Haus aus LaTeX-Vorlagen.  Um drucken zu können, braucht der Server ein geeignetes
4
      LaTeX System. Am einfachsten ist dazu eine <code class="literal">texlive</code> Installation. Unter debianoiden Betriebssystemen installiert man
5
      die Pakete mit:</p><p>
3
   <title>2.12. Drucken mit kivitendo</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="ch02s11.html" title="2.11. E-Mail-Versand aus kivitendo heraus"><link rel="next" href="ch02s13.html" title="2.13. OpenDocument-Vorlagen"></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.12. Drucken mit kivitendo</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s11.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="ch02s13.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.12. Drucken mit kivitendo"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="Drucken-mit-kivitendo"></a>2.12. Drucken mit kivitendo</h2></div></div></div><p>Das Drucksystem von kivitendo benutzt von Haus aus LaTeX-Vorlagen.
4
      Um drucken zu können, braucht der Server ein geeignetes LaTeX System. Am
5
      einfachsten ist dazu eine <code class="literal">texlive</code> Installation. Unter
6
      debianoiden Betriebssystemen installiert man die Pakete mit:</p><p>
6 7
            </p><pre class="programlisting">apt-get install texlive-base-bin texlive-latex-recommended texlive-fonts-recommended \
7 8
  exlive-latex-extra texlive-lang-german texlive-generic-extra</pre><p>
8 9
         </p><p>Für Fedora benötigen Sie die folgenden Pakete:</p><p>
......
13 14
            </p><pre class="programlisting">zypper install texlive-collection-latex texlive-collection-latexextra \
14 15
  texlive-collection-latexrecommended texlive-collection-langgerman \
15 16
  texlive-collection-langenglish</pre><p>
16
         </p><p>kivitendo bringt drei alternative Vorlagensätze mit:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>RB</p></li><li class="listitem"><p>f-tex</p></li><li class="listitem"><p>rev-odt</p></li></ul></div><p>Der ehemalige Druckvorlagensatz "Standard" wurde mit der Version 3.3 entfernt, da er nicht mehr gepflegt wurde.</p><div class="sect2" title="2.12.1. Vorlagenverzeichnis anlegen"><div class="titlepage"><div><div><h3 class="title"><a name="Vorlagenverzeichnis-anlegen"></a>2.12.1. Vorlagenverzeichnis anlegen</h3></div></div></div><p>Es lässt sich ein initialer Vorlagensatz erstellen. Die LaTeX-System-Abhängigkeiten hierfür kann man prüfen mit:</p><pre class="programlisting">./scripts/installation_check.pl -lv</pre><p>Der Angemeldete Benutzer muss in einer Gruppe sein, die über das
17
              Recht "Konfiguration -&gt; Mandantenverwaltung" verfügt. Siehe auch <a class="xref" href="ch02s09.html#Gruppen-anlegen" title="2.9.4. Gruppen anlegen">Abschnitt&nbsp;2.9.4, „Gruppen anlegen“</a>.
18
        </p><p>Im Userbereich lässt sich unter:
19
        "<span class="guimenu">System</span> -&gt;
20
        <span class="guisubmenu">Mandantenverwaltung</span> -&gt; <span class="guimenuitem">Verschiedenes</span>" die Option
21
        "Neue Druckvorlagen aus Vorlagensatz erstellen" auswählen.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
22
                     <code class="option">Vorlagen auswählen</code>: Wählen Sie hier den Vorlagensatz aus, der kopiert werden soll
23
          (<code class="filename">RB</code>, <code class="filename">f-tex</code> oder <code class="filename">odt-rev</code>.)</p></li><li class="listitem"><p>
24
                     <code class="option">Neuer Name</code>: Der Verzeichnisname für den neuen Vorlagensatz. Dieser kann im Rahmen der üblichen
25
          Bedingungen für Verzeichnisnamen frei gewählt werden.</p></li></ol></div><p>Nach dem Speichern wird das Vorlagenverzeichnis angelegt und ist für den aktuellen Mandanten ausgewählt.
26
           Der gleiche Vorlagensatz kann, wenn er mal angelegt ist, bei mehreren Mandanten verwendet werden.
27
           Eventuell müssen Anpassungen (Logo, Erscheinungsbild, etc) noch vorgenommen werden. Den Ordner findet man im Dateisystem unter
28
           <code class="filename">./templates/[Neuer Name]</code>
29
            </p></div><div class="sect2" title="2.12.2. Der Druckvorlagensatz RB"><div class="titlepage"><div><div><h3 class="title"><a name="Vorlagen-RB"></a>2.12.2. Der Druckvorlagensatz RB</h3></div></div></div><p>Hierbei handelt es sich um einen vollständigen LaTeX Dokumentensatz mit alternativem Design. Die odt oder html-Varianten sind nicht gepflegt.</p><p>Die konzeptionelle Idee der Vorlagen wird <a class="ulink" href="http://www.kivitendo-support.de/vortraege/Lx-Office%20Anwendertreffen%20LaTeX-Druckvorlagen-Teil3-finale.pdf" target="_top">hier</a>
30
          auf Folie 5 bis 10 vorgestellt. Informationen zur Anpassung an die eigenen Firmendaten finden sich in der Datei Readme.tex im Vorlagenverzeichnis.</p><p>Eine kurze Übersicht der Features:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Mehrsprachenfähig, mit Deutscher und Englischer Übersetzung</p></li><li class="listitem"><p>Zentrale Konfigurationsdateien, die für alle Belege benutzt werden, z.B. für Kopf- und Fußzeilen, und Infos wie Bankdaten</p></li><li class="listitem"><p>mehrere vordefinierte Varianten für Logos/Hintergrundbilder</p></li><li class="listitem"><p>Berücksichtigung für Steuerzonen "EU mit USt-ID Nummer" oder "Außerhalb EU"</p></li></ul></div></div><div class="sect2" title="2.12.3. f-tex"><div class="titlepage"><div><div><h3 class="title"><a name="f-tex"></a>2.12.3. f-tex</h3></div></div></div><p>Ein Vorlagensatz, der in wenigen Minuten alle Dokumente zur Verfügung stellt.</p><div class="sect3" title="2.12.3.1. Feature-Übersicht"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-Feature-%C3%9Cbersicht"></a>2.12.3.1. Feature-Übersicht</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Keine Redundanz. Es wird ein- und dieselbe LaTeX-Vorlage für alle briefartigen Dokumente verwendet. Also
31
            Angebot, Rechnung, Proformarechnung, Lieferschein, aber eben nicht für Paketaufkleber etc.</p></li><li class="listitem"><p>Leichte Anpassung an das Firmen-Layout durch Verwendung eines Hintergrund-PDFs. Dieses kann leicht mit dem
32
            eigenen Lieblingsprogramm erstellt werden (Openoffice, Inkscape, Gimp, Adobe*)</p></li><li class="listitem"><p>Hintergrund-PDF umschaltbar auf "nur erste Seite" (Standard) oder "alle Seiten" (Option
33
            "<code class="option">bgPdfFirstPageOnly</code>" in Datei <code class="filename">letter.lco</code>)</p></li><li class="listitem"><p>Hintergrund-PDF für Ausdruck auf bereits bedrucktem Briefpapier abschaltbar. Es wird dann nur bei per E-Mail
34
            versendeten Dokumenten eingebunden (Option "<code class="option">bgPdfEmailOnly</code>" in Datei
35
            <code class="filename">letter.lco</code>).</p></li><li class="listitem"><p>Nutzung der Layout-Funktionen von LaTeX für Seitenumbruch, Wiederholung von Kopfzeilen, Zwischensummen
36
            etc. (danke an Kai-Martin Knaak für die Vorarbeit)</p></li><li class="listitem"><p>Anzeige des Empfängerlandes im Adressfeld nur, wenn es vom Land des eigenen Unternehmens abweicht (also die
37
            Rechnung das Land verlässt).</p></li><li class="listitem"><p>Multisprachfähig leicht um weitere Sprachen zu erweitern, alle Übersetzungen in der Datei
38
            <code class="filename">translatinos.tex</code>.</p></li><li class="listitem"><p>Auflistung von Bruttopreisen für Endverbraucher.</p></li></ul></div></div><div class="sect3" title="2.12.3.2. Die Installation"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-Installation"></a>2.12.3.2. Die Installation</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Vorlagenverzeichnis mit Option f-tex anlegen, siehe: <a class="xref" href="ch02s12.html#Vorlagenverzeichnis-anlegen" title="2.12.1. Vorlagenverzeichnis anlegen">Vorlagenverzeichnis anlegen</a>. Das
39
            Vorlagensystem funktioniert jetzt schon, hat allerdings noch einen Beispiel-Briefkopf.</p></li><li class="listitem"><p>Erstelle eine pdf-Hintergrund Datei und verlinke sie nach <code class="filename">./letter_head.pdf</code>.</p></li><li class="listitem"><p>Editiere den Bereich "<code class="option">settings</code>" in der datei <code class="filename">letter.lco</code>.</p></li></ul></div><p>oder etwas detaillierter:</p><p>
40
            Es wird eine Datei <code class="filename">sample.lco</code> erstellt und diese nach <code class="filename">letter.lco</code> verlinkt.  Eigentlich
41
            ist dies die Datei die für die firmenspezifischen Anpassungen gedacht ist.  Da die Einstiegshürde in LaTeX nicht ganz niedrig
42
            ist, wird in dieser Datei auf ein Hintergrund-PDF verwiesen. Ich empfehle über dieses PDF die persönlichen Layoutanpassungen
43
            vorzunehmen und <code class="filename">sample.lco</code> unverändert zu lassen. Die Anpassung über eine
44
            <code class="filename">*.lco</code>-Datei, die letztlich auf <code class="filename">letter.lco</code> verlinkt ist ist aber auch möglich.
45
          </p><p>
46
            Es wird eine Datei <code class="filename">sample_head.pdf</code> mit ausgeliefert, diese wird nach <code class="filename">letter_head.pdf</code>
47
            verlinkt. Damit gibt es schon mal eine funktionsfähige Vorlage. Schau Dir nach Abschluss der Installation die Datei
48
            <code class="filename">sample_head.pdf</code> an und erstelle ein entsprechendes PDF passend zum Briefkopf Deiner Firma, diese dann im
49
            Template Verzeichniss ablegen und statt <code class="filename">sample_head.pdf</code> nach <code class="filename">letter_head.pdf</code>
50
            verlinken.
51
          </p><p>
52
            Letzlich muss <code class="filename">letter_head.pdf</code> auf das passende Hintergrund-PDF verweisen, welches gewünschten Briefkopf
53
            enthält.
54
          </p><p>
55
            Es wird eine Datei <code class="filename">mydata.tex.example</code> ausgeliefert, die nach <code class="filename">mytdata.tex</code> verlinkt
56
            ist. Bei verwendetem Hintergrund-PDF wird nur der Eintrag für das Land verwendet. Die Datei muss also nicht angefasst
57
            werden. Die anderen Werte sind für das Modul 'lp' (Label Print in erp - zur Zeit nicht im öffentlichen Zweig).
58
          </p><p>
59
            Alle Anpassungen zum Briefkopf, Fusszeilen, Firmenlogos, etc.  sollten über die Hintergrund-PDF-Datei oder die
60
            <code class="filename">*.lco</code>-Datei erfolgen.
61
          </p></div><div class="sect3" title="2.12.3.3. f-tex Funktionsübersicht"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-Funktions%C3%BCbersicht"></a>2.12.3.3. f-tex Funktionsübersicht</h4></div></div></div><p>
62
            Das Konzept von kivitendo sieht vor, für jedes Dokument (Auftragsbestätigung, Lieferschein, Rechnung, etc.) eine LaTeX-Vorlage
63
            vorzuhalten, dies ist sehr wartungsunfreundlich. Auch das Einlesen einer einheitlichen Quelle für den Briefkopf bringt nur
64
            bedingte Vorteile, da hier leicht die Pflege der Artikel-Tabellen aus dem Ruder läuft. Bei dem vorliegenden Ansatz wird für alle
65
            briefartigen Dokumente mit Artikel-Tabellen eine einheitliche LaTeX-Vorlage verwendet, welche über Codeweichen die
66
            Besonderheiten der jeweiligen Dokumente berücksichtigt:
67
          </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Tabellen mit oder ohne Preis</p></li><li class="listitem"><p>Sprache der Tabellenüberschriften etc.</p></li><li class="listitem"><p>Anpassung der Bezugs-Zeile (z.B. Rechnungsnummer versus Angebotsnummer)</p></li><li class="listitem"><p>Darstellung von Brutto oder Netto-Preisen in der Auflistung (Endverbraucher versus gewerblicher
68
            Kunde)</p></li></ul></div><p>Nachteil:</p><p>
69
             LaTeX hat ohnehin eine sehr steile Lehrnkurve. Die Datei <code class="filename">letter.tex</code> ist sehr komplex und verstärkt damit
70
             diesen Effekt noch einmal erheblich.  Wer LaTeX-Erfahrung hat, oder geübt ist Scriptsparachen nachzuvollziehen kann natürlich
71
             auch innerhalb der Tabellendarstellung gut persönliche Anpassungen vornehmen. Aber man kann sich hier bei Veränderungen sehr
72
             schnell heftig in den Fuss schiessen.
73
           </p><p>Wer nicht so tief in die Materie einsteigen will oder leicht zu frustrieren ist, sollte sein Hintergrund-PDF auf Basis der
74
           mitglieferten Datei <code class="filename">sample_head.pdf</code> erstellen, und sich an der Form der dargestellten Tabellen, wie sie
75
           ausgeliefert werden, erfreuen.
76
           </p><p>Kleiner Tipp: Nicht zu viel auf einmal wollen, lieber kleine, kontinuierliche Schritte gehen.</p></div><div class="sect3" title="2.12.3.4. Bruttopreise für Endverbraucher"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-Bruttopreise"></a>2.12.3.4. Bruttopreise für Endverbraucher</h4></div></div></div><p>Der auszuweisende Bruttopreis wird innerhalb der LaTeX-Umgebung berechnet. Es gibt zwar ein Feld, um bei Aufträgen "alle
77
	         Preise Brutto" auszuwählen, aber:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>hierfür müssen die Preise auch in Brutto in der Datenbank stehen (ja - das lässt sich über die Preisgruppen und die
78
              Zuordung einer Default-Preisgruppe handhaben)</p></li><li class="listitem"><p>man darf beim Anlegen des Vorgangs nicht vergessen, dieses Häkchen zu setzen.  (Das ist in der Praxis, wenn man sowohl
79
              Endverbraucher als auch Gewerbekunden beliefert, der eigentliche Knackpunkt)</p></li></ul></div><p>
80
            Es gibt mit f-tex eine weitere Alternative. Die Information ob Brutto oder Nettorechnung wird mit den Zahlarten
81
            verknüpft. Zahlarten bei denen Rechnungen, Angebote, etc, in Brutto ausgegeben werden sollen, enden mit "_E" (für
82
            Endverbraucher). Falls identische Zahlarten für Gewerbekunden und Endverbraucher vorhanden sind, legt man diese einfach doppelt
83
            an (einmal mit der Namensendung "_E"). Gewinn:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Die Entscheidung, ob Nettopreise ausgewiesen werden, ist nicht mehr fix mit einer Preisliste verbunden.</p></li><li class="listitem"><p>Die Default-Zahlart kann im Kundendatensatz hinterlegt werden, und man muss nicht mehr daran denken, "alle Preise
84
            Netto" auszuwählen.</p></li><li class="listitem"><p>Die Entscheidung, ob Netto- oder Bruttopreise ausgewiesen werden, kann direkt beim Drucken revidiert werden,
85
            ohne dass sich der Auftragswert ändert.</p></li></ul></div></div><div class="sect3" title="2.12.3.5. Lieferadressen"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-lieferadressen"></a>2.12.3.5. Lieferadressen</h4></div></div></div><p>In Lieferscheinen kommen <code class="varname">shipto*</code>-Variablen im Adressfeld zum Einsatz. Wenn die
86
          <code class="varname">shipto*</code>-Variable leer ist, wird die entsprechende Adressvariable eingesetzt.  Wenn also die Lieferadresse in
87
          Straße, Hausnummer und Ort abweicht, müssen auch nur diese Felder in der Lieferadresse ausgefüllt werden. Für den Firmenname wird
88
          der Wert der Hauptadresse angezeigt.
89
          </p></div></div><div class="sect2" title="2.12.4. Der Druckvorlagensatz rev-odt"><div class="titlepage"><div><div><h3 class="title"><a name="Vorlagen-rev-odt"></a>2.12.4. Der Druckvorlagensatz rev-odt</h3></div></div></div><p>Hierbei handelt es sich um einen Dokumentensatz der mit odt-Vorlagen erstellt wurde. Es gibt in dem Verzeichnis eine Readme-Datei, die eventuell aktueller als die Dokumentation hier ist.
90
Die odt-Vorlagen in diesem Verzeichnis "rev-odt" wurden von revamp-it, Zürich erstellt
91
und werden laufend aktualisiert. Ein paar der Formulierungen in den Druckvorlagen entsprechen dem Schweizer Sprachgebrauch, z.B. "Offerte" oder "allfällig".
92
        </p><p>
93
Hinweis zum Einsatz des Feldes "Land" bei den Stammdaten für KundInnen und LieferantInnen,
94
sowie bei Lieferadressen:
95
Die in diesem Vorlagensatz vorhandenen Vorlagen erwarten für "Land" das entsprechende
96
Kürzel, das in Adressen vor die Postleitzahl gesetzt wird.
97
Das Feld kann auch komplett leer bleiben.
98
Wer dies anders handhaben möchte, muss die Vorlagen entsprechend anpassen.
99
</p><p>
100
odt-Vorlagen können mit LibreOffice oder OpenOffice editiert
101
und den eigenen Bedürfnissen angepasst werden.
102
Wichtig beim Editieren von if-Blöcken ist, dass immer der gesamte Block
103
überschrieben werden muss und nicht nur Teile davon, da dies sonst oft
104
zu einer odt-Datei führt, die vom Parser nicht korrekt gelesen werden kann.
105
</p><p>
106
Zur Zeit gibt es in kivitendo noch keine Möglichkeit, odt-Vorlagen bei Mahnungen
107
einzusetzen. Entsprechende Vorlagen sind deshalb nicht vorhanden.
108
</p><p>
109
Inwieweit es möglich ist, für die in Version 3.2.0 neu eingeführten Pflichtenhefte
110
odt-Vorlagen zu erstellen, sind wir am abklären.
111
Wenn dies möglich ist, werden wir in Zukunft auch eine odt-Vorlage für Pflichtenhefte
112
in diesem Vorlagensatz zur Verfügung stellen.
113
</p><p>
114
Fehlermeldungen, Anregungen und Wünsche bitte senden an:
115
empfang@revamp-it.ch
116
</p></div><div class="sect2" title="2.12.5. Allgemeine Hinweise zu LaTeX Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="allgemeine-hinweise-zu-latex"></a>2.12.5. Allgemeine Hinweise zu LaTeX Vorlagen</h3></div></div></div><p>In den allermeisten Installationen sollte das Drucken jetzt schon
117
        funktionieren. Sollte ein Fehler auftreten, wirft TeX sehr lange
118
        Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste Zeile,
119
        die mit einem Ausrufezeichen anfängt. Häufig auftretende Fehler sind zum
120
        Beispiel:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>! LaTeX Error: File `eurosym.sty' not found. Die entsprechende
121
            LaTeX-Bibliothek wurde nicht gefunden. Das tritt vor allem bei
122
            Vorlagen aus der Community auf. Installieren Sie die entsprechenden
123
            Pakete.</p></li><li class="listitem"><p>! Package inputenc Error: Unicode char \u8:... set up for
17
         </p><p>kivitendo bringt drei alternative Vorlagensätze mit:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>RB</p></li><li class="listitem"><p>f-tex</p></li><li class="listitem"><p>rev-odt</p></li></ul></div><p>Der ehemalige Druckvorlagensatz "Standard" wurde mit der Version
18
      3.3 entfernt, da er nicht mehr gepflegt wurde.</p><div class="sect2" title="2.12.1. Vorlagenverzeichnis anlegen"><div class="titlepage"><div><div><h3 class="title"><a name="Vorlagenverzeichnis-anlegen"></a>2.12.1. Vorlagenverzeichnis anlegen</h3></div></div></div><p>Es lässt sich ein initialer Vorlagensatz erstellen. Die
19
        LaTeX-System-Abhängigkeiten hierfür kann man prüfen mit:</p><pre class="programlisting">./scripts/installation_check.pl -lv</pre><p>Der Angemeldete Benutzer muss in einer Gruppe sein, die über das
20
        Recht "Konfiguration -&gt; Mandantenverwaltung" verfügt. Siehe auch
21
        <a class="xref" href="ch02s09.html#Gruppen-anlegen" title="2.9.4. Gruppen anlegen">Abschnitt&nbsp;2.9.4, „Gruppen anlegen“</a>.</p><p>Im Userbereich lässt sich unter: "<span class="guimenu">System</span>
22
        -&gt; <span class="guisubmenu">Mandantenverwaltung</span> -&gt;
23
        <span class="guimenuitem">Verschiedenes</span>" die Option "Neue
24
        Druckvorlagen aus Vorlagensatz erstellen" auswählen.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
25
                     <code class="option">Vorlagen auswählen</code>: Wählen Sie hier den
26
            Vorlagensatz aus, der kopiert werden soll
27
            (<code class="filename">RB</code>, <code class="filename">f-tex</code> oder
28
            <code class="filename">odt-rev</code>.)</p></li><li class="listitem"><p>
29
                     <code class="option">Neuer Name</code>: Der Verzeichnisname für den
30
            neuen Vorlagensatz. Dieser kann im Rahmen der üblichen Bedingungen
31
            für Verzeichnisnamen frei gewählt werden.</p></li></ol></div><p>Nach dem Speichern wird das Vorlagenverzeichnis angelegt und ist
32
        für den aktuellen Mandanten ausgewählt. Der gleiche Vorlagensatz kann,
33
        wenn er mal angelegt ist, bei mehreren Mandanten verwendet werden.
34
        Eventuell müssen Anpassungen (Logo, Erscheinungsbild, etc) noch
35
        vorgenommen werden. Den Ordner findet man im Dateisystem unter
36
        <code class="filename">./templates/[Neuer Name]</code>
37
            </p></div><div class="sect2" title="2.12.2. Der Druckvorlagensatz RB"><div class="titlepage"><div><div><h3 class="title"><a name="Vorlagen-RB"></a>2.12.2. Der Druckvorlagensatz RB</h3></div></div></div><p>Hierbei handelt es sich um einen vollständigen LaTeX
38
        Dokumentensatz mit alternativem Design. Die odt oder html-Varianten
39
        sind nicht gepflegt.</p><p>Die konzeptionelle Idee der Vorlagen wird <a class="ulink" href="http://www.kivitendo-support.de/vortraege/Lx-Office%20Anwendertreffen%20LaTeX-Druckvorlagen-Teil3-finale.pdf" target="_top">hier</a>
40
        auf Folie 5 bis 10 vorgestellt. Informationen zur Anpassung an die
41
        eigenen Firmendaten finden sich in der Datei Readme.tex im
42
        Vorlagenverzeichnis.</p><p>Eine kurze Übersicht der Features:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Mehrsprachenfähig, mit Deutscher und Englischer
43
            Übersetzung</p></li><li class="listitem"><p>Zentrale Konfigurationsdateien, die für alle Belege benutzt
44
            werden, z.B. für Kopf- und Fußzeilen, und Infos wie
45
            Bankdaten</p></li><li class="listitem"><p>mehrere vordefinierte Varianten für
46
            Logos/Hintergrundbilder</p></li><li class="listitem"><p>Berücksichtigung für Steuerzonen "EU mit USt-ID Nummer" oder
47
            "Außerhalb EU"</p></li></ul></div></div><div class="sect2" title="2.12.3. f-tex"><div class="titlepage"><div><div><h3 class="title"><a name="f-tex"></a>2.12.3. f-tex</h3></div></div></div><p>Ein Vorlagensatz, der in wenigen Minuten alle Dokumente zur
48
        Verfügung stellt.</p><div class="sect3" title="2.12.3.1. Feature-Übersicht"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-Feature-%C3%9Cbersicht"></a>2.12.3.1. Feature-Übersicht</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Keine Redundanz. Es wird ein- und dieselbe LaTeX-Vorlage
49
              für alle briefartigen Dokumente verwendet. Also Angebot,
50
              Rechnung, Proformarechnung, Lieferschein, aber eben nicht für
51
              Paketaufkleber etc.</p></li><li class="listitem"><p>Leichte Anpassung an das Firmen-Layout durch Verwendung
52
              eines Hintergrund-PDFs. Dieses kann leicht mit dem eigenen
53
              Lieblingsprogramm erstellt werden (Openoffice, Inkscape, Gimp,
54
              Adobe*)</p></li><li class="listitem"><p>Hintergrund-PDF umschaltbar auf "nur erste Seite"
55
              (Standard) oder "alle Seiten" (Option
56
              "<code class="option">bgPdfFirstPageOnly</code>" in Datei
57
              <code class="filename">letter.lco</code>)</p></li><li class="listitem"><p>Hintergrund-PDF für Ausdruck auf bereits bedrucktem
58
              Briefpapier abschaltbar. Es wird dann nur bei per E-Mail
59
              versendeten Dokumenten eingebunden (Option
60
              "<code class="option">bgPdfEmailOnly</code>" in Datei
61
              <code class="filename">letter.lco</code>).</p></li><li class="listitem"><p>Nutzung der Layout-Funktionen von LaTeX für Seitenumbruch,
62
              Wiederholung von Kopfzeilen, Zwischensummen etc. (danke an
63
              Kai-Martin Knaak für die Vorarbeit)</p></li><li class="listitem"><p>Anzeige des Empfängerlandes im Adressfeld nur, wenn es vom
64
              Land des eigenen Unternehmens abweicht (also die Rechnung das
65
              Land verlässt).</p></li><li class="listitem"><p>Multisprachfähig leicht um weitere Sprachen zu erweitern,
66
              alle Übersetzungen in der Datei
67
              <code class="filename">translatinos.tex</code>.</p></li><li class="listitem"><p>Auflistung von Bruttopreisen für Endverbraucher.</p></li></ul></div></div><div class="sect3" title="2.12.3.2. Die Installation"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-Installation"></a>2.12.3.2. Die Installation</h4></div></div></div><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Vorlagenverzeichnis mit Option f-tex anlegen, siehe: <a class="xref" href="ch02s12.html#Vorlagenverzeichnis-anlegen" title="2.12.1. Vorlagenverzeichnis anlegen">Vorlagenverzeichnis anlegen</a>. Das Vorlagensystem
68
              funktioniert jetzt schon, hat allerdings noch einen
69
              Beispiel-Briefkopf.</p></li><li class="listitem"><p>Erstelle eine pdf-Hintergrund Datei und verlinke sie nach
70
              <code class="filename">./letter_head.pdf</code>.</p></li><li class="listitem"><p>Editiere den Bereich "<code class="option">settings</code>" in der
71
              datei <code class="filename">letter.lco</code>.</p></li></ul></div><p>oder etwas detaillierter:</p><p>Es wird eine Datei <code class="filename">sample.lco</code> erstellt
72
          und diese nach <code class="filename">letter.lco</code> verlinkt. Eigentlich
73
          ist dies die Datei die für die firmenspezifischen Anpassungen
74
          gedacht ist. Da die Einstiegshürde in LaTeX nicht ganz niedrig ist,
75
          wird in dieser Datei auf ein Hintergrund-PDF verwiesen. Ich empfehle
76
          über dieses PDF die persönlichen Layoutanpassungen vorzunehmen und
77
          <code class="filename">sample.lco</code> unverändert zu lassen. Die Anpassung
78
          über eine <code class="filename">*.lco</code>-Datei, die letztlich auf
79
          <code class="filename">letter.lco</code> verlinkt ist ist aber auch
80
          möglich.</p><p>Es wird eine Datei <code class="filename">sample_head.pdf</code> mit
81
          ausgeliefert, diese wird nach <code class="filename">letter_head.pdf</code>
82
          verlinkt. Damit gibt es schon mal eine funktionsfähige Vorlage.
83
          Schau Dir nach Abschluss der Installation die Datei
84
          <code class="filename">sample_head.pdf</code> an und erstelle ein
85
          entsprechendes PDF passend zum Briefkopf Deiner Firma, diese dann im
86
          Template Verzeichniss ablegen und statt
87
          <code class="filename">sample_head.pdf</code> nach
88
          <code class="filename">letter_head.pdf</code> verlinken.</p><p>Letzlich muss <code class="filename">letter_head.pdf</code> auf das
89
          passende Hintergrund-PDF verweisen, welches gewünschten Briefkopf
90
          enthält.</p><p>Es wird eine Datei <code class="filename">mydata.tex.example</code>
91
          ausgeliefert, die nach <code class="filename">mytdata.tex</code> verlinkt
92
          ist. Bei verwendetem Hintergrund-PDF wird nur der Eintrag für das
93
          Land verwendet. Die Datei muss also nicht angefasst werden. Die
94
          anderen Werte sind für das Modul 'lp' (Label Print in erp - zur Zeit
95
          nicht im öffentlichen Zweig).</p><p>Alle Anpassungen zum Briefkopf, Fusszeilen, Firmenlogos, etc.
96
          sollten über die Hintergrund-PDF-Datei oder die
97
          <code class="filename">*.lco</code>-Datei erfolgen.</p></div><div class="sect3" title="2.12.3.3. f-tex Funktionsübersicht"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-Funktions%C3%BCbersicht"></a>2.12.3.3. f-tex Funktionsübersicht</h4></div></div></div><p>Das Konzept von kivitendo sieht vor, für jedes Dokument
98
          (Auftragsbestätigung, Lieferschein, Rechnung, etc.) eine
99
          LaTeX-Vorlage vorzuhalten, dies ist sehr wartungsunfreundlich. Auch
100
          das Einlesen einer einheitlichen Quelle für den Briefkopf bringt nur
101
          bedingte Vorteile, da hier leicht die Pflege der Artikel-Tabellen
102
          aus dem Ruder läuft. Bei dem vorliegenden Ansatz wird für alle
103
          briefartigen Dokumente mit Artikel-Tabellen eine einheitliche
104
          LaTeX-Vorlage verwendet, welche über Codeweichen die Besonderheiten
105
          der jeweiligen Dokumente berücksichtigt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Tabellen mit oder ohne Preis</p></li><li class="listitem"><p>Sprache der Tabellenüberschriften etc.</p></li><li class="listitem"><p>Anpassung der Bezugs-Zeile (z.B. Rechnungsnummer versus
106
              Angebotsnummer)</p></li><li class="listitem"><p>Darstellung von Brutto oder Netto-Preisen in der
107
              Auflistung (Endverbraucher versus gewerblicher Kunde)</p></li></ul></div><p>Nachteil:</p><p>LaTeX hat ohnehin eine sehr steile Lehrnkurve. Die Datei
108
          <code class="filename">letter.tex</code> ist sehr komplex und verstärkt damit
109
          diesen Effekt noch einmal erheblich. Wer LaTeX-Erfahrung hat, oder
110
          geübt ist Scriptsparachen nachzuvollziehen kann natürlich auch
111
          innerhalb der Tabellendarstellung gut persönliche Anpassungen
112
          vornehmen. Aber man kann sich hier bei Veränderungen sehr schnell
113
          heftig in den Fuss schiessen.</p><p>Wer nicht so tief in die Materie einsteigen will oder leicht
114
          zu frustrieren ist, sollte sein Hintergrund-PDF auf Basis der
115
          mitglieferten Datei <code class="filename">sample_head.pdf</code> erstellen,
116
          und sich an der Form der dargestellten Tabellen, wie sie
117
          ausgeliefert werden, erfreuen.</p><p>Kleiner Tipp: Nicht zu viel auf einmal wollen, lieber kleine,
118
          kontinuierliche Schritte gehen.</p></div><div class="sect3" title="2.12.3.4. Bruttopreise für Endverbraucher"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-Bruttopreise"></a>2.12.3.4. Bruttopreise für Endverbraucher</h4></div></div></div><p>Der auszuweisende Bruttopreis wird innerhalb der
119
          LaTeX-Umgebung berechnet. Es gibt zwar ein Feld, um bei Aufträgen
120
          "alle Preise Brutto" auszuwählen, aber:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>hierfür müssen die Preise auch in Brutto in der Datenbank
121
              stehen (ja - das lässt sich über die Preisgruppen und die
122
              Zuordung einer Default-Preisgruppe handhaben)</p></li><li class="listitem"><p>man darf beim Anlegen des Vorgangs nicht vergessen, dieses
123
              Häkchen zu setzen. (Das ist in der Praxis, wenn man sowohl
124
              Endverbraucher als auch Gewerbekunden beliefert, der eigentliche
125
              Knackpunkt)</p></li></ul></div><p>Es gibt mit f-tex eine weitere Alternative. Die Information ob
126
          Brutto oder Nettorechnung wird mit den Zahlarten verknüpft.
127
          Zahlarten bei denen Rechnungen, Angebote, etc, in Brutto ausgegeben
128
          werden sollen, enden mit "_E" (für Endverbraucher). Falls identische
129
          Zahlarten für Gewerbekunden und Endverbraucher vorhanden sind, legt
130
          man diese einfach doppelt an (einmal mit der Namensendung "_E").
131
          Gewinn:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>Die Entscheidung, ob Nettopreise ausgewiesen werden, ist
132
              nicht mehr fix mit einer Preisliste verbunden.</p></li><li class="listitem"><p>Die Default-Zahlart kann im Kundendatensatz hinterlegt
133
              werden, und man muss nicht mehr daran denken, "alle Preise
134
              Netto" auszuwählen.</p></li><li class="listitem"><p>Die Entscheidung, ob Netto- oder Bruttopreise ausgewiesen
135
              werden, kann direkt beim Drucken revidiert werden, ohne dass
136
              sich der Auftragswert ändert.</p></li></ul></div></div><div class="sect3" title="2.12.3.5. Lieferadressen"><div class="titlepage"><div><div><h4 class="title"><a name="f-tex-lieferadressen"></a>2.12.3.5. Lieferadressen</h4></div></div></div><p>In Lieferscheinen kommen <code class="varname">shipto*</code>-Variablen
137
          im Adressfeld zum Einsatz. Wenn die
138
          <code class="varname">shipto*</code>-Variable leer ist, wird die entsprechende
139
          Adressvariable eingesetzt. Wenn also die Lieferadresse in Straße,
140
          Hausnummer und Ort abweicht, müssen auch nur diese Felder in der
141
          Lieferadresse ausgefüllt werden. Für den Firmenname wird der Wert
142
          der Hauptadresse angezeigt.</p></div></div><div class="sect2" title="2.12.4. Der Druckvorlagensatz rev-odt"><div class="titlepage"><div><div><h3 class="title"><a name="Vorlagen-rev-odt"></a>2.12.4. Der Druckvorlagensatz rev-odt</h3></div></div></div><p>Hierbei handelt es sich um einen Dokumentensatz der mit
143
        odt-Vorlagen erstellt wurde. Es gibt in dem Verzeichnis eine
144
        Readme-Datei, die eventuell aktueller als die Dokumentation hier ist.
145
        Die odt-Vorlagen in diesem Verzeichnis "rev-odt" wurden von revamp-it,
146
        Zürich erstellt und werden laufend aktualisiert. Ein paar der
147
        Formulierungen in den Druckvorlagen entsprechen dem Schweizer
148
        Sprachgebrauch, z.B. "Offerte" oder "allfällig".</p><p>Hinweis zum Einsatz des Feldes "Land" bei den Stammdaten für
149
        KundInnen und LieferantInnen, sowie bei Lieferadressen: Die in diesem
150
        Vorlagensatz vorhandenen Vorlagen erwarten für "Land" das
151
        entsprechende Kürzel, das in Adressen vor die Postleitzahl gesetzt
152
        wird. Das Feld kann auch komplett leer bleiben. Wer dies anders
153
        handhaben möchte, muss die Vorlagen entsprechend anpassen.</p><p>odt-Vorlagen können mit LibreOffice oder OpenOffice editiert und
154
        den eigenen Bedürfnissen angepasst werden. Wichtig beim Editieren von
155
        if-Blöcken ist, dass immer der gesamte Block überschrieben werden muss
156
        und nicht nur Teile davon, da dies sonst oft zu einer odt-Datei führt,
157
        die vom Parser nicht korrekt gelesen werden kann.</p><p>Zur Zeit gibt es in kivitendo noch keine Möglichkeit,
158
        odt-Vorlagen bei Mahnungen einzusetzen. Entsprechende Vorlagen sind
159
        deshalb nicht vorhanden.</p><p>Inwieweit es möglich ist, für die in Version 3.2.0 neu
160
        eingeführten Pflichtenhefte odt-Vorlagen zu erstellen, sind wir am
161
        abklären. Wenn dies möglich ist, werden wir in Zukunft auch eine
162
        odt-Vorlage für Pflichtenhefte in diesem Vorlagensatz zur Verfügung
163
        stellen.</p><p>Fehlermeldungen, Anregungen und Wünsche bitte senden an:
164
        empfang@revamp-it.ch</p></div><div class="sect2" title="2.12.5. Allgemeine Hinweise zu LaTeX Vorlagen"><div class="titlepage"><div><div><h3 class="title"><a name="allgemeine-hinweise-zu-latex"></a>2.12.5. Allgemeine Hinweise zu LaTeX Vorlagen</h3></div></div></div><p>In den allermeisten Installationen sollte das Drucken jetzt
165
        schon funktionieren. Sollte ein Fehler auftreten, wirft TeX sehr lange
166
        Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste
167
        Zeile, die mit einem Ausrufezeichen anfängt. Häufig auftretende Fehler
168
        sind zum Beispiel:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>! LaTeX Error: File `eurosym.sty' not found. Die
169
            entsprechende LaTeX-Bibliothek wurde nicht gefunden. Das tritt vor
170
            allem bei Vorlagen aus der Community auf. Installieren Sie die
171
            entsprechenden Pakete.</p></li><li class="listitem"><p>! Package inputenc Error: Unicode char \u8:... set up for
124 172
            use with LaTeX. Dieser Fehler tritt auf, wenn sie versuchen mit
125 173
            einer Standardinstallation exotische utf8 Zeichen zu drucken.
126 174
            TeXLive unterstützt von Haus nur romanische Schriften und muss mit
127
            diversen Tricks dazu gebracht werden andere Zeichen zu akzeptieren.
128
            Adere TeX Systeme wie XeTeX schaffen hier Abhilfe.</p></li></ul></div><p>Wird gar kein Fehler angezeigt, sondern nur der Name des Templates,
129
        heißt das normalerweise, dass das LaTeX Binary nicht gefunden wurde.
130
        Prüfen Sie den Namen in der Konfiguration (Standard:
175
            diversen Tricks dazu gebracht werden andere Zeichen zu
176
            akzeptieren. Adere TeX Systeme wie XeTeX schaffen hier
177
            Abhilfe.</p></li></ul></div><p>Wird gar kein Fehler angezeigt, sondern nur der Name des
178
        Templates, heißt das normalerweise, dass das LaTeX Binary nicht
179
        gefunden wurde. Prüfen Sie den Namen in der Konfiguration (Standard:
131 180
        <code class="literal">pdflatex</code>), und stellen Sie sicher, dass pdflatex
132 181
        (oder das von Ihnen verwendete System) vom Webserver ausgeführt werden
133
        darf.</p><p>Wenn sich das Problem nicht auf Grund der Ausgabe im Webbrowser verifizieren lässt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> editiere [kivitendo-home]/config/kivitendo.conf und ändere "keep_temp_files" auf 1</p><p>
182
        darf.</p><p>Wenn sich das Problem nicht auf Grund der Ausgabe im Webbrowser
183
        verifizieren lässt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>editiere [kivitendo-home]/config/kivitendo.conf und ändere
184
            "keep_temp_files" auf 1</p><p>
134 185
                     </p><pre class="programlisting">keep_temp_files = 1;</pre><p>
135 186
                  </p></li><li class="listitem"><p>bei fastcgi oder mod_perl den Webserver neu Starten</p></li><li class="listitem"><p>Nochmal einen Druckversuch im Webfrontend auslösen</p></li><li class="listitem"><p>wechsel in das users Verzeichnis von kivitendo</p><p>
136 187
                     </p><pre class="programlisting">cd [kivitendo-home]/users</pre><p>
137 188
                  </p></li><li class="listitem"><p>LaTeX Suchpfad anpassen:</p><p>
138 189
                     </p><pre class="programlisting">export TEXINPUTS=".:[kivitendo-home]/templates/[aktuelles_template_verzeichniss]:"</pre><p>
139
                  </p></li><li class="listitem"><p>Finde heraus,  welche Datei kivitendo beim letzten Durchlauf erstellt hat</p><p>
190
                  </p></li><li class="listitem"><p>Finde heraus, welche Datei kivitendo beim letzten Durchlauf
191
            erstellt hat</p><p>
140 192
                     </p><pre class="programlisting">ls -lahtr ./1*.tex</pre><p>
141
                  </p><p>Es sollte die letzte Datei ganz unten sein</p></li><li class="listitem"><p>für besseren Hinweis auf Fehler texdatei nochmals übersetzen</p><p>
193
                  </p><p>Es sollte die letzte Datei ganz unten sein</p></li><li class="listitem"><p>für besseren Hinweis auf Fehler texdatei nochmals
194
            übersetzen</p><p>
142 195
                     </p><pre class="programlisting">pdflatex ./1*.tex</pre><p>
143 196
                  </p><p>in der *.tex datei nach dem Fehler suchen.</p></li></ul></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s11.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="ch02s13.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.11. E-Mail-Versand aus kivitendo heraus&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.13. OpenDocument-Vorlagen</td></tr></table></div></body></html>

Auch abrufbar als: Unified diff