Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte aktivieren > DELETE_FORECAST

DELETE_FORECAST

Scriptfunktion: Löscht alle Forecasts oder einen bestimmten Forecast in der Automation Engine-Datenbank.

Syntax

DELETE_FORECAST(FC_TITLE, [DAYS], [FORCED])

Syntax	Beschreibung/Format
FC_TITLE	Titel der zu löschenden Prognose (Pflichtangabe). Es können auch Wildcards verwendet werden: "*" Wird über den UND-Operator logisch mit dem Parameter "DAYS" verknüpft. Format: string
DAYS	Startzeit der Prognose (optional) Wird über den UND-Operator logisch mit dem Parameter "FC_TITLE" verknüpft. Format: hh:mm:ss Ist dieser Parameter auf "0" gesetzt, wird der Wert Logisches Startdatum der Prognose auf das heutige Datum (todays_date) festgelegt: 23:59:59
FORCED	Fixwert: "FORCED" (optional). Wenn dieser Parameter gesetzt ist, werden alle Prognosen ohne Prüfung gelöscht und laufende Prognosen mit undefiniertem Fehler gestoppt. Wenn dieser Parameter nicht gesetzt ist, wird eine Prüfung des Aktivitätsstatus der Prognosen durchgeführt und nur die nicht aktiven Prognosen werden gelöscht.

Syntax

Beschreibung/Format

FC_TITLE

Titel der zu löschenden Prognose (Pflichtangabe). Es können auch Wildcards verwendet werden: "*"

Wird über den UND-Operator logisch mit dem Parameter "DAYS" verknüpft.

Format: string

DAYS

Startzeit der Prognose (optional)

Wird über den UND-Operator logisch mit dem Parameter "FC_TITLE" verknüpft.

Format: hh:mm:ss

Ist dieser Parameter auf "0" gesetzt, wird der Wert Logisches Startdatum der Prognose auf das heutige Datum (todays_date) festgelegt: 23:59:59

FORCED

Fixwert: "FORCED" (optional).

Wenn dieser Parameter gesetzt ist, werden alle Prognosen ohne Prüfung gelöscht und laufende Prognosen mit undefiniertem Fehler gestoppt.

Wenn dieser Parameter nicht gesetzt ist, wird eine Prüfung des Aktivitätsstatus der Prognosen durchgeführt und nur die nicht aktiven Prognosen werden gelöscht.

Rückgabewert
"0" - Der/die Prognose(n) wurde(n) erfolgreich gelöscht.
Eine Zahl > "0" - Nicht alle Prognosen mit den angegebenen Parametern wurden gelöscht.

Der Report des ausführbaren Objekts zeigt eine Meldung (Meldungsnummer 20824), in der die exakte Anzahl gelöschter Prognosen vermerkt ist.

Anmerkungen

Prognosen können nur gelöscht werden, wenn man deren Titel nutzt. Mit dieser Scriptfunktion ist die Verwendung des Namens nicht möglich.

Beachten Sie bitte beim Parameter "DAYS" auch die Regeln für die Zeitzone des Automation Engine-Systems.

Bei Verwendung dieser Scriptfunktion werden alle Typen von Prognosen gelöscht: Objekte, Aufgaben und Auto-Prognosen.

Beispiele

Die folgenden Beispiele zeigen die Verwendung von DELETE_FORECAST:

Löschen aller Prognosen, die nicht aktiv sind:

:SET &ret# = DELETE_FORECAST ("*", ,)

Alle Prognosen mit dem Status ENDED_OK löschen:

:SET &ret# = DELETE_FORECAST ("*")

Löschen aller Prognosen mit dem Titel "MyFC" erzwingen:

:SET &ret# = DELETE_FORECAST ("MyFC", , FORCED)

Löschen aller Prognosen, deren Titel mit "FC_" beginnt UND die älter als zwei Tage sind UND die den Status ENDED_OK haben:

:SET &ret# = DELETE_FORECAST ("FC_*", "2")

Löschen aller Prognosen, deren Titel mit "FC_" beginnt UND die älter als zwei Tage:

:SET &ret# = DELETE_FORECAST ("FC_*", "2","FORCED")

Löschen aller Prognosen, deren Titel mit "FC_" beginnt und deren logischer Start < (heutiges Datum):23:59:59 ist und die den Status ENDED_OK haben:

:SET &ret# = DELETE_FORECAST ("FC_*",0)

Löschen aller Prognosen, deren Titel mit "FC_" beginnt und deren logischer Start < (heutiges Datum):23:59:59 ist:

:SET &ret# = DELETE_FORECAST ("FC_*",0, "FORCED") ->

Siehe auch:

Script-Sprachmittel	Beschreibung
AUTOFORECAST	Berechnet Prognosedaten für zukünftige Aktivitäten.
FORECAST_TASK	Erzeugt eine Prognose für die angegebene Aufgabe.

Script-Sprachmittel - Objekte aktivieren

Prognose
Laufzeitermittlung

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support