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.