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
|
<?xml version='1.0' ?><!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 User Guide - Task Repositories</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 Repositories</th>
</tr>
<tr>
<td style="width: 20%" align="left">
<a href="Task-List.html" title="Task List">
<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="Task-Focused-UI.html" title="Task-Focused UI">
<img alt="Next" border="0" src="images/images/next.gif"/>
</a>
</td>
</tr>
<tr>
<td style="width: 20%" align="left" valign="top">Task List</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Task-Focused UI</td>
</tr>
</table><hr/>
<h1 id="TaskRepositories">Task Repositories</h1>
<h2 id="OpeningaRepositoryTask">Opening a Repository Task</h2>
<p>The recommended way to access repository tasks is with
<i>Queries</i>. For example, you can add a query for every task assigned to you and every task that you are CC'd on. However, sometimes you may know a particular task key or ID, and want to access it without creating or modifying a query.
</p>
<p>The quickest way to do this is to enter the task's key into the
<i>Find</i> box in the
<i>Task List</i>. You will immediately see whether this task is already in your
<i>Task List</i>. If not, click the ''Search repository for key or or summary, and then simply hit <code>Enter</code> once the Search dialog comes up.
</p>
<p>
<img border="0" src="images/MylynSearchById.png"/>
</p>
<p>The <code>Ctrl+Shift+F12</code> shortcut can also be used to invoke this action, and will additionally inspect the contents of the clipboard to look for a task key/ID to populate the Task Search dialog with (e.g., if you copied they key from an email message). The <code>Ctrl+F12</code> Open Task dialog also provides a link to the Task Search page. Note that off a task is selected in the active editor or the Task List, the repository in the Search dialog will be now automatically set to the corresponding repository, otherwise the previous repository will be used. </p>
<p>There other common ways of getting a particular repository task into your Task List are:</p>
<ul>
<li>Drag the URL of the task into the
<i>Task List</i>. Note that you need to hold down <code>Ctrl</code> if dragging from Internet Explorer.
</li>
</ul>
<ul>
<li>Search for the task and use the popup menu in the
<i>Search</i> view or on the task editor after opening. Note that you can also create a
<i>Task List</i> query from a search via the
<i>Search</i> view.
</li>
</ul>
<h2 id="Synchronization">Synchronization</h2>
<p>Repository tasks and queries are synchronized in order to reflect the latest changes. These changes are decorated with an incoming arrow, shown in the tooltip for the task, and highlighted in the task editor when opened. All tasks changed on the server are synchronized, not just those that match queries. Note that Mylyn does not have an explicit offline mode and does not require that you turn off synchronization when working offline.</p>
<p>Tasks are synchronized the following ways:</p>
<ul>
<li>Automatically: by default tasks will be incrementally 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>On open: tasks are synchronized automatically in the background when a task editor is opened.</li>
</ul>
<ul>
<li>Manually: tasks can be synchronized manually via the Synchronize actions on
<i>Task List</i> elements or via the toolbar.
</li>
</ul>
<p>
<i>Disconnected mode</i>
</p>
<p>A task repository can be put into Disconnected mode via the popup menu in the
<i>Task Repositories</i> view. This can be useful if the task repository is not being used any more (e.g. no longer engaged with the project), or is no longer available (e.g. no longer available online). Mylyn's 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.
</p>
<h3 id="SynchronizingAllTasks">Synchronizing All Tasks</h3>
<p>If properties of a repository change that are not picked up by automatic synchronization, e.g. the user get assigned additional privileges in the repository, it can be desirable to do a manual synchronization. Since Mylyn 2.2 the popup menu in the
<i>Task Repositories</i> view has an entry
<i>Synchronize All Tasks</i> to refresh cached information for all tasks in the task list for that repository.
</p><hr/>
<table class="navigation" style="width: 100%;" border="0" summary="navigation">
<tr>
<td style="width: 20%" align="left">
<a href="Task-List.html" title="Task List">
<img alt="Previous" border="0" src="images/images/prev.gif"/>
</a>
</td>
<td style="width: 60%" align="center">
<a href="Mylyn User Guide.html" title="Mylyn User Guide">
<img alt="Mylyn User Guide" border="0" src="images/images/home.gif"/>
</a>
</td>
<td style="width: 20%" align="right">
<a href="Task-Focused-UI.html" title="Task-Focused UI">
<img alt="Next" border="0" src="images/images/next.gif"/>
</a>
</td>
</tr>
<tr>
<td style="width: 20%" align="left" valign="top">Task List</td>
<td style="width: 60%" align="center"></td>
<td style="width: 20%" align="right" valign="top">Task-Focused UI</td>
</tr>
</table>
</body>
</html>
|
