Advanced

The Advanced tab has the following fields.

Field

Global

Var?

Description

Poll for Create Events

No

Checking this field starts a new process when a file or directory matching the specification in the File Name field is created. If this field is unchecked, newly created files/directories are ignored.

Poll for Modify Events

No

Checking this field starts a new process when a file or directory matching the specification in the File Name field is modified. If this field is unchecked, modifications to files/directories are ignored.

Poll for Delete Events

No

Checking this field starts a new process when a file or directory matching the specification in the File Name field is deleted. If this field is unchecked, deletions of files/directories are ignored.

Include Sub-Directories

No

When this field is checked, events that occur in subdirectories of the specified directory are also monitored. If this field is unchecked, only the directory is monitored, any subdirectories are ignored.

Mode

No

Specifies the type of polling to perform. Specify one of the following:

  • only-directories — only tracks the specified changes for directories.

  • only-files — only tracks the specified changes for files.

  • files-and-directories — tracks the specified changes for both files and directories.

Sort By

No

Specifies the order in which files should be processed, if more than one file is detected. You can sort by file name, modification date, or specify no sorting is to be performed.

Files are processed as the polling interval occurs. Therefore, the Sort By field applies to all files that have changed since the last polling interval. The Sort By field can be very useful if you want to process files in a specific order when the process engine starts and the Include Existing Files field is checked (then all existing files are processed in the specified order).

Note: The File Poller starts process instances based on the specified Sort By order, but the process instances may not complete in the same order. If you want to guarantee that processes start and complete in a given order, you must specify Max Jobs = 1 and enable the Activatation Limit field when you deploy your project. For more information about deploying projects, see TIBCO ActiveMatrix BusinessWorks™ Administration.

Sort Order

No

Specifies whether the order specified in the Sort By field is ascending or descending. This field is only applicable if File Name or Date Modified is selected in the Sort By field.