¶ Description
Scan a directory for (new) files.
¶ Parameters
¶ Parameters tab
Parameters:
-
Delay on each directory scan [seconds]
How often to rescan the folder. Use a sensible value (e.g., 5–30s) to avoid hammering disks or network shares. -
Directory to watch
The root folder to monitor. You can choose from common locations (e.g., assets, temporary data, recorded data) or supply a custom path / expression (⋯ button). -
Output
What should be returned at each tick:- all files in folder at scan time – a full snapshot on every scan.
- new files only – only files that appeared since the previous scan.
- initial files + new files only – emit one initial snapshot once, then only new arrivals.
-
File Filter
Glob pattern to include files (e.g.,*.csv,*.json). Leave*to include everything.
¶ Description tab
See dedicated page for more information.
¶ Code tab
scanDir is a scripted action. Embedded code is accessible and customizable through this tab.
¶ Configuration tab
See dedicated page for more information.
¶ About
Watches a directory at a fixed interval and outputs the files it finds. Great for simple “drop-folder” style automations.
What you get: on every scan, the action emits a table with at least these columns:
- FilePath – full path (relative to the selected root)
- FileName – the file’s name
¶ How it works (at a glance)
- Waits Delay seconds.
- Scans Directory to watch applying File Filter.
- Builds the output list according to Output mode.
- Emits the table (visible in the Data tab), then repeats.
¶ Examples
¶ Example 2 — Periodic inventory of a folder
- Delay:
10 - Directory to watch:
assets/ - Output:
all files in folder at scan time - File Filter:
*
Result: every 10 second you get a full snapshot of the folder.
¶ Tips & gotchas
- Very small delays can cause unnecessary load; prefer ≥5s unless you truly need near-real-time.
- Use new files only when downstream steps must process each file once.
- If the folder is empty or the pattern matches nothing, the action simply emits an empty list for that tick.
