Differences
This shows you the differences between the selected revisions of the page.
| ui_queue 2017-08-18 | ui_queue 2023-02-16 (current) | ||
| Line 1: | Line 1: | ||
| ====== Background Transfers Queue List ====== | ====== Background Transfers Queue List ====== | ||
| - | On both interfaces there is optional component at the very bottom, queue list of [[transfer_queue|background transfers]]. To show/hide the list use main menu (//View > Queue// in [[ui_explorer|Explorer interface]], | + | On both interfaces there is an optional component at the very bottom, queue list of [[transfer_queue|background transfers]]. To show/hide the list use the main menu (//View > Queue// in [[ui_explorer|Explorer interface]], |
| - | //Options > Queue// in [[ui_commander|Commander interface]]). Queue list have special view state //Hide when Empty//. This is default state and makes the queue list visible, when there is some background transfer in progress or scheduled, only. | + | //Options > Queue// in [[ui_commander|Commander interface]]). The queue list have special view state //Hide when Empty//. This is the default state and makes the queue list visible, when there is some background transfer in progress or scheduled, only. |
| &screenshotpict(queue_list) | &screenshotpict(queue_list) | ||
| - | ===== Information Displayed in the Queue List ===== | + | ===== [[information]] Information Displayed in the Queue List ===== |
| - | Each entry in the queue list represents one [[transfer_queue|background transfer]] (not file to transfer). | + | Each entry in the queue list represents one [[transfer_queue|background transfer]] (not a file to transfer). |
| - | There are three groups of transfers in following order: | + | There are three groups of transfers in the following order: |
| * Completed transfers are optionally shown first in gray color. You can configure the period they show or turn them off completely in [[ui_pref_background|preferences]]. You can also [[#manage|delete all completed transfers manually]]. | * Completed transfers are optionally shown first in gray color. You can configure the period they show or turn them off completely in [[ui_pref_background|preferences]]. You can also [[#manage|delete all completed transfers manually]]. | ||
| * Transfers in progress show second. Each multi-file (batch) transfer in progress has two or more lines, where the first line shows overall batch progress, while the others lines are used to display information about files being transferred. | * Transfers in progress show second. Each multi-file (batch) transfer in progress has two or more lines, where the first line shows overall batch progress, while the others lines are used to display information about files being transferred. | ||
| Line 22: | Line 22: | ||
| | //Progress// | Status of transfer. Percentage indicator for ongoing transfers. //Query//, //Error// or //Prompt// for transfers that need [[#interacting|interaction with the user]]. //Waiting...// for waiting transfers. //Suspended// for suspended transfers. //Completed// for completed transfers. | | | //Progress// | Status of transfer. Percentage indicator for ongoing transfers. //Query//, //Error// or //Prompt// for transfers that need [[#interacting|interaction with the user]]. //Waiting...// for waiting transfers. //Suspended// for suspended transfers. //Completed// for completed transfers. | | ||
| - | For ongoing transfers information being shown in the second line is following: | + | For ongoing transfers information being shown in the other lines is following: |
| ^ Column ^ Description ^ | ^ Column ^ Description ^ | ||
| Line 33: | Line 33: | ||
| ===== [[interacting]] Interacting with Background Transfers ===== | ===== [[interacting]] Interacting with Background Transfers ===== | ||
| - | Sometime the background transfer needs to interact with the user. For example to confirm resuming the files transfer, to show error message or to ask for password. | + | Sometime the background transfer needs to interact with the user. For example to confirm resuming the files transfer, to show an error message or to ask for a password. |
| - | There are two interaction modes. In the default mode the message or input box pops up whenever any of the background transfer needs to interact (but only when the main connection is idle). Alternatively the box may not pop up automatically. Instead the respective line on queue list may visually indicate that the transfer needs interaction. User must double-click the line or choose respective command from queue [[ui_context_menu|context menu]] (or toolbar) to make the box pop up (see [[#manage|Managing the Queue]]). To switch to alternative mode uncheck //[[ui_pref_background#background_transfers|Automatically popup prompts of background transfers when idle]]// on //Background page// of Preferences dialog. | + | There are two interaction modes. In the default mode, the message or an input box pops up whenever any of the background transfers need to interact (but only when the main connection is idle). Alternatively the box may not pop up automatically. Instead the respective line on queue list may visually indicate that the transfer needs an interaction. The user must double-click the line or choose a respective command from queue [[ui_context_menu|context menu]] (or toolbar) to make the box pop up (see [[#manage|Managing the Queue]]). To switch to alternative mode uncheck //[[ui_pref_background#background_transfers|Automatically popup prompts of background transfers when idle]]// on //Background page// of Preferences dialog. |
| - | Some prompts of background transfers may be avoided at all. To disable [[ui_overwrite|overwrite confirmations]] (and similar prompts) check //No confirmations// on [[ui_copy|transfer options dialog]]. To avoid background transfers asking for password WinSCP [[security_credentials#password_memory|keeps the main session password in memory]] by default and reuses it for background transfer connections. | + | Some prompts of background transfers may be avoided altogether. To disable [[ui_overwrite|overwrite confirmations]] (and similar prompts) check //No confirmations// on [[ui_copy|transfer options dialog]]. To avoid background transfers asking for a password, WinSCP [[security_credentials#password_memory|keeps the main session password in memory]] by default and reuses it for background transfer connections. |
| ===== [[manage]] Managing the Queue ===== | ===== [[manage]] Managing the Queue ===== | ||
| You can manage scheduled transfers using [[ui_context_menu|context menu]] of the queue list or using optional toolbar. To show the toolbar go to //View > Queue > Toolbar// in [[ui_explorer|Explorer interface]], | You can manage scheduled transfers using [[ui_context_menu|context menu]] of the queue list or using optional toolbar. To show the toolbar go to //View > Queue > Toolbar// in [[ui_explorer|Explorer interface]], | ||
| - | //Options > Queue > Toolbar// in [[ui_commander|Commander interface]]). | + | //Options > Queue > Toolbar// in [[ui_commander|Commander interface]]. |
| Commands available in the menu (or on the toolbar) are: | Commands available in the menu (or on the toolbar) are: | ||
| Line 63: | Line 63: | ||
| | //Delete All Completed// | Use to remove all completed transfers. Particularly useful, when completed transfers are [[ui_pref_background|configured to show forever]]. | | | //Delete All Completed// | Use to remove all completed transfers. Particularly useful, when completed transfers are [[ui_pref_background|configured to show forever]]. | | ||
| - | In submenu //Once Empty// or on queue toolbar you can choose [[once_done|action to do]] once the queue is completed (all scheduled transfers are finished). Note that the action setting is cleared whenever you [[task_connections#switch|switch sessions]]. Also the action will not be done, if WinSCP is not idle (i.e. there is some dialog box opened, etc.). | + | In submenu //Once Empty// or on the queue toolbar you can choose [[once_done|action to do]] once the queue is completed (all scheduled transfers are finished). Note that the action setting is cleared whenever you [[ui_tabs#switch|switch sessions]]. Also the action will not be done, if WinSCP is not idle (i.e. there is some dialog box opened, etc.). |
| + | |||
| + | ===== [[file_list]] File List ===== | ||
| + | |||
| + | You can display a complete list of files included in a queued transfer. To show the list go to //View > Queue > File List// in [[ui_explorer|Explorer interface]], | ||
| + | //Options > Queue > File List// in [[ui_commander|Commander interface]]). The option is also available in the queue context menu. | ||
| + | |||
| + | The files there were already transferred (or skipped) or are currently being transferred are displayed in a gray color. | ||