Local or Network Folders

This section describes the procedures required to include the set of selected programming files, reports, and other documents from local or network folders, add or edit search path(s), include / exclude archive files, exclude files or folders, and to apply file filters to restrict processing to only a subset of selected files.

To access the active project settings for local or network (source) folders:

1. In the frame on the left, in the Folders and Version Control category, click to select Local or Network Folders. See below:

   

   OR

2. From the menu, select  Projects -> Settings . See below:

   

3. The following dialog box will appear:

   

Include Source

When a source item is selected from the frame on the left, the Include [Source Name] check-box at the top of the dialog box is checked by default. To exclude the source from your search, click to un-check the check-box.

Add or Edit Search Path(s)

To add a search path to the Local and Network Folders search:

1. From the Options tab, click on the  Add  button.

2. In the Search Path(s) section, click on the  Add  button. A Search Path dialog will appear, as below:

   

3. Click on the folder icon button to the right of the Directory field. A Select Folder dialog will appear. See example below:

   

   1. Navigate to and select the folder you want to add as a search path.

   2. Click on the  Select Folder  button. The folder path will appear in the Directory field.

      Tip: You can also copy and paste or type in a fully-qualified path into the Directory text box.

4. Note that the Include Sub Directories check-box is checked by default. To exclude sub directories for the selected folder, click to un-check this check-box.

5. Click on the  OK  button. The new search path will be added to the Search Path(s) list. See example below:

   

   Note: If sub directories have been included for a given search path, a green check mark appears in the corresponding Include Sub Directories? column.

   Alert: You will be prevented from entering duplicate paths or overlapping sub-folders for a project.

6. Repeat steps 2 through 5 to add multiple paths.

To edit a search path:

1. In the Search Path(s) list, click to highlight the search path you want to edit. See example below:

   

2. Click on the  Edit  button.
3. Repeat steps 3-5 above.

To remove a search path:

1. In the Search Path(s) list, click to highlight the search path you want to remove.

2. Click on the  Remove  button. The selected search path will be removed from the list.

Click on the  Close  button to apply your changes.

Include Archive Files

Whether or not a file is considered an Archive is determined by the file extension. If it is any of the following support Archive types, it will be opened as an archive and Find it EZ will search the contents:

"ARJ", "LZH", "LZMA", "RAR", "RPM", "7Z", "XZ", "BZ2", "BZ", "GZIP", "GZ", "TAR", "ZIP"

To include archive files in your Local or Network Folders search, locate and click the Yes option to Search within archive files.

Exclude Files or Folders

There are three ways to add one or more specific files or folders to be excluded from the selected directories (in the Search Path(s) list) in your Local or Network Folders search:

1. Right-click a search results item in the Errors tab, chose  Add File to Project Exclusion List  from the context menu. See below:

   

2. To import a list of files to exclude:

   1. In the Exclude files, folders and archives ... section of the Mask Filters tab, click on the  Import  button. An Open dialog will appear.

      

   2. Navigate to and select the desired *.txt file.

   3. Click on the  Open  button. The contents of the selected file will be added to the in the Exclude files, folders and archives ... list.

   4. Click on the  Close  button to apply your exclusions.

   AND / OR

3. To enter the path, file name, or wildcard to exclude:

   1. Click inside the Exclude files, folders and archives ... text box and enter the desired text to exclude.

      Note: Enter each item on a separate line. Use * for wildcards. For example, enter the path to exclude a sub-directory, exclude a specific type of files (e.g. *.cs), etc.
   2. Click on the  Apply  button to apply your exclusions.

To clear the Exclude File(s) / Folder(s) list:

• Click on the  Clear  button. All items in the list will be removed.

Include File Filters

You may use both the Mask Filters and/or the File Filter tabs to include only a subset of specific files within the configured path(s). You must first add the desired source path folders. This filter is often used to minimize false positives or expedite indexing and searching by limiting the number of file contents included in a project. This setting can be quickly changed to include all or a subset of files as needed.

To include one or more files and/or folders based on a wildcard or pattern that matches part of a file or path name:

1. Open the Local or Network Folders project settings dialog box, click to open the Mask Filters tab, see below:



2. By default, all paths and filenames within the Options tab Search Path(s) are included using the wildcard pattern *.* .
3. To only include the subset of files containing the text "order" in either the folder path or filename itself, replace the default *.* pattern with the text order, or *order* , as below:

   

4. To also include any files in a subset of paths such as order history sales report stored by date as follows "..\orderhistory\yyyy-mm\gross-sales.rpt", enter the pattern *\orderhistory\*\gross-sales.* , as below:

   

5. Repeat adding additional patterns on separate lines as needed, or use the Import button below to import a list of patterns.
Note: The list of "included" patterns is cumulative. In other words, each pattern on a line is "OR"-ed together with all other patterns. As such, leaving the default "*.*" pattern in this box would supersede all individual pattern lines that may be added.
6. To clear the list, use the Reset button to restore the default *.* pattern ( ie, include all ).

To include one or more specific fully qualified files by name:

1. Open the Local or Network Folders project settings dialog box, click to open the File Filter tab, see below:

   

2. To include all files, click to choose the Include all Files option. This is the default selection.

   OR

3. To include only a subset of files, click to choose the Only include this subset of Files option.
4. To add a subset:

   1. Click on the  Add  button. An Add Filter dialog will appear.

      

      The Available Files list will be populated with a list of files included in the folders selected previously on the Options tab, and filtered to include / exclude specific subsets of files based on any entries on the Mask Filters tab.

   2. Click to select the desired file(s).

      Note: Select multiple items by holding down the  Ctrl  key. Or, click on the  Select All  button or the  Select None  button, or the  Refresh  button as desired.
   3. To filter by file name, use the Filename Filter:

      1. Click inside the Filename Filter text box.

         

      2. Enter the desired file name filter, using wildcards as desired (e.g. *.cs, *.js, *user*, etc.).

         

         Note: This filter applies to the filename itself, and does not apply to the drive letter, folders or path names.

   4. Select one or more items from the list.

      Tip: Use the Select All button or hold the CTRL key then click to select multiple items.

   5. Once complete, click on the  Add  button. The selected files will be added to the Only include this subset of Files list.

   6. Repeat steps 5a through 5e to add additional files as desired.

   AND / OR

5. To paste a subset from the clipboard:
   1. Click on the  Paste  button. The clipboard contents will be added directly to the Only include this subset of Files list.

   2. Optionally repeat Copy then Paste additional fully qualified filenames until completed.

      Alert: The clipboard may contain a single file or list of filenames, but each line must be formatted with a fully qualified path.

6. To remove file(s):
   1. To remove all files from the list, click on the  Remove All  button.
   2. To remove only selected file(s) from the list, click to select the files you want to remove, then click on the  Remove  button.

7. Click on the  Close  button to apply your changes.