refresh_server_events()

Lädt die serverseitigen Scripting-Events (OsEvents) über adm.ServerEventsRefresh neu, sodass angelegte, geänderte oder gelöschte Events sofort aktiv werden — ohne Neustart des Servers.

Die DMS-Engine hält die registrierten OsEvents in einem Cache. Ein create_os_event(), update_os_event() oder delete_os_event() ändert die Datenbank, wird aber erst nach einem Neuladen des Caches wirksam (normalerweise beim Serverstart). Diese Methode löst das Neuladen unmittelbar aus.

1. Signatur

  • Sync

  • Async

ecm.system.refresh_server_events() -> None
await ecm.system.refresh_server_events() -> None

2. Parameter

Keine. Der Job selbst verlangt einen Flags-Parameter — fehlt er, antwortet der Server mit -1043332470 ("A required parameter was not specified: Flags") --, deshalb sendet die Bibliothek immer Flags=0. Ausgewertet wird kein Wert von Flags (0, 1 und 2 sind alle erfolgreich). Gegen enaio 12.0 verifiziert.

3. Rückgabewert

Keiner (None). Bei einem Serverfehler wird eine Exception ausgelöst.

4. Beispiele

  • Sync

  • Async

event_id = ecm.system.create_os_event(
    ECMOsEventCode.KERNEL_BEFORE_JOB,
    script="...",
)
ecm.system.refresh_server_events()  # ohne Neustart aktivieren
event_id = await ecm.system.create_os_event(
    ECMOsEventCode.KERNEL_BEFORE_JOB,
    script="...",
)
await ecm.system.refresh_server_events()  # ohne Neustart aktivieren

5. Siehe auch