XML configuration files

About the XML configuration files

The application reads XML configuration files from the application root folder. The XML configuration file (fwatcher.xml) specifies how the file system is monitored and what actions are performed when there is a file system change. The XML configuration file provides many configuration options that can suit specific needs. You may configure as many file watchers (file system monitors) as is needed. Application starts a file watcher for each config table (configuration set) in the XML configuration file.

XML configuration files

fwatcher.xml	This file contains the actual configuration information.
fwatcher.xsl	This file contains structure of the configuration.

XML configuration file structure

config table (the tag)

**Tag name**	**Description**
daemonName	Unique name of the file watcher.
startDaemon	**True | False** if to start file watcher.
displayFileSystemChange	**True | False** if to display file system change.
logFileSystemChange	**True | False** if to log file system change to log file.
logFileSystemSearchError	**True | False** if to log file system search error to log file.
displayFileSystemSearchError	**True | False** if to display file system search error.
logFileSystemSearchProgress	**True | False** if to log file system search process to log file.
displayFileSystemSearchProgress	**True | False** if to display file system search process.
path	Path of the directory to watch.
filter	File name filter string.
generateFileSystemEventsAtStartup	**True | False** if to generate file system events at startup.
generatedEventFileNameRegularExpressionFilter	Generated file system event file name regular expression filter.
changedRegularExpressionFilter	Changed event file name regular expression filter.
createdRegularExpressionFilter	Created file name regular expression filter.
deletedRegularExpressionFilter	Deleted event file name regular expression filter.
renamedRegularExpressionFilter	Renamed event file name regular expression filter.
includeSubdirectories	**True | False** if to monitor subdirectories.
internalBufferSize	File watcher internal buffer size. (The default buffer size is 8192).
subscribeToBufferErrorEvent	**True | False** if to subscribe to file watcher buffer error event.
subscribeToChangedEvent	**True | False** if to monitor file change.
subscribeToCreatedEvent	**True | False** if to monitor file creation.
subscribeToDeletedEvent	**True | False** if to monitor file deletion.
subscribeToRenamedEvent	**True | False** if to monitor file renaming.
notifyAttribute	**True | False** if to notify file of folder attribute change.
notifyCreationTime	**True | False** if to notify file or folder creation time change.
notifyDirectoryName	**True | False** if to notify directory name change.
notifyFileName	**True | False** if to notify file or folder name change.
notifyLastAccess	**True | False** if to notify file or folder last access change.
notifyLastWrite	**True | False** if to notify file or folder last write change.
notifySecurity	**True | False** if to notify security change.
notifySize	**True | False** if to notify file or folder size change.
startProcess	**True | False** if to start process when file watcher detects file system change.
logProcessStart	**True | False** if to log process start.
logProcessEnd	**True | False** if to log process end.
processFileName	Name of the process executable (or document). Cannot be empty.
processArguments	Process arguments.
processUseFileNameAsArgument	**True | False** if to use changed file as argument.
processArgumentsFileNameEscapeString	Arguments escape string for the file name.
processUseOldFileNameAsArgument	**True | False** if to use old file name as argument.
processArgumentsOldFileNameEscapeString	Arguments escape string for the old file name.
processUseChangeTypeAsArgument	**True | False** if to use the file system change type as argument.
processArgumentsChangeTypeEscapeString	Arguments escape string for the file system change type.
processVerb	Process verb.
processWorkingDirectory	Process working directory.
processUseShellExecute	**True | False** if to use shell execute method.
processCreateNoWindow	**True | False** if to create no window. Ignored if processUseShellExecute is **True**.
processWindowStyle	Process window style: normal | minimized | maximized | hidden. Set processShellExecute to **True**.
processSynchronizedExecution	**True | False** if to execute this process synchronized. Blocks other processes until the process is done.
processMaxWaitTime	Amount of time in milliseconds to wait for the synchronized process to exit. -1 to wait infinite.
processRedirectStandardError	**True | False** if to redirect process standard error to this application. Cannot be used if processUseShellExecute is **True**.
processRedirectStandardOutput	**True | False** if to redirect process standard output to this application. Cannot be used if processUseShellExecute is **True**.
processLoadUserProfile	**True | False** if to load user profile to execute process.
processDomain	Process user profile domain. Saved as plain text.
processUserName	Process user profile user name. Saved as plain text. Must be empty if processUseShellExecute is **True**.
processPassword	Process user profile password. Saved as plain text. Must be empty if processUseShellExecute is **True**.
processBatchSize	Process batch size (limits amount of simultaneous processes run by this file watcher). Zero value for no limit.
processFileMustExist	**True | False** to not to run the process if file does not exist.
processDelay	Process delay in milliseconds.
processLockFile	**True | False** to test for file lock.
processLockFileLastWriteDelay	The file last write time must occur specified amount of milliseconds before. The process will be requeued if the last write time condition is not met. This counts as a retry. Otherwise the file is tested for a file lock.
processLockFileRetries	File lock test retries. Zero for infinite.
processLockFileRetriesQueueLimit	Preserves the specified amount of processes even if the file lock retries count is met.
callService	**True | False** if to call a service when the file watcher detects a file system change.
tryRenameFile	**True | False** if to rename file before processing it.
tryRenameFileRetries	Rename retries.