Differences
This shows you the differences between the selected revisions of the page.
| 2007-01-23 | 2024-02-15 (current) | ||
| unc (martin) | 6.3 stable released (martin) | ||
| Line 1: | Line 1: | ||
| ====== Transfer Options Dialog ====== | ====== Transfer Options Dialog ====== | ||
| - | Transfer options dialog appears before transfer ([[task_upload|upload]] or [[task_download|download]]) actually starts, so you can set your transfer options. The initial options are determined by your preferred default [[transfer_settings|transfer options]]. In [[ui_pref_environment#confirmations|preferences]] you can suppress the dialog at all, for some methods of transfer. | + | Transfer options dialog appears before transfer ([[task_upload|upload]] or [[task_download|download]]) actually starts, so you can set your transfer options. The initial options are determined by your preferred default [[transfer_settings|transfer options]]. |
| + | |||
| + | You can [[#suppress|suppress the dialog]]. | ||
| The dialog slightly differs for [[task_upload|uploads]] and [[task_download|downloads]]. | The dialog slightly differs for [[task_upload|uploads]] and [[task_download|downloads]]. | ||
| - | |||
| - | Upload options dialog: | ||
| &screenshotpict(upload) | &screenshotpict(upload) | ||
| - | Download options dialog: | + | ===== [[target_directory]] Target Directory ===== |
| + | Use the box at the top of dialog to set destination directory and [[operation_mask|operation mask]]. The box is hidden for [[task_download#dragdrop|drag&drop downloads]] in [[ui_pref_dragdrop#temporary|temporary folder mode]], because in that mode WinSCP has no control over the target of the transfer. | ||
| + | |||
| + | The destination directory is by default the current working directory (local for [[task_download|downloads]] and remote for [[task_upload|uploads]]). For downloads in [[ui_explorer|Explorer interface]], where there is no local working directory, it will be the last local directory used. | ||
| + | |||
| + | If you omit the [[operation_mask|operation mask]] for upload, you must still include a trailing slash ''/''. Omitting the operation mask is the same as using mask ''*.*''. | ||
| + | |||
| + | ===== [[transfer_settings]] Transfer Settings ===== | ||
| + | //Transfer settings// box shows current [[transfer_settings|transfer settings]]. | ||
| + | |||
| + | To change the settings, use //Transfer settings// button to show [[ui_transfer_custom|Transfer Settings dialog]] (alternatively you may click //Transfer settings// box). Clicking drop-down icon on the button reveals menu with list of configured [[transfer_settings#presets|presets]]. Command //Configure// opens Preferences dialog on //[[ui_pref_transfer|Transfer page]]//. | ||
| + | |||
| + | ===== Transfer on Background ===== | ||
| + | Use //Transfer on background (add to transfer queue)// checkbox to instruct WinSCP to perform the [[transfer_queue#transferring|transfer on background]]. | ||
| - | &screenshotpict(download) | + | You can set the default value for the options in [[ui_pref_background#background_transfers|preferences]]. |
| - | By default the dialog appears collapsed, showing only very basic options. To display full range of options, press //More// button. The next time the dialog will appear expanded already. You can always collapse the dialog using //Less// button (appears instead of //More//). | + | You cannot use background transfers when downloading files using drag&drop to another application in [[ui_pref_dragdrop#temporary|temporary folder download mode]]. |
| - | ===== Target Directory ===== | + | ===== [[saving]] Saving Transfer Options ===== |
| - | Use the box at the top of dialog to set destination directory and [[operation_mask|operation mask]]. The box is hidden for drag&drop downloads with disabled [[dragext|drag&drop shell extension]], because in the mode WinSCP has no control over target of the transfer. | + | |
| - | The destination directory is by default the current working directory (local for [[task_download|downloads]] and remote for [[task_upload|uploads]]). For downloads in [[ui_explorer|Explorer-like interface]], where there is no local working directory, it will be the last local directory used. For [[task_download|downloads]] you can type even UNC path as target (''\\host\share\''). | + | In the menu invoked from //Transfer settings// button: |
| - | If you omit the [[operation_mask|operation mask]], you must still include trailing slash ''/'' (for upload) or backslash ''\'' (for download). Omitting the operation mask is the same as using mask ''*.*''. | + | * //Set as Default// command sets the current transfer settings as default. |
| + | * //Save as Preset// command saves the current transfer settings as a [[transfer_settings#presets|preset]]. | ||
| - | ===== Transfer Options ===== | + | ===== [[suppress]] Suppressing the Dialog ===== |
| - | Most options of the dialog are subset of [[ui_transfer|transfer options]]. Options not affecting your particular direction of transfer ([[task_upload|upload]] or [[task_download|download]]) are hidden. | + | To suppress the dialog, check //Do not show this dialog box again//. |
| - | In addition to configuring the options manually you can load them from [[transfer_settings#transfer_settings_presets|transfer settings preset]]. Press button //Presets// to reveal drop down menu with list of configured presets. In the menu you will find also command //Configure// that opens Preferences dialog on //[[ui_pref_presets|Presets tab]]//. | + | For transfers initiated with drag&drop, the dialog is suppressed automatically after the first use, unless you explicitly opt to keep it in use by unchecking //Do not show this dialog box again//.· |
| - | ===== Additional Options ===== | + | You can revert your decision in [[ui_pref_environment#confirmations|preferences]] any time. Use of the dialog is configured individually for transfers initiated with drag&drop and other transfers. |
| - | The //New and updated file(s) only// checkbox makes WinSCP ignore files in source directory for which there exist file in the target directory with the same filename and the same or newer timestamp. The option is available for [[protocols#sftp_ssh_file_transfer_protocol|SFTP protocol]] only. | + | |
| - | The //Use same settings next time// checkbox makes your options become default [[transfer_settings|transfer options]]. It has the same effect as changing [[ui_pref_transfer|default transfer options]] in preferences. | + | ===== [[generating_code]] Generating Transfer Code ===== |
| + | Use the //Transfer Settings > Generate Code// command to generate a code that automates the transfer. The [[ui_generateurl|Generate Transfer Code]] window opens with the generated code. | ||
| - | For drag&drop transfers you will have additional checkbox //Do not show this dialog box again// to disable the dialog for further transfers. You can alway revert this in [[ui_pref_environment#confirmations|preferences]]. | + | ===== [[browse]] Browsing Source Directory ===== |
| + | When [[integration_url#handling|handling a download URL]], there is an additional option //Browse// in the drop-down menu of the //OK// button. The option opens a main window with focus on the source directory and file, instead of initiating a download. | ||
| - | Use //Transfer on background (add to transfer queue)// checkbox to instruct WinSCP to perform the [[transfer_queue#transferring_files_on_background|transfer on background]]. You can check //No confirmations// to avoid overwrite and other confirmations for the background transfer. You can set the default value for the options in [[ui_pref_background#background_transfers|preferences]]. | ||