Aktivierung von Apache2 modsecurity

2.7.3.1. SystemV-basierende Systeme (z.B. Ã¤ltere Debian, Ã¤ltere + anstelle eines symbolischen Links verwendet werden kÃ¶nnen.

2.7.3.1. SystemV-basierende Systeme (z.B. Ã¤ltere Debian, Ã¤ltere openSUSE, Ã¤ltere Fedora)

Kopieren Sie die Datei scripts/boot/system-v/kivitendo-task-server nach /etc/init.d/kivitendo-task-server. Passen @@ -52,12 +52,12 @@ DAEMON=....). Binden Sie das Script in den Boot-Prozess ein. Dies ist distributionsabhÃ¤ngig:

Debian-basierende Systeme:

update-rc.d kivitendo-task-server defaults
 insserv kivitendo-task-server

Ãltere openSUSE und Ã¤ltere Fedora:
```
chkconfig --add kivitendo-task-server
```

Danach kann der Task-Server mit dem folgenden Befehl gestartet - werden:

/etc/init.d/kivitendo-task-server start

2.7.3.2. Upstart-basierende Systeme (z.B. Ubuntu bis 14.04)

Kopieren Sie die Datei + werden:

/etc/init.d/kivitendo-task-server start

2.7.3.2. Upstart-basierende Systeme (z.B. Ubuntu bis 14.04)

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 exec ....).

Danach kann der Task-Server mit dem folgenden Befehl gestartet - werden:

service kivitendo-task-server start

2.7.3.3. systemd-basierende Systeme (z.B. neure openSUSE, neuere + werden:

service kivitendo-task-server start

2.7.3.3. systemd-basierende Systeme (z.B. neure openSUSE, neuere Fedora, neuere Ubuntu und neuere Debians)

Kopieren Sie die Datei scripts/boot/systemd/kivitendo-task-server.service nach /etc/systemd/system/. Passen Sie in der diff --git a/doc/html/ch02s13.html b/doc/html/ch02s13.html index ba6aecc2a..dfe1ea1a2 100644 --- a/doc/html/ch02s13.html +++ b/doc/html/ch02s13.html @@ -63,14 +63,14 @@ Verzeichnis umbenannt werden.

Dieses Verzeichnis, wie auch das komplette users-Verzeichnis, muss vom Webserver beschreibbar sein. Dieses wurde bereits erledigt (siehe Manuelle Installation des Programmpaketes), kann aber erneut - Ã¼berprÃ¼ft werden, wenn die Konvertierung nach PDF fehlschlÃ¤gt.

2.13.1. OpenDocument (odt) Druckvorlagen mit Makros

OpenDocument Vorlagen kÃ¶nnen Makros enthalten, welche komplexere + Ã¼berprÃ¼ft werden, wenn die Konvertierung nach PDF fehlschlÃ¤gt.

2.13.1. OpenDocument (odt) Druckvorlagen mit Makros

OpenDocument Vorlagen kÃ¶nnen Makros enthalten, welche komplexere Aufgaben erfÃ¼llen.

Der Vorlagensatz "rev-odt" enthÃ¤lt solche Vorlagen mit Schweizer Bank-Einzahlungsscheinen (BESR). Diese Makros haben die Aufgabe, die in den Einzahlungsscheinen benÃ¶tigte Referenznummer und Kodierzeile zu erzeugen. Hier eine kurze Beschreibung, wie die Makros aufgebaut sind, und was bei ihrer Nutzung zu beachten ist (in fett sind nÃ¶tige einmalige - Anpassungen aufgefÃ¼hrt):

2.13.1.1. Bezeichnung der Vorlagen

Rechnung: invoice_besr.odt, Auftrag: - sales_order_besr.odt

2.13.1.2. Vorbereitungen im Adminbereich

Damit beim Erstellen von Rechnungen und AuftrÃ¤gen neben der + Anpassungen aufgefÃ¼hrt):

2.13.1.1. Bezeichnung der Vorlagen

Rechnung: invoice_besr.odt, Auftrag: + sales_order_besr.odt

2.13.1.2. Vorbereitungen im Adminbereich

Damit beim Erstellen von Rechnungen und AuftrÃ¤gen neben der Standardvorlage ohne Einzahlungsschein weitere Vorlagen (z.B. mit Einzahlungsschein) auswÃ¤hlbar sind, muss fÃ¼r jedes Vorlagen-Suffix ein Drucker eingerichtet werden:

Druckeradministration â Drucker hinzufÃ¼gen
Mandant wÃ¤hlen
Druckerbeschreibung â aussagekrÃ¤ftiger Text: wird in der @@ -79,11 +79,11 @@ AuftrÃ¤gen oder Rechnungen als odt-Datei keine Bedeutung, darf aber nicht leer sein)
VorlagenkÃ¼rzel â besr bzw. selbst gewÃ¤hltes Vorlagensuffix (muss genau der Zeichenfolge entsprechen, die zwischen - "invoice_" bzw. "sales_order_" und ".odt" steht.)
speichern

2.13.1.3. Benutzereinstellungen

Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung + "invoice_" bzw. "sales_order_" und ".odt" steht.)

speichern

2.13.1.3. Benutzereinstellungen

Wer den Ausdruck mit Einzahlungsschein als Standardeinstellung im Rechnungs- bzw. Auftragsformular angezeigt haben mÃ¶chte, kann dies persÃ¶nlich fÃ¼r sich bei den Benutzereinstellungen konfigurieren:

Programm â Benutzereinstellungen â Druckoptionen
Standardvorlagenformat â OpenDocument/OASIS
Standardausgabekanal â Bildschirm
Standarddrucker â gewÃ¼nschte Druckerbeschreibung auswÃ¤hlen - (z.B. mit Einzahlungsschein Bank xy)
Anzahl Kopien â leer
speichern

2.13.1.4. Aufbau und nÃ¶tige Anpassungen der Vorlagen

In der Vorlage sind als Modul "BESR" 4 Makros gespeichert, die + (z.B. mit Einzahlungsschein Bank xy)

Anzahl Kopien â leer

speichern

2.13.1.4. Aufbau und nÃ¶tige Anpassungen der Vorlagen

In der Vorlage sind als Modul "BESR" 4 Makros gespeichert, die aus dem von kivitendo erzeugten odt-Dokument die korrekte Referenznummer inklusive PrÃ¼fziffer sowie die Kodierzeile in OCRB-Schrift erzeugen und am richtigen Ort ins Dokument @@ -112,12 +112,12 @@ angepasst werden. Dabei ist darauf zu achten, dass sich die Positionen der Postkonto-Nummern der Bank, sowie der Zeichenfolgen dddfr, DDDREF1, DDDREF2, 609, DDDKODIERZEILE nicht - verschieben.

2.13.1.5. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer + verschieben.

2.13.1.5. Auswahl der Druckvorlage in kivitendo beim Erzeugen einer odt-Rechnung (analog bei Auftrag)

Im Fussbereich der Rechnungsmaske muss neben Rechnung, OpenDocument/OASIS und Bildschirm die im Adminbereich erstellte Druckerbeschreibung ausgewÃ¤hlt werden, falls diese nicht bereits bei den Benutzereinstellungen als persÃ¶nlicher Standard gewÃ¤hlt - wurde.

2.13.1.6. Makroeinstellungen in LibreOffice anpassen

Falls beim Ãffnen einer von kivitendo erzeugten odt-Rechnung + wurde.

2.13.1.6. Makroeinstellungen in LibreOffice anpassen

Falls beim Ãffnen einer von kivitendo erzeugten odt-Rechnung die Meldung kommt, dass Makros aus SicherheitsgrÃ¼nden nicht ausgefÃ¼hrt werden, so mÃ¼ssen folgende Einstellungen in LibreOffice angepasst werden:

Extras â Optionen â Sicherheit â Makrosicherheit
Sicherheitslevel auf "Mittel" einstellen (Diese diff --git a/doc/html/ch03s03.html b/doc/html/ch03s03.html index bb217be34..89b38c48c 100644 --- a/doc/html/ch03s03.html +++ b/doc/html/ch03s03.html @@ -617,7 +617,7 @@ invdate
Rechnungsdatum
invnumber -
Rechnungsnummer

3.3.10. Variablen in anderen Vorlagen

3.3.10.1. EinfÃ¼hrung

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

Rechnungsnummer

3.3.10. Variablen in anderen Vorlagen

3.3.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: diff --git a/doc/html/ch03s07.html b/doc/html/ch03s07.html index cfb048744..a6f2ce596 100644 --- a/doc/html/ch03s07.html +++ b/doc/html/ch03s07.html @@ -1,15 +1,15 @@ - 3.7. Artikelklassifizierung

3.7. Artikelklassifizierung
ZurÃ¼ck	Kapitel 3. Features und Funktionen	Weiter

3.7. Artikelklassifizierung

3.7.1. Ãbersicht

Die Klassifizierung von Artikeln dient einer weiteren + 3.7. Artikelklassifizierung

3.7. Artikelklassifizierung
ZurÃ¼ck	Kapitel 3. Features und Funktionen	Weiter

3.7. Artikelklassifizierung

3.7.1. Ãbersicht

Die Klassifizierung von Artikeln dient einer weiteren Gliederung, um zum Beispiel den Einkauf vom Verkauf zu trennen, gekennzeichnet durch eine Beschreibung (z.B. "Einkauf") und ein KÃ¼rzel (z.B. "E"). FÃ¼r jede Klassifizierung besteht eine Beschreibung und eine AbkÃ¼rzung die normalerweise aus einem Zeichen besteht, kann aber auf mehrere Zeichen erweitert werden, falls zur Unterscheidung - notwendig. Sinnvoll sind jedoch nur maximal 2 Zeichen.

3.7.2. Basisklassifizierung

Als Basisklassifizierungen gibt es

Einkauf
Verkauf
Handelsware
Produktion
- keine - (diese wird bei einer Aktualisierung fÃ¼r alle + notwendig. Sinnvoll sind jedoch nur maximal 2 Zeichen.

3.7.2. Basisklassifizierung

Als Basisklassifizierungen gibt es

Einkauf
Verkauf
Handelsware
Produktion
- keine - (diese wird bei einer Aktualisierung fÃ¼r alle existierenden Artikel verwendet und ist gÃ¼ltig fÃ¼r Verkauf und Einkauf)

Es kÃ¶nnen weitere Klassifizierungen angelegt werden. So kann es - z.B. fÃ¼r separat auszuweisende Artikel folgende Klassen geben:

Lieferung (Logistik, Transport) mit KÃ¼rzel L
Material (Verpackungsmaterial) mit KÃ¼rzel M

3.7.3. Attribute

Bisher haben die Klassifizierungen folgende Attribute, die auch + z.B. fÃ¼r separat auszuweisende Artikel folgende Klassen geben:

Lieferung (Logistik, Transport) mit KÃ¼rzel L
Material (Verpackungsmaterial) mit KÃ¼rzel M

3.7.3. Attribute

Bisher haben die Klassifizierungen folgende Attribute, die auch alle gleichzeitg gÃ¼ltig sein kÃ¶nnen

gÃ¼ltig fÃ¼r Verkauf - dieser Artikel kann im Verkauf genutzt werden
gÃ¼ltig fÃ¼r Einkauf - dieser Artikel kann im Einkauf genutzt werden
separat ausweisen - hierzu gibt es zur Dokumentengenerierung @@ -19,7 +19,7 @@ pro separat auszuweisenden Klassifizierungen die Variable< %separate_X_subtotal%>, wobei X das KÃ¼rzel der Klassifizierung ist.
Im obigen Beispiel wÃ¤re das fÃ¼r Lieferkosten <%separate_L_subtotal%> und fÃ¼r Verpackungsmaterial - <%separate_M_subtotal%>.

3.7.4. Zwei-Zeichen AbkÃ¼rzung

Der Typ des Artikels und die Klassifizierung werden durch zwei + <%separate_M_subtotal%>.

3.7.4. Zwei-Zeichen AbkÃ¼rzung

Der Typ des Artikels und die Klassifizierung werden durch zwei Buchstaben dargestellt. Der erste Buchstabe ist eine Lokalisierung des Artikel-Typs ('P','A','S'), deutsch 'W', 'E', und 'D' fÃ¼r Ware Erzeugnis oder Dienstleistung und ggf. weiterer Typen.

Der zweite Buchstabe (und ggf. auch ein dritter, falls nÃ¶tig) diff --git a/doc/html/ch03s08.html b/doc/html/ch03s08.html index a8430c592..81986e1f6 100644 --- a/doc/html/ch03s08.html +++ b/doc/html/ch03s08.html @@ -1,10 +1,10 @@ - 3.8. Dateiverwaltung (Mini-DMS)

3.8. Dateiverwaltung (Mini-DMS)
ZurÃ¼ck	Kapitel 3. Features und Funktionen	Weiter

3.8. Dateiverwaltung (Mini-DMS)

3.8.1. Ãbersicht

Parallel zum alten WebDAV gibt es ein Datei-Management-System, + 3.8. Dateiverwaltung (Mini-DMS)

3.8. Dateiverwaltung (Mini-DMS)
ZurÃ¼ck	Kapitel 3. Features und Funktionen	Weiter

3.8. Dateiverwaltung (Mini-DMS)

3.8.1. Ãbersicht

Parallel zum alten WebDAV gibt es ein Datei-Management-System, das Dateien verschiedenen Typs verwaltet. Dies kÃ¶nnen

aus ERP-Daten per LaTeX Template erzeugte PDF-Dokumente,
zu bestimmten ERP-Daten gehÃ¶rende Anhangdateien unterschiedlichen Formats,
per Scanner eingelesene PDF-Dateien,
per E-Mail empfangene DateianhÃ¤nge unterschiedlichen - Formats,
sowie speziel fÃ¼r Artikel hochgeladene Bilder sein.

3.8.2. Struktur

Ãber eine vom Speichermedium unabhÃ¤ngige Zwischenschicht werden + Formats,

sowie speziel fÃ¼r Artikel hochgeladene Bilder sein.

3.8.2. Struktur

Ãber eine vom Speichermedium unabhÃ¤ngige Zwischenschicht werden die Dateien und ihre Versionen in der Datenbank verwaltet. Darunter kÃ¶nnen verschiedene Implementierungen (Backends) gleichzeitig existieren:

Dateisystem
WebDAV
Schnittstelle zu externen @@ -23,7 +23,7 @@ fÃ¼r "attachment" und "image" nur die Quelle "uploaded". FÃ¼r "document" gibt es auf jeden Fall die Quelle "created". Die Quellen "scanner" und "email" mÃ¼ssen derzeit in der Datenbank konfiguriert werden (siehe - Datenbank-Konfigurierung).

3.8.3. Anwendung

Die Daten werden bei den ERP-Objekten als extra Reiter + Datenbank-Konfigurierung).

3.8.3. Anwendung

Die Daten werden bei den ERP-Objekten als extra Reiter dargestellt. Eine Verkaufsrechnung z.B. hat die Reiter "Dokumente" und "DateianhÃ¤nge".

Bei den DateianhÃ¤ngen wird immer nur die aktuelle Version einer Datei angezeigt. Wird eine Datei mit gleichem Namen hochgeladen, so @@ -39,13 +39,13 @@ so sind diese z.B. bei Einkaufsrechnungen sichtbar:

Statt des LÃ¶schens wird hier die Datei zurÃ¼ck zur Quelle verschoben. Somit kann die Datei anschlieÃend an ein anderes ERP-Objekt angehÃ¤ngt werden.

Derzeit sind "Titel" und "Beschreibung" noch nicht genutzt. Sie - sind bisher nur bei Bildern relevant.

3.8.4. Konfigurierung

3.8.4.1. Mandantenkonfiguration

3.8.4.1.1. Reiter "Features"

Unter dem Reiter Features + sind bisher nur bei Bildern relevant.

3.8.4. Konfigurierung

3.8.4.1. Mandantenkonfiguration

3.8.4.1.1. Reiter "Features"

Unter dem Reiter Features im Abschnitt Dateimanagement ist neben dem "alten" WebDAV das Dateimangement generell zu- und abschaltbar, sowie die Zuordnung der Dateitypen zu Backends. Die LÃ¶schbarkeit von Dateien, sowie die maximale UploadgrÃ¶Ãe sind Backend-unabhÃ¤ngig

Die einzelnen Backends sind einzeln einschaltbar. Spezifische Backend-Konfigurierungen sind hier noch - ergÃ¤nzbar.

3.8.4.1.2. Reiter "Allgemeine DokumentenanhÃ¤nge"

Unter dem Reiter Allgemeine + ergÃ¤nzbar.

3.8.4.1.2. Reiter "Allgemeine DokumentenanhÃ¤nge"

Unter dem Reiter Allgemeine DokumentenanhÃ¤nge kann fÃ¼r alle ERP-Dokumente ( Angebote, AuftrÃ¤ge, Lieferscheine, Rechnungen im Verkauf und Einkauf ) allgemeingÃ¼ltige AnhÃ¤nge hochgeladen werden.

Diese AnhÃ¤nge werden beim Generieren von PDF-Dateien an die diff --git a/doc/html/ch03s09.html b/doc/html/ch03s09.html index 84d486ea9..1c17ab803 100644 --- a/doc/html/ch03s09.html +++ b/doc/html/ch03s09.html @@ -1,13 +1,13 @@ - 3.9. Webshop-Api

3.9. Webshop-Api
ZurÃ¼ck	Kapitel 3. Features und Funktionen	Weiter

3.9. Webshop-Api

Das Shopmodul bietet die MÃ¶glichkeit Onlineshopartikel und + 3.9. Webshop-Api

3.9. Webshop-Api
ZurÃ¼ck	Kapitel 3. Features und Funktionen	Weiter

3.9. Webshop-Api

Das Shopmodul bietet die MÃ¶glichkeit Onlineshopartikel und Onlineshopbestellungen zu verwalten und zu bearbeiten.

Es ist MultishopfÃ¤hig, d.h. Artikel kÃ¶nnen mehreren oder unterschiedlichen Shops zugeordnet werden. Bestellungen kÃ¶nnen aus mehreren Shops geholt werden.

Zur Zeit bietet das Modul nur einen Connector zur REST-Api von Shopware. Weitere Connectoren kÃ¶nnen dazu programmiert und eingerichtet - werden.

3.9.1. Rechte fÃ¼r die Webshopapi

In der Administration kÃ¶nnen folgende Rechte vergeben - werden

Webshopartikel anlegen und bearbeiten
Shopbestellungen holen und bearbeiten
Shop anlegen und bearbeiten

3.9.2. Konfiguration

Unter System->Webshops kÃ¶nnen Shops angelegt und konfiguriert - werden

3.9.3. Webshopartikel

3.9.3.1. Shopvariablenreiter in Artikelstammdaten

Mit dem Recht "Shopartikel anlegen und bearbeiten" und des + werden.

3.9.1. Rechte fÃ¼r die Webshopapi

In der Administration kÃ¶nnen folgende Rechte vergeben + werden

Webshopartikel anlegen und bearbeiten
Shopbestellungen holen und bearbeiten
Shop anlegen und bearbeiten

3.9.2. Konfiguration

Unter System->Webshops kÃ¶nnen Shops angelegt und konfiguriert + werden

3.9.3. Webshopartikel

3.9.3.1. Shopvariablenreiter in Artikelstammdaten

Mit dem Recht "Shopartikel anlegen und bearbeiten" und des Markers "Shopartikel" in den Basisdaten zeigt sich der Reiter "Shopvariablen" in den Artikelstammdaten. Hier kÃ¶nnen jetzt die Artikel mit @@ -16,11 +16,11 @@ Stelle kÃ¶nnen auch beliebig viele Bilder dem Shopartikel zugeordnet werden. Artikelbilder gelten fÃ¼r alle Shops.

Die Artikelgruppen werden direkt vom Shopsystem geholt somit ist es mÃ¶glich einen Artikel auch mehreren Gruppen - zuzuordenen

3.9.3.2. Shopartikelliste

Unter dem Menu Webshop->Webshop Artikel hat man nochmal + zuzuordenen

3.9.3.2. Shopartikelliste

Unter dem Menu Webshop->Webshop Artikel hat man nochmal eine GesamtÃ¼bersicht. Von hier aus ist es mÃ¶glich Artikel im Stapel unter verschiedenen Kriterien <alles><nur Preis><nur Bestand><Preis und Bestand> an die jeweiligen Shops - hochzuladen.

3.9.4. Bestellimport

Unter dem Menupunkt Webshop->Webshop Import Ã¶ffnet sich die + hochzuladen.

3.9.4. Bestellimport

Unter dem Menupunkt Webshop->Webshop Import Ã¶ffnet sich die Bestellimportsliste. Hier ist sind MÃ¶glichkeiten gegeben Neue Bestellungen vom Shop abzuholen, geholte Bestellungen im Stapel oder einzeln als Auftrag zu transferieren. Die Liste kann nach @@ -52,7 +52,7 @@ auch der Grund fÃ¼r die Auftragssperre sein.

Die Buttons "Auftrag erstellen" und "Kunde mit Rechnungsadresse Ã¼berschreiben" zeigen sich erst, wenn ein Kunde aus dem Listing ausgewÃ¤hlt ist.

Es ist aber mÃ¶glich die Shopbestellung zu lÃ¶schen.

Ist eine Bestellung schon Ã¼bernommen, zeigen sich an dieser - Stelle, die dazugehÃ¶rigen BelegverknÃ¼pfungen.

3.9.5. Mapping der Daten

Das Mapping der kivitendo Daten mit den Shopdaten geschieht in + Stelle, die dazugehÃ¶rigen BelegverknÃ¼pfungen.

3.9.5. Mapping der Daten

Das Mapping der kivitendo Daten mit den Shopdaten geschieht in der Datei SL/ShopConnector/<SHOPCONNECTORNAME>.pm z.B.:SL/ShopConnector/Shopware.pm

In dieser Datei gibt es einen Bereich wo die Bestellpostionen, die Bestellkopfdaten und die Artikeldaten gemapt werden. In dieser diff --git a/doc/html/ch03s10.html b/doc/html/ch03s10.html index 03d97addf..5cae9e7c1 100644 --- a/doc/html/ch03s10.html +++ b/doc/html/ch03s10.html @@ -35,12 +35,12 @@

3.10.3. Erstellen von ZUGFeRD Rechnungen in Kivitendo

FÃ¼r die Erstellung von ZUGFeRD Rechnungen bedarf es in kivitendo zwei Dinge:

Die Erstellung muss in der Mandantenkonfiguration aktiviert sein
Beim mindestens einem Bankkonto muss die Option - âNutzung von ZUGFeRDâ aktiviert sein

3.10.3.1. Mandantenkonfiguration

Die Einstellung fÃ¼r die Erstellung von ZUGFeRD Rechnungen + âNutzung von ZUGFeRDâ aktiviert sein

3.10.3.1. Mandantenkonfiguration

Die Einstellung fÃ¼r die Erstellung von ZUGFeRD Rechnungen erfolgt unter âSystemâ â âMandatenkonfigurationâ â âFeaturesâ. Im Abschnitt âEinkauf und Verkaufâ finden Sie die Einstellung âVerkaufsrechnungen mit ZUGFeRD-Daten erzeugenâ. Hier besteht die Auswahl zwischen:

ZUGFeRD-Rechnungen erzeugen
ZUGFeRD-Rechnungen im Testmodus erzeugen
Keine ZUGFeRD Rechnungen erzeugen

Rechnungen die als PDF erzeugt werden, werden je nach - Einstellung nun im ZUGFeRD Format ausgegeben.

3.10.3.2. Konfiguration der Bankkonten

Unter âSystem â Bankkontenâ muss bei mindestens einem + Einstellung nun im ZUGFeRD Format ausgegeben.

3.10.3.2. Konfiguration der Bankkonten

Unter âSystem â Bankkontenâ muss bei mindestens einem Bankkonto die Option âNutzung mit ZUGFeRDâ auf âJaâ gestellt werden.

3.10.4. Einlesen von ZUGFeRD Rechnungen in Kivitendo

Es lassen sich auch Rechnungen von Kreditoren, die im ZUGFeRD Format erstellt wurden, nach Kivitendo importieren. diff --git a/doc/html/ch04.html b/doc/html/ch04.html index 5f10ec8d6..1db7b2e4c 100644 --- a/doc/html/ch04.html +++ b/doc/html/ch04.html @@ -1,6 +1,6 @@ - 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 + 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 Datumsformat dateformat und @@ -122,10 +122,10 @@ Ã¼berwiegend die Daten, die sich unter Programm -> Einstellungen befinden, bzw. die Informationen Ã¼ber den Benutzer die Ã¼ber die - Administrator-Schnittstelle 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 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,7 +135,7 @@ "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 @@ -144,7 +144,7 @@ $main::lxdebug->message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form->{ Dessen Einstellungen kÃ¶nnen Ã¼ber $::auth->client abgefragt werden; RÃ¼ckgabewert ist ein Hash mit den Werten aus der Tabelle - auth.clients.
4.1.3.6. $::lx_office_conf
Objekt der Klasse + auth.clients.
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 @@ -154,16 +154,16 @@ $main::lxdebug->message(0, 'Wer bin ich? Kunde oder Lieferant:' . $form->{ file_name = /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 @@ -176,20 +176,20 @@ file_name = /tmp/kivitendo-debug.log
ist der Key f $::request
Muss ich von anderen Teilen des Programms lesend drauf zugreifen? Dann $::request, aber Zugriff Ã¼ber - Wrappermethode

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

`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.10. ZUGFeRD Rechnungen	Zum Anfang	4.2. Entwicklung unter FastCGI

\ No newline at end of file diff --git a/doc/html/index.html b/doc/html/index.html index d4dd2f09b..379e9e17b 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -2,8 +2,8 @@ kivitendo 3.5.5: Installation, Konfiguration, Entwicklungkivitendo 3.5.5: Installation, Konfiguration, Entwicklung Weiter kivitendo 3.5.5: Installation, Konfiguration, - Entwicklung Inhaltsverzeichnis 1. Aktuelle Hinweise 2. Installation und Grundkonfiguration 2.1. Ãbersicht 2.2. BenÃ¶tigte Software und Pakete 2.2.1. Betriebssystem 2.2.2. BenÃ¶tigte Perl-Pakete installieren 2.2.3. Andere Pakete installieren 2.3. Manuelle Installation des Programmpaketes 2.4. kivitendo-Konfigurationsdatei 2.4.1. EinfÃ¼hrung 2.4.2. Abschnitte und Parameter 2.4.3. Versionen vor 2.6.3 2.5. Anpassung der PostgreSQL-Konfiguration 2.5.1. ZeichensÃ¤tze/die Verwendung von Unicode/UTF-8 2.5.2. Ãnderungen an Konfigurationsdateien 2.5.3. Erweiterung fÃ¼r servergespeicherte Prozeduren 2.5.4. Erweiterung fÃ¼r Trigram Prozeduren 2.5.5. Datenbankbenutzer anlegen 2.6. Webserver-Konfiguration 2.6.1. Grundkonfiguration mittels CGI 2.6.2. Konfiguration fÃ¼r FastCGI/FCGI 2.6.3. Authentifizierung mittels HTTP Basic Authentication 2.6.4. Aktivierung von mod_rewrite/directory_match fÃ¼r git basierte Installationen 2.6.5. Weitergehende Konfiguration 2.7. Der Task-Server 2.7.1. VerfÃ¼gbare und notwendige Konfigurationsoptionen 2.7.2. Konfiguration der Mandanten fÃ¼r den Task-Server 2.7.3. Automatisches Starten des Task-Servers beim Booten 2.7.4. Wie der Task-Server gestartet und beendet wird 2.7.5. Exemplarische Konfiguration eines Hintergrund-Jobs, der die Jahreszahl in allen Nummernkreisen zum Jahreswechsel erhÃ¶ht 2.8. Benutzerauthentifizierung und Administratorpasswort 2.8.1. Grundlagen zur Benutzerauthentifizierung 2.8.2. Administratorpasswort 2.8.3. Authentifizierungsdatenbank 2.8.4. PasswortÃ¼berprÃ¼fung 2.8.5. Name des Session-Cookies 2.8.6. Anlegen der Authentifizierungsdatenbank 2.9. Mandanten-, Benutzer- und Gruppenverwaltung 2.9.1. ZusammenhÃ¤nge 2.9.2. Mandanten, Benutzer und Gruppen 2.9.3. Datenbanken anlegen 2.9.4. Gruppen anlegen 2.9.5. Benutzer anlegen 2.9.6. Mandanten anlegen 2.10. Drucker- und Systemverwaltung 2.10.1. Druckeradministration 2.10.2. System sperren / entsperren 2.11. E-Mail-Versand aus kivitendo heraus 2.11.1. Versand Ã¼ber lokalen E-Mail-Server 2.11.2. Versand Ã¼ber einen SMTP-Server 2.12. Drucken mit kivitendo 2.12.1. Vorlagenverzeichnis anlegen 2.12.2. Der Druckvorlagensatz RB 2.12.3. f-tex 2.12.4. Der Druckvorlagensatz rev-odt 2.12.5. Allgemeine Hinweise zu LaTeX Vorlagen 2.13. OpenDocument-Vorlagen 2.13.1. OpenDocument (odt) Druckvorlagen mit Makros 2.14. Nomenklatur 2.14.1. Datum bei Buchungen 2.15. Konfiguration zur EinnahmenÃ¼berschussrechnung/Bilanzierung: + Entwicklung