A source is a reference to a host that defines a single location from which files are obtained for use in a task. A task can be configured with an unlimited number of sources.
Common Source Options:
For filesystem, MOVEit Transfer, FTP, and SSH hosts, you may use wildcards here. For example, "/home/jal/data*/reports" will match any folder named "reports" which is a direct subfolder of a folder whose name starts with "data" and which is a subfolder of /home/jal. For example, both /home/jal/data/reports and /home/jal/dataaccounting/reports match, but /home/jal/reports does not.
Additionally, a special MOVEit Automation-specific "**" wildcard operator is available. "**" matches any number of intermediate subfolders. For instance, "/home/jal/**/reports" matches any folder named reports which is a direct or indirect subfolder of jal. The folders /home/jal/data1/2005/07/reports, /home/jal/2005/reports, and /home/jal/reports all match this folder specification, but /home/jal/2005/report1 and /home/jal/2005/reports/mydata do not. (However, that last folder would match if "Include Subdirectories" were checked.) Note that a trailing ** means the same thing as checking "Include Subdirectories"; e.g. /home/jal/2005/** means the same thing as /home/jal/2005 with "Include Subdirectories" checked.
Full UNC paths cannot be used here when using the local filesystem host. In order to use a remote filesystem by UNC or mounted drive letter, the host must be added as a Share to the hosts list. If a UNC is entered, MOVEit Automation Admin will attempt to find a matching Share host to use instead, and prompt the user to use that host.
There are two special wildcard characters:
*, which matches zero or more characters at that position in the filename |
?, which matches exactly one character at that position in the filename |
You may use multiple wildcard characters in a single mask.
For example, a*.rpt matches a.rpt, a1.rpt, and apple.rpt, but not apple.rp or lemon.rpt.
a?.rpt matches a1.rpt and aQ.rpt, but not a.rpt, a12.rpt, or a1.rp
You may also use multiple filenames or filemasks, separated by semi-colons (";"). The semi-colons act as an "Or" operator. For instance, the filemask "fred*.*;*.zip" will match fred7.txt and will also match sally.zip.
The ampersand operator ("&") acts as an "And" operator unless it is preceded by $. ("$&" means to match an ampersand literally.) For instance, given a filemask of "*.txt&ready.dat&final.log", MOVEit Automation will not process any files on the source location unless "ready.txt", "final.log" and at least one "*.txt" file are available. A semi-colon (";") has a higher precedence than "&", so "*.txt;*.doc&*.zip" means "either *.txt or *.doc, AND ALSO *.zip".
If you want the task to wait until all filetypes in the mask are available from the source, also choose Retry If No Files Found.
Note: If the filemask on an existing source is changed, and the Collect Only New Files option is enabled, a confirmation message will be displayed warning the user that changing the filemask while collecting only new files could cause old files to be downloaded from the source host. This is because file collection timestamps are stored by filemask internally in MOVEit Automation. Changing the filemask negates existing timestamps.
Filters are built in a pop-up window accessed through the nearby "Edit" button. Supported size filters are expressed in your choice of bytes, KB, MB or GB. Supported date/time filters are expressed the difference between now and some other date in hours, days, months or years. A "match all/any" selection controls whether files must match all or just one of the filter criteria.
NOTE: If the source is using an FTP or SSH host with the Blind Downloads option enabled, the Browse button will not be available. Blind Downloads are used when the client is not allowed to do directory listings, or directory listings will not appear correctly. The Browse button usually will not function correctly in these situations, so it is disabled.
NOTE: browsing will not work if the username or password fields contain references to certain types of macros, such as non-global task parameters.
Note: State information for the "Collect Only New Files" option is saved on a per-Task basis, not on a per-Host bais. If the task has run previously and sent files, the files will be resent initially after turning on the option, if they still exist on the source.
See POP3 Sources for the special case of deleting POP3 messages.
If unchecked, a directory listing returning no files is not retried, and as a result, no files are downloaded from this source.
Specialized Source Options:
The value is the number of seconds to wait between scans. The default is 0, which deactivates the feature .A reasonable value for when you do need the feature might be 5 or 10 seconds. (This setting will be overriddent if specified in any source related to this host.)
If the Re-Run Task Automatically option is enabled, Central will automatically re-run the task if the configured limits are exceeded, allowing Central to pick up the remaining source files without waiting for the next scheduled run of the task. Note that if this option is enabled and neither the Collect Only New Files or Delete/Rename After Successful Download options are enabled, the task could potentially end up looping indefinitely. For this reason, MOVEit Automation Admin will display a warning message if it detects this condition while a source is being edited.
See also AS1, AS2, AS3.