Automatisch ein Skript Ihrer Wahl ausführen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 7 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

    Im Folgenden finden Sie ein Beispiel für ein bedingtes Skript. Die geplante Aufgabe wird nur ausgeführt, wenn aktive Incidents ä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 Alle > Systemdefinition > Geplante Aufgabenan.
    2. Wählen Sie Neu.
    3. Wählen Sie Aus Führen Sie automatisch ein Skript Ihrer Wahl aus .
    4. Füllen Sie im Formular die Felder aus.
      Tabelle : 1. Skriptausführung planen
      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 Ein bedingtes Skript, das bestimmt, 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 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 Script sandbox.

      Nach dem Upgrade werden Aufträge mit bedingten Skripts, die diese unzulässigen API-Komponenten enthalten, mit Fehlern abgeschlossen.
      Ausführen
      Zeitintervall für die Ausführung der geplanten Aufgabe:
      • Täglich: Wird täglich zu einem bestimmten Zeitpunkt ausgeführt
      • Tag und Monat im Jahr : Wird jährlich an einem bestimmten Tag und Monat (z. B. 14. Juli) zu einer bestimmten Zeit ausgeführt.
      • Tag in der Woche im Monat im Jahr : Wird jährlich an einem bestimmten Wochentag in einer bestimmten Woche eines bestimmten Monats (z. B. der zweite Montag im Oktober) zu einer festgelegten Zeit ausgeführt.
      • Woche im Monat : Wird monatlich während einer bestimmten Woche des Monats (z. B. die dritte Woche jedes Monats) an festgelegten Tagen und zu einer bestimmten Zeit 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. Wenn Sie einen Geschäftskalender auswählen und sich alle Geschäftskalenderspannen in der Vergangenheit befinden, wird der Auftrag nie ausgeführt, da dies eine ungültige Konfiguration ist. 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 Geschäftskalender werden erstelltUnd 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.

        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.

      • 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 Ermöglicht Ihnen, das Anfangsfenster der Zeit zu definieren, zu der Ihr Auftrag ausgeführt werden soll. Der Auftrag wird tatsächlich zu dem in angegebenen Zeitpunkt ausgeführt Laufzeit . Wählen Sie Datum und Uhrzeit des Kalenders aus. Die Wird Gestartet Das Feld wird nur angezeigt, wenn Sie eine der folgenden Optionen auswählen Ausführen Gibt in ein Ausführen Feld:
      • Täglich
      • Tag und Monat im Jahr
      • Tag in der Woche im Monat im Jahr
      • Monatlich
      • Einmal
      • In regelmäßigen Abständen
      • Woche des Monats
      • Wöchentlich

      Für den Ausführungstyp Regelmäßig , Wird Gestartet Uhrzeit ist Datum und Uhrzeit der ersten Generierung geplanter Aufgaben.
      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 im Feld Zeit die Option Business Entry: Start Date (Geschäftseintrag: Startdatum) oder Business Entry: End Date (Geschäftseintrag: Enddatum) 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-Regel, oder rufen Sie eine Skripteinbindung auf.
    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 – Domänenerweiterungs-Installationsprogramm“ installiert diese Felder. Weitere Informationen finden Sie unter Domänentrennung anfordern .
      Feld Beschreibung
      Domäneniterator Kontrollkästchen, mit dem dieser Auftrag über mehrere Domänen hinweg ausgeführt werden kann. Wenn diese Option ausgewählt ist, 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 .
      Hinweis:
      Es ist eine gute Idee, eine domänengetrennte Tabelle zu erstellen, die ausschließlich für Beschaffungsdomänen bestimmt ist, es sei denn, Sie haben einen Anwendungsfall, der die Verwendung eines vorhandenen rechtfertigt. Wenn Sie ein neues erstellen, wählen Sie es einfach über dieses 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 werden.
      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 .
      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 wird die Filterbedingung angewendet, 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.
    6. Wählen Sie Aus 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.