Use this operation to establish a connection to an FTP server.
The operation does not have any special requirements.
The operation properties are organized into the following pages:
This page contains properties common for all operations. For more information on
them, see Properties That Are Common for All Operations.
Server name or IP-address of the FTP server. For instance, ftp.ourwebsite.com.
Port of the FTP server. The default value is 21.
User Name and Password
Your account name and password used to connect to the FTP server. The default user name is anonymous.
Use Passive Transfer
Specifies whether to use active or passive transfer mode. In active transfer mode, a connection is initiated by the FTP server while the FTP client (Automated Build Studio) listens to incoming TCP connections. In passive transfer mode, a connection is initiated by the FTP client (Automated Build Studio). Passive transfer mode may be used if the computer is behind a firewall or proxy server and cannot accept incoming TCP connections.
Specifies whether you access the Internet via a proxy server. Turning this option on will enable the following properties:
The type of the proxy server that should be used to access the Internet. The following values are available:
Host Name and Port
Address and port of the proxy server. The default value for Port is 1080.
Your account name and password on the proxy server.
Note that in any property on this page, where it is possible, you can either enter the desired value itself, or specify an existing variable or constant that holds this value. To specify the property values, you can also use the single-lined scripts.
Do Not Use Secure Protocols
If this property is selected a secure protocol will not be used to access the Internet.
Select this property to use the SSL secure protocol to access the internet.
Specifies the version of the SSL protocol. The available variants are 2.0 and 3.0.
Select this property to use the SSL/TLS secure protocol to access the internet.
If this property is selected the Explicit TLS mode of the SSL/TLS secure protocol will be used.
If this property is selected the Implicit TLS mode of the SSL/TLS secure protocol will be used.
TLS Support is Required
This property specifies what the operation does if server does not support the SSL/TLS connection. If the property is checked the operation fails, otherwise the operation does not use a secure protocol to access the internet.
Use The Clear Command Channel (CCC) Command
Check this property to send the Clear Command Channel command to the server after authentication. It means that SSL/TLS protocol is used only for authentication on the server. After authentication the secure protocol will not be used.
Server Authentication Certificate File
Specifies the name and path to the server authentication certificate file (.cer).
Specifies the level of certificate chain to accept. 0 means the root server certificate is accepted.
Client Authentication Certificate File
Specifies the name and path to the client authentication certificate file (.pfx).
Private Key Password
The password used for authentication on the specified server.
You can use variables and constants to set values of operation properties. When specifying the variable (or constant) name, enclose it in the % symbols, for instance, %VariableName%. See Using Variables and Constants in Operation Properties.
To finish working with the FTP server, close the connection: execute the Disconnect From FTP operation. If you do not do so, the connection will be closed automatically at the end of the macro execution.
The macro execution engine only allows one live FTP connection per thread (that can be an operation or a group of operations). That is, a macro with a serial execution path uses a single connection for all operations that interact with an FTP server. If you execute the Connect to FTP operation while a connection established by another Connect to FTP operation is still live, the existing connection will be closed permanently and the new one will be established. In a macro with concurrently executed operations, each thread uses a separate FTP connection. So, each concurrent group that contains operations that interact with an FTP server must have its own Connect to FTP operation. For more information or running macro operations concurrently, see Concurrent Execution of Operations.
© 2012 SmartBear Software. All rights reserved.