Zeitsteuerung

Mit der Zeitsteuerung kann man bestimmte Abläufe zeitlich steuern. Bisher wurde ein einfacher Timer benutzt, mit dem Start- und Endzeit und die Intervalle einstellen konnte. Ab Version 2.6.1. ist ein neuer Timer eingebunden, mit dem dann auch solche Zeiten wie z.B. "jeden Freitag um neun Uhr" oder "jeden Wochentag um 9.30 Uhr" oder sogar "alle 5 Minuten zwischen 9.00 und 10.00 Uhr an jedem Montag, Mittwoch und Freitag im Januar" möglich sind.

ab Version 2.6.1 - Cron Trigger

Cron Trigger sind oft besser geeignet als SimpleTrigger, wenn man zu wiederkehrenden Zeiten Jobs starten will, im Gegensatz zu exakt angegebenen Zeitintervallen beim Simple Trigger. Mit dem Cron Trigger kann man Startzeiten festlegen wie z.B. "jeden Freitag um neun Uhr" oder "jeden Wochentag um 9.30 Uhr" oder sogar "alle 5 Minuten zwischen 9.00 und 10.00 Uhr an jedem Montag, Mittwoch und Freitag im Januar". Der Cron Trigger hat aber auch analog dem Simple Trigger eine Startzeit und Endzeit, die den Einsatz des Triggers steuert.

Mode

Modus	Bedeutung
Ausführlich	Zeiträume werden über bestimmte Felder ausgewählt
Expert	Zeiträume werden mit Cron-Expressions im Feld "Cron-Trigger" angegeben

Stunde

Innerhalb welcher Stunde(n)?

Auswahl:

Option	Bedeutung
jede	innerhalb jeder Stunde
Zahl auswählen	innerhalb der ausgewählten Stunde, z.B. 0 → von 0:00 bis 0:59
zyklisch	alle 2, 4, … Stunden starten (für je eine Stunde)
Eingabe	spezielle Angaben mit Cron-Expressions

Werte (Cron-Expression):

Zeichen	Bedeutung
*	wie Auswahl "jede"
0 … 23	wie "Zahl auswählen"
,	mehrere Stunden, z.B. 3,7,10: Stunde 3, 7 und 10
-	Zeitraum, z.B. 10-20: ab Stunde 10 bis einschließlich 20
/	Inkremente, z.B. 0/2: Start Stunde 0, alle 2 Stunden; 3/3: Start Stunde 3, alle 3 Stunden

Minute

Zu welcher Minute innerhalb der Stunden bzw. alle wie viele Minuten innerhalb der Stunden?

Auswahl:

Option	Bedeutung
jede	startet jede Minute innerhalb der Stunde
Zahl auswählen	z.B. Start zur Minute 15 innerhalb der Stunde
zyklisch	alle 2, 5, … Minuten starten
Eingabe	spezielle Angaben mit Cron-Expressions

Werte (Cron-Expression):

Zeichen	Bedeutung
*	wie Auswahl "jede"
0 … 59	wie "Zahl auswählen"
/	Inkremente, z.B. 0/10: Start Minute 0, alle 10 Minuten; 30/2: Start Minute 30, alle 2 Minuten
,	mehrere Werte, z.B. 2,20,45: Minute 2, 20 und 45
-	Zeitraum, z.B. 10-20: ab Minute 10 bis Minute 20, jede Minute

Tag

Innerhalb welchen Tages im Monat?

Auswahl:

Option	Bedeutung
jeden	innerhalb jeden Tages im Monat
Zahl auswählen	innerhalb des ausgewählten Tages im Monat
Eingabe	spezielle Angaben mit Cron-Expressions

Werte (Cron-Expression):

Zeichen	Bedeutung
*	wie Auswahl "jeden"
1 … 31	wie "Zahl auswählen"
,	mehrere Tage, z.B. 13,14,19: 13., 14. und 19. Tag im Monat
-	Zeitraum, z.B. 5-10: 5. bis einschließlich 10. Tag im Monat
/	Inkremente, z.B. 1/4: Start Tag 1, alle 4 Tage; 3/3: Start Tag 3, alle 3 Tage
L	letzter Tag im Monat (egal ob 28., 30. oder 31.), z.B. L-2: vorvorletzter Tag im Monat
W	nächster Wochentag zum angegebenen Tag, z.B. 13W: ist der 13. ein Samstag → Freitag, ist er ein Sonntag → Montag
?	kein spezieller Wert (Platzhalter)

Monat

Innerhalb welchen Monats?

Auswahl:

Option	Bedeutung
jeden	jeden Monat
Zahl auswählen	in welchem Monat aktiv?
Eingabe	spezielle Angaben mit Cron-Expressions

Werte (Cron-Expression):

Zeichen	Bedeutung
*	wie Auswahl "jeden"
1 … 12 bzw. JAN … DEC	wie Auswahl einer Zahl
,	mehrere Werte, z.B. FEB,OCT: Februar und Oktober

Wochentag

Innerhalb welchen Wochentages?

Auswahl:

Option	Bedeutung
jeden	Timer startet täglich
Mo–Fr	Timer startet innerhalb dieses Tages
Eingabe	spezielle Angaben mit Cron-Expressions

Werte (Cron-Expression):

Zeichen	Bedeutung
*	wie Auswahl "jeden"
1 … 7 bzw. SUN … SAT	wie "Zahl auswählen" (1 = Sonntag)
,	mehrere Wochentage, z.B. MON,FRI: montags und freitags
-	Zeitraum, z.B. MON-FRI: "wochentags"
L	allein: letzter Tag (Sonnabend); mit Wochentagszahl: letzter x-Tag im Monat, z.B. 6L: letzter Freitag im Monat
?	kein spezieller Wert (Platzhalter)
/	Inkremente, z.B. 1/2: alle zwei (Wochen-)Tage mit Start am Sonntag
#	der wievielte Wochentag im Monat, z.B. 2#1: erster Montag im Monat (auch MON#1)

Jahr

Innerhalb welchen Jahres?

Auswahl:

Option	Bedeutung
jedes	in jedem Jahr
Eingabe	individuelle Jahre angeben

Wechselwirkungen

Wochentag und Tag

z.B. Wochentag "Mo" und Tag "4": jeden Montag, der ein 4. des Monats ist (Monat muss dann auf "jeder" stehen)

Monat und Tag

z.B. Monat "jeden" und Tag "31": an jedem 31. des Monats — also nur in Monaten mit 31 Tagen (Tag: "jeder")

Monat, Tag und Wochentag

z.B. Monat "9", Wochentag "Fr" und Tag "13": startet nur, wenn der September einen Freitag den 13. hat

Das Ganze lässt sich noch mit dem Jahr koppeln, ist aber m.E. nicht sinnvoll.

Aktion

Auswahl eines Timer-Actions (siehe unten unter "aktuelle Timerklassen").

Steuerparameter

siehe unten unter "aktuelle Timerklassen" unter der jeweiligen Klasse

Cron-Expressions

Cron-Expressions werden verwendet, um eine Instanz eines Cron-Triggers zu konfigurieren. Sie sind Strings aus 7 Einzelwerten, die die individuellen Einzelheiten des Ablaufplans beschreiben. Die Werte werden mit Leerzeichen getrennt und repräsentieren:

0 0 5 * * ? *
┬ ┬ ┬ ┬ ┬ ┬ ┬
│ │ │ │ │ │ └── Jahr (optional)
│ │ │ │ │ └──── Wochentag (1-7) (Sonntag=1)
│ │ │ │ └────── Monat (1-12)
│ │ │ └──────── Tag (1-31)
│ │ └────────── Stunde (0-23)
│ └──────────── Minute (0-59)
└────────────── Sekunde (0-59, meist 0)

Die zu verwendenden Werte stehen oben unter dem jeweiligen Feld (Tag, Monat usw.).

Beispiele:

Expression	Bedeutung
0 0 12 ? * WED	jeden Mittwoch um 12:00 Uhr
0 0/5 * * * ?	alle 5 Minuten (beginnend mit Minute 0)
0 30 10-13 ? * WED,FRI	um 10:30, 11:30, 12:30 und 13:30, jeden Mittwoch und Freitag
0 0/30 8-9 5,20 * ?	halbstündlich zwischen 8 und 10 Uhr am 5. und 20. jeden Monats (8:00, 8:30, 9:00, 9:30 — aber nicht 10:00)

Manche Startzeiten sind zu komplex für einen einzigen Ausdruck, z.B. alle 5 Minuten zwischen 9:00 und 10:00 Uhr und alle 20 Minuten zwischen 1:00 und 10:00 Uhr. Das lässt sich nur mit zwei Timern abbilden.

in alten Versionen

TimerTaskKlassen

veraltet (nicht mehr benutzen)

• com.batix.timer.ContainerDeActivatorTask (aktiviert/deeaktiviert alte Containerdatensätze wenn Datum herangekommen ist)
• com.batix.timer.ContainerRemoveTask (löscht alte Containerdatensätze wenn Datum herangekommen ist)
• com.batix.timer.DetailDeactivatorTask (bx:schleife deaktiviert einzelne Schleifen-Datensätze)
• com.batix.timer.NavDeActivatorTask (aktiviert/deeaktiviert Navigationspunkte zu bestimmten Zeitpunkt)
• com.batix.timer.NewsArchiver (altes Newssmodul; verschiebt alte News ins Archiv)

aktuelle Timerklassen

com.batix.timer.ContainerImportTimer

aktualisiert einen neuen Container mit Daten von einem anderen System

Steuerparameter:

Parameter	Beschreibung
container-id=125DA0FBA30	Container intern
extern-id=10EA47412E6	Container extern
extern-host=https://www.externer-server.de	Hostname des externen Systems
img-kat=125A1311768	Bildergaleriekategorie für importierte Bilder
doc-kat=125A2CE1376	Bildergalerieordner für importierte Dokumente
flag=html	Editorfelder mit importieren

---

com.batix.timer.UserReactivation

aktiviert gesperrte User, wenn sie 3x falsches Passwort eingegeben hatten

---

com.batix.timer.VisitorStatTimer

verkürzt Userstatistik

Steuerparameter:

Parameter	Beschreibung
days-to-keep=60

---

com.batix.timer.URLConnectionTimer

ruft URL auf (für gewöhnlich ein Action)

Steuerparameter:

Parameter	Beschreibung
url=http://www.dein-web.de/aktionen/testaktion.act	ruft ein Aktion auf
max-redirects=30	Anzahl der Redirekts (optional, Standard 5)
username=… / password=…	Zugangsdaten für den Aufruf (Basic-Auth)
post=true	Aufruf per POST statt GET
read-timeout=… / connect-timeout=…	Sekunden bis zum Abbruch der Anfrage (die Aktion läuft serverseitig evtl. trotzdem weiter)
reportemail=Email-Adresse	Serverantwort als Report an diese Adressen schicken (mehrere mit ;), wenn der HTTP-Code nicht 200 ist oder die Antwort das Zeichenlimit erreicht
reportemail-from=Absender-Adresse	Absender des Reports (Standard: die reportemail-Adresse)
reportemail-cc=Email-Adresse	CC-Empfänger des Reports
reportemail-characterlimit=0	Mindestanzahl Zeichen der Antwort, ab der der Report auch bei HTTP 200 verschickt wird
smtp-connection=ID oder Bezeichnung	SMTP-Zugang für den Report (ab v3.3.4): Alias aus der special.xml oder ID bzw. Bezeichnung eines Mailkontos des Mandanten (Verwaltung → SMTP-Zugänge). Ohne Angabe wird der default-Zugang der special.xml verwendet; nur wenn es keinen gibt, das einzige Mailkonto des Mandanten. Im Docker-Image ist immer ein default-Zugang (localhost, Platzhalter) eingetragen, dort muss der Parameter gesetzt werden, sonst schlägt der Versand fehl

---

com.batix.search.CrawlerTask

Keywords: Web indizieren, Indizierung, Crawler

Steuerparameter:

Parameter	Beschreibung
sleeptime=500	Pause in Millisekunden zwischen zwei Seitenabrufen (Standard 500), entlastet den Server
quickmode=true	Index nicht komplett neu aufbauen, nur geänderte Seiten neu einlesen (If-Modified-Since)
force=true	Mehrfachstarts am selben Tag zulassen (Standard: höchstens einmal täglich)
max-pdf-size=30	Maximale Größe in MB einer PDF-Datei, die noch geparst und indiziert wird; größere werden nur auf Erreichbarkeit geprüft (Standard 30, 0 = ohne Limit)
username=… / password=…	Zugangsdaten, wenn ein geschützter Bereich gecrawlt werden soll
entry-point=/unterpfad/start.htm	Startseite des Crawls (Standard: Startseite des Projekts)
search-area=/unterpfad	Pfad, innerhalb dessen ausschließlich gecrawlt wird (nur zusammen mit entry-point)
extern-link-check=true	nach dem Indizieren die gefundenen externen Links prüfen, der HTTP-Code kommt in den Report
report-to=Email-Adresse	Report über fehlerhafte Seiten (404 usw.) an diese Adressen (mehrere mit ;), nur wenn Fehler auftraten. Sonderwerte console und livelog schreiben den Report statt per Mail in die Konsole bzw. ins Livelog
report-from=Absender-Adresse	Absender des Reports. Seit v2.8.0 Pflicht: ohne report-from wird keine Mail verschickt
smtp-connection=ID oder Bezeichnung	SMTP-Zugang für den Report (ab v3.3.4): Alias aus der special.xml oder ID bzw. Bezeichnung eines Mailkontos des Mandanten (Verwaltung → SMTP-Zugänge). Ohne Angabe wird der default-Zugang der special.xml verwendet; nur wenn es keinen gibt, das einzige Mailkonto des Mandanten (bei mehreren Konten Fehler im Log). Im Docker-Image ist immer ein default-Zugang (localhost, Platzhalter) eingetragen, dort muss der Parameter gesetzt werden, sonst schlägt der Versand fehl

Um auch Actions zu indizieren (z.B. Weiterleitungen usw. - wenn man sicher ist, daß nix gelöscht wird) kann man im Action in die Metadaten accept-crawler=true eintragen.