File Listener (Win Share)
Overview
The File Listener (Win Share) trigger watches files in a Windows shared location and starts a new workflow iteration when matching files are created or updated.
Purpose
Use this trigger to process files that arrive on SMB or Windows network shares.
Configuration
| Field | Description |
|---|---|
| Windows Share Service | The Windows share service to connect to. For more, see Windows Share Service. |
| File Path | File path on the share. The value can include workflow properties and wildcard patterns such as *.xlsx. |
| Read file content to property | Stores supported file content in WIN_SHARE_FILE_LISTENER_CONTENT. |
Outputs
| Output | Data Type | Collection | Description |
|---|---|---|---|
| ChangedFile | NodeFile | False | The trigger outputs a NodeFile for each changed file. |
Properties
| Property | FlowDataType | Description |
|---|---|---|
| WIN_SHARE_FILE_LISTENER_FILE | JsonNode | File information that been listened for changed from the server |
| WIN_SHARE_FILE_LISTENER_CONTENT | String | The file content inside a property |
| WIN_SHARE_FILE_LISTENER_NAME | String | File name. |
| WIN_SHARE_FILE_LISTENER_PATH | String | File path. |
| WIN_SHARE_FILE_LISTENER_SIZE | Long | File size in bytes. |
| WIN_SHARE_FILE_LISTENER_LAST_MODIFIED | Long | Last modified timestamp. |
| WIN_SHARE_FILE_LISTENER_IS_HIDDEN | Boolean | |
| WIN_SHARE_FILE_LISTENER_CAN_READ | Boolean | |
| WIN_SHARE_FILE_LISTENER_CAN_WRITE | Boolean | |
| WIN_SHARE_FILE_LISTENER_OWNER_GROUP | String | |
| WIN_SHARE_FILE_LISTENER_OWNER | String | |
| WIN_SHARE_FILE_LISTENER_REQUEST_PROPERTIES | JsonNode | |
| WIN_SHARE_FILE_LISTENER_SERVER | String | Windows share server information. |
Processing Logic
The trigger evaluates the configured path, lists matching files when a wildcard is used, sorts changed files by modification time, downloads each file from the share, and emits them sequentially. The last processed modification timestamp is stored after a successful iteration.
Examples
masterdata\mydata.csvwatches one file.excel_reports\*.xlsxwatches all matching Excel files in a folder.signatures_shares\signatures${EXEC_BY_USERNAME}_scanned_signature.jpguses a workflow property in the path.
Notes / Limitations
- The Windows Share Service must have access to the configured path.
- Manual runs do not update the stored listener state.
- File content is only stored as a property when the option is enabled and the file type can be read safely.