FTP Advanced

Description

Sends specific customized commands to an FTP server. For most transactions, use the standard FTP Upload/Download actions.

The standard FTP Download and FTP Upload commands send predetermined command sequences to the server. FTP Advanced is useful when it is necessary to create perform a customized sequence of commands. For example, the FTP Advanced action could be used return a folder listing.  This list could then be looped using the Loop List action to "examine" each file (such as the date) before performing some other action for each individual file based on the result.  Advanced FTP can also be used to perform commands that are server specific and/or not supported by other Automated Workflow FTP actions such as "Move" (moves the file on the FTP Server without downloading it first).

Declaration

<AMFTPADVANCED FTPCOMMAND="text" PARAMETER="text" RESULTVARIABLE="text [variable name]" SENTDATAVARIABLE="text [variable name]" SESSION="text [session name]">

Example

<AMFTPADVANCED FTPCOMMAND="connect" />

General Tab Parameters

FTP command: Specifies the command to execute. The available commands are:

  • Connect: Connect to an FTP server. Example parameter: ftp.domain.com or 207.46.133.140.

  • Username: Provide a username for logging in (USER). Example parameter: anonymous.

  • Password: Provide a password for logging in (PASS). Example parameter: anonymous@domain.com

  • Help: Retrieve FTP help information (HELP).

  • System information: Retrieve information about the remote FTP server (SYST).

  • Site command: Issue server specific commands that are not part of the FTP RFC (SITE). Examples include CHMOD or DIRSTYLE. Example parameter: CHMOD 744 FileName.exe

  • Passive mode: Switch to passive mode to negotiate file transfers through firewalls (PASV).

  • Ascii mode: Switch to ASCII transfer mode (TYPE A). Used when transferring text files with FTP servers that do not use ASCII as the base character set. One example is EBCDIC.

  • Binary mode: Switch to binary transfer mode (TYPE I). Used when transferring binary files.

  • Download file (get): Download one file (PORT followed by RETR). Similar to DOS FTP 'get'.Example parameter: \"/Remote FileName.exe\" [optional]\"C:\\Local FileName.exe\"

  • Download multiple files (mget): Download multiple files using a mask (multiple PORT and RETR). Similar to DOS FTP 'mget'.    Example parameter: /*.exe

  • Upload file (put): Upload one file (PORT followed by STOR).Similar to DOS FTP 'put'. Example parameter: \"C:\\Local FileName.exe\" [optional]\"/Remote FileName.exe\"

  • Upload multiple files (mput): Upload multiple files using a mask (multiple PORT and STOR). Similar to DOS FTP 'mput'. Example parameter: \"C:\\*.exe\"

  • Delete file: Delete one file (DELE). Example parameter: \"/FileName.exe\"

  • Delete multiple files (mdelete): Delete files using a mask (multiple DELE). Similar to DOS FTP 'mdelete'. Example parameter: \"/*.exe\"

  • Rename file: Rename a file (RNFR followed by RNTO). Example parameters: FileName.exe \"New FileName.exe\"

  • Create folder: Create a folder (MKD). Example parameter: \"New Folder\"

  • Remove folder: Remove a folder (RMD). Example parameter: \"Old Folder\"

  • Change folder: Change the current folder (CWD). Example parameter: \"New Folder\"

  • Up one folder: Change to the parent folder (CDUP)

  • Retrieve current folder: Retrieve the current folder (PWD)

  • Get short file list: Retrieve a basic file listing (PORT followed by NLST). Example parameter: *.exe

  • Get long file list: Retrieve a verbose file listing (PORT followed by LIST). Example parameter: *.exe

  • Disconnect: Disconnect from an FTP server.

  • User defined: Issue a custom command to an FTP server.

Text, Required
MARKUP:
FTPCOMMAND="connect"

Parameter(s): Specifies the parameter for the command specified. The use of this parameter varies depending on the command selected and in certain cases is not used.

Text
MARKUP:
a) PARAMETER="c:\filename.txt"
b) PARAMETER="Foldername"

Session name: Specifies the session (created in a previous FTP Log On action) that should be used to perform the download. This allows for multiple simultaneous FTP transfers to take place.

Text, Optional default="default"
MARKUP: SESSION="ServerB"

Data Tab Parameters

Populate variable with return data: Specify the variable that is to be populated with the return data. (The workflow must have variables defined for the variable to be available in this list.)

Populate variable with sent data: Specify the variable that is to be populated with the sent data. (The workflow must have variables defined for the variable to be available in this list.)

See Also

FTP Log On, FTP Upload, FTP Download, FTP Delete, FTP Rename, FTP Create Folder, FTP Remove Folder, FTP Change Folder, HTTP Post