2.10. Drucken mit kivitendo

2.10. Drucken mit kivitendo
ZurÃ¼ck	Kapitel 2. Installation und Grundkonfiguration	Weiter

Das Drucksystem von kivitendo benutzt von Haus aus LaTeX Vorlagen. Um drucken zu kÃ¶nnen, braucht der Server ein geeignetes LaTeX System. Am einfachsten ist dazu eine texlive Installation. Unter - Debianoiden Betriebssystemen sind das die Pakete:

- texlive-latex-base texlive-latex-extra - texlive-fonts-recommended -

Diese hinteren beiden enthalten Bibliotheken und Schriftarten die - von den Standardvorlagen verwendet werden.

TODO: rpm Pakete.

In den allermeisten Installationen sollte drucken jetzt schon - funktionieren. Sollte ein Fehler auftreten wirft TeX sehr lange - Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste Zeite - die mit einem Ausrufezeichen anfÃ¤ngt. HÃ¤ufig auftretende Fehler sind zum - Beispiel:

! LaTeX Error: File `eurosym.sty' not found. Die entsprechende - LaTeX-Bibliothek wurde nicht gefunden. Das tritt vor allem bei - Vorlagen aus der Community auf. Installieren Sie die entsprechenden - Pakete.
! Package inputenc Error: Unicode char \u8:Ã¦Â¡Â not set up for - use with LaTeX. Dieser Fehler tritt auf, wenn sie versuchen mit - einer Standardinstallation exotische utf8 Zeichen zu drucken. - TeXLive unterstÃ¼tzt von Haus nur romanische Schriften und muss mit - diversen Tricks dazu gebracht werden andere Zeichen zu akzeptieren. - Adere TeX Systeme wie XeTeX schaffen hier Abhilfe.

Wird garkein Fehler angezeigt sondern nur der Name des Templates, - heiÃt das normalerweise, dass das LaTeX Binary nicht gefunden wurde. - PrÃ¼fen Sie den Namen in der Konfiguration (Standard: - pdflatex), und stellen Sie sicher, dass pdflatex - (oder das von Ihnen verwendete System) vom Webserver ausgefÃ¼hrt werden - darf.

2.10.1. Vorlagenverzeichnis anlegen

Bei einem neuen Benutzer/Mandanten lÃ¤sst sich einer dieser VorlagensÃ¤tze + als Basis fÃ¼r die zu druckenden Dokumente auswÃ¤hlen:

unter:
+Administration -> Benutzerverwaltung -> [ein Benutzer]
+   Erzeuge Vorlagen, Name: [Name fÃ¼r das neue Vorlagenverzeichnis]
+   Vorlagen auswÃ¤hlen: [Default, f-tex oder RB]
+   -> Speichern
+

der gleiche Vorlagensatz kann, wenn er mal angelegt ist, bei mehreren Benutzern verwendet werden.

Die AbhÃ¤ngigkeiten kann man prÃ¼fen mit:

/scripts/installation_check.pl -l

2.10.2. Default

Der standard Vorlagensatz von Kivitendo. Wie unter + http://demo.kivitendo.org zu sehen.

2.10.3. f-tex

Ein Vorlagensatz, der in Wenigen Minuten alle Dokumente zur stellt.

2.10.3.1. f-tex Feature Ãbersicht

Keine Retundanz. Es wird ein und die selbe Latex-Vorlage fÃ¼r alle + briefartigen Dokumente verwendet. Also Angebot, Rechnung, + Performarechnung, Lieferschein, aber eben nicht fÃ¼r Paketaufkleber + etc..
Leichte Anpassung an das Firmen Layout durch verwendung eines Hintergrund-PDF + dieses kann leicht mit dem eigenen Lieblingsprogramm erstellt werden + (Openoffice, Inkscape, Gimp, Adobe*) +
Hintergrundpdf um schaltbar auf "nur erste Seite" (default) oder "alle Seiten" + (option "bgPdfFirstPageOnly" in Datei letter.lco) +
Hintergrundpdf fÃ¼r Ausdruck auf bereits bedrucktem Briefpapier Abschaltbar, + es wird dann nur bei per email versendeten Dokumenten eingebunden. + (Option "bgPdfEmailOnly" in Datei letter.lco) +
Nutzung der Layout-Funktionen von Latex fÃ¼r Seitenumbruch, + wiederholung von Kopfzeilen, Zwischensummen etc. (danke an Kai-Martin fÃ¼r + die Vorarbeit) +
Anzeige des EmpfÃ¤ngerlandes im Adressfeld nur, wenn es vom Land des + eigenen Unternehmens abweicht (also die Rechnung das Land verlÃ¤sst). +
MultisprachfÃ¤hig leicht um weitere Sprachen zu erweitern, alle + Ãbersetzungen in der Datei translatinos.tex. +
Auflistung von Bruttopreisen fÃ¼r Endverbraucher. +

2.10.3.2. f-tex Die Installation

Vorlagenverzeichnis mit Option f-tex anlegen, siehe: + Vorlagenverzeichnis anlegen + Das Vorlagensystem funktioniert jetzt schon, hat allerdings noch einen + Beispiel Briefkopf +
+ Erstelle eine pdf-Hintergrund Datei und verlinke sie nach +
```
./letter_head.pdf
```
+ Editiere den Bereich "settings" in der datei letter.lco +

oder etwas Detaillierter:

+ Es wird eine Datei sample.lco erstellt und diese nach letter.lco verlinkt. + Eigentlich ist dies die Datei die fÃ¼r die Firmenspezifischen Anpassungen + gedacht ist. Da die EinstiegshÃ¼rde in LaTeX nicht ganz niedrig ist, wird in + dieser Datei auf ein Hintergrundpdf verwiesen. Ich empfehle Ã¼ber dieses pdf + die persÃ¶nlichen Layoutanpassungen vorzunehmen und sample.lco unverÃ¤ndert zu + lassen. Die die Anpassung Ã¼ber eine *.lco Datei die letztlich auf letter.lco + verlinkt ist ist aber auch mÃ¶glich. +

+ Es wird eine Datei sample_head.pdf mit ausgeliefert, diese wird nach + letter_head.pdf verlinkt. Damit gibt es schon mal eine FunktionsfÃ¤hige + Vorlage. Schau Dir nach Abschluss der Installation die Datei sample_haed.pdf + an und erstelle ein entsprechendes pdf passend zum Briefkopf Deiner Firma, + diese dann im Template Verzeichniss ablegen und statt sample_head.pdf nach + letter_head.pdf verlinken. +

+ letzlich muss ./letter_head.pdf auf das passende Hintergrundpdf verweisen, + welches gewÃ¼nschten Briefkopf enthÃ¤lt. Bei Updates oder nach erneutem +

+ Es wird eine Datei mydata.tex.example ausgeliefert die nach mytdata.tex + verlinkt ist. Bei verwendetem Hintergrundpdf wird nur der Eintrag fÃ¼r das + Land verwendet die Datei muss also nicht angefasst werden. Die Anderen Werte + sind fÃ¼r das Modul lp (Label Print in erp - zur Zeit nicht im + Ã¶ffentlichen Zweig). +

+ Alle Anpassungen zum Briefkopf, Fusszeilen, Firmenlogos, etc. + sollten Ã¼ber die Hintergrund pdf datei oder die *.lco Datei erfolgen. +

2.10.3.3. f-tex FunktionsÃ¼bersicht

+ Das Konzept von kivitendo sieht vor, fÃ¼r jedes Dokument + (AuftragsbestÃ¤tigung, Lieferschein, Rechnung, etc.) eine + Latex-Vorlage vorzuhalten, dies ist sehr Wartungsunfreundlich. Auch + das Einlesen einer einheitlichen Quelle fÃ¼r den Briefkopf bringt nur + bedingte Vorteile, da hier leicht die Pflege der Artikel-Tabellen aus + dem Ruder lÃ¤uft. Bei dem vorliegenden Ansatz wird fÃ¼r alle + Briefartigen Dokumente mit Artikel-Tabellen eine einheitliche + Latexvorlage verwendet, welche Ã¼ber Codeweichen die Besonderheiten + der jeweiligen Dokumente BerÃ¼cksichtigt +

Tabellen mit oder ohne Preis +
Sprache der TabellenÃ¼berschriften etc. +
Anpassung der Bezugs-Zeile (z.B. Rechnungsnummer versus + Angebotsnummer) +
Darstellung von Brutto oder Netto-Preisen in der Auflistung + (Endverbraucher versus Gewerblicher Kunde) +

Nachteil:

+ Latex hat ohnehin eine sehr steile Lehrnkurve. Die Datei letter.tex + ist sehr komplex und verstÃ¤rkt damit diesen Effekt noch einmal erheblich. + Wer Latex-Erfahrung hat, oder geÃ¼bt ist Scriptsparachen nachzuvollziehen kann + natÃ¼rlich auch innerhalb der Tabellendarstellung gut persÃ¶nliche Anpassungen + vornehmen. Aber man kann sich hier bei VerÃ¤nderungen sehr schnell hÃ¤ftig in + den Fuss schiessen. +

Wer nicht so tief in die Materie einsteigen will oder leicht zu + frustrieren ist, sollte sein Hintergrund PDF auf Basis der mitglieferten + Datei sample_head.pdf erstellen, und sich an der Form der dargestellten Tabellen + wie sie ausgeliefert werden, erfreuen. +

Kleiner Tipp: + Nicht zu viel auf einmal wollen, lieber kleine kontinuierliche + Schritte gehen. +

Bruttopreise fÃ¼r Endvorbraucher

Der auszuweisende Bruttopreis wird innerhalb der LaTeX + Umgebung berechnet. es gibt zwar ein Feld um bei AuftrÃ¤gen "alle Preise + Brutto" auszuwÃ¤hlen, aber:

+ hierfÃ¼r mÃ¼ssen die Preise auch in Brutto in der Datenbank stehen + (ja - das lÃ¤sst sich Ã¼ber die Preisgruppen und die Zuordung einer Default-Preisgruppe + handhaben) +
+ man darf beim Anlegen des Vorgangs nicht vergessen Dieses HÃ¤kchen zu setzen. + (das ist in der Praxis wenn man sowohl Endverbraucher- wie Gewerbekunden beliefert + der eigentliche Knackpunkt) +

+ Es gibt mit f-tex eine weitere Alternative. Die Information ob Brutto oder + Nettorechnung wird mit den Zahlarten verknÃ¼pft. Zahlarten bei denen + Rechnungen, Angebote, etc, in Brutto ausgegeben werden sollen enden mit "_E" + (fÃ¼r Endverbraucher) Falls identische Zahlarten fÃ¼r Gewerbekunden und + Endverbraucher vorhanden sind legt man diese einfach doppelt an (einmal mit + der Namensendung "_E"). Gewinn:

+ die Entscheidung ob Netopreise ausgewiesen werden ist nicht mehr fix + mit einer Preisliste Verbunden. +
+ die Default-Zahlart kann im Kundendatensatz hinterlegt werden und man + muss nicht mehr daran denken "alle Preise Netto" auszuwÃ¤hlen. +
+ Die Entscheidung ob Netto/Oder Bruttopreise ausgewiesen werden kann direkt + beim Drucken reviediert werden, ohne dass sich der Auftragswert Ã¤ndert. +

Lieferadressen

+ in Lieferscheinen kommen shipto* -Variablen im Adressfeld zum Einsatz +
+ wenn die shipto*variable leer ist wird die entsprechende + Adressvariable eingesetzt. Wenn Also die Lieferadresse in Strasse, + Hausnummer und Ort abweicht, mÃ¼ssen auch nur diese Felder in der + Lieferadresse ausgefÃ¼llt werden. FÃ¼r den Firmenname wird der Wert der + Hauptadresse angezeigt. +

2.10.4. RB

VollstÃ¤ndiger Dokumentensatz mit alternativen Design

2.10.5. Allgemeine Hinweise zu LaTeX Vorlagen

In den allermeisten Installationen sollte drucken jetzt schon + funktionieren. Sollte ein Fehler auftreten wirft TeX sehr lange + Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste Zeite + die mit einem Ausrufezeichen anfÃ¤ngt. HÃ¤ufig auftretende Fehler sind zum + Beispiel:

! LaTeX Error: File `eurosym.sty' not found. Die entsprechende + LaTeX-Bibliothek wurde nicht gefunden. Das tritt vor allem bei + Vorlagen aus der Community auf. Installieren Sie die entsprechenden + Pakete.
! Package inputenc Error: Unicode char \u8:Ã¦Â¡Â not set up for + use with LaTeX. Dieser Fehler tritt auf, wenn sie versuchen mit + einer Standardinstallation exotische utf8 Zeichen zu drucken. + TeXLive unterstÃ¼tzt von Haus nur romanische Schriften und muss mit + diversen Tricks dazu gebracht werden andere Zeichen zu akzeptieren. + Adere TeX Systeme wie XeTeX schaffen hier Abhilfe.

Wird garkein Fehler angezeigt sondern nur der Name des Templates, + heiÃt das normalerweise, dass das LaTeX Binary nicht gefunden wurde. + PrÃ¼fen Sie den Namen in der Konfiguration (Standard: + pdflatex), und stellen Sie sicher, dass pdflatex + (oder das von Ihnen verwendete System) vom Webserver ausgefÃ¼hrt werden + darf.

Wenn sich das Problem nicht auf Grund der ausgabe im Webbrowser verifizieren lÃ¤sst:

editiere [kivitendo-home]/config/kivitendo.conf und Ã¤ndere "keep_tmp_files" auf 1
+
```
keep_temp_files = 1;
```
+
bei fastcgi oder mod_perl den Webserver neu Starten
Nochmal einen Druckversuch im Webfrontend auslÃ¶sen
wechsele in das users Verzeichnis von kivitendo
+
```
cd [kivitendo-home]/users
```
+

LaTeX Suchpfad anpassen:

export TEXINPUTS=".:[kivitendo-home]/templates/[aktuelles_template_verzeichniss]:"

Finde herraus welche Datei kivitendo beim letzten Durchlauf erstellt hat
+
```
ls -lahtr ./1*.tex
```
+
Es sollte die letzte Datei ganz unten sein
fÃ¼r besseren Hinweis auf Fehler texdatei nochmals Ã¼bersetzen
+
```
pdflatex ./1*.tex
```
+
in der *.tex datei nach dem Fehler suchen.

ZurÃ¼ck	Nach oben	Weiter
2.9. E-Mail-Versand aus kivitendo heraus	Zum Anfang	2.11. OpenDocument-Vorlagen

ZurÃ¼ck	Nach oben	Weiter
2.9. E-Mail-Versand aus kivitendo heraus	Zum Anfang	2.11. OpenDocument-Vorlagen