Submit hierarchy

Submit hierarchy is a producer that supports one or more levels of subfolders. Since it is a producer, a submit hierarchy can be used only to submit jobs into a flow. The backing folder (on disk) for a submit hierarchy should typically be user-managed.

Each subfolder up to the nesting level specified by the “subfolder levels” property is treated as if it were an individual hot folder.

A file placed inside a subfolder at the specified nesting level, or at any level closer to the main folder, moves along the flow as a file.

A job folder placed inside a subfolder at the specified nesting level moves along the flow with its contents as a single entity (i.e. as a job folder).

A job folder placed on the same level as the allowed subfolders is treated as a subfolder by mistake, and its contents is moved along as separate files.

Keywords

Keywords can be used with the search function above the elements pane.

The keywords for the Submit hierarchy element are:

backing
folder
subfolder
structure
input
hot
watched

Connections

Submit hierarchy does not allow incoming connections.

Submit hierarchy injects folder filter properties into its outgoing connections so that it is possible to include/exclude certain subfolders in the hierarchy for particular connections. Also see the "skip folders" property described below.

Properties

Property	Description
Name	The name of the flow element displayed in the canvas
Path	The path of the submit hierarchy's backing folder on disk, or "auto-managed"
Leave originals in place	If set to yes, incoming jobs are left untouched in the hierarchy; Switch never writes to the hierarchy so read-only access rights suffice If set to no (the default), incoming jobs are moved out of the hierarchy; Switch needs full access rights to rename, create and remove files and folders in the hierarchy
Ignore Updates	The Ignore Updates option is only available if Leave Originals is set to yes. If set to yes, a job will only be processed once, regardless of any changes to the file size or modification date. This can be used for workflows where the input job is replaced by the processing result, to avoid triggering endless loops. If set to no, the job will be reprocessed when its file size or modification date is different. This allows processing jobs which have the same file name as previously submitted jobs.
Check every (minutes)	The frequency with which this submit hierarchy is scanned for newly arrived jobs; if “Default” or zero the global user preference is used instead; see Processing
Time-of-day window	If set to yes, the submit hierarchy detects (and moves) newly arrived jobs only during a certain time of the day (specified in the subordinate properties)
Allow from (hh:mm)	The time-of-day window during which to detect jobs; the values are structured as "hh:mm" (hours, minutes) indicating a time of day on a 24 hour clock; an empty value means midnight; two identical values mean the submit hierarchy always detects jobs
Allow to (hh:mm)
Day-of-week window	If set to yes, the submit hierarchy detects (and moves) newly arrived jobs only during certain days of the week (specified in the subordinate properties)
Allow from	The days of the week (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday) during which to detect jobs; two identical values mean the submit hierarchy only detects jobs on that specific day.
Allow to
Day-of-month window	If set to yes, the submit hierarchy detects (and moves) newly arrived jobs only during a certain day of the month (specified in the subordinate properties)
Day	The day in the month during which to detect jobs, as a number in the range [1 . .31]; the default value of one means the first or the last day of the month (depending on the following property)
Relative to	Determines whether the day of the month is relative to “Start of month’” or “End of the month”
Subfolder levels	The number of nested subfolder levels considered to be hot folders (as opposed to job folders); see also the description on subfolders earlier.
Process these folders	Defines the initial set of folders that should be processed. This set can be adjusted by defining rules in the subsequent properties
Adjusted by	This property defines a rule for adjusting the set of folders to be processed, by including or excluding folders matching or not matching a folder name. Different rules can be applied, and will be processed in the order as they are specified. Additional properties for this rule are: The Folder name used for matching The Levels, limiting the range of subfolder levels on which the rule applies. Your root folder is at level 0, its direct subfolders at level 1, and so on. This property allows you to include/exclude folder(s) at specific levels by entering a number or a range (e.g.: 2-4 or 1,3 or 3). It is especially helpful when working with folder names that are variable and not under your control (e.g.: customer names). A Restriction, based on the folder name of the parent or ancestors for the folder. If folder Y contains subfolder X; Y is X's parent folder. If folder Z then contains subfolder Y; Z is one of X's ancestors. The folder that contains folder Z is also one of X's ancestors, etc. Nesting, defining whether this rule operates on all nested subfolders of the target folder, or on the target folder itself.
Attach hierarchy info	If set to yes, (part of) a job’s submit location, depending on the hierarchy info configuration, is added to its hierarchy location path as it is submitted in the flow; see Using hierarchy info for more details
Include hierarchy name	Only available if Attach hierarchy info is enabled. If set to yes, the name of the flow element is included at the top of the remembered location path
Include subfolder levels	Identifies the number of hierarchy segments in the hierarchy information.
Save top subfolders	If set to yes, the top-most subfolders are remembered in the location path, otherwise the bottom-most subfolders are remembered
Attach email info	Email addresses and body text specified with the editor for this property are added to each job's email info as the job is submitted in the flow; the information added can vary depending on the subfolder in which the job was submitted; see Using email info for more details
Allow subfolder cleanup	If set to yes, subfolders created in the submit hierarchy (by an external process or a user) are automatically removed when they become empty
Starting at level	The number of upper levels for which not to cleanup subfolders