--- sourceDocument: Yokohama Now Plattformverwaltung sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/platform-administration Release : - yokohama ft:locale : - de-DE ft:publication_title : - Yokohama Now Plattformverwaltung ft:clusterId : - platadm bundleId : - platadm workflow : - Platform --- # Automatisch ein Skript Ihrer Wahl ausführen # Automatisch ein Skript Ihrer Wahl ausführen {#ariaid-title1} * Freigeben Version: Yokohama * * Aktualisiert 30. Januar 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 Minuten Lesedauer Planen Sie sowohl bedingte als auch nicht bedingte Skripts. Wenn Domänentrennung in der Instanz installiert ist, können Sie Skripts auch basierend auf den zugewiesenen Domänen auswählen, filtern, sortieren und planen. ## Vorbereitungen Erforderliche Rollen: administrator ## Warum und wann dieser Vorgang ausgeführt wird Das folgende ist ein Beispiel für ein bedingtes Skript. Die geplante Aufgabe wird nur ausgeführt, wenn aktive Incidents vorhanden sind, die älter als 30 Tage sind. // Only run this Scheduled Job if there are active Incidents over 30 days old var ga = new GlideAggregate('incident'); ga.addAggregate('COUNT'); ga.addQuery('active', 'true'); ga.addQuery('sys_created_on', '<', gs.daysAgo(30)); ga.query(); ga.next(); ga.getAggregate('COUNT') !== '0' ## Prozedur 1. Navigieren zu AlleSystemdefinitionGeplante Aufgabenan. 2. Klicken Sie auf Neu. 3. Wählen Sie Aus Führen Sie automatisch ein Skript Ihrer Wahl aus . 4. Füllen Sie im Formular die Felder aus. {#t_ScheduleAScriptExecution__t_ScheduleScriptExecution__entry__2} | Feld | Beschreibung | |-|-| | Name | Name, der diese geplante Aufgabe identifiziert. | | Aktiv | Option, die angibt, dass die geplante Aufgabe aktiv ist und zum angegebenen Zeitpunkt ausgeführt werden soll. | | Anwendung | Name der Anwendung, die das Skript enthält. Global Wird angezeigt, wenn sich das Skript im globalen Bereich befindet. | | Bedingt | Option zum Aktivieren der Ausführung der geplanten Aufgabe, wenn bestimmte Bedingungen im zugehörigen Skript erfüllt sind. | | Bedingung | Bedingtes Skript, das bestimmt, ob eine geplante Aufgabe ausgeführt werden soll. Der letzte Ausdruck des Skripts sollte als boolescher Wert (wahr/falsch) ausgewertet werden. Dieses Textfeld wird nur angezeigt, wenn Sie auswählen Bedingungen verwenden . Warnung: Bedingte Skripts für geplante Berichts-E-Mails und Performance AnalyticsDatensammlungsaufträge werden in der Sandbox ausgeführt. Daher sind Funktionsdefinitionen nicht zulässig. Einige API-Aufrufe und Stichwörter sind ebenfalls nicht zulässig. Weitere Informationen finden Sie unter [Skript-Sandbox-Eigenschaft](https://www.servicenow.com/docs/access?context=r_ScriptSandboxing&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). Nach dem Upgrade werden Aufträge mit bedingten Skripts, die diese unzulässigen API-Komponenten enthalten, mit Fehlern abgeschlossen. | | Ausführen | Zeitintervall, das für die Ausführung der geplanten Aufgabe verwendet werden soll: * Täglich : Wird täglich zu einer bestimmten Zeit ausgeführt. * Wöchentlich : Wird wöchentlich zu einer festgelegten Uhrzeit und einem bestimmten Wochentag ausgeführt. * Monatlich : Wird monatlich zu einer bestimmten Uhrzeit und einem bestimmten Tag des Monats ausgeführt. * Regelmäßig : Wird in einem festgelegten Wiederholungsintervall ausgeführt. * Einmal : Wird nur für ein einzelnes Vorkommen ausgeführt. * Bei Bedarf : Wird sofort bei Bedarf ausgeführt. * Geschäftskalender: Eintragsbeginn : Wird an den Starteintragsdaten für den Geschäftskalender ausgeführt, den Sie in auswählen Geschäftskalender Feld. Eine geplante Aufgabe wird für das Startdatum jedes der Geschäftseinträge ausgeführt, die Sie für den Geschäftskalender definiert haben. Wenn der Geschäftskalender beispielsweise ein Geschäftsjahr darstellt und das Startdatum jedes Eintrags ein Geschäftsmonat ist, wird die geplante Aufgabe am ersten Tag jedes Monats ausgeführt. {#t_ScheduleAScriptExecution__p_nyg_nfg_h1c} * Geschäftskalender: Eintragsende : Wird für das Enddatum des Geschäftskalenders ausgeführt, den Sie in auswählen Geschäftskalender Feld. Diese Auswahl wird auf die gleiche Weise ausgeführt wie Geschäftskalender: Eintragsbeginn , Aber für die Enddaten der zugehörigen Geschäftskalendereinträge. Hinweis: Wenn Sie auswählen Geschäftskalender: Eintragsbeginn Oder Geschäftskalender: Eintragsende , Sie können einen Offsetfaktor anwenden, um die Ausführung des Auftrags vor oder nach der Zeitspanne des ausgewählten Geschäftskalenders zu planen. Wenn Sie einen Geschäftskalender auswählen und sich alle Geschäftskalenderbereiche in der Vergangenheit befinden, wird der Auftrag nie ausgeführt, da dies eine ungültige Konfiguration ist. Weitere Informationen finden Sie unter Offset-Typ Und Offset Felder. Weitere Informationen zum Erstellen und Verwenden von Geschäftskalendern und zum Definieren von Geschäftskalendereinträgen finden Sie unter [Geschäftskalender werden erstellt](https://servicenow-prod.fluidtopics.net/Imh4a4ZsFfoYFFzA4Qkqqw "Erstellen Sie Geschäftskalender in Now PlatformDamit Sie Ereignisse für Ihre Anwender planen und ihre Zeit anwendungsübergreifend nachverfolgen können. Sie definieren Zeitpläne und Kalender aller Typen, einschließlich Geschäftskalender, im Menü „Geschäftskalender“.")Und [Definieren Sie Geschäftskalendereinträge](https://servicenow-prod.fluidtopics.net/BLb1TX4CHW85mKKCYzfg9g#define-business-calendar-entries "Erstellen Sie Geschäftskalendereintragsdatensätze, die die einzelnen Zeiträume definieren, aus denen ein Geschäftskalender besteht. Sie erstellen einen Geschäftskalendereintrag für jede einzelne Zeitspanne im Kalender."). {#t_ScheduleAScriptExecution__ul-run-sched-job} | | Tag | Tag, an dem die geplante Aufgabe ausgeführt werden soll. * Wenn Ausführen Ist auf festgelegt Wöchentlich , Wählen Sie den Wochentag aus. Wählen Sie beispielsweise Mittwoch aus. * Wenn Ausführen Ist auf festgelegt Monatlich , Wählen Sie den Tag des Monats aus. Wählen Sie beispielsweise 25 für den 25. Tag des Monats aus. {#t_ScheduleAScriptExecution__ul-day-sched-job}Dieses Feld wird nur angezeigt, wenn Sie auswählen Monatlich Oder Wöchentlich In Ausführen Feld. | | Wiederholungsintervall | Dauer des Wiederholungsintervalls für jede geplante Auftragsausführung. Geben Sie die Dauer in Tagen, Stunden oder Minuten ein. Zum Beispiel: * Um die geplante Aufgabe alle vier Tage auszuführen, geben Sie ein 04 In Tage Feld. * Um sie alle 26 Stunden auszuführen, geben Sie ein 26 In Stunden Feld. * Wenn sie in einem Intervall von 13:30:25 wiederholt werden soll, geben Sie die Eingabetaste ein 13 In Stunden Und geben Sie dann ein 30 Und 25 In den zwei nicht bezeichneten Feldern danach. {#t_ScheduleAScriptExecution__ul_bmk_m2b_njb} | | Zeitzone | Zeitzone, die mit verwendet werden soll Zeit Feldeintrag, wenn Sie den Zeitpunkt angeben, zu dem die geplante Aufgabe ausgeführt werden soll. Wählen Sie einen Zeitzoneneintrag aus: * -Keine- : Verwenden Sie die Standardzeitzone für den angemeldeten Anwender, der die geplante Aufgabe erstellt. Beispiel: Die geplante Aufgabe wird um 16:45 Uhr (US/Pazifik-Zeit) ausgeführt, wenn es sich um die zugewiesene Zeitzone des Anwenders handelt, und Sie geben ein 16:45 In Zeit Feld. {#t_ScheduleAScriptExecution__p_qyg_nfg_h1c} * Verwenden Sie Die Systemzeitzone : Verwenden Sie die Standardsystemzeitzone, die für die Instanz angegeben ist, in der sie ausgeführt wird. Beispiel: Die geplante Aufgabe wird um 22:15 Uhr Londoner Zeit ausgeführt, wenn Europa/London die Standardsystemzeitzone für die Instanz ist und Sie eingeben 22:15 In Zeit Feld. {#t_ScheduleAScriptExecution__p_ryg_nfg_h1c} * Tatsächliche Zeitzone. Beispiel: Die geplante Aufgabe wird um 13:30 Uhr in der Zeitzone „Osten" der USA ausgeführt, wenn Sie auswählen USA/Osten , Und Eingabetaste 13:30 Uhr In Zeit Feld. {#t_ScheduleAScriptExecution__p_syg_nfg_h1c} {#t_ScheduleAScriptExecution__ul_zxv_cnb_njb} | | Zeit | Uhrzeit, zu der die geplante Aufgabe ausgeführt werden soll, ausgedrückt in Stunden, Minuten und Sekunden auf 24-Stunden-Uhr. Die Auswahl, die Sie in treffen Zeitzone Feld bestimmt die Zeitzone für diesen Eintrag. | | Tag | Tag, an dem die geplante Aufgabe ausgeführt werden soll. * Wenn Ausführen Ist auf festgelegt Wöchentlich , Wählen Sie den Wochentag aus. Wählen Sie beispielsweise Mittwoch aus. * Wenn Ausführen Ist auf festgelegt Monatlich , Wählen Sie den Tag des Monats aus. Wählen Sie beispielsweise 25 für den 25. Tag des Monats aus. {#t_ScheduleAScriptExecution__d1959e231}Dieses Feld wird nur angezeigt, wenn Sie auswählen Monatlich Oder Wöchentlich In Ausführen Feld. | | Wiederholungsintervall | Dauer des Wiederholungsintervalls für jede geplante Auftragsausführung. Geben Sie die Dauer in Tagen, Stunden oder Minuten ein. Zum Beispiel: * Um die geplante Aufgabe alle vier Tage auszuführen, geben Sie ein 04 In Tage Feld. * Um sie alle 26 Stunden auszuführen, geben Sie ein 26 In Stunden Feld. * Wenn sie in einem Intervall von 13:30:25 wiederholt werden soll, geben Sie die Eingabetaste ein 13 In Stunden Und geben Sie dann ein 30 Und 25 In den zwei nicht bezeichneten Feldern danach. {#t_ScheduleAScriptExecution__d1959e272} | | Wird gestartet | Datum und Uhrzeit der ersten Generierung geplanter Aufgaben. Wählen Sie Datum und Uhrzeit des Kalenders aus. Dieses Feld wird nur angezeigt, wenn Sie auswählen Regelmäßig In Ausführen Feld. | | Geschäftskalender | Geschäftskalendereintrag, den Sie verwenden, um das Start- oder Enddatum des Geschäftskalenders für die geplante Aufgabe zu bestimmen. Dieses Feld wird nur angezeigt, wenn Sie auswählen Geschäftseintrag: Startdatum Oder Geschäftseintrag: Enddatum In Zeit Feld. | | Offsettyp | Typ des Zeitversatzes, falls vorhanden, der auf den Geschäftskalender angewendet werden soll, den Sie für die Planung dieses Auftrags ausgewählt haben: * Vergangen : Anwenden Sie einen Offsetfaktor, um die Ausführung des Auftrags vor dem Beginn der Zeitspanne des ausgewählten Geschäftskalenders zu planen. * Zukunft : Anwenden Sie einen Offsetfaktor, um die Ausführung des Auftrags nach dem Ende der Zeitspanne des ausgewählten Geschäftskalenders zu planen. * --Keine-- : Wenden Sie bei der Planung dieser Aufgabe keinen Zeitversatz an. {#t_ScheduleAScriptExecution__ul_dfj_ptw_5lb}Durch das Hinzufügen eines Offsetfaktors können Sie die Ausführung des Auftrags vor oder nach der offiziellen Zeitspanne planen, die im Geschäftskalender für die folgenden Anwendungsfälle definiert ist: | | Offset | Zeit-Offset, ausgedrückt in Tagen, Stunden, Minuten und Sekunden, zum Anwenden auf den Geschäftskalender, den Sie für die Planung dieses Auftrags ausgewählt haben. Wenn Sie beispielsweise planen möchten, dass der Auftrag drei Tage, 14 Stunden, 10 Minuten und 45 Sekunden vor dem Startdatum des Geschäftskalenders startet, führen Sie die folgenden Aktionen aus: * Wählen Sie Aus Vergangen In Offset-Typ Feld. * Eingabetaste 3 In Tage Feld. * Eingabetaste 14 , 10 , Und 45 In Stunden Feld. {#t_ScheduleAScriptExecution__ul_aty_1ww_5lb} Die Offset-Tage Und Stunden Felder werden nur angezeigt, wenn Sie auswählen Geschäftskalender: Eintragsbeginn Oder Geschäftskalender: Eintragsende In Ausführen Feld, und Vergangen Oder Zukunft In Offset-Typ Feld. | | Ausführen als \[optional\] | Wählen Sie einen anderen Anwender aus, als den die Skriptausführung ausgeführt werden soll. Konfigurieren Sie das Formular, um dieses Feld hinzuzufügen, falls es nicht vorhanden ist. | | Dieses Skript ausführen | Name des Skripts, das zum geplanten Datum und zur geplanten Uhrzeit ausgeführt werden soll. Kopieren Sie beispielsweise die Skriptlogik aus einer Business-Regel, oder rufen Sie eine Skripteinbindung auf. | [Tabelle : 1. Skriptausführung planen] {#t_ScheduleAScriptExecution__t_ScheduleScriptExecution} 5. Wenn die Domänentrennung in dieser Instanz installiert ist, werden auch die folgenden Felder zum Auswählen, Sortieren und Planen von Aufgaben nach Domäne angezeigt. Hinweis: Das Plugin Domänenunterstützung -- Installationsprogramm für Domänenerweiterungen installiert diese Felder. Weitere Informationen finden Sie unter [Domänentrennung anfordern](https://www.servicenow.com/docs/access?context=t_ActivateDomainSeparation&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). {#t_ScheduleAScriptExecution__table_m2n_yyf_tlb__entry__2} | Feld | Beschreibung | |-|-| | Domäneniterator | Kontrollkästchen, mit dem dieser Auftrag über mehrere Domänen hinweg ausgeführt werden kann. Wenn ausgewählt, wird Domänenquelltabelle Und Domänenquellfilter Felder werden angezeigt. | | Domänenquelltabelle | Name der domänengetrennten Tabelle, die die Quelle der Domänen ist, in denen die geplante Aufgabe ausgeführt werden soll. Wählen Sie beispielsweise aus Abteilung (cmn_Department) Wenn Sie es als Quelle der zugewiesenen Domänen verwenden möchten, die zum Planen von Skripts verwendet werden. Die geplante Aufgabe bestimmt diese Domänen aus dem Feld „sys_Domain" der Quelltabellendatensätze. Weitere Informationen finden Sie unter [Domänenzuweisung](https://www.servicenow.com/docs/access?context=c_DomainAssignment&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). Hinweis: Es ist eine gute Idee, eine domänengetrennte Tabelle zu erstellen, die ausschließlich Beschaffungsdomänen gewidmet ist, es sei denn, Sie haben einen Anwendungsfall, der die Verwendung einer vorhandenen Tabelle rechtfertigt. Wenn Sie eine neue erstellen, wählen Sie sie einfach mit diesem Feld aus. | | Domänenquellfilter | Optionale Bedingung, die Sie angeben können, um die abgefragten Datensätze aus der ausgewählten Domänenquelltabelle zu filtern. 1. Wählen Sie das Feld aus, das zum Filtern von Datensätzen verwendet werden soll. 2. Fügen Sie Filterbedingungen und Operatoren hinzu, um die Domänenauswahlkriterien einzugrenzen. Weitere Informationen finden Sie unter [Filter](https://www.servicenow.com/docs/access?context=c_Filters&version=yokohama&pubname=yokohama-platform-user-interface&ft:locale=en-US). {#t_ScheduleAScriptExecution__ol_tbc_fck_vlb} | [ ] {#t_ScheduleAScriptExecution__table_m2n_yyf_tlb} Die folgende Verarbeitung erfolgt beim Planen eines Auftrags in einer domänengetrennten Instanz: * Fragt zuerst die ausgewählte Domänenquelltabelle ab. * Wenn Sie eine Bedingung in angegeben haben Domänenquellfilter Feld angewendet wird die Filterbedingung, um den resultierenden Satz von Datensätzen einzugrenzen. * Schließlich ruft es die Liste der eindeutigen Domänen aus den sys_Domain-Spalten dieser Datensätze ab. {#t_ScheduleAScriptExecution__ul_wnp_kff_vlb} 6. Klicken Sie Auf Aktualisieren So aktualisieren Sie die geplante Aufgabe: Jetzt Ausführen Um das geplante Skript sofort auszuführen, oder Löschen Um den Auftrag zu löschen. **Zugehörige Tasks** * [Geplante Aufgaben erstellen](https://servicenow-prod.fluidtopics.net/yVFA0E45psywuGQt~VS7fA "Erstellen Sie eine geplante Aufgabe in der Tabelle „Auftrag planen“ [sysauto].") * [Personalisieren Sie das Systemdatumsformat](https://servicenow-prod.fluidtopics.net/31qzkLREz2sNgqDCFxixow "Sie können das Format personalisieren, in dem Datumswerte in Ihrer Instanz angezeigt werden.") * [Legen Sie eine Systemzeitzone fest](https://servicenow-prod.fluidtopics.net/Duum4Mwz9ysJoO3f7LN3oA "Legen Sie Ihre Systemzeitzone mit einer Systemeigenschaft fest.") **Zugehörige Informationen** * [Domänentrennung für Service Provider](https://www.servicenow.com/docs/access?context=domain-sep-landing-page&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US)