Text Search

This task allows you to search for a string of text within a file.  If the text is found, then the line containing the text is appended to a results file.  You can also choose to append surrounding lines to the results file.  You can also search for multiple strings of text.  Also, you can search multiple files in a directory tree.

WARNING: If you select the option to 'save lines as variables', the task will run much slower. If the search file has thousands of lines that are saved as variables then the task could even run out of memory. Please test this option with small files and slowly move to bigger files.

Source Directory
Enter the full pathname of the directory where the files you need to search are located.

Filename
Enter the filename filter for the files you wish to copy  using the following wildcard rules. This field also supports dynamic variables.  Using dynamic variables, you can select a file based on current date/time.

Folder Path Filter
Leave this field blank if you want all folders to be processed. If you need specific folders to be processed, then enter the folder name or path, using the following wildcard rules.  If a folder passes the filter, then all its subfolders will also pass the filter.
Simple Example: Folder = c:\test  , subfolders = john, john\old, sam, sam\old, joe, joe\old
Folder path filter = john    .  john and john\old are processed
Folder path filter = jo       .  john,  john\old, joe, joe\old are processed
Folder path filter = old     .  sam\old,  john\old, joe\old are processed
Folder path filter = test     .  all files in c:\test and its sub folders are processed
Folder path filter = john\old.   only john\old is processed.
Folder path filter = c:\test\john   .  john and john\old are processed

Search Term
Enter the search term required.  If you have more than 1 search term, separate them by a character which is not included within the search term.  Example: Searching^Java^Automation .  This field also supports dynamic variables.  Using dynamic variables, for example, you can search a log file for toady's date/time, and run a task if that entry is found.

Search Term Separator
Enter the separator character used between search terms, if you have more than 1 search term.

Surrounding Lines
If a search term is found, the line is appended to the results file.  If you need to append surrounding lines also, select the desired number of surrounding lines to append.

Results Directory
Enter the full pathname of the directory where you need to put the results File.  Note that the path is case sensitive on Unix systems.

Results File
Enter the name for the results File.  If left blank, a default filename of your task title is used.  This field also supports dynamic variables.  Using dynamic variables, you can save the file to a customized name based on date/time.

Append to Filename
You can save each archive to a different filename based on current time/date, or based on custom code you set.