Enumerates all files matching the specified criteria in the specified location. Includes support for local files, UNC paths. FTP, SFTP anf FTPS.

Revision History - Added support for explicit passive & active FTP, added support for custom timeout, some bug fixes - Added support for SSH Authentication by providing certificate contents, changed property names for consistency. - Updated the SFTP libaray which contains bug fixes. - Updated the node to re-evaluate the files when an input property changed. - Fixed bug where list of files is not re-evaluated when run downstream from a trigger - Fixed bug where TotalRows was cleared when the Finished output is fired. - Provide a meaningful error when properties are missing



Type: Connection Input
Provides a Connection and optionally a DropPoint to service the request.

Type: String
The username used to authenticate access to the FTP or SFTP server

Type: String
The password used to authenticate access to FTP or SFTP server

PrivateKeyFileContentsType: Multiline Text Data
The SSH Certificate contents used to authenticate to SFTP or FTPS

Type: Boolean
When True , indicates that the target path should be created if it does not already exist.

Type: Boolean
Some servers are configured to expect the PASV command when a connection is initialized. The Node then sends the PASV command instead of the PORT command when initiating a connection to the Server. 


Type: String Input
The path to the directory from which files should be listed.


Type: String Input
The search string to match against the names of files in the path.
Filter can be a combination of literal and wildcard characters, but doesn't support regular expressions. The following wildcard specifiers are permitted in Filter. * (asterisk) Zero or more characters in that position. ? (question mark) Zero or one character in that position. Characters other than the wildcard are literal characters. Filter cannot end in two periods ("..") or contain two periods ("..") followed by Directory Separator Character, nor can it contain any invalid characters.


Type: Boolean Input
When true, all files in directories under the primary directory will also be enumerated. When false only files directly under the primary directory will be listed.


Type: Boolean Input
When true, the full path to the file will be provided on the FileName output. When false, only the file name will be provided.


Type: String Output
Returns the name of each file found in turn.


Type: Int32 Output
An incrementing counter, returning the index of the current file in the returned list.


Type: Int32 Output
Returns the total number of files which match the supplied criteria.


The File Enumerator enumerates files based on the specified criteria. 

The prefix provided as part of DirectoryPath determines the file type as follows:

  • [Drive]:\ local drive

  • \\ UNC path for network share

  • ftp:// FTP

  • sftp://  SFTP

  • ftps:// FTPS

When accessing a local filesystem, a DropPoint must be used, not using a DropPoint will result in the error "An operation requiring File access permission was denied." Direct connections may only be used for FTP/SFTP servers.


The Username and Password or PrivateKeyFileContents provided in the Connection Property will be used to authorize FTP or SFTP sessions only. If you require specific credentials to gain access to a local file or UNC path, change the Windows Service account used by the DropPoint.

See Also

File Watcher
Flat File

Did this answer your question?