Automatisch ein Skript Ihrer Wahl ausführen

Freigeben Version: Washingtondc

Aktualisiert 1. Februar 2024

8 Minuten Lesedauer

Planen Sie sowohl bedingte als auch nicht bedingte Skripts. Wenn Domain Separation in der Instanz installiert ist, können Sie Skripts auch basierend auf den ihnen zugewiesenen Domänen auswählen, filtern, sortieren und planen.

Vorbereitungen

Erforderliche Rolle: admin

Warum und wann dieser Vorgang ausgeführt wird

Das folgende Beispiel zeigt 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

Navigieren zu Alle > Systemdefinition > Geplante Aufgaben.
Klicken Sie auf Neu.
Wählen Sie Automatisch ein Skript Ihrer Wahl ausführen aus.

Füllen Sie die Felder des Formulars aus.

Tabelle : 1. Planen Sie die Skriptausführung
Feld	Beschreibung
Name	Name, der diese geplante Aufgabe identifiziert
Aktiv	Option, die angibt, dass die geplante Aufgabe aktiv ist und zum angegebenen Datum und zur angegebenen Uhrzeit ausgeführt werden soll
Applikation	Name der Anwendung, die das Skript enthält. Global wird angezeigt, wenn das Skript zum globalen Umfang gehört.
Bedingt	Option zum Aktivieren der Ausführung der geplanten Aufgabe, wenn bestimmte Bedingungen im zugehörigen Skript erfüllt sind
Bedingung	Bedingtes Skript, mit dem festgelegt wird, ob eine geplante Aufgabe ausgeführt werden soll. Der letzte Ausdruck des Skripts muss einen booleschen Wert (true/false) ergeben. Dieses Textfeld wird nur angezeigt, wenn Sie Bedingungen verwendenauswählen. Warnung: Bedingte Skripts für geplante Berichts-E-Mails und Performance Analytics Datenerfassungsaufgaben 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. Nach dem Upgrade werden Aufträge mit bedingten Skripts, die diese unzulässigen API-Komponenten enthalten, mit Fehlern beendet.
Run-Kosten	Zeitintervall für die Ausführung der geplanten Aufgabe: Täglich: Wird täglich zu einem bestimmten Zeitpunkt ausgeführt Wöchentlich: Wird wöchentlich zu einer bestimmten Uhrzeit und an einem bestimmten Wochentag ausgeführt Monatlich: Wird auf monatlicher Basis zu einer vorgegebenen Uhrzeit und an einem vorgegebenen Tag im Monat ausgeführt Regelmäßig: Wird in einem vorgegebenen, sich wiederholenden Intervall ausgeführt Einmal: Wird nur für ein einzelnes Vorkommen ausgeführt Bei Bedarf: Wird bei Bedarf sofort ausgeführt Geschäftskalender: Eintragsbeginn: Wird am Eintragsbeginndatum für den Geschäftskalender ausgeführt, den Sie im Feld Geschäftskalender auswählen. Eine regelmäßige Aufgabe wird für das Startdatum aller 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 Beginndatum jedes Eintrags ein Geschäftsmonat ist, wird die geplante Aufgabe am ersten Tag jedes Monats ausgeführt. Geschäftskalender: Eintragsende: Wird am Enddatum für den Geschäftskalender ausgeführt, den Sie im Feld Geschäftskalender auswählen. Diese Auswahl wird auf dieselbe Weise ausgeführt wie Geschäftskalender: Eintragsbeginn, jedoch für die Enddaten der zugehörigen Geschäftskalendereinträge. Hinweis: Wenn Sie Geschäftskalender: Eintragsbeginn oder Geschäftskalender: Eintragsende auswählen, können Sie einen Offset-Faktor anwenden, um die Ausführung der Aufgabe vor oder nach der Zeitspanne des ausgewählten Geschäftskalenders zu planen. Weitere Informationen finden Sie in den Feldern Offsettyp und Offset. Weitere Informationen zum Erstellen und Verwenden von Geschäftskalendern und zum Definieren von Geschäftskalendereinträgen finden Sie unter Erstellen von Geschäftskalendern und Definieren Sie Geschäftskalendereinträge.
Tag	Tag, an dem die geplante Aufgabe ausgeführt werden soll Wenn für Ausführen die Option Wöchentlich festgelegt ist, geben Sie den Wochentag an. Wählen Sie zum Beispiel „Mittwoch“ aus. Wenn Ausführen auf Monatlich eingestellt ist, wählen Sie den Tag im Monat. Wählen Sie beispielsweise 25 für den 25. Tag des Monats aus. Dieses Feld wird nur angezeigt, wenn Sie im Feld Ausführen die Option Monatlich oder Wöchentlich auswählen.
Wiederholungsintervall	Dauer des Wiederholungsintervalls für jede geplante Aufgabenausführung. Geben Sie die Dauer in Tagen, Stunden oder Minuten ein. Beispiel: Um die regelmäßige Aufgabe alle vier Tage auszuführen, geben Sie in das Feld Tage den Wert `04` ein. Um sie alle 26 Stunden auszuführen, geben Sie in das Feld Stunden den Wert `26` ein. Wenn die regelmäßige Aufgabe in einem Intervall von 13:30:25 wiederholt werden soll, geben Sie in das Feld Stunden den Wert `13` ein. Geben Sie anschließend in die beiden nachstehenden unbeschrifteten Felder die Werte `30` und `25` ein.
Zeitzone	Zeitzone, die mit dem Eintrag im Feld Zeit verwendet werden soll, wenn Sie die Uhrzeit angeben, zu der die regelmäßige Aufgabe ausgeführt werden soll. Wählen Sie einen Zeitzoneneintrag aus: -Keine-: Verwenden Sie die Standardzeitzone für den angemeldeten Benutzer, der die regelmäßige Aufgabe erstellt. Die geplante Aufgabe wird beispielsweise um 16:45 Uhr US-Pazifik-Zeit ausgeführt, wenn es sich um die für den Benutzer zugewiesene Zeitzone handelt und wenn Sie `16:45` in das Feld Zeit eingeben. Zeitzone des Systems verwenden: Verwenden Sie die standardmäßige Systemzeitzone, die für die Instanz angegeben ist, in der sie ausgeführt wird. Die regelmäßige Aufgabe wird beispielsweise um 22:15 Uhr Londoner Zeit ausgeführt, wenn Europa/London die standardmäßige Systemzeitzone für die Instanz ist und Sie `22:15` in das Feld Zeit eingeben. Tatsächliche Zeitzone. Beispiel: Die regelmäßige Aufgabe wird um 13:30 Uhr in der Zeitzone USA/Osten ausgeführt, wenn Sie USA/Osten auswählen und `13:30` in das Feld Zeit eingeben.
Zeit	Uhrzeit, zu der die geplante Aufgabe ausgeführt werden soll, ausgedrückt in Stunden, Minuten und Sekunden im 24-Stunden-Format. Mit der Auswahl, die Sie im Feld Zeitzone treffen, wird die Zeitzone für diesen Eintrag festgelegt.
Tag	Tag, an dem die geplante Aufgabe ausgeführt werden soll Wenn für Ausführen die Option Wöchentlich festgelegt ist, geben Sie den Wochentag an. Wählen Sie zum Beispiel „Mittwoch“ aus. Wenn Ausführen auf Monatlich eingestellt ist, wählen Sie den Tag im Monat. Wählen Sie beispielsweise 25 für den 25. Tag des Monats aus. Dieses Feld wird nur angezeigt, wenn Sie im Feld Ausführen die Option Monatlich oder Wöchentlich auswählen.
Wiederholungsintervall	Dauer des Wiederholungsintervalls für jede geplante Aufgabenausführung. Geben Sie die Dauer in Tagen, Stunden oder Minuten ein. Beispiel: Um die regelmäßige Aufgabe alle vier Tage auszuführen, geben Sie in das Feld Tage den Wert `04` ein. Um sie alle 26 Stunden auszuführen, geben Sie in das Feld Stunden den Wert `26` ein. Wenn die regelmäßige Aufgabe in einem Intervall von 13:30:25 wiederholt werden soll, geben Sie in das Feld Stunden den Wert `13` ein. Geben Sie anschließend in die beiden nachstehenden unbeschrifteten Felder die Werte `30` und `25` ein.
Wird gestartet	Datum und Uhrzeit der ersten Erstellung einer geplanten Aufgabe. Wählen Sie Datum und Uhrzeit des Kalenders aus. Dieses Feld wird nur angezeigt, wenn Sie im Feld Ausführen die Option Regelmäßig auswählen.
Geschäftskalender	Geschäftskalendereintrag, den Sie verwenden, um das Start- oder Enddatum des Geschäftskalenders für die regelmäßige Aufgabe zu bestimmen. Dieses Feld wird nur angezeigt, wenn Sie im Feld Zeit die Option Business Entry: Start Date (Geschäftseintrag: Startdatum) oder Business Entry: End Date (Geschäftseintrag: Enddatum) auswählen.
Offsettyp	Typ des Zeitversatzes, der auf den Geschäftskalender angewendet werden soll, den Sie für die Planung dieser Aufgabe ausgewählt haben: Vergangenheit: Wenden Sie einen Offset-Faktor an, um die Ausführung der Aufgabe vor dem Beginn der Zeitspanne des ausgewählten Geschäftskalenders zu planen. Zukunft: Wenden Sie einen Offset-Faktor an, um die Ausführung der Aufgabe nach dem Ende der Zeitspanne des ausgewählten Geschäftskalenders zu planen. --Keiner--: Wenden Sie beim Planen dieser Aufgabe keinen Zeitversatz an. Durch das Hinzufügen eines Offset-Faktors können Sie die Ausführung der Aufgabe so planen, dass sie vor oder nach der im Geschäftskalender definierten offiziellen Zeitspanne für die folgenden Anwendungsfälle ausgeführt wird:
Offset	Zeitversatz (in Tagen, Stunden, Minuten und Sekunden), der auf den Geschäftskalender angewendet werden soll, den Sie für die Planung dieser Aufgabe ausgewählt haben. Wenn Sie beispielsweise so planen möchten, dass die Aufgabe drei Tage, 14 Stunden, 10 Minuten und 45 Sekunden vor dem Startdatum des Geschäftskalenders beginnt, gehen Sie folgendermaßen vor: Wählen Sie im Feld Offsettyp die Option Vergangenheit aus. Geben Sie in das Feld Tage den Wert 3 ein. Geben Sie in das Feld Stunden die Werte 14, 10 und 45 ein. Die Felder Offset Days (Offset-Tage) und Stunden werden nur angezeigt, wenn Sie im Feld Ausführen die Option Geschäftskalender: Eintragsbeginn oder Geschäftskalender: Eintragsende auswählen und im Feld Offsettyp die Option Vergangenheit oder Zukunft auswählen.
Ausführen als [optional]	Wählen Sie einen anderen Benutzer aus, unter dem 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 am geplanten Datum und zur geplanten Uhrzeit ausgeführt werden soll. Kopieren Sie beispielsweise die Skriptlogik aus einer Business Rule, oder rufen Sie eine Skripteinbindung auf.

Wenn in dieser Instanz Domänentrennung installiert ist, werden die folgenden Felder auch zum Auswählen, Sortieren und Planen von Aufgaben nach Domäne angezeigt.

Hinweis:

Das Plugin „Domain Support – Domain Extensions Installer“ installiert die folgenden Felder. Weitere Informationen finden Sie unter Domänentrennung anfordern.


Feld	Beschreibung
Domäneniterator	Kontrollkästchen, mit dem dieser Auftrag in mehreren Domänen ausgeführt werden kann. Wenn diese Option ausgewählt ist, werden die Felder Domänenquelltabelle und Domänenquellfilter 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 Abteilung (cmn_department) aus, wenn Sie sie als Quelle der zugewiesenen Domänen verwenden möchten, die zum Planen von Skripts verwendet werden. Die regelmäßige Aufgabe bestimmt diese Domänen aus dem Feld sys_domain der Quelltabellendatensätze. Weitere Informationen finden Sie unter Domänenzuweisung. Hinweis: Es wird empfohlen, eine domänengetrennte Tabelle zu erstellen, die ausschließlich der Beschaffung von Domänen dient, es sei denn, Sie haben einen Anwendungsfall, der die Verwendung einer vorhandenen Domäne rechtfertigt. Wenn Sie einen neuen erstellen, wählen Sie ihn einfach in diesem Feld aus.
Domänenquellfilter	Optionale Bedingung, die Sie angeben können, um die Datensätze zu filtern, die aus der ausgewählten Domänenquelltabelle abgefragt wurden. Wählen Sie das Feld aus, das zum Filtern von Datensätzen verwendet werden soll. Fügen Sie Filterbedingungen und Operatoren hinzu, um die Domänenauswahlkriterien einzugrenzen. Weitere Informationen finden Sie unter Filter.

Die folgende Verarbeitung findet statt, wenn eine Aufgabe in einer domänengetrennten Instanz geplant wird:

Sie fragt zuerst die ausgewählte Domänenquelltabelle ab.
Wenn Sie eine Bedingung im Feld Domänenquellfilter angegeben haben, wird die Filterbedingung angewendet, um den resultierenden Datensatz einzugrenzen.
Schließlich wird die Liste der eindeutigen Domänen aus den sys_domain-Spalten dieser Datensätze abgerufen.

Klicken Sie auf Aktualisieren, um die geplante Aufgabe zu aktualisieren, auf Jetzt ausführen, um das geplante Skript sofort auszuführen, oder auf Löschen, um die Aufgabe zu löschen.