FTP Upload Action

Upload File

Connection

Select the connection (see FTP Connect action.)

Upload file options

Local Directory

Specify the local directory where the files which you want to upload are located.

Filename or Filespec

If you are uploading a single file, then enter the filename here (without directory, as that is specified with Local Directory). If you want to upload multiple files, then enter a filespec, eg. *.zip, or MyProject.*

Recursive

If you specify a filespec, then setting the recursive option will find any matching files in any subdirectories of the Local Directory. The files will be placed into the correct subdirectories on the FTP server. Subdirectories on the server will be created if required.

Remote Filename

If you are uploading a single file, then you can change the name of the uploaded file on the server.

Check size of files uploaded

This option will attempt to check the size of the file uploaded against the size of the original file and fail if the size differs. This option doesn't work with all FTP servers.

Detailed FTP Logging

Outputs the raw FTP commands and log messages to the log.

Maximum Upload Speed

You can choose a maximum speed in (in kilobytes per second) to throttle the upload. This allows you to conserve bandwidth for other applications.

Update Options

Update options

The update options allow you to conserve bandwidth and time by only uploading files which have changed since the last upload:

Update Only

If you check this box, only files which differ from the versions on the server will be uploaded.

Local files will be uploaded if they:

• Do not exist on the server,
• Are a different size to the copy of the file on the server, or
• Are newer than the copy of the file on the server.

Not all FTP Servers support this option. The FTP Server must be able to return reliable time/date and file size information in order to use the Update Only feature.

Upload anyway if the files is less than X minutes older than server version.

This option allows you to "feather" the comparison times to ensure false-negatives do not occur. It is recommended this option is enabled to account for clock drift over time. For extra reliability, set it to a high value (eg 120 minutes.)

Server clock skew

The Server Clock Skew options allow you to compensate for differences between the timestamps reported by the server and the local date/time (for example, the local computer may think the time is 1430 UTC, while the server may report 1436 UTC.)

In cases where timezones are set incorrectly, or the FTP server does not use UTC, clock skew may be several hours.

It is generally recommended that you do not edit the clock skew value manually, but rely on the "Reset clock skew value after next upload" and "Update automatically after each upload" options to set it automatically.

Reset clock skew value after next upload

If this option is checked, the next file that the action uploads will never be skipped, even if it has not changed. The timestamp of that file will be used to set the clock skew value. This only happens once (the option is turned off after the clock skew value has been set.)

It is recommended that this option is set the first time the action is used, and any time there is a possibility that the FTP Server or local computer's timezone information might have changed.

Update automatically after each upload

If this option is checked, then each time a file is updated its timestamp is used to reset the clock skew value if it has changed. This helps overcome "clock drift" over time.