tFTPPut
tFTPPut Standard properties
These properties are used to configure tFTPPut running in the
Standard Job framework.
The Standard
tFTPPut component belongs to the Internet
family.
The component in this framework is available in all Talend
products.
Basic settings
Property Type |
Select the way the connection details
|
Use an existing connection |
Select this check box and in the Component List click the relevant connection component to |
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 |
Local directory |
The local directory from which the files will be uploaded to |
Remote directory |
The FTP directory where the uploaded files will be placed. |
Move to the current directory |
Select this check box to change the directory to the one specified in the This property is available only when the Use an existing |
Transfer mode |
Select the transfer mode from the list, either asciibinary. |
Overwrite file |
Select the action to be performed when the file already
overwrite, resume, and |
Append |
Select this check box to append data at the end of the file in order to avoid |
SFTP Support |
Select this check box to connect to the FTP server via an SFTP connection. Warning: This option does not work with an HTTP/HTTPS proxy. If you need a
proxy, set a SOCKS proxy in the Advanced settings tab. |
Authentication method |
Select the SFTP authentication method, either Public key or
This property is available only when the |
Filename encoding |
Select this check box to set the encoding used to convert file names from Strings to This property is available only when the |
FTPS Support |
Select this check box to connect to the FTP server via an FTPS If you are using an HTTP proxy, via a tSetProxy component for example, |
Keystore File |
The path to your keystore file, a password protected file containing several keys and This property is available only when the |
Keystore Password |
The password for your keystore file. This property is available only when the |
Security Mode |
Select the security mode from the list, either Implicit or This property is available only when the |
Use Perl5 Regex Expression as Filemask |
Select this check box to use Perl5 regular expressions in the For more information about Perl5 regular expression syntax, see Perl5 Regular Expression Syntax. |
Use Perl5 Regex Expression as Filemask |
Select this check box to use Perl5 regular expressions in the For more information about Perl5 regular expression syntax, see Perl5 Regular Expression Syntax. |
Files |
Specify the files to be uploaded.
|
Connection mode |
Select the connection mode from the list, either Passive or |
Encoding |
Specify the encoding type by selecting an encoding type from the list or selecting |
Die on error |
Select the check box to stop the execution of the Job when an error occurs. Clear the check box to skip any error and continue the Job execution process. |
Advanced settings
Use Socks Proxy |
Select this check box if you are using a proxy, and in the Proxy |
Ignore Failure At Quit (FTP) |
Select this check box to ignore library closing errors or FTP closing errors. |
Connection timeout |
Specify the timeout value (in ms) for the connection. A value of 0 or any negative values will be ignored. In this case, the default value (that is, 60000ms) will be used. |
Data Channel Protection Level |
The data channel protection level with which data is transferred between the client and This property is available only |
Protection Buffer Size |
The maximum size (in bytes) of the encoded data blocks to be transferred between the This property is available only |
tStatCatcher Statistics |
Select this check box to gather the Job processing metadata at the Job level |
Global Variables
ERROR_MESSAGE |
The error message generated by the component when an error occurs. This is an After |
NB_FILE |
The number of the files processed. This is an After variable and it returns an integer. |
CURRENT_STATUS |
The execution result of the component. This is a Flow variable and it returns a |
CURRENT_FILE_EXISTS |
The result of whether the current file exists. This is a Flow variable and it returns a |
TRANSFER_MESSAGES |
The file transferred information. This is an After variable and it returns a |
Usage
Usage rule |
This component is typically used as a single-component subJob |
Putting files onto an FTP server
in a local directory onto an FTP server.
Creating a Job for putting files onto an FTP server
Create a Job to connect to an FTP server, then put several local files
onto the server, finally close the connection to the server.
-
Create a new Job and add a tFTPConnection component, a tFTPPut
component, and a tFTPClose component by typing
their names in the design workspace or dropping them from the Palette. -
Link the tFTPConnection component to
the tFTPPut component using a Trigger > OnSubjobOk
connection. -
Link the tFTPPut component to the
tFTPClose component using a Trigger > OnSubjobOk
connection.
Opening a connection to the FTP server
component to open a connection to the FTP server.
-
Double-click the tFTPConnection
component to open its Basic settings view. -
In the Host and Port fields, enter the FTP server IP address and the listening port
number respectively. - In the Username and Password fields, enter the authentication details.
-
From the Connection Mode drop-down
list, select the FTP connection mode you want to use, Active in this example.
Putting files onto the FTP server
component to put several local files onto the FTP server root directory.
-
Double-click the tFTPPut component to
open its Basic settings view. -
Specify the connection details required to access the FTP server. In
this example, select the Use an existing connection
check box and from the Component list drop-down
list displayed, select the connection component to reuse its connection details you
have already defined. -
In the Local directory field, specify
the local directory that contains the files to be put onto the FTP server. In this
example, it is D:/components. -
In the Remote directory field, specify
the FTP server directory onto which the files will be put. In this example, it is
/, which means the root directory of the FTP
server. -
Clear the Move to the current
directory check box. -
In the Files table, click twice the
[+] button to add two lines, and in the two
Filemask column fields, enter *.txt and *.png
respectively, which means only the text and png files in the specified local
directory will be put onto the FTP server root directory.
Closing the connection to the FTP server
component to close the connection to the FTP server.
-
Double-click the tFTPClose component
to open its Basic settings view. -
From the Component list drop-down
list, select the tFTPConnection component that
opens the connection you need to close. In this example, only one tFTPConnection component is used and it is selected by
default.
Executing the Job to put files on the FTP server
the Job for putting files onto the FTP server, you can then execute the Job and verify
the Job execution result.
-
Press Ctrl + S to save the Job and
then F6 to execute the Job. -
Connect to the FTP server to verify the result.
As shown above, only the text and png files in the local directory are put onto
the FTP server.