tFTPFileList Standard properties

Property Type

Select the way the connection details will be set.

• Built-In: The connection details will be set locally for this component. You need to specify the values for all related connection properties manually.

• Repository: The connection details stored centrally in Repository > Metadata will be reused by this component. You need to click the [...] button next to it and in the pop-up Repository Content dialog box, select the connection details to be reused, and all related connection properties will be automatically filled in.

Use an existing connection

Select this check box and in the Component List click the relevant connection component to reuse the connection details you already defined.

Host

The IP address or hostname of the FTP server.

Port

The listening port number of the FTP server.

Username and Password

The user authentication data to access the FTP server.

To enter the password, click the [...] button next to the password field, and then in the pop-up dialog box enter the password between double quotes and click OK to save the settings.

Remote directory

The remote directory where the files and folders to be listed are located.

Move to the current directory

Select this check box to change the directory to the one specified in the Remote directory field. The next FTP component in the Job will take this directory as the root of the remote directory when using the same connection.

This property is available only when the Use an existing connection check box is selected.

File detail

Select this check box to list the details of each file/folder. The informative details include the file/folder permissions, the name of the author, the name of the group of users that have read/write permissions, the file size, and the last modification date.

Files

The names of the files/folders to be listed. You can specify multiple files/folders in a line by using wildcards or a regular expression.

SFTP Support

Select this check box to connect to the FTP server via an SFTP connection.

Authentication method

Select the SFTP authentication method, either Public key or Password.

• Public key: Enter the path to the private key and the passphrase for the key in the Private key and Key Passphrase fields correspondingly.

• Password: Enter the password required.

This property is available only when the SFTP Support check box is selected.

Filename encoding

Select this check box to set the encoding used to convert file names from Strings to bytes. It should be the same encoding used on the SFTP server. If the SFTP server's version is greater than 3, the encoding should be UTF-8, or else an error occurs.

This property is available only when the SFTP Support check box is selected.

FTPS Support

Select this check box to connect to the FTP server via an FTPS connection.

If you are using an HTTP proxy, via a tSetProxy component for example, you need to select this check box and set the connection mode to Passive.

Keystore File

The path to your keystore file, a password protected file containing several keys and certificates.

This property is available only when the FTPS Support check box is selected.

Keystore Password

The password for your keystore file.

This property is available only when the FTPS Support check box is selected.

Security Mode

Select the security mode from the list, either Implicit or Explicit.

This property is available only when the FTPS Support check box is selected.

Connection mode

Select the connection mode from the list, either Passive or Active.

Encoding

Specify the encoding type by selecting an encoding type from the list or selecting CUSTOM and enter the encoding type manually.

Use Socks Proxy

Select this check box if you are using a proxy, and in the Proxy host, Proxy port, Proxy user and Proxy password fields displayed, specify the proxy server settings information.

Ignore Failure At Quit (FTP)

Select this check box to ignore library closing errors or FTP closing errors.

Data Channel Protection Level

The data channel protection level with which data is transferred between the client and the server. For more information, see RFC 2228: FTP Security Extensions.

This property is available only when the FTPS Support check box is selected.

Protection Buffer Size

The maximum size (in bytes) of the encoded data blocks to be transferred between the client and the server. For more information, see RFC 2228: FTP Security Extensions.

This property is available only when the FTPS Support check box is selected.

Enable Remote Verification

Select this option to enable remote verification. This option solves FTPS server architecture compatibility issues. See setRemoteVerificationEnabled for related information.

This option is available when FTPS Support is selected in the Basic settings view.

tStatCatcher Statistics

Select this check box to gather the Job processing metadata at the Job level as well as at each component level.

ERROR_MESSAGE

The error message generated by the component when an error occurs. This is an After variable and it returns a string.

CURRENT_FILE

The current file name. This is a Flow variable and it returns a string.

CURRENT_FILEPATH

The current file path. This is a Flow variable and it returns a string.

NB_FILE

The number of the files processed. This is an After variable and it returns an integer.

Usage rule

This component is typically used as a single-component subJob but can also be used with other components.