X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentation.xml;h=e7547b153bb37f5773b16fca04ebf1cb34e7805b;hb=bf32f143e97443f074c37772a052b861ad3492ff;hp=4208d8471f46030e8b79d9c89131ffb36a5f0b16;hpb=872f04a75528d55c3987c09fa0445451c35c6ef9;p=kivitendo-erp.git
diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml
index 4208d8471..e7547b153 100644
--- a/doc/dokumentation.xml
+++ b/doc/dokumentation.xml
@@ -14,11 +14,6 @@
im kivitendo-Forum: https://forum.kivitendo.org/
-
-
- im alten Lx-Office-Wiki unter Dokumentation (http://wiki.lx-office.org/index.php?title=Installation_Lx-Office_ERP)
-
@@ -42,12 +37,21 @@
dass kivitendo auf ihnen läuft:
+
- Ubuntu 10.04 LTS Lucid Lynx bis 12.10 Oneiric Ocelot
+ Debian
+
+
+ 6.0 Squeeze (hier muss allerdings das Modul FCGI in der Version >= 0.72 compiled werden)
+
+
+ 7.0 Wheezy
+
+
- Debian 5.0 Lenny und 6.0 Squeeze
+ Ubuntu 10.04 LTS Lucid Lynx bis 12.10 Oneiric Ocelot
@@ -363,7 +367,7 @@ dbcharset = UTF-8
eingreifen
Dieses kann überprüft werden: ist das Encoding der Datenbank
- âtemplate1â âUTF8â, so braucht man nichts weiteres diesbezueglich
+ âtemplate1â âUTF8â, so braucht man nichts weiteres diesbezüglich
unternehmen. Zum Testen:
su postgres
@@ -438,6 +442,9 @@ psql template1
anlegen. Ein Beispiel, wie Sie einen neuen Benutzer anlegen
können:
+ Die Frage, ob der neue User Superuser sein soll, können Sie mit nein
+ beantworten, genauso ist die Berechtigung neue User (Roles) zu
+ generieren nicht nötig.su - postgres
createuser -d -P kivitendo
exit
@@ -558,7 +565,7 @@ Alias /kivitendo-erp/ /var/www/kiviteno-erp/
bestimmte Eingaben von kivitendo. Falls es Probleme mit Umlauten in Ihrere Installation gibt, muss zwingend Version 0.68 oder
aber Version 0.72 und neuer eingesetzt werden.
- Mit CPAN lässt sie sich die Vorgängerversion wie folgt
+ Mit CPAN lässt sie sich die Vorgängerversion wie folgt
installieren:force install M/MS/MSTROUT/FCGI-0.68.tar.gz
@@ -1305,49 +1312,279 @@ insserv kivitendo-task-server
Drucken mit kivitendo
- 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:
+ 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 installiert man
+ die Pakete mit:
- texlive-latex-base texlive-latex-extra
- texlive-fonts-recommended
+ aptitude install texlive-base-bin texlive-latex-recommended texlive-fonts-recommended \
+ texlive-latex-extra texlive-lang-german texlive-generic-extra
- Diese hinteren beiden enthalten Bibliotheken und Schriftarten die
- von den Standardvorlagen verwendet werden.
+ TODO: RPM-Pakete.
- TODO: rpm Pakete.
+ kivitendo bringt drei alternative Vorlagensätze mit:
+
+ Standard
+ f-tex
+ RB
+
- 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:
+
+ Vorlagenverzeichnis anlegen
+ Im Administrationsbereich lässt sich bei einem Benutzer/Mandanten einer dieser Vorlagensätze als Basis für die zu
+ druckenden Dokumente auswählen. Rufen Sie dazu die Benutzerverwaltung auf.
-
-
- ! 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.
-
+ Wählen Sie dort einen Benutzer aus oder legen Sie einen neuen an. In der Benutzerbearbeiten-Maske müssen Sie zwei Dinge
+ angeben:
-
- ! 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.
-
-
+
+ : Der Verzeichnisname für den neuen Vorlagensatz. Dieser kann im Rahmen der üblichen
+ Bedingungen für Verzeichnisnamen frei gewählt werden.
+ : Wählen Sie hier den Vorlagensatz aus, der kopiert werden soll
+ (Standard, f-tex oder RB.)
+
+
+ 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
+
+
+
+ Standard
+
+ Der Standard-Vorlagensatz von Kivitendo. Wie unter http://demo.kivitendo.org zu
+ sehen.
+
+
+
+
+ f-tex
+
+ Ein Vorlagensatz, der in wenigen Minuten alle Dokumente zur Verfügung stellt.
+
+
+ Feature-Ãbersicht
+
+ Keine Redundanz. Es wird ein- und dieselbe 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*)
+
+ Hintergrund-PDF umschaltbar auf "nur erste Seite" (Standard) oder "alle Seiten" (Option
+ "" in Datei letter.lco)
+
+ Hintergrund-PDF für Ausdruck auf bereits bedrucktem Briefpapier abschaltbar. Es wird dann nur bei per E-Mail
+ versendeten Dokumenten eingebunden (Option "" in Datei
+ letter.lco).
+
+ Nutzung der Layout-Funktionen von LaTeX für Seitenumbruch, Wiederholung von Kopfzeilen, Zwischensummen
+ etc. (danke an Kai-Martin Knaak 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.
+
+
+
+
+ Die Installation
+
+ Vorlagenverzeichnis mit Option f-tex anlegen, siehe: . 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 "" 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 Hintergrund-PDF 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 Hintergrund-PDF 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.
+
+
+
+
+ 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 LaTeX-Vorlage 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 Endverbraucher
+
+ 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
+ StraÃe, 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.
+
+
+
+
+
+ RB
+
+ Vollständiger Dokumentensatz mit alternativem Design
- 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.
+
+
+
+ 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:... 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.
+
+
+
@@ -4137,6 +4374,18 @@ insserv kivitendo-task-server
und dem "end" werden nur ausgegeben, wenn die Variable
variablenname gesetzt und ungleich 0 ist.
+ Handelt es sich bei der benannten Variable um ein Array, also um einen Variablennamen, über den man mit
+ <%foreach variablenname%> iteriert, so wird mit diesem Konstrukt darauf getestet, ob das Array Elemente
+ enthält. Somit würde im folgenden Beispiel nur dann eine Liste von Zahlungseingängen samt ihrer Ãberschrift "Zahlungseingänge"
+ ausgegeben, wenn tatsächlich welche getätigt wurden:
+
+ <%if payment%>
+Zahlungseingänge:
+ <%foreach payment%>
+ Am <%paymentdate%>: <%payment%> â¬
+ <%end foreach%>
+<%end if%>
+
Die Bedingung kann auch negiert werden, indem das Wort
not nach dem if verwendet
wird. Beispiel:
@@ -5516,6 +5765,9 @@ filenames
Test::Deep (Debian-Paketname: libtest-deep-perl; Fedora Core:
perl-Test-Deep; openSuSE: perl-Test-Deep)
+ Test::Harness 3.0.0 oder höher. Dieses Modul ist ab Perl 5.10.1 Bestandteil der
+ Perl-Distribution und kann für frühere Versionen aus dem CPAN bezogen
+ werden.