Einrichtung von Scheduler Services

Allgemeines

Ein Job der Klasse SchedulerRegisterService wird periodisch ausgeführt. Es kann als CRON-Job oder als DELAY-Job angelegt werden. Beispiele sind die DeleteJobs.

Einrichtung

Konfiguration Service

Einrichten eines SCHEDULER-Service mit ID und Name je nach Job, der eingerichtet werden soll:

ServiceDelete1

Als Service-Klasse muss org.b2bbp.service.inbound.scheduled.SchedulerRegisterService angegeben werden.

Konfiguration Service-Properties

Die folgenden Service-Properties müssen für jeden SchedulerRegisterService eingerichtet werden. Bei keiner dieser Properties wird der Nachrichtenkontext überschrieben!

Die folgenden B3P_CRON_<Wert>-Angaben haben einen Default-Wert von -1. Das heißt, dass der Job jede Minute/Stunde/Tag/… ausgeführt wird!
Sollte also keine dieser Properties gesetzt werden, wird der CRON-Job jede Minute ausgeführt! In allen CRON-Properties (außer für das Jahr) können kommasepariert mehrere Werte angegeben werden.

Allgemeine Konfiguration

Mit den folgenden Eigenschaften wird die generelle Konfiguration des Service vorgenommen.

Name der Eigenschaft erlaubte Werte Beschreibung
B3P_SCHEDULER_REGISTER_CLASSNAME Java-Klassenbezeichnung Name der Java-Klasse, die den Service implementiert
B3P_SCHEDULER_NAME Beliebiger Text Name der im Monitor angezeigt wird nachdem der Job ausgeführt wurde. (optional)
B3P_SCHEDULER_TYPE CRON oder DELAY Art der wiederholten Ausführung. Je nach Wahl müssen die Properties B3P_CRON_<Wert> oder B3P_DELAY_<Wert> gesetzt werden. (1) (Pflichtfeld)
B3P_DELAY_MINUTES Ganze positive Zahl Anzahl der Minuten, die bis zum Ausführen gewartet wird und nach denen der Job erneut ausgeführt wird. (Pflichtfeld)
B3P_DELAY_REPEAT Boolean Wert (true oder false) Angabe, ob der Job nach einmaligem Lauf wiederholt werden soll oder nicht. Default: false

(1) Falls die Property B3P_SCHEDULER_TYPE nicht gesetzt ist, wird automatisch ein Default gewählt: falls die Property B3P_DELAY_MINUTES gesetzt ist, wird als Scheduler Type DELAY gesetzt. Sonst wird CRON gesetzt.

Konfiguration der Laufzeit

Mit den folgenden Eigenschaften werden die Zeitpunkte konfiguriert, zu welchen der Job laufen soll.

Name der Eigenschaft erlaubte Werte Beschreibung
B3P_CRON_HOURS_MINUTES hh:mm Uhrzeit, zu der der Job ausgeführt wird. Kann alternativ zu B3P_CRON_HOURS & B3P_CRON_MINUTES genutzt werden.
B3P_CRON_MINUTES Ganze Zahl von 0-59 Minute, in der der Job ausgeführt wird.
Die Eingabe mehrerer Werte ist kommasepariert anzugeben
B3P_CRON_HOURS Ganze Zahl von 0-23 Stunde, in der der Job ausgeführt wird.
Die Eingabe mehrerer Werte ist kommasepariert anzugeben
B3P_CRON_DAYS_OF_MONTH Ganze Zahl von 1-31 Tag im Monat, an dem der Job ausgeführt wird.
Die Eingabe mehrerer Werte ist kommasepariert anzugeben
B3P_CRON_MONTH Ganze Zahl von 0-11 Monat, in dem der Job ausgeführt wird (0=Jan, 1=Feb, …).
Die Eingabe mehrerer Werte ist kommasepariert anzugeben
B3P_CRON_DAYS_OF_WEEK Ganze Zahl von 1-7 Wochentag, an dem Job ausgeführt wird (1=Sonntag, 2=Montag, …).
Die Eingabe mehrerer Werte ist kommasepariert anzugeben
B3P_CRON_YEAR Ganze Zahl Jahr der Ausführung (Default -1 führt zur Ausführung in jedem Jahr)
B3P_FACTORY_CALENDAR_EXTNAME Name der Extension des Werkskalenders Verweis auf eine Extension, welche Wochentage und spezielle Daten von der Ausführung des Jobs ausschließt. Kann nur mit CRON-Jobs genutzt werden.

Der Scheduler-Service läuft also zum Beispiel einmal täglich, wenn nur die beiden Properties B3P_CRON_HOURS und B3P_CRON_MINUTES gesetzt werden (24-Stunden-Angaben verwenden).

Ausführung

Alle Details zu weiteren nötigen Service Properties sind in den Dokumentationen zu den einzelnen Jobs zu finden.

Abschließend muss der Service einem Knoten zugeordnet werden (der Global Property NODE_<x> hinzufügen) und die Services oder der entsprechende Application Server neugestartet werden.

Damit ist der Job aktiv. Der CRON-Job wird zum gewünschten Zeitpunkt ausgeführt, der DELAY-Job wartet die in B3P_DELAY_MINUTES konfigurierte Zeit, bevor er zum ersten Mal ausgeführt wird.

 

 

Tags: b2b
View Me   Edit Me