Zeitgesteuerte Events MOD009DA6

Einstieg

• Customizer → System-Customizer → Events → Zeitgesteuerte Events

Zeitgesteuerte Events sind programmierbare Events, die unabhängig von Speichervorgängen und sonstigen Aktivitäten zu bestimmten Zeiten ausgeführt werden. Mehr zu Events

Informationen

• In diesem Modul werden zeitgesteuerte Events angelegt und bearbeitet.
• Ebenfalls kann der Event-Verlauf eingesehen werden.

Modulaufbau und -funktionen

Informationen

• Jedes Event wird mitsamt seiner Daten in einem Kasten angezeigt.
• Auf der linken Seite des Kastens werden allgemeine Eventinformationen angezeigt, die teilweise bearbeitet werden können.
• Auf der rechten Seite werden die Intervalleinstellungen des Events angezeigt.
• Ganz rechts stehen Schaltflächen zur Verfügung:
  • konfigurieren - Über diese Schaltfläche wird das Modul Benutzerdefiniertes Intervall konfigurieren geöffnet, in dem ein benutzerdefiniertes Wiederholungsintervall für ein Event konfiguriert wird.
  • Verlauf - Über diese Schaltfläche wird das Modul Event-Verlauf geöffnet, das die Historien-Datensätze eines Events enthält.
  • Löschen - Mit dieser Schaltfläche wird ein Event gelöscht.
  • Ausführen - Mit dieser Schaltfläche wird ein Event manuell einmalig ausgeführt. Hierzu werden Status, Wiederholungsart und Startzeit geändert sowie die Event-Historie dieses Events gelöscht.

Event-Einstellungen

Informationen

• In der Listbox Funktionstyp wird die Sprache bzw. die Methode des Events hinterlegt.
  • Die Listbox erlaubt die Einträge Java, Jython und Python, aktuell werden für zeitgesteuerte Events aber nur Java- und Jython-Funktionen unterstützt.
• Im Feld Funktionsname wird der volle Name der auszuführenden (statischen) Klassenmethode einschließlich Pfad hinterlegt.
• In das Feld Parameter kann ein frei definierbarer String für die auszuführende Methode eingetragen werden.
• Im Feld Status wird der Zustand des Events hinterlegt und vom System automatisch angepasst. 
  • Folgende Status-Werte werden für zeitgesteuerte Events verwendet:
    • 0: Wartend
      • Das Event ist derzeit terminiert, zu einem späteren Zeitpunkt zu laufen. 
      • Diesen Status erhält ein Event bei seiner Erstellung.
    • 1: Wird ausgeführt
      • Die dem Event zugeordnete Funktion läuft derzeit.
    • 2: Beendet
      • Das Event wurde ohne Fehler beendet und wird nicht erneut ausgeführt.
    • 3: Fehlgeschlagen
      • Bei der letzten Ausführung trat ein Fehler auf. Das Event wird nach Server-Neustart erneut ausgeführt.
  •  Eine manuelle Änderung des Status hat keinen Einfluss darauf, ob ein Event erneut ausgeführt wird oder nicht. Die Ausführung hängt nur von dem Parameter Aktiviert sowie den Intervalleinstellungen des Events ab.
• Der Parameter Aktiviert bestimmt, ob das Event ausgeführt () oder ignoriert wird ().
  • Ein Event wird nur ausgeführt, wenn in der Checkbox Aktiviert das Häkchen gesetzt ist.
• Unterhalb der bearbeitbaren Eventeinstellungen werden Informationen zur nächsten Startzeit, der letzten Ausführung und der Anzahl der erfolgten Ausführungen angezeigt.
• Nach der letzten Ausführung wird eine Ampel angezeigt, die entweder eine erfolgreiche (grüne Scheibe) oder eine fehlerhafte (rote Scheibe) Ausführung kennzeichnet.

Intervalleinstellungen

Informationen

• Die Intervalleinstellungen bestehen standardmäßig aus den Feldern Tag, Uhrzeit und Wiederholt sich .
  • Tag und Uhrzeit bestimmen den erstmaligen Startzeitpunkt des Events.
  • In der Listbox Wiederholt sich wird angegeben, ob und wie häufig das Event wiederholt werden soll. Folgende Einträge stehen zur Auswahl:

• Benutzerdefinierte Intervall-Einstellungen werden nur angezeigt, wenn im Feld Wiederholt sich die Einstellung Benutzerdefiniert ausgewählt ist. Es handelt sich um Ausgabefelder (ausgegraut), die in diesem Modul nicht bearbeitet werden können.
  • Um die benutzerdefinierten Intervall-Einstellungen zu bearbeiten, die Schaltfläche konfigurieren betätigen. Das Modul Benutzerdefiniertes Intervall konfigurieren erscheint, in dem die Änderungen vorgenommen werden können.
  • Änderungen, die im Modul Benutzerdefiniertes Intervall konfigurieren gemacht werden, werden unmittelbar in die Ausgabefelder des Event-Datensatzes übernommen.

Ein zeitgesteuertes Event anlegen

Vorgehensweise

• Im Modul Zeitgesteuerte Events einen neuen Event-Datensatz einfügen.
• Funktionstyp und Funktionsnamen vergeben.
  • Aktuell werden für zeitgesteuerte Events nur die Funktionstypen Jython und Java unterstützt.
• Optional einen Eintrag im Feld Parameter vornehmen.
• Tag und Uhrzeit der erstmaligen Ausführung des Events eingeben.
• Im Feld Wiederholt sich  aus der Listbox auswählen, wie häufig das Event ausgeführt werden soll.
  • Wenn die Wiederholung des Events genauer konfiguriert werden soll:
    • Den Eintrag Benutzerdefiniert auswählen.
    • Speichern.
    • Mit Klick auf die Schaltfläche konfigurieren das Modul Benutzerdefiniertes Intervall konfigurieren aufrufen.
      • Unter der Überschrift Wiederholt sich alle eine Zahl und eine Einheit eingeben, um den Abstand zwischen den Wiederholungen des Events festzulegen.
      • Unter der Überschrift Wiederholt sich am optional die Checkboxen der Wochentage aktivieren, um die Ausführung des Events auf bestimmte Tage zu beschränken.
        • An den Wochentagen der aktivierten Checkboxen darf das Event durchgeführt werden.
      • Unter der Überschrift Endet festlegen, wann das Event beendet werden soll, d. h. wann die Wiederholungen des Events eingestellt werden.
        • Standardmäßig ist die Checkbox Endet nie aktiviert.
        • Wenn das Event an einem bestimmten Datum beendet werden soll, die Checkbox Endet am aktivieren und das Datum hinterlegen.
        • Wenn das Event nach einer bestimmten Anzahl an Ausführungen beendet werden soll, die Checkbox Endet nach aktivieren und die Anzahl der gewünschten Ausführungen hinterlegen.
• Wenn das Event direkt aktiv sein soll, das Häkchen in der Checkbox Aktiviert setzen.
  • Ein Event wird nur ausgeführt, wenn in der Checkbox Aktiviert das Häkchen gesetzt ist.
• Speichern.

Details

• Um ein benutzerdefiniertes Intervall zu bearbeiten, die Schaltfläche konfigurieren betätigen und im Modul Benutzerdefiniertes Intervall konfigurieren die Änderungen vornehmen.

Standard-Events

Folgende Events stellt PLANTA standardmäßig zur Verfügung:

Hinweis

• Generell sind die Events standardmäßig ausgeschaltet und können bei Bedarf durch Aktivieren der Checkbox Aktiviert eingeschaltet werden. Einige Events werden automatisch eingeschaltet, wenn die zugrundeliegende Funktion aktiviert wird.
• Für alle Events (ausgenommen Automatische E-Mails bei Ressourcenanfragen verschicken) muss der Clientless-Session-Benutzer im Feld Parameter festgelegt werden. Im PLANTA-Standard ist es PLSYSTEM.