--- sourceDocument: Xanadu-Build-Workflows sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/build-workflows Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-Build-Workflows ft:clusterId : - crworkflow bundleId : - crworkflow workflow : - Creator --- # Workflow-Aktivität „Timer" # Workflow-Aktivität „Timer" {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer Die Aktivität Timer hält den Workflow für einen bestimmten Zeitraum an.{#r_Timer__wf-timer-activity-shortdesc} Diese Dauer kann ein absoluter Zeitwert oder ein relativer Wert sein, der auf einem definierten [Zeitplan für das Erstellen und Verwenden](https://www.servicenow.com/docs/access?context=c_UseSchedules&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US)von basiert. 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](https://www.servicenow.com/docs/access?context=r_WaitForCondition&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) beschrieben. Hinweis: Timer-Aktivitäten werden als Systembenutzer ausgeführt, da der System-Scheduler den Workflow fortführt. ## Ergebnisse {#r_Timer__table_b1r_fgd_lq__entry__2} | 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. | [Tabelle : 1. Ergebnisse der Aktivität „Timer"] {#r_Timer__table_b1r_fgd_lq} ## Eingabevariablen Eingabevariablen bestimmen das anfängliche Verhalten der Aktivität. {#r_Timer__table_dl4_ngd_lq__entry__2} | 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. {#r_Timer__ul_ebm_sgd_lq} | | 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. {#r_Timer__ul_q3v_chd_lq} | | 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. {#r_Timer__ul_wys_qhd_lq} | | 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. {#r_Timer__ul_hmv_vhd_lq} | | 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. | [Tabelle : 2. Eingabevariablen der Aktivität „Timer"] {#r_Timer__table_dl4_ngd_lq} ## Status Der Aktivitätsstatus teilt der Workflow-Engine mit, wie mit der Aktivität verfahren werden soll. {#r_Timer__table_qts_d3d_lq__entry__2} | 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. | [Tabelle : 3. Status der Aktivität „Timer"] {#r_Timer__table_qts_d3d_lq} ## 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');