2.5.2.4. Konfiguration des Webservers

Bevor Sie versuchen, eine kivitendo Installation unter FCGI laufen zu lassen, empfliehlt es sich die Installation ersteinmal unter CGI aufzusetzen. FCGI macht es nicht einfach Fehler zu diff --git a/doc/html/ch02s06.html b/doc/html/ch02s06.html index 4dd3522b1..8708cfc40 100644 --- a/doc/html/ch02s06.html +++ b/doc/html/ch02s06.html @@ -29,7 +29,7 @@ Links aus einem der Runlevel-Verzeichnisse heraus in den Boot-Prozess einzubinden. Da das bei neueren Linux-Distributionen aber nicht zwangslÃ¤ufig funktioniert, werden auch Start-Scripte mitgeliefert, die - anstelle eines symbolischen Links verwendet werden kÃ¶nnen.

2.6.2.1. SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora + anstelle eines symbolischen Links verwendet werden kÃ¶nnen.

2.6.2.1. SystemV-basierende Systeme (z.B. Debian, OpenSuSE, Fedora Core)

Kopieren Sie die Datei scripts/boot/system-v/kivitendo-server nach /etc/init.d/kivitendo-server. Passen @@ -40,7 +40,7 @@ insserv kivitendo-task-server

OpenSuSE und Fedora Core:

chkconfig --add kivitendo-task-server

Danach kann der Task-Server mit dem folgenden Befehl gestartet werden: /etc/init.d/kivitendo-task-server start -

2.6.2.2. Upstart-basierende Systeme (z.B. Ubuntu)

Kopieren Sie die Datei +

2.6.2.2. Upstart-basierende Systeme (z.B. Ubuntu)

Kopieren Sie die Datei scripts/boot/upstart/kivitendo-task-server.conf nach /etc/init/kivitendo-task-server.conf. Passen Sie in der kopierten Datei den Pfad zum Task-Server an (Zeile diff --git a/doc/html/ch02s10.html b/doc/html/ch02s10.html index d050121df..a83033615 100644 --- a/doc/html/ch02s10.html +++ b/doc/html/ch02s10.html @@ -1,153 +1,84 @@ - 2.10. Drucken mit kivitendo

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

2.10. 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 installiert man die Pakete mit:

aptitude install \
-      texlive-base-bin \
-texlive-latex-recommended \
-texlive-fonts-recommended \
-texlive-latex-extra \
-texlive-lang-german \
-texlive-generic-extra
-

TODO: rpm Pakete.

kivitendo bringt 3 alternative VorlagensÃ¤tze mit:

Standard
f-tex
RB

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. + 2.10. Drucken mit kivitendo

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

2.10. 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 installiert man + die Pakete mit:

aptitude install texlive-base-bin texlive-latex-recommended texlive-fonts-recommended \
+  texlive-latex-extra texlive-lang-german texlive-generic-extra

TODO: RPM-Pakete.

kivitendo bringt drei alternative VorlagensÃ¤tze mit:

Standard
f-tex
RB

2.10.1. 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.

WÃ¤hlen Sie dort einen Benutzer aus oder legen Sie einen neuen an. In der Benutzerbearbeiten-Maske mÃ¼ssen Sie zwei Dinge + angeben:

+ Name: Der Verzeichnisname fÃ¼r den neuen Vorlagensatz. Dieser kann im Rahmen der Ã¼blichen + Bedingungen fÃ¼r Verzeichnisnamen frei gewÃ¤hlt werden.
+ Vorlagen auswÃ¤hlen: 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

2.10.2. Standard

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 VerfÃ¼gung stellt.

2.10.3.1. 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 + "bgPdfFirstPageOnly" 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 "bgPdfEmailOnly" 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.

2.10.3.2. 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. + 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 + 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 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). + 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. + 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 + 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.

2.10.3.4. 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.

2.10.3.5. 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. +

2.10.4. RB

VollstÃ¤ndiger Dokumentensatz mit alternativem 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 + 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 diff --git a/doc/html/ch03s02.html b/doc/html/ch03s02.html index 91679b177..e8b2f81d1 100644 --- a/doc/html/ch03s02.html +++ b/doc/html/ch03s02.html @@ -556,7 +556,7 @@ invdate
Rechnungsdatum
invnumber -
Rechnungsnummer

3.2.10. Variablen in anderen Vorlagen

3.2.10.1. EinfÃ¼hrung

Die Variablen in anderen Vorlagen sind Ã¤hnlich wie in der +

Rechnungsnummer

3.2.10. Variablen in anderen Vorlagen

3.2.10.1. EinfÃ¼hrung

Die Variablen in anderen Vorlagen sind Ã¤hnlich wie in der Rechnung. Allerdings heiÃen die Variablen, die mit inv beginnen, jetzt anders. Bei den Angeboten fangen sie mit quo fÃ¼r "quotation" an: @@ -660,7 +660,15 @@ ... <%end%>

Eine normale "if-then"-Bedingung. Die Zeilen zwischen dem "if" und dem "end" werden nur ausgegeben, wenn die Variable - variablenname gesetzt und ungleich 0 ist.

Die Bedingung kann auch negiert werden, indem das Wort + 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:

<%if not cp_greeting%>
 ...
diff --git a/doc/html/ch04.html b/doc/html/ch04.html
index fd72356c9..6f4616f0d 100644
--- a/doc/html/ch04.html
+++ b/doc/html/ch04.html
@@ -1,6 +1,6 @@
 
       
-   Kapitel 4. EntwicklerdokumentationKapitel 4. Entwicklerdokumentation
ZurÃ¼ck     Weiter
Kapitel 4. Entwicklerdokumentation
4.1. Globale Variablen
4.1.1. Wie sehen globale Variablen in Perl aus?
Globale Variablen liegen in einem speziellen namespace namens
+   Kapitel 4. Entwicklerdokumentation
Kapitel 4. Entwicklerdokumentation
ZurÃ¼ck     Weiter
Kapitel 4. Entwicklerdokumentation
4.1. Globale Variablen
4.1.1. Wie sehen globale Variablen in Perl aus?
Globale Variablen liegen in einem speziellen namespace namens
         "main", der von Ã¼berall erreichbar ist. DarÃ¼ber hinaus sind bareword
         globs global und die meisten speziellen Variablen sind...
         speziell.
Daraus ergeben sich folgende Formen:

@@ -25,7 +25,7 @@
               $PACKAGE::form.

                      local $form
                   
Alle Ãnderungen an $form werden am Ende
-              des scopes zurÃ¼ckgesetzt
4.1.2. Warum sind globale Variablen ein Problem?
Das erste Problem ist FCGIâ¢.

+              des scopes zurÃ¼ckgesetzt
4.1.2. Warum sind globale Variablen ein Problem?
Das erste Problem ist FCGIâ¢.

                SQL-Ledgerâ¢ hat fast alles im globalen
         namespace abgelegt, und erwartet, dass es da auch wiederzufinden ist.
         Unter FCGIâ¢ mÃ¼ssen diese Sachen aber wieder
@@ -39,7 +39,7 @@
         dies hat, seit der EinfÃ¼hrung, u.a. schon so manche langwierige
         Bug-Suche verkÃ¼rzt. Da globale Variablen aber implizit mit Package
         angegeben werden, werden die nicht geprÃ¼ft, und somit kann sich
-        schnell ein Tippfehler einschleichen.
4.1.3. Kanonische globale Variablen
Um dieses Problem im Griff zu halten gibt es einige wenige
+        schnell ein Tippfehler einschleichen.
4.1.3. Kanonische globale Variablen
Um dieses Problem im Griff zu halten gibt es einige wenige
         globale Variablen, die kanonisch sind, d.h. sie haben bestimmte
         vorgegebenen Eigenschaften, und alles andere sollte anderweitig
         umhergereicht werden.
Diese Variablen sind im Moment die folgenden neun:

@@ -62,7 +62,7 @@
                      $::request
                   
Damit diese nicht erneut als MÃ¼llhalde missbraucht werden, im
         Folgenden eine kurze ErlÃ¤uterung der bestimmten vorgegebenen
-        Eigenschaften (Konventionen):
4.1.3.1. $::form
Ist ein Objekt der Klasse
+        Eigenschaften (Konventionen):
4.1.3.1. $::form
Ist ein Objekt der Klasse
               "Form"
Wird nach jedem Request gelÃ¶scht
Muss auch in Tests und Konsolenscripts vorhanden
               sein.
EnthÃ¤lt am Anfang eines Requests die Requestparameter vom
               User
Kann zwar intern Ã¼ber Requestgrenzen ein Datenbankhandle
@@ -110,7 +110,7 @@
   push @{ $form->{TEMPLATE_ARRAYS}{number} },          $form->{"partnumber_$i"};
   push @{ $form->{TEMPLATE_ARRAYS}{description} },     $form->{"description_$i"};
   # ...
-}

4.1.3.2. %::myconfig

Das einzige Hash unter den globalen Variablen
Wird spÃ¤testens benÃ¶tigt wenn auf die Datenbank +}

4.1.3.2. %::myconfig

Das einzige Hash unter den globalen Variablen
Wird spÃ¤testens benÃ¶tigt wenn auf die Datenbank zugegriffen wird
Wird bei jedem Request neu erstellt.
EnthÃ¤lt die Userdaten des aktuellen Logins
Sollte nicht ohne Filterung irgendwo gedumpt werden oder extern serialisiert werden, weil da auch der Datenbankzugriff fÃ¼r diesen user drinsteht.
EnthÃ¤lt unter anderem Listenbegrenzung vclimit, @@ -122,10 +122,10 @@ Ã¼berwiegend die Daten, die sich unter Programm -> Einstellungen befinden, bzw. die Informationen Ã¼ber den Benutzer die Ã¼ber die - Administrator-Schnittstelle (admin.pl) eingegeben wurden.

4.1.3.3. $::locale

Objekt der Klasse "Locale"
Wird pro Request erstellt
Muss auch fÃ¼r Tests und Scripte immer verfÃ¼gbar + Administrator-Schnittstelle (admin.pl) eingegeben wurden.

4.1.3.3. $::locale

Objekt der Klasse "Locale"
Wird pro Request erstellt
Muss auch fÃ¼r Tests und Scripte immer verfÃ¼gbar sein.
Cached intern Ã¼ber Requestgrenzen hinweg benutzte Locales

Lokalisierung fÃ¼r den aktuellen User. Alle Ãbersetzungen, - Zahlen- und Datumsformatierungen laufen Ã¼ber dieses Objekt.

4.1.3.4. $::lxdebug

Objekt der Klasse "LXDebug"
Wird global gecached
Muss immer verfÃ¼gbar sein, in nahezu allen + Zahlen- und Datumsformatierungen laufen Ã¼ber dieses Objekt.

4.1.3.4. $::lxdebug

Objekt der Klasse "LXDebug"
Wird global gecached
Muss immer verfÃ¼gbar sein, in nahezu allen Funktionen

$::lxdebug stellt Debuggingfunktionen bereit, wie "enter_sub" und @@ -135,12 +135,12 @@ "message" und "dump" mit denen man flott Informationen ins Log (tmp/kivitendo-debug.log) packen kann.

Beispielsweise so:

$main::lxdebug->message(0, 'Meine Konfig:' . Dumper (%::myconfig));
-$main::lxdebug->message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form->{vc});

4.1.3.5. $::auth

Objekt der Klasse "SL::Auth"
Wird global gecached
Hat eine permanente DB Verbindung zur Authdatenbank
Wird nach jedem Request resettet.

+$main::lxdebug->message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form->{vc});

4.1.3.5. $::auth

Objekt der Klasse "SL::Auth"
Wird global gecached
Hat eine permanente DB Verbindung zur Authdatenbank
Wird nach jedem Request resettet.

$::auth stellt Funktionen bereit um die Rechte des aktuellen Users abzufragen. Obwohl diese Informationen vom aktuellen User abhÃ¤ngen wird das Objekt aus GeschwindigkeitsgrÃ¼nden nur einmal angelegt und dann nach jedem - Request kurz resettet.

4.1.3.6. $::lx_office_conf

Objekt der Klasse + Request kurz resettet.

4.1.3.6. $::lx_office_conf

Objekt der Klasse "SL::LxOfficeConf"
Global gecached
ReprÃ¤sentation der config/kivitendo.conf[.default]-Dateien

Globale Konfiguration. Configdateien werden zum Start gelesen und danach nicht mehr angefasst. Es ist derzeit nicht geplant, dass @@ -150,16 +150,16 @@ $main::lxdebug->message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form->{ file = /tmp/kivitendo-debug.log

ist der Key file im Programm als $::lx_office_conf->{debug}{file} erreichbar.

	Warnung
	Zugriff auf die Konfiguration erfolgt im Moment Ã¼ber - Hashkeys, sind also nicht gegen Tippfehler abgesichert.

4.1.3.7. $::instance_conf

Objekt der Klasse + Hashkeys, sind also nicht gegen Tippfehler abgesichert.

4.1.3.7. $::instance_conf

Objekt der Klasse "SL::InstanceConfiguration"
wird pro Request neu erstellt

Funktioniert wie $::lx_office_conf, speichert aber Daten die von der Instanz abhÃ¤ngig sind. Eine Instanz ist hier eine Mandantendatenbank. Beispielsweise Ã¼berprÃ¼ft

$::instance_conf->get_inventory_system eq 'perpetual'

- ob die berÃ¼chtigte Bestandsmethode zur Anwendung kommt.

4.1.3.8. $::dispatcher

Objekt der Klasse + ob die berÃ¼chtigte Bestandsmethode zur Anwendung kommt.

4.1.3.8. $::dispatcher

Objekt der Klasse "SL::Dispatcher"
wird pro Serverprozess erstellt.
enthÃ¤lt Informationen Ã¼ber die technische Verbindung zum Server

Der dritte Punkt ist auch der einzige Grund warum das Objekt global gespeichert wird. Wird vermutlich irgendwann in einem anderen - Objekt untergebracht.

4.1.3.9. $::request

Hashref (evtl spÃ¤ter Objekt)
Wird pro Request neu initialisiert.
Keine Unterstruktur garantiert.

+ Objekt untergebracht.

4.1.3.9. $::request

Hashref (evtl spÃ¤ter Objekt)
Wird pro Request neu initialisiert.
Keine Unterstruktur garantiert.

$::request ist ein generischer Platz um Daten "fÃ¼r den aktuellen Request" abzulegen. Sollte nicht fÃ¼r action at a distance benutzt werden, sondern um lokales memoizing zu @@ -172,20 +172,20 @@ file = /tmp/kivitendo-debug.log

ist der Key file$::request

Muss ich von anderen Teilen des Programms lesend drauf zugreifen? Dann $::request, aber Zugriff Ã¼ber - Wrappermethode

4.1.4. Ehemalige globale Variablen

Die folgenden Variablen waren einmal im Programm, und wurden - entfernt.

4.1.4.1. $::cgi

war nÃ¶tig, weil cookie Methoden nicht als + Wrappermethode

4.1.4. Ehemalige globale Variablen

Die folgenden Variablen waren einmal im Programm, und wurden + entfernt.

4.1.4.1. $::cgi

war nÃ¶tig, weil cookie Methoden nicht als Klassenfunktionen funktionieren
Aufruf als Klasse erzeugt Dummyobjekt was im Klassennamespace gehalten wird und Ã¼ber Requestgrenzen leaked
liegt jetzt unter $::request->{cgi} -

4.1.4.2. $::all_units

war nÃ¶tig, weil einige Funktionen in Schleifen zum Teil +

4.1.4.2. $::all_units

war nÃ¶tig, weil einige Funktionen in Schleifen zum Teil ein paar hundert mal pro Request eine Liste der Einheiten brauchen, und de als Parameter durch einen Riesenstack von Funktionen geschleift werden mÃ¼ssten.
Liegt jetzt unter $::request->{cache}{all_units}
Wird nur in AM->retrieve_all_units() gesetzt oder - gelesen.

4.1.4.3. %::called_subs

wurde benutzt um callsub deep recursions + gelesen.

4.1.4.3. %::called_subs

wurde benutzt um callsub deep recursions abzufangen.
Wurde entfernt, weil callsub nur einen Bruchteil der mÃ¶glichen Rekursioenen darstellt, und da nie welche auftreten.
komplette recursion protection wurde entfernt.

ZurÃ¼ck		Weiter
3.3. Excel-Vorlagen	Zum Anfang	4.2. Entwicklung unter FastCGI

\ No newline at end of file diff --git a/doc/html/ch04s05.html b/doc/html/ch04s05.html index 87fee7702..638a83576 100644 --- a/doc/html/ch04s05.html +++ b/doc/html/ch04s05.html @@ -3,7 +3,10 @@ 4.5. Die kivitendo-Test-Suite

4.5. Die kivitendo-Test-Suite
ZurÃ¼ck	Kapitel 4. Entwicklerdokumentation	Weiter

4.5. Die kivitendo-Test-Suite

4.5.1. EinfÃ¼hrung

kivitendo enthÃ¤lt eine Suite fÃ¼r automatisierte Tests. Sie basiert auf dem Standard-Perl-Modul Test::More.

Die grundlegenden Fakten sind:

Alle Tests liegen im Unterverzeichnis t/.
Ein Script (bzw. ein Test) in f/ enthÃ¤lt einen oder mehrere TestfÃ¤lle.
Alle Dateinamen von Tests enden auf .t. Es sind selbststÃ¤ndig ausfÃ¼hrbare Perl-Scripte.
Die Test-Suite besteht aus der Gesamtheit aller Tests, sprich aller Scripte in f/, deren Dateiname auf .t endet.

4.5.2. Voraussetzungen

FÃ¼r die AusfÃ¼hrung werden neben den fÃ¼r kivitendo eh schon benÃ¶tigten Module noch weitere Perl-Module benÃ¶tigt. Diese sind:

Test::Deep (Debian-Paketname: libtest-deep-perl; Fedora Core: - perl-Test-Deep; openSuSE: perl-Test-Deep)

4.5.3. + `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.

4.5.3. Existierende Tests ausfÃ¼hren

Es gibt mehrere MÃ¶glichkeiten zum AusfÃ¼hren der Tests: entweder, man lÃ¤sst alle Tests auf einmal ausfÃ¼hren, oder man fÃ¼hrt gezielt einzelne Scripte aus. FÃ¼r beide FÃ¤lle gibt es das Helferscript t/test.sh.

Will man die komplette Test-Suite ausfÃ¼hren, so muss man einfach nur t/test.sh ohne weitere Parameter aus diff --git a/doc/html/index.html b/doc/html/index.html index f9ac994c3..9b8060127 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -1,9 +1,9 @@ - kivitendo: Installation, Konfiguration, Entwicklung