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.1: 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> </td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right"> <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>
7 </p><pre class="programlisting">apt-get install texlive-base-bin texlive-latex-recommended texlive-fonts-recommended \
8 exlive-latex-extra texlive-lang-german texlive-generic-extra</pre><p>
9 </p><p>Für Fedora benötigen Sie die folgenden Pakete:</p><p>
10 </p><pre class="programlisting">dnf install texlive-collection-latex texlive-collection-latexextra \
11 texlive-collection-latexrecommended texlive-collection-langgerman \
12 texlive-collection-langenglish</pre><p>
13 </p><p>Für openSUSE benötigen Sie die folgenden Pakete:</p><p>
14 </p><pre class="programlisting">zypper install texlive-collection-latex texlive-collection-latexextra \
15 texlive-collection-latexrecommended texlive-collection-langgerman \
16 texlive-collection-langenglish</pre><p>
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 -> Mandantenverwaltung" verfügt. Siehe auch
21 <a class="xref" href="ch02s09.html#Gruppen-anlegen" title="2.9.4. Gruppen anlegen">Abschnitt 2.9.4, „Gruppen anlegen“</a>.</p><p>Im Userbereich lässt sich unter: "<span class="guimenu">System</span>
22 -> <span class="guisubmenu">Mandantenverwaltung</span> ->
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, Briefen und Pflichtenheften einzusetzen.
159 Entsprechende Vorlagen sind deshalb nicht vorhanden.</p><p>Fehlermeldungen, Anregungen und Wünsche bitte senden an:
160 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
161 schon funktionieren. Sollte ein Fehler auftreten, wirft TeX sehr lange
162 Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste
163 Zeile, die mit einem Ausrufezeichen anfängt. Häufig auftretende Fehler
164 sind zum Beispiel:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>! LaTeX Error: File `eurosym.sty' not found. Die
165 entsprechende LaTeX-Bibliothek wurde nicht gefunden. Das tritt vor
166 allem bei Vorlagen aus der Community auf. Installieren Sie die
167 entsprechenden Pakete.</p></li><li class="listitem"><p>! Package inputenc Error: Unicode char \u8:... set up for
168 use with LaTeX. Dieser Fehler tritt auf, wenn sie versuchen mit
169 einer Standardinstallation exotische utf8 Zeichen zu drucken.
170 TeXLive unterstützt von Haus nur romanische Schriften und muss mit
171 diversen Tricks dazu gebracht werden andere Zeichen zu
172 akzeptieren. Adere TeX Systeme wie XeTeX schaffen hier
173 Abhilfe.</p></li></ul></div><p>Wird gar kein Fehler angezeigt, sondern nur der Name des
174 Templates, heißt das normalerweise, dass das LaTeX Binary nicht
175 gefunden wurde. Prüfen Sie den Namen in der Konfiguration (Standard:
176 <code class="literal">pdflatex</code>), und stellen Sie sicher, dass pdflatex
177 (oder das von Ihnen verwendete System) vom Webserver ausgeführt werden
178 darf.</p><p>Wenn sich das Problem nicht auf Grund der Ausgabe im Webbrowser
179 verifizieren lässt:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>editiere [kivitendo-home]/config/kivitendo.conf und ändere
180 "keep_temp_files" auf 1</p><p>
181 </p><pre class="programlisting">keep_temp_files = 1;</pre><p>
182 </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>
183 </p><pre class="programlisting">cd [kivitendo-home]/users</pre><p>
184 </p></li><li class="listitem"><p>LaTeX Suchpfad anpassen:</p><p>
185 </p><pre class="programlisting">export TEXINPUTS=".:[kivitendo-home]/templates/[aktuelles_template_verzeichniss]:"</pre><p>
186 </p></li><li class="listitem"><p>Finde heraus, welche Datei kivitendo beim letzten Durchlauf
188 </p><pre class="programlisting">ls -lahtr ./1*.tex</pre><p>
189 </p><p>Es sollte die letzte Datei ganz unten sein</p></li><li class="listitem"><p>für besseren Hinweis auf Fehler texdatei nochmals
191 </p><pre class="programlisting">pdflatex ./1*.tex</pre><p>
192 </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> </td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right"> <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 </td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top"> 2.13. OpenDocument-Vorlagen</td></tr></table></div></body></html>
projects / kivitendo-erp.git / blob