1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
|
<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Mylyn Reference - Task List</title>
<link type="text/css" rel="stylesheet" href="book.css"/>
</head>
<body>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<th style="width: 100%" align="center" colspan="3">Task List</th>
</tr>
<tr>
<td style="width: 20%" align="left">
<a href="Installation.html" title="Installation">
<img alt="Previous" border="0" src="images/images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right">
<a href="Configuring-Task-Repositories.html" title="Configuring Task Repositories">
<img alt="Next" border="0" src="images/images/next.gif"/>
</a>
</td>
</tr>
<tr>
<td style="width: 20%" align="left" valign="top">Installation</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Configuring Task Repositories</td>
</tr>
</table><hr/>
<h1 id="Task_List">Task List</h1>
<p>Use the Task List to view and manage your tasks. If the task list view is not visible, you can open it by navigating to Window -> Show View -> Other... -> Mylyn -> Task List. The Task List contains both "Local Tasks" and shared "repository tasks" that are stored in a task repository such as Bugzilla or Jira. See how to create new tasks. Local tasks are typically contained in categories, which you can create by right-clicking on the task list and selecting new -> category. Repository tasks are contained in special categories that represent queries.</p>
<p>
<img border="0" src="images/Feature-Reference-3.0-Task-List-Categorized.png"/>
</p>
<p>At the top of the Task List, you will find the following buttons and features:</p>
<ul>
<li>
<b>New Task</b> - Create a new local or repository task.
</li>
<li>
<b>Synchronize</b> - Update repository tasks with changes from the server.
</li>
<li>
<b>Task Presentation</b> - Toggle between Scheduled and Categorized presentations.
</li>
<li>
<b>Focus on Workweek</b> - See only tasks scheduled for this week.
</li>
<li>
<b>Find</b> - search for a task by typing in words from the task summary
</li>
<li>
<b>Working set indicator</b> - Indicates the currently active working set. Use the black arrow on the left to change the working set.
</li>
<li>
<b>Current task indicator</b> - Indicates the currently active task. Use the black arrow on the left to re-activate a recently active task.
</li>
</ul>
<h2 id="Task_List_Presentation">Task List Presentation</h2>
<p>The task list supports several ways to present tasks. You can toggle between the following modes by using the "Task Presentation" button in the toolbar.</p>
<ul>
<li>
<b>Categorized</b> - View tasks grouped by their category
</li>
<li>
<b>Scheduled</b> - View tasks grouped by the "
<i>scheduled</i> date"
</li>
</ul>
<p>
<img border="0" src="images/Feature-Reference-3.0-Task-List-Presentation-Select.png"/>
</p>
<p>In either presentation, you can toggle the "Focus on Workweek" button. In this mode, only the following tasks will be visible:</p>
<ul>
<li>Tasks scheduled for this week.</li>
<li>Overdue tasks.</li>
<li>Tasks with unread changes from your task repository.</li>
</ul>
<h2 id="Icon_Legend_and_Color_Coding">Icon Legend and Color Coding</h2>
<p>See the legend below to interpret the icons and color coding in the task list. You can view this legend by selecting "Show UI Legend" from the menu that appears when you click the white down arrow next to the minimize button in the top right corner of the Task List view. </p>
<p>
<img border="0" src="images/Feature-Reference-3.0-UI-Legend.png"/>
</p>
<h2 id="Scheduling">Scheduling</h2>
<p>Two kinds of dates for scheduling are provided.</p>
<p>
<b>Scheduled Date</b>
</p>
<ul>
<li>A soft date used for personal scheduling that can be easily deferred as priorities change. The scheduled date is the date you plan to start working on the task.</li>
<li>When a task reaches its scheduled date it will turn blue, indicating that the task should be activated and worked on today.</li>
<li>Scheduled dates are private to your local workspace</li>
</ul>
<p>
<b>Due Date</b>
</p>
<ul>
<li>A hard date when the task must be completed. This is often related to external constraints such as deadlines.</li>
<li>If you are using a shared task repository, due dates become an attribute of the shared task and will be visible to other team members.</li>
<li>A task with a due date has a small clock overlay that is blue before the due date and red after.</li>
</ul>
<h2 id="Synchronization">Synchronization</h2>
<p>Repository tasks and queries are synchronized to reflect the latest changes on the server.
Tasks are synchronized the following ways:</p>
<ul>
<li>
<b>Automatic Synchronization.</b> By default, tasks will be synchronized with the repository every 20 minutes. Automatic synchronization can be disabled via the
<i>Synchronize Automatically</i> option in the view menu (e.g. when working with intermittently available connectivity). The synchronization interval can be changed via
<i>Preferences -> Mylyn -> Task List</i>.
</li>
</ul>
<ul>
<li>
<b>On Task Open.</b> Tasks are synchronized automatically in the background when a task editor is opened.
</li>
</ul>
<ul>
<li>
<b>Manually.</b> Individual tasks and queries can be synchronized manually by right-clicking on them in the Task List and selecting "Synchronize", or via the toolbar button. Clicking the toolbar button will synchronize all queries in your task list.
</li>
</ul>
<p>
<br/>
<b>Disconnected Mode</b>
<br/>
A task repository can be put into Disconnected mode via the right-click menu in the
<i>Task Repositories</i> view. This can be useful if the task repository is not currently in use (e.g. you are no longer engaged with the project, or the repository is no longer available). The offline support will ensure that you can still access tasks that you have worked with via their offline copies, and the Disconnected mode will ensure that synchronization warnings do not appear. Note that it is not necessary to turn off synchronization or work in Disconnected Mode when working offline.
</p>
<h2 id="Incoming_Changes">Incoming Changes</h2>
<p>A blue arrow to the left of a task indicates that the task has changed in the shared repository. Double-click the task to view it in the task editor. Changes to the task will be highlighted in blue.</p>
<p>To quickly review the differences since the task was last read, hover over the task in the Task List to view a summary in a tooltip. You can also press F4 to display a tooltip. You may also wish to view the task list in "Focus on Workweek" mode, which will filter out tasks without incoming changes that are not scheduled or due this week. You can toggle "Focus on Workweek" using a button in the Task List's toolbar.</p>
<h2 id="Keyboard_Shortcuts">Keyboard Shortcuts</h2>
<p>You can use the following hot keys to quickly access frequently used functionality.</p>
<table>
<tr>
<td>F2</td>
<td>rename</td>
</tr>
<tr>
<td>F4</td>
<td>show tooltip</td>
</tr>
<tr>
<td>F5</td>
<td>synchronize</td>
</tr>
<tr>
<td>Alt + Down</td>
<td>go to next unread</td>
</tr>
<tr>
<td>Alt + Up</td>
<td>go to previous unread</td>
</tr>
<tr>
<td>Alt + Shift + R</td>
<td>mark as read</td>
</tr>
<tr>
<td>Alt + Shift + U</td>
<td>mark as unread</td>
</tr>
<tr>
<td>Esc</td>
<td>hide tooltip</td>
</tr>
<tr>
<td>Enter</td>
<td>open task</td>
</tr>
<tr>
<td>Insert</td>
<td>new local task</td>
</tr>
<tr>
<td>Ctrl+C</td>
<td>Copy details</td>
</tr>
<tr>
<td>Ctrl+F</td>
<td>Find</td>
</tr>
</table>
<h2 id="Reviewing_Tasks">Reviewing Tasks</h2>
<p>The task list has been carefully designed to support quickly reviewing tasks. Task reviewing is best done by configuring a query to show the tasks that you want to review. Once the tasks are displayed in the Task List they can be reviewed one at a time by scrolling through them using the keyboard up/down arrows. The task tooltip should provide enough detail to do a review and will display information relevant to the currently selected task. </p>
<p>To edit the selected task press the enter key, use Ctrl+Enter to open the task in the background. To quickly jump to the next unread task hold down the Alt-key when pressing up or down. To mark a task as read while navigating use Alt+shift+up/down. When reviewing tasks in this way, it is best to avoid mouse-based and gesture-based scrolling.</p>
<p>
<img border="0" src="images/Feature-Reference-3.0-Task-List-Tooltip.png"/>
</p>
<h2 id="Task_Progress_Indicators">Task Progress Indicators</h2>
<p>
<b>Weekly progress</b>
<br/>
When in
<i>Focus on Workweek</i> mode (right-most toolbar button), the Task List will show a progress bar that indicates progress on the tasks scheduled for the current week. Each task that is scheduled for the week but not yet completed adds to the bar. A task completed by you adds to the green progress in the bar. Deferring a task to a future week will also add to the apparent progress because it will remove the task from the current week. Mousing over the bar will indicate details about your progress, such as the number of tasks and hours completed. To avoid the need for manual estimation by default every task is estimated for 1 hour, but if you have longer or shorter running tasks that week you can adjust the estimate in the task editor's
<i>Planning</i> page to ensure that the progress bar is accurate.
</p>
<p>Note that when in
<i>Focus on Workweek</i> mode the
<i>Task List</i> will show each of the tasks scheduled for this week. However, overdue tasks and those with incoming changes will also show, making the number of tasks visible not be a reliable indicator of progress on the tasks planned for the week.
</p>
<p>
<img border="0" src="images/Feature-Reference-3.0-Weekly-Progress.png"/>
</p>
<p>
<br/>
<b>Category Progress</b>
<br/>
You can hover over categories in the task list to display a tooltip that displays a summary of complete and incomplete tasks.
</p>
<p>
<img border="0" src="images/Feature-Reference-3.0-Category-Progress.png"/>
</p>
<h2 id="Task_List_Settings_and_Operations">Task List Settings and Operations</h2>
<p>Click the small white arrow in the top left of the task list to access the following settings:</p>
<ul>
<li>
<b>Go Up to Root</b> - Return to the normal presentation after previously selecting "Go Into" to see only the tasks in a particular category.
</li>
<li>
<b>Sort</b> - Open a dialog to set the sort order for the task list. This option is only availabe when the task list is not in "Focus on Workweek" mode.
</li>
<li>
<b>Filter priority lower than</b> - Hide tasks with a priority less than the priority you select. This option is only availabe when the task list is not in "Focus on Workweek" mode.
</li>
<li>
<b>Filter completed tasks</b> - Hide local and repository tasks that are in a completed state.
</li>
<li>
<b>Search Repository</b> - Opens a dialog to search for repository tasks. Search results will appear in a separate search results view.
</li>
<li>
<b>Restore Tasks from History</b> - Opens a dialog for restoring lost tasks.
</li>
<li>
<b>Synchronize Changed</b> - Updates the task list with any changes on the task repository.
</li>
<li>
<b>Synchronize Automatically</b> - When checked, the task list will update from the task repository on an interval specified in Window -> Preferences -> Tasks -> Synchronization
</li>
<li>
<b>Show UI Legend</b> - Displays a legend explaining icons and color-coding.
</li>
<li>
<b>Focus on Workweek</b> - Displays only tasks that are scheduled for this week, overdue, or have unread changes.
</li>
<li>
<b>Link with Editor</b> - Automatically selects the task corresponding to the active task editor.
</li>
<li>
<b>Preferences</b> - Access additional Task List preferences.
</li>
</ul>
<p>
<br/>
Right-clicking in the task list provides access to the following operations
</p>
<ul>
<li>
<b>New...</b> - Create new categories, queries, and tasks.
</li>
<li>
<b>Open with Browser</b> - Open the task in a web browser tab rather than the rich editor.
</li>
<li>
<b>Schedule for</b> - Set the soft date when you intend to work on the task.
</li>
<li>
<b>Mark as</b> - Mark a task as read or unread as you would an email message.
</li>
<li>
<b>Copy Details</b> - Places the task summary and html link in the clipboard so you can paste it into an email, document, etc.
</li>
<li>
<b>Delete</b> - Deletes local tasks. For repository tasks, the all downloaded data and local task information will be cleared but the task will re-appear if it still matches a query.
</li>
<li>
<b>Rename</b> - Rename a task.
</li>
<li>
<b>Go into</b> (queries only) - Show only the tasks in the selected category.
</li>
<li>
<b>Import and Export</b> - Access functionality for importing and exporting task data.
</li>
<li>
<b>Repository</b> (queries only) - Update repository settings
</li>
<li>
<b>Synchronize</b> - Update the selected tasks or queries from the shared task repository
</li>
<li>
<b>Properties</b> - Edit the settings for a repository query
</li>
</ul><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<td style="width: 20%" align="left">
<a href="Installation.html" title="Installation">
<img alt="Previous" border="0" src="images/images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center">
<a href="Mylyn Reference.html" title="Mylyn Reference">
<img alt="Mylyn Reference" border="0" src="images/images/home.gif"/>
</a>
</td>
<td style="width: 20%" align="right">
<a href="Configuring-Task-Repositories.html" title="Configuring Task Repositories">
<img alt="Next" border="0" src="images/images/next.gif"/>
</a>
</td>
</tr>
<tr>
<td style="width: 20%" align="left" valign="top">Installation</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Configuring Task Repositories</td>
</tr>
</table>
</body>
</html>
|
