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)
com.batix.search.CrawlerTask
Keywords: Web indizieren, Indizierung, Crawler
Steuerparameter:
Parameter
Beschreibung
sleeptime=500
report-to=Email-Adresse
liefert einen Report über die Seiten, die beim indizieren 404 zurückgeliefert haben, an die angegebene E-Mail-Adresse, ab 2.6.1 RC15
report-from=Absender-Adresse
wenn report-from fehlt, wird noreply@batix.info verwendet
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.