Vorschau · Entwicklungsstand 1.6.1

Datei- oder Ordnerereignis

**Ordner-Automation**Ordnerüberwachung mit Beispieldateipfad und Filter für Textdateien. Der Beispielpfad muss vor Verwendung angepasst werden.

Wofür ist das gedacht?

Beobachtet einen vorhandenen Ordner mit Dateimuster und optionalen Unterordnern. Created, Changed, Deleted oder Renamed bestimmen die Ereignisart. Dateisystemereignisse können mehrfach auftreten; Readiness und RunPolicy begrenzen Starts, ersetzen aber keine fachliche Deduplizierung.

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.

Einstellung	Bedeutung und Bedienung	Beispielwert
directory_path	Vorhandener beobachteter Ordner des Datei-Triggers. Die App benötigt Zugriff auf ihn; ein nicht vorhandener Ordner ist keine gültige Automation.	C:\Beispiele\Dokumente
event_kind	Beobachtetes Fenster-, Datei- oder Systemereignis. Wähle nur die Optionen dieses Trigger-Typs. Erstellt Datei-/Ordnereintrag wurde erstellt. Geändert Beobachteter Eintrag wurde geändert. Gelöscht Beobachteter Eintrag wurde entfernt. Umbenannt Beobachteter Eintrag wurde umbenannt.	Erstellt
filter	Optionales Dateimuster wie *.txt. Beim Ordner-Trigger begrenzt es die beobachteten Einträge; bei Dateiaktionen gilt es nur für die dafür angebotene Aktion.	*.txt
include_subdirectories	Beobachtet auch Unterordner unterhalb des angegebenen Pfads. Eine größere Baumstruktur kann mehr Ereignisse erzeugen.	Aus (Häkchen entfernt)
kind	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. 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.	Datei- oder Ordnerereignis
wait_until_ready	Wartet bei unterstützten Datei-Ereignissen auf Verwendbarkeit der Datei, bevor der Zielablauf gestartet wird. Es ersetzt keine Zugriffsrechte.	An (Häkchen gesetzt)

Beispiel

Sicherungsbeispiel: Created und *.txt im Rechnungsordner starten den Rückfrage-Job.

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: file_system_event

Felder und Zusammenhänge auf einen Blick

1
directory_pathdirectory_path · String · Leerer Text
Vorhandener beobachteter Ordner des Datei-Triggers
2
event_kindevent_kind · FileSystemAutomationEventKind · Created, Changed, Deleted, Renamed
Beobachtetes Fenster-, Datei- oder Systemereignis
3
filterfilter · String · *.*
Optionales Dateimuster wie *.txt
4
include_subdirectoriesinclude_subdirectories · Boolean · false
Beobachtet auch Unterordner unterhalb des angegebenen Pfads
5
kindkind · AutomationTriggerKind · Hotkey, OnceAt, Schedule, Interval, ProcessStarted, ProcessExited, WindowEvent, FileSystemEvent, SystemEvent, WindowsEvent, Webhook
Abgeleitete Triggerart zur Anzeige
6
wait_until_readywait_until_ready · Boolean · true
Wartet bei unterstützten Datei-Ereignissen auf Verwendbarkeit der Datei, bevor der Zielablauf gestartet wird

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

Feldtypen, Standards und Regeln

Wert	Typ	Standard laut Vertrag	Optionen und Regeln	Erklärung
directory_path `directory_path`	`String`	`Leerer Text`	Regeln siehe Erklärung	Vorhandener beobachteter Ordner des Datei-Triggers. Die App benötigt Zugriff auf ihn; ein nicht vorhandener Ordner ist keine gültige Automation.
event_kind `event_kind`	`FileSystemAutomationEventKind`	`Created`	Regeln siehe Erklärung `["Created", "Changed", "Deleted", "Renamed"]`	Beobachtetes Fenster-, Datei- oder Systemereignis. Wähle nur die Optionen dieses Trigger-Typs. `Created` Datei-/Ordnereintrag wurde erstellt. `Changed` Beobachteter Eintrag wurde geändert. `Deleted` Beobachteter Eintrag wurde entfernt. `Renamed` Beobachteter Eintrag wurde umbenannt.
filter `filter`	`String`	`.`	Regeln siehe Erklärung	Optionales Dateimuster wie *.txt. Beim Ordner-Trigger begrenzt es die beobachteten Einträge; bei Dateiaktionen gilt es nur für die dafür angebotene Aktion.
include_subdirectories `include_subdirectories`	`Boolean`	`false`	Regeln siehe Erklärung	Beobachtet auch Unterordner unterhalb des angegebenen Pfads. Eine größere Baumstruktur kann mehr Ereignisse erzeugen.
kind `kind`	`AutomationTriggerKind`	`FileSystemEvent`	Regeln 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.
wait_until_ready `wait_until_ready`	`Boolean`	`true`	Regeln siehe Erklärung	Wartet bei unterstützten Datei-Ereignissen auf Verwendbarkeit der Datei, bevor der Zielablauf gestartet wird. Es ersetzt keine Zugriffsrechte.

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": "file_system_event",
  "Kind": "FileSystemEvent",
  "event_kind": "Created",
  "directory_path": "",
  "filter": "*.*",
  "include_subdirectories": false,
  "wait_until_ready": true,
  "kind": "FileSystemEvent"
}