FTP_PUT Type Uproc

Click OK to save the Uproc and close the window or Cancel to close the window without saving.

FTP_PUT type Uproc characteristics:

• The folder and file names may contain a variable or a code, refer to Use Variables.
• Empty origin and destination file names will be interpreted as a multiple download (like if * is used), refer to Use Wildcards.

From

• Host

  Node name associated with the Management Unit where the Uproc will be executed. This field cannot be modified for the type FTP_PUT.

• Source file name

  Name of local file to send to the FTP server (optional). Format: maximum of 256 alphanumerical characters.

  By default, unless specified otherwise, all files in the local folder will be sent to the FTP server (multiple transfers: "MPUT").

• Source path name

  Name of the local folder from which files are to be sent. This is mandatory. Format: maximum of 256 alphanumerical characters, * forbidden

To

• Host

  Host name of the machine to connect to (the FTP server) or its IP address. Format: alphanumerical characters (mandatory).

• Logon

  User name for connection to the FTP server (optional). Format: Maximum of 32 alphanumerical characters. By default, unless specified otherwise, the connection will be made in anonymous mode (if this is authorized by the FTP server).

• Password

  Password of the specified user name (optional). Format: maximum of 32 alphanumerical characters.

  By default, the connection will be made with an empty password field. The connection will only be established if the FTP server authorizes users (or anonymous user if the user is not specified) to connect without a password.

  If the SFTP protocol is used with the public / private key authentication, this field will be ignored (refer to section: Dollar Universe – FTP settings).

• Destination file name

  Name of the file on the FTP server, only when a single file is to be transferred (Optional). Format: Maximum of 256 alphanumerical characters.

  By default, the transfer will maintain the source file name.

• Destination path name

  Name of the destination folder on the FTP server to which files will be sent. This is optional with FTP but mandatory with SFTP. Format: maximum of 256 alphanumerical characters, * forbidden.

  If not specified, the FTP server will determine the folder where files will be saved, based on its default values. The folder will be created on the FTP server if it does not exist.

Settings

• Transfer mode

  Choice between "ASCII" and "BINARY". Click the arrow to select one of the two options. The BINARY type uses file transfers without conversions. In SFTP mode, this field is ignored. SFTP protocol uses binary mode only.

• Delete source file

  To delete the source file(s) after the transfer.

  • Selected: The source file(s) will be deleted if the transfer is successful.
  • Not selected: The source file(s) will be kept (default).

• Recursive

  When enabled, the recursive option allows the transfer of whole files and sub-directories of the Source path name set in the General section (the Source file name and the Destination file name can't be edited). When using the recursive option, the recursion depth limit is set to 150 directories.

  The Recursive option uses the FTP LIST command internally to get a list of files and directories on the remote server. The expected server answer must be formatted so each line starts with the file permissions in UNIX format. Since this answer varies from a server to another, the feature will not work if the answer has a different format. Should this happen, a fail-over option is available: it tests each single file on the specified remote server location with a FTP CWD command to check the existence of a directory. The fail-over option is less performing but it can be enabled with the U_FT_GET_DIR_FAILOVER node setting in the Dollar Universe – FTP settings category.

• Action if exists

  This option determines what should happen if the file already exists on the FTP server. The choices are "Replace", "Abort", "Append" and "None". Click on the arrow to select one of the actions in the list.

  • Replace: Replaces the remote file (if it exists) by the local file sent to the FTP server.
  • Abort: Aborts the transfer and returns an error (default).
  • Append: Appends the file sent to the remote file (if it exists), (ASCII mode only).
  • None: Cancels the transfer without any error.

• Buffer Size

  This field is not used in the case of an FTP PUT.

• Retry

  Number of additional attempts if a transfer fails, before leaving in error (default = 0). The user must enter a positive or null number on one digit. This field applies only for the FTP transfer part of the Uproc in case of failure. It does not retry the whole Uproc in case of error.

• Umask

  Not available for type FTP_PUT

  • Linux-like OS: files are uploaded with their original permissions.
  • Windows: files are uploaded with 755 as permission (the octal permissions doesn't natively exists for Windows)

• Newer only

  Date comparison before transfer. This option is ignored if the action "Abort" or "None" were selected.

  • Selected: The local file is only transferred if it is more recent than the remote file.
  • Not selected: The local file is sent without checking its date (default).

  Warning! This option is not supported by SFTP by default. To see if SFTP has been configured, see the node setting U_FT_SFTP value.