Workflow-Aktivität „Timer“

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 5 Minuten Lesedauer
  • Die Aktivität Timer hält den Workflow für einen bestimmten Zeitraum an.

    Diese Dauer kann ein absoluter Zeitwert oder ein relativer Wert basierend auf einer definierten sein Zeitpläne werden erstellt und verwendet . Es empfiehlt sich, die Dauer so anzupassen, dass der Workflow zeitnah ablaufen kann. Wie Sie einen Workflow auf unbestimmte Zeit anhalten, bis eine Bedingung erfüllt ist, wird unter Auf Bedingung warten beschrieben.
    Hinweis:
    Timer-Aktivitäten werden als Systembenutzer ausgeführt, da der System-Scheduler den Workflow fortführt.

    Ergebnisse

    Tabelle : 1. Ergebnisse der Aktivität „Timer“
    Ergebnis Beschreibung
    Abgeschlossen Die Aktivität hat die angegebene Dauer erfolgreich erreicht.
    Abgebrochen Die Aktivität oder der Workflow wurde abgebrochen, bevor der Timer die angegebene Dauer erreicht hat.

    Eingabevariablen

    Eingabevariablen bestimmen das anfängliche Verhalten der Aktivität.

    Tabelle : 2. Eingabevariablen der Aktivität „Timer“
    Feld Beschreibung
    Timer-Informationen
    Timer basierend auf Methode zur Berechnung der Zeitdauer. Die Optionen sind:
    • Eine benutzerdefinierte Dauer: Die Dauer basiert auf den Dauer-Feldern, wie z. B. Tage und Stunden.
    • Eine relative Dauer: Die Dauer basiert auf den Feldern Relative Dauer (z. B. Ende des nächsten Geschäftstags) und Warten.
    • Ein Feld für Datum/Uhrzeit oder Dauer: Die Dauer basiert auf dem Wert Feld und dem Feld Warten.
    • Skript: Die Dauer basiert auf einem Skript, das die Anzahl von Sekunden zurückgibt.
    Dauer

    Wird nur angezeigt, wenn Timer basierend auf auf Eine benutzerdefinierte Dauer festgelegt ist.

    Die bestimmte Anzahl von Tagen und Stunden, die gewartet werden muss, bevor mit der nächsten Aktivität im Workflow fortgefahren wird.
    Relative Dauer

    Wird nur angezeigt, wenn Timer basierend auf auf Eine relative Dauer festgelegt ist.

    Die allgemeine Anzahl und Länge der Geschäftstage, die gewartet werden muss, bevor mit der nächsten Workflow-Aktivität fortgefahren wird.
    Warten

    Wird nur angezeigt, wenn Timer basierend auf auf Eine relative Dauer oder Ein Feld für Datum/Uhrzeit oder Dauer festgelegt ist.

    Eine zusätzliche Timer-Anpassung, wenn Timer basierend auf auf Eine relative Dauer oder Ein Feld für Datum/Uhrzeit oder Dauer festgelegt ist. Die Optionen sind:
    • Die gesamte Dauer: Keine Änderung der berechneten Dauer.
    • Ein % der Dauer: Die Dauer wird durch Multiplikation der Anzahl von Sekunden mit dem ( Prozentsatz / 100) angepasst.
    • Einige Zeit früher: Die Dauer wird um die Tage und Stunden für Zeit davor verkürzt.
    • Einige Zeit später: Die Dauer wird um die Tage und Stunden für Zeit danach verlängert.
    Prozentsatz

    Wird nur angezeigt, wenn Timer basierend auf auf Eine relative Dauer oder Ein Feld für Datum/Uhrzeit oder Dauer festgelegt ist.

    Der Prozentwert für Warten, wenn Timer basierend auf auf Eine relative Dauer oder Ein Feld für Datum/Uhrzeit oder Dauer festgelegt ist.
    Zeit davor

    Wird nur angezeigt, wenn Timer basierend auf auf Eine relative Dauer oder Ein Feld für Datum/Uhrzeit oder Dauer und Warten auf Einige Zeit früher festgelegt ist.

    Der Modifikator-Zeitwert, wenn Warten auf Einige Zeit früher festgelegt ist.
    Zeit danach

    Wird nur angezeigt, wenn Timer basierend auf auf Eine relative Dauer oder Ein Feld für Datum/Uhrzeit oder Dauer und Warten auf Einige Zeit später festgelegt ist.

    Der Modifikator-Zeitwert, wenn Warten auf Einige Zeit später festgelegt ist.
    Feld

    Wird nur angezeigt, wenn Timer basierend auf auf Ein Feld für Datum/Uhrzeit oder Dauer oder festgelegt ist.

    Das Datums-/Uhrzeit- oder Dauerfeld, das die verstrichene Wartezeit enthält, bevor zur nächsten Workflow-Aktivität gewechselt wird.
    Skript

    Wird nur angezeigt, wenn Timer basierend auf auf Skript festgelegt ist.

    Das Skript, das 'answer' auf die Anzahl der Sekunden für die Dauer setzt.
    Timer-Zeitplan
    Zeitplan basierend auf Der grundlegende Zeitplan, nach dem der Timer Arbeitsstunden zählt. Wenn ein Zeitplan bereitgestellt wird, wird die Dauer nur für Zeiten berücksichtigt, die im Zeitplan angegeben sind. Wenn die Dauer beispielsweise 2 Stunden beträgt und der Workflow in einem Zeitplan von 8:00 Uhr bis 17:00 Uhr um 16:00 Uhr beginnt, endet er am nächsten Tag um 9:00 Uhr. Die Optionen sind:
    • Zeitplan dieses Workflows: Der Zeitplan verwendet Datum und Uhrzeit des Workflow-Kontexts und einen optionalen Wert für Zeitzone basiert auf.
    • Ein bestimmter Zeitplan: Der Zeitplan verwendet einen vordefinierten Zeitplan und einen optionalen Wert für Zeitzone basiert auf .
    • Ein Zeitplanfeld: Der Zeitplan verwendet einen Wert aus einer Tabelle und einen optionalen Wert für Zeitzone basiert auf.
    Zeitplan

    Wird nur angezeigt, wenn Zeitplan basierend auf auf Ein bestimmter Zeitplan festgelegt ist.

    Der vordefinierte Zeitplan aus einer Liste.
    Zeitplanfeld

    Wird nur angezeigt, wenn Zeitplan basierend auf auf Ein Zeitplanfeld festgelegt ist.

    Ein Datums- und Uhrzeit- oder Dauerfeld für den Zeitplan, das der Tabelle zugeordnet ist. Gültige Felder werden im Dialogfeld „Element aus der Struktur auswählen“ in Blau angezeigt.
    Timer-Zeitzone
    Zeitzone basiert auf Die Zeitzone für die Berechnung der Dauer. Die Zeitzone kann auf Folgendem basieren:
    • Keine Zeitzone: Standardeinstellung. Der Workflow verwendet die GMT-Zeitzone.
    • Eine bestimmte Zeitzone: Eine vordefinierte Zeitzone.
    • Ein Zeitzonenfeld: Ein Zeitzonenfeld, um die Zeitdauer von einem Feld im Formular zu verfolgen.
    Zeitzone

    Wird nur angezeigt, wenn Zeitzone basiert auf auf Eine bestimmte Zeitzone festgelegt ist.

    Die vordefinierte Zeitzone.
    Zeitzonenfeld

    Wird nur angezeigt, wenn Zeitzone basiert auf auf Ein Zeitzonenfeld festgelegt ist.

    Ein Datums- und Uhrzeit- oder Dauerfeld für den Zeitplan, das der Tabelle zugeordnet ist. Gültige Felder werden im Dialogfeld „Element aus der Struktur auswählen“ in Blau angezeigt.

    Status

    Der Aktivitätsstatus teilt der Workflow-Engine mit, wie mit der Aktivität verfahren werden soll.

    Tabelle : 3. Status der Aktivität „Timer“
    Status Beschreibung
    Wird ausgeführt Die Aktivität Timer befindet sich während des Initialisierens nur sehr kurz in diesem Status und wechselt sofort zu Warten.
    Warten Die Workflow-Engine wartet, bis der Timer die angegebene Dauer erreicht. Die Engine überführt den Workflow dann zur nächsten Aktivität.
    Fertig Die Ausführung der Aktivität ist abgeschlossen. Der Ergebniswert gibt das Ergebnis der Aktivität an.
    Abgebrochen Diese Aktivität oder der Workflow, der diese Aktivität enthält, wurde abgebrochen.
    Fehler Ein JavaScript-Fehler ist aufgetreten. Überprüfen Sie die Protokolle auf Fehlerdetails.

    Beispiel

    Sie können eine Timer-Aktivität verwenden, um den Workflow bis zum Ende des Geschäftstags anzuhalten.

    Abbildung : 1. Timer-Beispiel

    In diesem Beispiel wertet das Skript die Zeit zwischen der Variablen now und der Variablen eod aus. Die Variable eod ist im 24-Stunden-Format als 4:00 PM (16:00 Uhr) definiert. Das Skript legt dann die Variable answer auf die Differenz zwischen diesen Variablen in Sekunden fest und protokolliert eine Nachricht.

    // get now and calc end of day (4:00pm)
     
    var now =new Date();
     
    var eod =new Date();
    eod.setHours(16);
    eod.setMinutes(0);
    eod.setSeconds(0);
     
    answer =(eod.getTime()- now.getTime())/1000;
     
    workflow.debug('Timer will fire @: '+ eod +'  '+(answer/60)+' minutes from now');