DELETE_FORECAST

Verwenden Sie die Script-Funktion DELETE_FORECAST, um eine oder mehrere in der Automation Engine-Datenbank gespeicherte Prognosen zu löschen. Diese Script-Funktion löscht jede Art von Prognose:

• Autoprognose
• Objektprognosen
• Aufgabeprognosen

Syntax

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

Parameter

• DELETE_FORECAST
  Löscht eine oder mehrere Prognosen
• FC_TITLE
  Titel der zu löschenden Prognose
  Hinweis: Sie können „*“ als Wildcardzeichen verwenden.
  Format: Zeichenfolge
  Wichtig: DELETE_FORECAST verwendet den Titel der Prognosen und nicht den Objektnamen, um die zu löschenden Prognosen auszuwählen.
  
• DAYS
  (Optional) Alter (Startzeit) der Prognose
  Format: Zahl ohne Hochkommata, Script-Literal oder Script-Variable
  Standardwert: Keine Selektion nach logischer Startzeit (Alter) der Prognose.
  Hinweis: Um das logische Startdatum der Prognose auf heute (todays_date) (23:59:59) zu setzen, geben Sie 0 als den Parameter DAYS ein.
  Tipp: Berücksichtigen Sie bei der Einstellung des DAYS-Parameters die Zeitzonenregeln. Weitere Informationen finden Sie unter Logisches Datum und reales Datum.
• FORCED
  (Optional) Löscht alle Prognosen ohne Prüfung
  Hinweise:
  • Laufende Prognosen werden mit undefinierten Fehlern gestoppt, wenn Sie diesen Parameter verwenden.
  • Ohne diesen Parameter prüft das System, ob die Prognose aktiv ist, und löscht nur gerade inaktive Prognosen.

Hinweis: Die Parameter FC_TITLE und DAYS werden logisch durch einen AND-Operator verknüpft. Die Script-Funktion löscht Prognosen mit dem angegebenen Titel, die am angegebenen Tag beginnen.

Rückgabewerte

• 0
  Die Prognosen wurden erfolgreich gelöscht
• Eine Zahl größer als 0
  Anzahl der Prognosen, die nicht gelöscht werden konnten

Die Anzahl der gelöschten Prognosen wird in der Nachrichtennummer 20824 im Report des ausführbaren Objekts angezeigt, dass das Script aufruft.

Beispiele

Die folgenden Beispiele zeigen, wie Sie mit DELETE_FORECAST unterschiedliche Ergebnisse erzielen:

• : SET &ret# = DELETE_FORECAST ("*", ,)
  Löscht alle Prognosen, die derzeit nicht aktiv sind

• : SET &ret# = DELETE_FORECAST ("*")
  Löscht alle Prognosen mit dem Status ENDED_OK

• : SET &ret# = DELETE_FORECAST ("MyFC", , FORCED)
  Löscht alle Prognosen mit dem Titel „MyFC“ und stoppt eine dieser Prognosen, wenn sie gerade aktiv ist

• : SET &ret# = DELETE_FORECAST ("FC_*", "2")
  Löscht alle Prognosen, deren Titel mit „FC_“ beginnt, die älter als zwei Tage sind und den Status ENDED_OK besitzen

• : SET &ret# = DELETE_FORECAST("FC_*", "2","FORCED")Löscht alle Prognosen, deren Titel mit FC_ beginnt und die älter als zwei Tage sind

• : SET &ret# = DELETE_FORECAST ("FC_*",0, "FORCED"
  Löscht alle Prognosen, deren Titel mit „FC_“ beginnt und deren logisches Startdatum am heutigen Tag liegt (23:59:59)

• : SET &ret# = DELETE_FORECAST ("FC_*",0)
  Löscht alle Prognosen, deren Titel mit „FC_“ beginnen, deren logisches Startdatum am heutigen Tag liegt, und die den Status ENDED_OK besitzen

Siehe auch: