update_os_event()

Aktualisiert den Script-Code eines bestehenden OsEvents über dms.UpdateOsEvent.

Es kann nur der Script-Code (vb_code) geändert werden. Event-Code, Ziel-Objekttyp, Kontextparameter und Plattform sind unveränderlich. Um eine dieser Eigenschaften zu ändern, lösche das Event mit delete_os_event() und lege es mit create_os_event() neu an — dabei entsteht eine neue id.

1. Signatur

  • Sync

  • Async

ecm.system.update_os_event(
    os_event_id: int,
    script: str,
) -> None
await ecm.system.update_os_event(
    os_event_id: int,
    script: str,
) -> None

2. Parameter

Parameter Typ Standard Beschreibung

os_event_id

int

—

id des zu aktualisierenden Events (das id-Feld eines ECMOsEvent).

script

str

—

Neuer Script-Code (JavaScript oder VBScript). Wird serverseitig in der Codepage Windows-1252 (cp1252) gespeichert; Zeichen außerhalb von cp1252 lösen UnicodeEncodeError aus.

3. Rückgabewert

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

4. Beispiele

  • Sync

  • Async

ecm.system.update_os_event(9, "'aktualisiertes Skript")
await ecm.system.update_os_event(9, "'aktualisiertes Skript")

5. Siehe auch