The File event trigger monitors changes in a file system. When a file has been changed, removed or created based on special attributes. Reacts directly and is not dependant on the polling interval.The file event is one of the most powerful event types. The file event reacts directly when a change has occurred. To monitor a change you have to specify a path. The file event is not based on WMI but can monitor a remote computer if you specify the appropriate credentials (username, password and computer name for the remote computer).
Folder path
This is the directory you want to monitor.
File mask
The filter can be a complete file name or your can use *.* to monitor all files (default) or e.g. *.txt to monitors all text files.
Include subfolders
This setting enables monitoring of all sub folders of the Path.
Use polling (Samba compatible)
Only use this option if you are monitoring a Samba file share. Samba does not support the normal file events so we are using our own polling technique instead.
File/Folder watch type
There are a set of watch types which monitors changes that might occur to a file or directory:
| • | "Created" - the creation of a file or folder |
| • | "Changed" - change of a file or folder. The types of changes include: changes to size, attributes, security settings, last write, and last access time |
| • | "Deleted" - the deletion of a file or folder |
| • | "Renamed" - the renaming of a file or folder |
Notify filters
Specifies changes to watch for in a file or folder. These are used in conjunction with the watch types. Certain combinations can give different results. The following notify filters can be activated:
| • | "File name" - the name of the file |
| • | "Directory name" - the name of the directory |
| • | "Attributes" - the attributes of the file or folder |
| • | "Size" - the size of the file or folder |
| • | "Last write" - the date the file or folder last was updated |
| • | "Last access" - the date the file or folder was last opened |
| • | "Creation time" - the creation time for a file or folder |
| • | "Security" - the security settings of the file or folder |
You can combine the notify filters to watch for more than one kind of change. For example, you can watch for changes in the size of a file or folder, and for changes in security settings. This raises an event anytime there is a change in size or security settings of a file or folder.
On error reconnect attempts
Let say the remote folder you watch gets disconnected for some reason, perhaps the network or computer is down. The reconnect attempts value controls how many times VisualCron tries to reconnect. Default value is 3 times.
On error reconnect interval (seconds)
Let say the remote folder you watch gets disconnected for some reason, perhaps the network or computer is down. The reconnect interval which you can specify is the number of seconds it will wait between each reconnect attempt, in seconds. Value 1 to 500 is available. Default is 5 seconds which may be a long time when the network is down and a short time if the remote computer is down. VisualCron attempts to reconnect 3 times by default.
Trigger when file has been released
If you are planning on using the file that was triggered directly you could use this option to ensure that the file has been fully changed/written before it is being triggered (and used by you or a later stage in VisualCron).