[Files] Pick Subset
Q100047: [Files] Pick Subset
Picks a subset of files from the supplied FileSource, up to the specified number of files, and returns their names in output list parameter.
| Parameter | In/Out | Description | Other Info |
|---|---|---|---|
| Active Directory Connection | In | Active Directory name and login credentials for account with permissions to perform the requested operation. Optional. | Connection type: sysAD |
| File source | InOut | The file source is a list of one or more files to select from, using fully qualified pathnames, such as a FileList output parameter from another module. A typical example being the [Files] Find module. |
|
| Mode | InOut | Choices: Random, Newest, Oldest, Largest, Smallest, First, LastThe subset mode determines how the files will be selected from the input list. |
Default: Random |
| Count | In | Number of files to select. | Default: 1Minimum: 1Maximum: 2147483647 |
| Low count action | InOut | Choices: Continue Job, Stop Job With Failure, Stop Job With SuccessIf the number of file cannot be chosen to meet the specified count, what action should the module respond with. |
Default: ContinueJob |
| Log output level | In | Choices: Minimal, VerboseThe level of execution detail you want to appear in the log. |
Default: Minimal |
| File list | Out | The list of selected files. | |
| Unselected File list | Out | The list of input files that were excluded from the File List. |
(Italics = required parameters)
Notes
The [Files] Pick Subset module is well suited for limiting the number of files you are going to pass to a subsequent step in your job. An example might be that you are processing files that might have a somewhat random number of output files, but you want to email the results to someone and their email can only accept up to 10 files per email message or else it is bounced to the SpamMail folder. Using this module, you can limit the number of files passed to the next step in your job.
Options such as randomizing the file list, going from newest to oldest, or going from largest to smallest, give you some flexibilty on how you can best apply this featured module.