Run FTP Commands
Description
Runs a list of FTP commands on the specified FTP server.
You can enter the list of commands to be run in the code of the action, separated with line returns.
FTP protocol is designed to use raw commands, but most common
implementations comes with a set of higher-level commands.
For instance, there is a set of command aliases supported in Windows,
another with Linux, such as dir'' or
ls'', which are transformed to
the same raw FTP commands behind the scenes.
This action supports both using commands alias such as ``cd'', and raw FTP commands, such as CWD.
The complete list of supported commands can be found further in this documentation.
Parameters
Name | Mandatory | Default | Description |
---|---|---|---|
FTP Hostname |
Yes |
FTP host name or IP address. |
|
FTP Port |
No |
21 in normal mode, 990 in secure mode. |
FTP host port. |
FTP User |
Yes |
FTP user. |
|
FTP Password |
This user’s encrypted password. |
||
FTP Unencrypted Password |
This user’s password in plain text. |
||
FTP Passive Mode |
No |
true |
Use FTP passive (PASV) mode. |
FTP File Mode |
No |
ascii |
FTP file transfer mode: ascii or binary. |
FTP Remote Path |
No |
Remote FTP path. |
|
FTP Disable Login |
No |
false |
If true, the connection to the server will be performed anonymously, without using the login credentials. |
FTP Implicit FTPs |
No |
true |
Use FTPs Implicit mode. |
FTP Secured Protocol |
No |
None |
Protocol used for FTPs communication: none, tls, ssl. |
FTP Protection Buffer Size |
No |
Defines the size to use for the Protection Buffer. Please refer to your FTP server provider for the possible values. |
|
FTP System Type |
No |
Specifies the system type of the FTP Server. This helps to better treat the responses of the server. By default, the Runtime will try to auto-detect it. The following types are supported: UNIX,VMS,WINDOWS,OS/2,OS/400,AS/400,MVS,TYPE: L8,NETWARE |
|
Ignore Trust Store |
No |
false |
If true, the specified Trust Store will be ignored. |
Proxy Host |
No |
Host name for the proxy server. |
|
Proxy Port |
No |
1080 |
Port of the proxy server. |
Proxy User |
No |
Proxy server user. |
|
Proxy Password |
No |
Proxy server user password, encrypted. |
|
Proxy Unencrypted Password |
No |
Proxy server user password in plain text. |
|
Proxy Protocol |
No |
Protocol used for the proxy server: HTTP, SOCKS, SOCKS4 or SOCKS5 . |
|
Socket Timeout |
No |
Timeout of the command on the socket. |
|
Connection Timeout |
No |
Timeout of the FTP connection. |
|
Data Timeout |
No |
Data Timeout of the FTP connection. |
|
Key Store |
No |
Full path to the Java Key Store to use when connecting to the server. |
|
Key Store Type |
No |
JKS |
Type of the Java Key Store. |
Key Store Password |
No |
Encrypted password of the Java Key Store. |
|
Trust Store |
No |
Full path to the Java Trust Store to use when connecting to the server. |
|
Trust Store Type |
No |
JKS |
Type of the Java Trust Store. |
Trust Store Password |
No |
Encrypted password of the Java Trust Store. |
Passwords are encrypted using the encrypt <password> command
on the Runtime engine console (engine command line tool).
|
Published Variables
Name |
Description |
Command |
APPEND_ADDED_FILE_SIZE |
Size of the added data |
Append |
DELETED_FILES_SIZE |
Size of the deleted file |
Deleted |
DELETED_FILES_SIZE |
Size of deleted files |
MDeleted |
DELETED_FILES_NUMBER |
Number of deleted files |
MDeleted |
LISTED_FILES_NUMBER |
Number of files listed |
Dir |
LISTED_FILES_SIZE |
Size of files listed |
Dir |
RETRIEVED_FILES_SIZE |
Size of the file received |
Get |
RETRIEVED_FILES_SIZE |
Size of files received |
MGet |
RETRIEVED_FILES_NUMBER |
Number of files received |
MGet |
STORED_FILES_SIZE |
Size of the file sent |
Put |
STORED_FILES_SIZE |
Size of files sent |
MPut |
STORED_FILES_NUMBER |
Number of files sent |
MPut |
STORED_FILES_SIZE |
Size of the file sent |
Stou |
Supported commands
FTP commands supported by the action:
Commande | Description | Supported Aliases | Examples |
---|---|---|---|
active |
Enter active transfer mode. |
active |
|
append |
Append to a remote file. |
appe |
append [local_file]append [local_file] [remote_file] |
ascii |
Switch to ASCII transfer mode. |
ascii |
|
binary |
Switches to binary transfer mode. |
binary |
|
bye |
Terminate ftp session and exit. |
close, disconnect, exit, quit |
bye |
cd |
Changes remote working directory. |
cwd |
cd [remote_folder] |
cdup |
Change remote working directory to parent directory. |
cdup |
|
connect |
Connect to remote ftp. |
open |
connect [hostname] [port] |
delete |
Deletes a remote file. |
dele |
delete [remote_file] |
dir |
List contents of remote directory. |
list, ls, mlsd, mlst, nlst |
dirdir [remote_directory] |
get |
Get file from the remote computer. |
recv, retr |
get [remote_file]get [remote_file] [local_file] |
help |
Accesses the Help screen and displays information about the command if the command is typed after help. |
rhelp |
help |
lcd |
Displays local directory if typed alone or if path typed after lcd will change the local directory. |
lcdlcd [local_directory] |
|
login |
Send new login information. |
login [user] [password] |
|
mdelete |
Delete multiple remote files. |
mdelete [remote_pattern] |
|
mdtm |
Show last modification time of remote file. |
modtime |
mdtm [remote_file] |
mget |
Get multiple files. |
mget[remote_pattern] |
|
mkd |
Make directory on remote computer. |
mkdir, xmkd |
mkd [remote_directory] |
mput |
Send multiple files to remote computer. |
mput[local_pattern]mput[local_pattern][remote_pattern] |
|
newer |
Get file if remote file is newer than local file.Timezone is like : GMT-2 or GMT+2 |
newer [remote_file]newer [remote_file] [local_file]newer [remote_file] [local_file] [local_timezone] |
|
pass |
Send new password information. |
password |
pass [thy_password] |
passive |
Enter passive transfer mode. |
pasv |
passive |
put |
Send one file to remote computer. |
send, stor |
put [local_file][remote_file] |
pwd |
Print working directory on remote machine. |
pwd |
|
rename |
Renames a remote file. |
rnfr & rnto |
rename [remote_actual_name][remote_expected_name] |
rmd |
Removes a directory on the remote computer. |
rmdir |
rmd [remote_file] |
site |
Send site specific command to remote computer. |
site [command] [args…]site help |
|
size |
Show size of remote file. |
size [remote_file] |
|
stat |
Show current status of remote computer. |
status |
statstat [remote_file] |
stou |
Store file uniquely. |
stou [local_file]stou [local_file] [remote_file] |
|
syst |
Show remote system type. |
system |
syst |
type |
Set file transfer type. |
type binarytype ascii |
|
user |
Send new user information. |
user [thy_user] |
|
verbose |
Sets verbose on or off. |
verbose |
|
<RAW COMMAND> |
Any raw command is sent as is to the FTP server. |
CWD |
Unknown commands and raw commands are sent as is to the FTP server, meaning that using commands which are not listed above may work even if it is not in the list. |
Beware some FTP servers can add technical response code (3
digits) at the beginning of response message. So it can be confusing for final users to read some commands results. For example, take a 98 bytes file named file.txt .The SIZE file.txt`command may return `213 98 , 213 is the
technical code (ie response OK) and 98 is the size.
|