[Files] Join
Q100058: [Files] Join
Join a list of specified pathnames (files) together.
| Parameter | In/Out | Description | Other Info |
|---|---|---|---|
| File source | InOut | The file source is a list of one or more files to process, using fully qualified pathnames, such as is provided by the FileList output parameter from other modules. A typical example being the [Files] Find module. |
|
| Output Folder | In | The local or network folder to write the joined file(s) to. If not specified, the joined files will be written back to the same location as the source files. | |
| Sort Files | In | Set to true to sort files by filename; otherwise will take files in the order they appear. | Default: true |
| Separator Line | In | Sequence of characters that will be injected between joined files. | |
| Log output level | In | Choices: Minimal, VerboseThe level of execution detail you want to appear in the log. |
Default: Minimal |
| Processed file list | Out | List of pathnames (files) that were processed. |
(Italics = required parameters)
Notes
The [Files] Join module can be used to join together, or concatenate, multiple files into a single file. This is typically used with text or log files in specific formats. If the supplied list of files in the File Source is in the exact order it should be joined in, then the module will create the specified output by concatenating the files in that same order. However, if the files have filenames that designate the order they should be joined, then setting the Sort Files parameter to true will make sure the files are sorted regardless of what order they might appear in within the File Source.
If the files being joined are plain text files, logfiles, or other such similar file type, then the Separator Line parameter allows you to inject this specified line of text in between each file that is joined together. Otherwise leave this value blank if you do not need a separator, or are joining binary files back together.