Upload Remote File
This task allows you to upload a file to a remote server.
Settings
Connection
Required
The connection to the remote server, see Connecting to a Remote Server for details.
Input File
Required
The file you want to upload, including the full path if it's not in the working directory.
Output File
Optional
The output location and name for the file, if not specified will default to file name.
Remote Directory
Required
The path to the remote directory e.g. /site/wwwroot.
Overwrite File
Required
Set to true to rename the file even if the new file name already exists on the remote server.
Permissions
Required
The permissions to apply to the uploaded file. They are specified using Unix permissions symbolic notation, but without the first character which indicates the file type (e.g. rwxrwxrwx). Leave blank to use the defaults set by the remote server.
Note
This setting is only applicable when connecting to an SFTP server.
Prepend Timestamp
Required
Set to True to have a timestamp added to the filename during the upload based on the Timestamp Format provided. Defaults to False.
Preserve Timestamp
Required
Set to True to set the last write time of uploaded file to that of the input file.
If you encounter an error which states "Upload of file was successful, but error occurred while setting the permissions and/or timestamp.", try changing this setting to False.
Retry Count
Required
The number of times to retry the upload should it fail. Defaults to 2.
Temporary Import Settings > Setting
Required
You can choose to upload to a temporary file and have the file renamed once the transfer is complete.
- NotEnabled - will upload directly to the output file location
- TemporaryFile - will upload to the remote directory using the specified extension, and rename to the output file once complete
- TemporaryDirectory - will upload to the temporary directory specified, and move to the remote directory once complete
Temporary Import Settings > Temporary Directory
Dependent
The relative directory to use when importing temporary files, required if using TemporaryDirectory.
Temporary Import Settings > Temporary File Extension
Dependent
The file extension to use when importing as a temporary file, required if using TemporaryFile.
Timestamp Format
Dependent
Used to control the format of the timestamp to prepend to file names if the setting is enabled. Defaults to yyyyMMddHHmmssffff.