The Process Files action creates a step to process multiple files in a folder (and optionally in subfolders) that match a given file mask.  This action generates a list of all files matching the specified criteria, and then performs all child steps once for each file that matches.  Create one or more child steps of any type (including Subroutine Call actions) and use the macros defined below to operate on each matching file.

 

Folder: The folder to search for files in.

 

Recursively search sub folders: If checked, any sub folders of the main folder are also searched for files.

 

Process once for each folder: If this option is checked, rather than once for each file, the child steps are invoked once for each folder that contains one or more matching files.

 

Process empty folders: If checked, even empty folders will be matched/processed (enabled only if Process once for each folder is checked).

 

Fail step if no matching files found: If checked and no matching files are found, the step will fail instead of being skipped when building.

 

Log matches found while searching: If checked, each matching file is logged while scanning for matching files (filenames are also logged for each iteration when child steps are being processed even when this option is unchecked).

 

Files to process: Specifies the files and folders to include or exclude.

 

Attributes Tab

 

Each child step is built once for each matching file, and the following system macros are defined for each matching file:

 

 

The above macros can be used in child steps to process each file that matches the search.

 

Notes: