X-Git-Url: http://wagnertech.de/git?a=blobdiff_plain;f=doc%2Fdokumentation.xml;h=d68cfe683943e8be288784d0831a8bc43f662b0b;hb=cf0455f57e7fe398b59a3c4a01f459d16b9db419;hp=6917944bb66c8e61a858b15352eb234615570aa0;hpb=e725668550139cf352547e8eb9c5fa3108f78b42;p=kivitendo-erp.git diff --git a/doc/dokumentation.xml b/doc/dokumentation.xml index 6917944bb..d68cfe683 100644 --- a/doc/dokumentation.xml +++ b/doc/dokumentation.xml @@ -2,7 +2,7 @@ - kivitendo 3.5.4: Installation, Konfiguration, + <title>kivitendo 3.5.5: Installation, Konfiguration, Entwicklung @@ -13,7 +13,7 @@ im Community-Forum: https://forum.kivitendo.de:32443 + url="https://forum.kivitendo.de">https://forum.kivitendo.de @@ -1480,7 +1480,7 @@ systemctl enable kivitendo-task-server.service status berichtet, ob der Task-Server läuft. - + yy Der Task-Server wechselt beim Starten automatisch in das @@ -1493,8 +1493,59 @@ systemctl enable kivitendo-task-server.service so startet dieser nach Beendigung automatisch erneut. - + + Exemplarische Konfiguration eines Hintergrund-Jobs, der die Jahreszahl in allen Nummernkreisen zum Jahreswechsel erhöht + Hintergrund-Jobs werden über System -> Hintergrund-Jobs und Task-Server -> Aktuelle Hintergrund-Jobs anzeigen -> Aktions-Knopf 'erfassen' angelegt. + Nachdem wir über das Menü dort angelangt sind, legen wir unseren exemplarischen Hintergrund-Jobs "Erhöhung der Nummernkreise" mit folgenden Werten an: + + + Aktiv: Hier ein 'Ja' auswählen + + + Ausführungsart: 'wiederholte Ausführung' auswählen + + + Paketname: 'SetNumberRange' auswählen + + + Ausführungszeitplan: Hier entsprechend Werte wie in der crontab eingeben.Syntax: +* * * * * +┬ ┬ ┬ ┬ ┬ +│ │ │ │ │ +│ │ │ │ └──── Wochentag (0-7, Sonntag ist 0 oder 7) +│ │ │ └────── Monat (1-12) +│ │ └──────── Tag (1-31) +│ └────────── Stunde (0-23) +└──────────── Minute (0-59) + Die Sterne können folgende Werte haben: + +1 2 3 4 5 + +1 = Minute (0-59) +2 = Stunde (0-23) +3 = Tag (0-31) +4 = Monat (1-12) +5 = Wochentag (0-7, Sonntag ist 0 oder 7) + +Um die Ausführung auf eine Minute vor Sylvester zu setzen, müssen die folgenden Werte eingetragen werden: +59 23 31 12 * + + + Daten:In diesem Feld können optionale Parameter für den Hintergrund im JSON-Format gesetzt werden. Der Hintergrund-Job SetNumberRange akzeptiert zwei Variable nämlich digit_year sowieso multiplier. digit_year kann zwei Werte haben entweder 2 oder 4, darüber wird gesteuert ob die Jahreszahl zwei oder vierstellig kodiert wird (für 2019, dann entweder 19 oder 2019). Der Standardwert ist vierstellig. multiplier ist ein Vielfaches von 10, darüber wird die erste Nummer im Nummernkreis (die Anzahl der Stellen) wie folgt bestimmt: + +multiplier Nummernkreis 2020 +10 -> 20200 +100 -> 202000 +1000 -> 2020000 + +Wir gehen jetzt beispielhaft von einer letzten Rechnungsnummer von RE2019456 aus. Demnach sollte ab Januar 2020 die erste Nummer RE2020001 sein. Da der Task auch Präfixe berücksichtigt, kann dies mit folgenden JSON-kodierten Werten umgesetzt werden: +Daten:multiplier: 100 +digits_year: 4 + + + + Benutzerauthentifizierung und Administratorpasswort @@ -1514,9 +1565,8 @@ systemctl enable kivitendo-task-server.service Datenbank, in der sowohl die Benutzerinformationen als auch die Daten abgelegt werden. - Zusätzlich ermöglicht es kivitendo, dass die Benutzerpasswörter - entweder gegen die Authentifizierungsdatenbank oder gegen einen - LDAP-Server überprüft werden. + Zusätzlich ermöglicht es kivitendo, dass die Benutzerpasswörter gegen die Authentifizierungsdatenbank oder gegen einen oder + mehrere LDAP-Server überprüft werden. Welche Art der Passwortüberprüfung kivitendo benutzt und wie kivitendo die Authentifizierungsdatenbank erreichen kann, wird in der @@ -1599,22 +1649,28 @@ systemctl enable kivitendo-task-server.service Passwortüberprüfung kivitendo unterstützt Passwortüberprüfung auf zwei Arten: gegen - die Authentifizierungsdatenbank und gegen einen externen LDAP- oder + die Authentifizierungsdatenbank und gegen externe LDAP- oder Active-Directory-Server. Welche davon benutzt wird, regelt der Parameter module im Abschnitt [authentication]. - Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank - gespeichert werden, so muss der Parameter module - den Wert DB enthalten. In diesem Fall können sowohl - der Administrator als auch die Benutzer selber ihre Passwörter in - kivitendo ändern. + Dieser Parameter listet die zu verwendenden Authentifizierungsmodule auf. Es muss mindestens ein Modul angegeben werden, es + können aber auch mehrere angegeben werden. Weiterhin ist es möglich, das LDAP-Modul mehrfach zu verwenden und für jede Verwendung + eine unterschiedliche Konfiguration zu nutzen, z.B. um einen Fallback-Server anzugeben, der benutzt wird, sofern der Hauptserver + nicht erreichbar ist. + + Sollen die Benutzerpasswörter in der Authentifizierungsdatenbank geprüft werden, so muss der Parameter + module das Modul DB enthalten. Sofern das Modul in der Liste enthalten ist, egal an welcher + Position, können sowohl der Administrator als auch die Benutzer selber ihre Passwörter in kivitendo ändern. + + Wenn Passwörter gegen einen oder mehrere externe LDAP- oder Active-Directory-Server geprüft werden, so muss der Parameter + module den Wert LDAP enthalten. In diesem Fall müssen zusätzliche Informationen über den + LDAP-Server im Abschnitt [authentication/ldap] angegeben werden. Das Modul kann auch mehrfach angegeben werden, + wobei jedes Modul eine eigene Konfiguration bekommen sollte. Der Name der Konfiguration wird dabei mit einem Doppelpunkt getrennt an + den Modulnamen angehängt (LDAP:Name-der-Konfiguration). Der entsprechende Abschnitt in der Konfigurationsdatei + lautet dann [authentication/Name-der-Konfiguration]. - Soll hingegen ein externer LDAP- oder Active-Directory-Server - benutzt werden, so muss der Parameter module auf - LDAP gesetzt werden. In diesem Fall müssen - zusätzliche Informationen über den LDAP-Server im Abschnitt - [authentication/ldap] angegeben werden: + Die verfügbaren Parameter für die LDAP-Konfiguration lauten: @@ -1645,6 +1701,17 @@ systemctl enable kivitendo-task-server.service + + verify + + + Wenn Verbindungsverschlüsselung gewünscht und der Parameter tls gesetzt ist, so gibt dieser + Parameter an, ob das Serverzertifikat auf Gültigkeit geprüft wird. Mögliche Werte sind require (Zertifikat + wird überprüft und muss gültig sei; dies ist der Standard) und none (Zertifikat wird nicht + überpfüft). + + + attribute @@ -1694,6 +1761,14 @@ systemctl enable kivitendo-task-server.service also ‘Martin Mustermann’. + + + timeout + + + Timeout beim Verbindungsversuch, bevor der Server als nicht erreichbar gilt; Standardwert: 10 + +