Process these folders

Properties

The tool offers the following new properties:

Property name	Description	Editors	Default
Process these folders	Defines the ‘initial' set of folders that should be processed by the submit hierarchy tool; this set can be adjusted by defining one or more rules in subsequent properties Possible values are: All folders No folders	Dropdown list	All folders
Adjusted by (rule 1)	Defines a rule for adjusting the set of folders that should be processed by including or excluding folders Possible values are: Including folders named Including folders not named Excluding folders named Excluding folders not named	Dropdown list	None
.. Folder name	A pattern for the folder name to be included or excluded	Folder patterns Regular expression Script expression	Empty
.. On levels	The level or range of levels to which this rule applies, in the same format as the old "Subfolder range" property	Single-line text	Empty
.. Restriction	Defines an optional restriction on the parent or ancestors for the folder in this rule Possile values are: None With immediate parent named With no immediate parent named With any ancestor named With no ancestor named	Dropdown list	None
.... Parent name or .... Ancestor name	A pattern for the folder name of the parent or ancestor	Folder patterns Regular expression Script expression	Empty
.. Nesting	Defines whether this rule operates on all nested subfolders of the target folder, or just on the target folder itself Possible values for "including" rule are: Include nested subfolders as well Don't include nested subfolders Possible values for "excluding" rule are: Exclude nested subfolders as well Dont exclude nested subfolders	Dropdown list	"Don't include…" or "Exclude…"
Adjusted by (rule 2) .... Adjusted by (rule 5)	Same as rule 1 with an identical set of dependent properties

Applying rules

The rules are applied in the same order as they are specified. It is perfectly possible for a rule to exclude folders that were included by a previous rule, or vice versa.

For example, consider a hierarchy with two levels (in addition to the root folder) and where each level has three folders called A, B, C. Now, consider the following rules:

Start with no folders
Include folders named C on level 2 (with or without nesting)
Exclude folders named C on level 1 (with nesting)

These rules will process all jobs in folders A/C and A/B, but not in folder C/C (because it was excluded in the second rule), and not in any of the other folders (because they were never included to begin with).

Reversing the order of the rules would change the result (files in folder C/C will be processed as well), because excluding something from an empty set has no effect.

Upgrading

When upgrading from a previous version of Switch, the new properties are initialized as follows:

The new "Process these folders" property is set to "All folders"
If the old "Process only these folders" property is not set to "All folders", a rule is created as indicated in the following table
If the old "Skip these folders" property is not set to "No folders", a rule is created as indicated in the following table

If both old properties are present, the rules are listed in the order presented above (although the order is not important).

Property name	Value for "Process only these folders"	Value for "Skip these folders"
Adjusted by	"Excluding folders not named"	"Excluding folders named"
.. Folder name	The value of the "Process only these folders" property	The value of the "Skip these folders" property
.. On levels	The value of the corresponding dependent property	The value of the corresponding dependent property
.. Restriction	"None"	"None"
.. Nesting	"Exclude nested subfolders as well"	"Exclude nested subfolders as well"

These values should produce the same behavior as in the previous Switch version.