[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 |
|---|---|---|---|
| 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: ContinueJob, StopJobWithFailure, StopJobWithSuccessIf the number of file cannot be chosen to meet the specified count, what action should the module respond with. |
Default: ContinueJob |
| File list | Out | The list of selected files. |
(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.