The file filter is a part of many Tasks and other objects within VisualCron. The purpose of the file filter is to provide a standardized way of filtering out files for a given Task.
Evaluation
The file filter is evaluated the following way:
| • | Location AND Content AND Date AND Size AND Attributes = filtered files |
| • | Date = Date older than AND/OR Date newer than |
| • | Size = Size smaller than AND/OR Size larger than |
File filter -> Location
The Location tab contains the basic properties of finding one or more files.
Folder
The folder path where the source file(s) reside. You can input several folders by separating with semicolon ";" like this:
C:\Temp;C:\test
Include sub folders
If the file filter should look for files in sub folders then check this option.
Include file mask
Defined your file mask for the file name here. When not using “Is regex” string here you can use the normal wildcard characters like * or ?. You can input more than one file mask by separating them with semicolon ";" like this:
*.doc;*.txt
Is regex
If the include file mask is a regular expression. For more information about regular expressions please look here: http://www.regular-expressions.info/
Case sensitive
If the file name search is case sensitive.
Exclude file mask
It is possible, the same way, to use a exclusion filter. When not using “Is regex” string here you can use the normal wildcard characters like * or ?.
Is regex
If the exclude file mask is a regular expression. For more information about regular expressions please look here: http://www.regular-expressions.info/
File filter -> Content
Is possible to check found files for content.
The default Content property is Don’t check. Use the drop down menu to select the desired property.
File filter -> Date
It is possible to check the created/modified date against a Variable value.
There are two types of checks Older than and Newer than. These can be combined with AND/OR or used separately. Only date variables can be used here. Once you have selected a Variable it can be previewed when hovering over text box (tool tip) or in the group caption.
Click on the Settings button to view and select available Date Variables.
File filter -> Size
It is possible to filter out files based on size. Like the Date filter it can be combined with AND/OR and check can be done on Larger than or Smaller than.
Check if file is smaller than x size
Select this to enable size checking. Enter a value in the numeric text box and select the size unit to compare with. Default is kilobyte(s). If the size on the file is smaller than the value you enter in the numeric box it will return true (=file will be included).
Check if file is larger than x size
Select this to enable size checking. Enter a value in the numeric text box and select the size unit to compare with. Default is kilobyte(s). If the size on the file is larger than the value you enter in the numeric box it will return true (=file will be included).
File filter -> Attributes
All files have different attributes. If you want to check for a specific attribute you can use whether to include or exclude a file based on attribute.
Include all attributes
The default is checked, uncheck if you want to filter on attributes.
Include attribute(s), Exclude attribute(s)
Check the attributes you want to include or exclude.
File filter -> Test
In the Test tab you can test your current file filter - if it matches any existing files. The test will use the selected Credential. Click on Show filtered files to test filter.
