Allows files or folders to be monitored for changes. When a file in the specified folder matching the specified mask is created, modified or renamed, the Node will fire.

Revision History

1.0.0.35 - Added support for explicit passive & active FTP, added support for custom timeout, some bug fixes

Properties

Connection

Direction: Input
Type: Connection

Username
Type: String
The username used to authenticate access to the FTP or SFTP server.

Password
Type: Password
The password used to authenticate access to the FTP or SFTP server.

TargetUsername
Type: String
Not used on this Connector.

TargetPassword
Type: Password
Not used on this Connector.

CreateTargetDirectory
Type: Boolean
When True, indicates that the target path should be created if it does not already exist.

Path

Type: String Input
The path to the folder or file which should be watched for changes.

Mask

Type: String Input
Only files matching the mask in the specified folder will be watched, the others will be ignored.
To watch changes in all files, set the Mask property to an empty string. To watch a specific file, set the Mask property to the file name. For example, to watch for changes in the file MyDoc.txt, set the Mask property to MyDoc.txt. You can also watch for changes in a certain type of file. For example, to watch for changes in any text files, set the Mask property to *.txt. Use of multiple masks such as *.txt|*.doc is not supported.

PollInterval

Type: Int32 Static
The duration in seconds which the system will wait between checking for changes to the specified file/folder.

IncludeSubDirs

Type: Boolean Static
If True, sub folders will also be monitored for changes. If False only files in the top level directory specified will be monitored for changes.

FindMatchesOnStart

Type: Boolean Static
If True, the node will immediately return all files which match the criteria provided when the node is executed. If not, only changes made after the node is executed cause a change event to be recognized.

ChangedFilePath

Type: String Output
Provides the path to a file which has changed, been created or been renamed.

Video

Remarks

The File Watcher Trigger allows a set of files to be monitored for changes. 

The prefix provided as part of Path determines the file type as follows:

  • [Drive]:\ local drive
  • \\ UNC path for network share
  • ftp:// FTP
  • sftp://  SFTP
  • ftps:// FTPS

When accessing a local filesystem, a DropPoint must be used, not using a DropPoint will result in the error "An operation requiring File access permission was denied." Direct connections may only be used for FTP/SFTP servers.

Authentication

The Username and Password provided in the Connection Property will be used to authorize FTP or SFTP sessions only. If you require specific credentials to gain access to a local file or UNC path, change the Windows Service account used by the DropPoint.

See Also

File Enumerator
File
File Compressor
FileManage
Flat File

Did this answer your question?