Getting a list of files and adding it to the result stream
There is a nifty sounding job entry called “Add filenames to result” that would be really cool to use if it were better documented. This step lets you specify multiple directories and regex patterns for a set of files to look for, then puts all matching filenames on the “result”.
So, what is the “result”? In this case, “result” means some data that is transferred from one job entry to the next. In the case of a list of files, this means the “Add filenames to result” entry will makes these filenames available to other job entries, presumably.
So, which job entries can use this list? This list is based off of a source code search for “getResultFilesList()” and “getResultFiles()”, which are methods of class Result. The last column “Reads file list” indicates that that component actaully reads the filenames from the list rather than setting or clearing it. These components would actually do something with the list of files.
| Classname | Category | Component name | Comments | Reads file list |
|---|---|---|---|---|
| JobEntryMSAccessBulkLoad | Bulk loading | MS Access Bulk Load | Imports multiple specified files into an Access file. Optionally adds imported files to list of files | |
| JobEntryMssqlBulkLoad | Bulk loading | BulkLoad into MSSQL | Imports a specified file into an MS Sql database. Optionally adds imported file to list of files | |
| JobEntryMysqlBulkFile | Bulk loading | BulkLoad from MySQL into file | Exports a mysql database to a file. Optionally adds imported files to list of files | |
| JobEntryMysqlBulkLoad | Bulk loading | BulkLoad into MySQL | Imports a specified file into a MySql database. Optionally adds imported file to list of files | |
| JobEntryAddResultFilenames | File management | Add filenames to result | lets you specify multiple directories and filenames/wildcards to add to the list of files. option to clear out a previous list of files first | |
| JobEntryCopyFiles | File management | Copy files | lets you copy folders/files, and the copied files are added to the list of files. no option to clear previous file list | |
| JobEntryCopyMoveResultFilenames | File management | Copy or move result filenames | will copy or move files in the file list. can optionally add the new filenames to the list. can optionally remove the old filenames from the list | X |
| JobEntryCreateFile | File management | Create file | Will create a file. Can optionally add it to the list of files | |
| JobEntryDeleteResultFilenames | File management | Delete filenames from result | deletes some or all of the files from the list of files. does NOT actaully delete the file from disk | X |
| JobEntryFileCompare | File management | File compare | Compares two files. Optionally adds both filenames to list of files | |
| JobEntryHTTP | File management | HTTP | Gets or uploads a file using HTTP. Will add a retrieved filename to the list of files | |
| JobEntryMoveFiles | File management | Move Files | lets you specify multiple directories and filenames/wildcards to be moved. optionally adds the new filenames to the list of files | |
| JobEntryUnzip | File management | Unzip file | Will unzip a file to a specified folder, including/excluding specified wildcards. Optionally adds filenames to list | |
| JobEntryWaitForFile | File management | Wait for file | Will wait for a file to show up - cannot use wildcards to specify file, only waits for a single file. Optionally adds the filename to the list | |
| JobEntryZipFile | File management | Zip file | Zips a set of files. Optionally adds zip file to list of files | |
| JobEntryFTP | File transfer | Get a file with FTP | gets files from FTP. optionally adds files to list | |
| JobEntrySFTP | File transfer | Get a file with SFTP | gets files using SFTP. optionally adds files to list | |
| JobEntrySFTPPUT | File transfer | Put a file with SFTP | puts files using SFTP. optionally adds uploaded files to list | |
| JobEntryJob | General | Job | Runs a job. Will add the log file to the list of files if specified | |
| JobEntryTrans | General | Transformation | Runs a transformation. Optionally, will clear out the list of result filenames before running. If a logfile is specified, will add the log file to the list of files | |
| JobEntryMail | allows you to email the list of files as individual attachments or a zip file | X | ||
| JobEntryExportRepository | Repository | Export repository to XML file | exports the repository to an xml file. optionally adds the file name to the list of files | |
| JobEntryXMLWellFormed | XML | Check if XML file is well formed | Checks XML files for well formedness. Optionally adds all/good/bad files to list | |
| JobEntryXSLT | XML | XSL Transformation | Transforms a single XML file. Optionally adds the transformed file to list |
