{
  "appVersion": "1.6.1",
  "contract": {
    "id": "file_system_event",
    "name": "Datei- oder Ordnerereignis",
    "fields": [
      {
        "id": "directory_path",
        "name": "directory_path",
        "type": "String",
        "options": [],
        "defaultValue": ""
      },
      {
        "id": "event_kind",
        "name": "event_kind",
        "type": "FileSystemAutomationEventKind",
        "options": [
          "Created",
          "Changed",
          "Deleted",
          "Renamed"
        ],
        "defaultValue": "Created"
      },
      {
        "id": "filter",
        "name": "filter",
        "type": "String",
        "options": [],
        "defaultValue": "*.*"
      },
      {
        "id": "include_subdirectories",
        "name": "include_subdirectories",
        "type": "Boolean",
        "options": [],
        "defaultValue": false
      },
      {
        "id": "kind",
        "name": "kind",
        "type": "AutomationTriggerKind",
        "options": [
          "Hotkey",
          "OnceAt",
          "Schedule",
          "Interval",
          "ProcessStarted",
          "ProcessExited",
          "WindowEvent",
          "FileSystemEvent",
          "SystemEvent",
          "WindowsEvent",
          "Webhook"
        ],
        "defaultValue": "FileSystemEvent"
      },
      {
        "id": "wait_until_ready",
        "name": "wait_until_ready",
        "type": "Boolean",
        "options": [],
        "defaultValue": true
      }
    ]
  },
  "explanations": {
    "purpose": "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.",
    "example": "Sicherungsbeispiel: Created und *.txt im Rechnungsordner starten den Rückfrage-Job.",
    "errors": "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.",
    "field.directory_path": "Vorhandener beobachteter Ordner des Datei-Triggers. Die App benötigt Zugriff auf ihn; ein nicht vorhandener Ordner ist keine gültige Automation.",
    "field.event_kind": "Beobachtetes Fenster-, Datei- oder Systemereignis. Wähle nur die Optionen dieses Trigger-Typs.",
    "field.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.",
    "field.include_subdirectories": "Beobachtet auch Unterordner unterhalb des angegebenen Pfads. Eine größere Baumstruktur kann mehr Ereignisse erzeugen.",
    "field.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.",
    "field.wait_until_ready": "Wartet bei unterstützten Datei-Ereignissen auf Verwendbarkeit der Datei, bevor der Zielablauf gestartet wird. Es ersetzt keine Zugriffsrechte.",
    "field.kind.option.ProcessExited": "Start, wenn ein passender Prozess beendet wird.",
    "field.kind.option.ProcessStarted": "Start, wenn ein passender Prozess neu erscheint.",
    "field.event_kind.option.Created": "Datei-/Ordnereintrag wurde erstellt.",
    "field.kind.option.Hotkey": "Start über Tastenkombination.",
    "field.kind.option.FileSystemEvent": "Start bei einem passenden Datei-/Ordnerereignis.",
    "field.kind.option.Interval": "Start in einem positiven Wiederholungsintervall.",
    "field.kind.option.Schedule": "Start zu einer Uhrzeit an ausgewählten Wochentagen.",
    "field.kind.option.Webhook": "Start durch einen authentifizierten HTTP-POST-Aufruf.",
    "field.kind.option.WindowEvent": "Start bei einem passenden Fensterereignis.",
    "field.event_kind.option.Changed": "Beobachteter Eintrag wurde geändert.",
    "field.kind.option.WindowsEvent": "Start über eine unterstützte Funktion des Windows-Ereigniskatalogs.",
    "field.kind.option.SystemEvent": "Start bei einem unterstützten Sitzungs-/Energie-/Systemereignis.",
    "field.event_kind.option.Deleted": "Beobachteter Eintrag wurde entfernt.",
    "field.event_kind.option.Renamed": "Beobachteter Eintrag wurde umbenannt.",
    "field.kind.option.OnceAt": "Einmaliger Start zu einem zukünftigen Zeitpunkt."
  },
  "template": {
    "$type": "file_system_event",
    "Kind": "FileSystemEvent",
    "event_kind": "Created",
    "directory_path": "",
    "filter": "*.*",
    "include_subdirectories": false,
    "wait_until_ready": true,
    "kind": "FileSystemEvent"
  },
  "screenshots": [
    {
      "id": "automation-ordner",
      "file": "automation-ordner.detail.png",
      "title": "Ordner-Automation",
      "caption": "Ordnerüberwachung mit Beispieldateipfad und Filter für Textdateien. Der Beispielpfad muss vor Verwendung angepasst werden.",
      "width": 1324,
      "height": 630,
      "pages": [
        "/doku/automationen/file_system_event/"
      ],
      "markers": [
        {
          "number": 1,
          "label": "Trigger-Typ",
          "explanation": "Hier wählst du, welches Ereignis die Automation startet."
        },
        {
          "number": 2,
          "label": "Ereignis",
          "explanation": "Wählt die Art der Änderung aus, auf die der Trigger reagiert."
        },
        {
          "number": 3,
          "label": "Dateifilter",
          "explanation": "Schränkt die überwachten Namen ein, beispielsweise auf *.txt."
        },
        {
          "number": 4,
          "label": "Job oder Makro",
          "explanation": "Hier steht das Ziel, das bei einer passenden Auslösung gestartet wird."
        },
        {
          "number": 5,
          "label": "Wenn bereits aktiv",
          "explanation": "Bestimmt die Startentscheidung, falls dieses Ziel bereits läuft."
        },
        {
          "number": 6,
          "label": "Cooldown",
          "explanation": "Mindestabstand zwischen angenommenen Starts; die Einheit ist Sekunden."
        }
      ]
    }
  ],
  "note": "Referenzdaten. Defaultvorlage vor Verwendung vervollständigen und fachlich validieren."
}