Vorschau · Entwicklungsstand 1.6.1

Fensterereignis

FensterereignisDetailansicht: Fensterereignis. Markierte Beschriftungen zeigen die Einstellungen im Editor. Die Abbildung zeigt eine Beispielkonfiguration, keine ausgeführte Aktion.
Detailansicht: Fensterereignis. Markierte Beschriftungen zeigen die Einstellungen im Editor. Die Abbildung zeigt eine Beispielkonfiguration, keine ausgeführte Aktion.
  1. 1
    Trigger-Typ

    Hier wählst du, welches Ereignis die Automation startet.

  2. 2
    Ereignis

    Wählt die zu beobachtende Fensteränderung.

  3. 3
    Prozessname (optional)

    Beschränkt die Beobachtung auf den angegebenen Prozess.

  4. 4
    Job oder Makro

    Hier steht das Ziel, das bei einer passenden Auslösung gestartet wird.

  5. 5
    Wenn bereits aktiv

    Bestimmt die Startentscheidung, falls dieses Ziel bereits läuft.

  6. 6
    Cooldown

    Mindestabstand zwischen angenommenen Starts; die Einheit ist Sekunden.

Editor-Ausschnitt mit Markierungen · Lightmode · Beispieldaten · Bild anklicken zum Vergrößern. Die Ansichten erklären die Bedienung; noch nicht gewählte Quellen, Geräte oder Modelle müssen für einen ausführbaren Job ergänzt werden.

Wofür ist das gedacht?

Beobachtet Öffnen, Schließen, Fokuswechsel oder Titeländerungen passender Fenster. Ein Titelteil und Prozessname grenzen die Fenster ein; mehrere Ereignisse können kurz hintereinander auftreten.

Einstellungen in der Oberfläche

Beispielwerte dienen zur Orientierung. Passe Pfade, Quellen und Geräte an deinen Arbeitsplatz an. Ein ausgeschaltetes Häkchen und die Zahl 0 sind ebenfalls gültige Beispielwerte.

EinstellungBedeutung und BedienungBeispielwert
delay_after_eventVerzögerung zwischen Ereignisbeobachtung und Startentscheidung als TimeSpan-Text, zum Beispiel 00:00:02.00:00:00
event_kindBeobachtetes Fenster-, Datei- oder Systemereignis. Wähle nur die Optionen dieses Trigger-Typs.
Fenster geöffnet
Passendes Fenster wurde geöffnet.
Fenster geschlossen
Passendes Fenster wurde geschlossen.
Fenster fokussiert
Passendes Fenster wurde in den Vordergrund gewechselt.
Fenstertitel geändert
Titel des passenden Fensters wurde geändert.
Fenster geöffnet
kindAbgeleitete Triggerart zur Anzeige. Für die polymorphe Deserialisierung ist $type maßgeblich; die kanonische Vorlage zeigt die zusätzlich geschriebenen Kind/kind-Werte.
Hotkey
Start über Tastenkombination.
Einmalig
Einmaliger Start zu einem zukünftigen Zeitpunkt.
Zeitplan
Start zu einer Uhrzeit an ausgewählten Wochentagen.
Intervall
Start in einem positiven Wiederholungsintervall.
Prozess gestartet
Start, wenn ein passender Prozess neu erscheint.
Prozess beendet
Start, wenn ein passender Prozess beendet wird.
Fensterereignis
Start bei einem passenden Fensterereignis.
Datei- oder Ordnerereignis
Start bei einem passenden Datei-/Ordnerereignis.
Windows-Systemereignis
Start bei einem unterstützten Sitzungs-/Energie-/Systemereignis.
Windows-Ereignis
Start über eine unterstützte Funktion des Windows-Ereigniskatalogs.
Webhook
Start durch einen authentifizierten HTTP-POST-Aufruf.
Fensterereignis
process_nameName des gesuchten Prozesses, zum Beispiel notepad. Ein Name kann mehrere Instanzen treffen; eine konkrete Prozessreferenz grenzt gezielt ein.notepad
window_title_containsOptionaler Teil des Fenstertitels zum Eingrenzen mehrerer Fenster. Ein leerer Text setzt diesen Filter nicht.Editor

Beispiel

Lege eine deaktivierte Automation an, wähle den beschriebenen Trigger beziehungsweise die Ziel-/Startregel und teste den Zieljob zuerst manuell. Die Dateianleitung zeigt die vollständige Hülle mit trigger, action und run_policy.

Vorbereitete Beispielabläufe ansehen

Fehler und Hinweise

Eine Triggerbeobachtung ist noch kein erfolgreicher Zielstart. Prüfe active, Ziel-ID, Pflichtparameter, aktives Zeitfenster, Cooldown und bereits laufendes Ziel. Für Webhooks zusätzlich Port, Netzwerkmodus und Authentifizierung prüfen; für Datei-Trigger muss der Ordner existieren. Diagnose und Startentscheidung stehen im Automationsverlauf.

Entwickler- und Agenten-Doku JSON, Feldnamen, Typen und Verträge

Dieser Bereich erklärt die Bearbeitung von Textdateien und die technischen Verträge. Zur Entwickler-Doku

Identifier: window_event

Felder und Zusammenhänge auf einen Blick
  1. 1
    delay_after_eventdelay_after_event · TimeSpan · 00:00:00

    Verzögerung zwischen Ereignisbeobachtung und Startentscheidung als TimeSpan-Text, zum Beispiel 00:00:02.

  2. 2
    event_kindevent_kind · WindowAutomationEventKind · Opened, Closed, Focused, TitleChanged

    Beobachtetes Fenster-, Datei- oder Systemereignis

  3. 3
    kindkind · AutomationTriggerKind · Hotkey, OnceAt, Schedule, Interval, ProcessStarted, ProcessExited, WindowEvent, FileSystemEvent, SystemEvent, WindowsEvent, Webhook

    Abgeleitete Triggerart zur Anzeige

  4. 4
    process_nameprocess_name · String · Leerer Text

    Name des gesuchten Prozesses, zum Beispiel notepad

  5. 5
    window_title_containswindow_title_contains · String · Leerer Text

    Optionaler Teil des Fenstertitels zum Eingrenzen mehrerer Fenster

Schematische Übersicht: Beschriftungen und Werte aus der Referenz, keine nachgezeichnete Bedienoberfläche.

Feldtypen, Standards und Regeln

WertTypStandard laut VertragOptionen und RegelnErklärung
delay_after_event
delay_after_event		TimeSpan00:00:00Regeln siehe Erklärung
Verzögerung zwischen Ereignisbeobachtung und Startentscheidung als TimeSpan-Text, zum Beispiel 00:00:02.
event_kind
event_kind		WindowAutomationEventKindOpenedRegeln siehe Erklärung
["Opened", "Closed", "Focused", "TitleChanged"]		Beobachtetes Fenster-, Datei- oder Systemereignis. Wähle nur die Optionen dieses Trigger-Typs.
Opened
Passendes Fenster wurde geöffnet.
Closed
Passendes Fenster wurde geschlossen.
Focused
Passendes Fenster wurde in den Vordergrund gewechselt.
TitleChanged
Titel des passenden Fensters wurde geändert.
kind
kind		AutomationTriggerKindWindowEventRegeln siehe Erklärung
["Hotkey", "OnceAt", "Schedule", "Interval", "ProcessStarted", "ProcessExited", "WindowEvent", "FileSystemEvent", "SystemEvent", "WindowsEvent", "Webhook"]		Abgeleitete Triggerart zur Anzeige. Für die polymorphe Deserialisierung ist $type maßgeblich; die kanonische Vorlage zeigt die zusätzlich geschriebenen Kind/kind-Werte.
Hotkey
Start über Tastenkombination.
OnceAt
Einmaliger Start zu einem zukünftigen Zeitpunkt.
Schedule
Start zu einer Uhrzeit an ausgewählten Wochentagen.
Interval
Start in einem positiven Wiederholungsintervall.
ProcessStarted
Start, wenn ein passender Prozess neu erscheint.
ProcessExited
Start, wenn ein passender Prozess beendet wird.
WindowEvent
Start bei einem passenden Fensterereignis.
FileSystemEvent
Start bei einem passenden Datei-/Ordnerereignis.
SystemEvent
Start bei einem unterstützten Sitzungs-/Energie-/Systemereignis.
WindowsEvent
Start über eine unterstützte Funktion des Windows-Ereigniskatalogs.
Webhook
Start durch einen authentifizierten HTTP-POST-Aufruf.
process_name
process_name		StringLeerer TextRegeln siehe Erklärung
Name des gesuchten Prozesses, zum Beispiel notepad. Ein Name kann mehrere Instanzen treffen; eine konkrete Prozessreferenz grenzt gezielt ein.
window_title_contains
window_title_contains		StringLeerer TextRegeln siehe Erklärung
Optionaler Teil des Fenstertitels zum Eingrenzen mehrerer Fenster. Ein leerer Text setzt diesen Filter nicht.

Diese Referenz für Textdateien und Agenten: Markdown · JSON-Vertrag

JSON-Vorlage für Textdateien und Agenten

Strukturelle Defaultvorlage direkt vom App-Serializer. Leere Pflichtwerte und Ziele vor Verwendung ergänzen; diese Vorlage ist kein vollständig validierter Ablauf. Bei neuen Jobs den aktuellen inputs/localValues-Vertrag verwenden.

Dateiformate und Regeln · JSON herunterladen
{
  "$type": "window_event",
  "Kind": "WindowEvent",
  "event_kind": "Opened",
  "process_name": "",
  "window_title_contains": "",
  "delay_after_event": "00:00:00",
  "kind": "WindowEvent"
}