User Guide





Contents

 

Tasktop Feature Overview

Tasktop Starter for Eclipse is an always free version of Tasktop that provides access to the latest Mylyn, one-click install of partner connectors (Jira, CollabNet's Issuezilla, SFEE and ProjectTracker repositories, and Rally), Gmail and IMAP integration and a time tracking dashboard. Look for the icon to determine which features are provided in Tasktop Starter.
Tasktop Pro is a for-pay version of Tasktop. Tasktop Pro for Eclipse provides all of the features in Tasktop Starter plus many more, including Outlook integration, time reporting and Google calendar synchronization, to name just a few. Tasktop Pro for Eclipse also provides Mylyn support. Tasktop Pro for Windows allows Windows users to access Tasktop functionality.
Look for this icon to indicate features available only on the Windows platform for Tasktop Pro for Eclipse and Tasktop Pro for Windows users.

For a full description of the features available in the different versions, check out the Download page.

Installing Tasktop

Installing the Tasktop Pro or Tasktop Starter plug-ins for Eclipse

You need to have a url for the update site to install Tasktop plug-ins for Eclipse. For Tasktop Starter, you can obtain a copy of the update site url from here. For Tasktop Pro, upon accepting the license agreement presented when you trial or buy Tasktop Pro, your personal update site url is presented in the subsequent web page. Copy this url to the clipboard and execute the steps as outlined in the section for the Eclipse version you have installed.

 

Eclipse 3.3

  1. Navigate to Help (menu) > Software Updates > Find and Install, select the "Search for new features to install" option and press Next
  2. Press the New Remote Site button, enter a title (i.e., Tasktop), paste your personal update site url copied earlier from tasktop.com and press Okay.
  3. With the update site added and checked off, press the Finish button to execute installation of the Tasktop plug-ins.
  4. Enter your Tasktop username (the same user name that you created when you purchased Tasktop) and password in the subsequent authentication dialog.

  5. From the resulting search results, select all available features: Tasktop, Tasktop Features, Mylyn and press Finish.
  6. After accepting the subsequent license agreements and choosing to install all plug-ins, restart Eclipse when prompted to complete installation of your Tasktop plug-ins.

 

Eclipse 3.4

  1. Navigate to Help (menu) > Software Updates..., selected Available Software tab.
  2. Press the Add Site... button, paste the update site url and press OK.
  3. Enter your Tasktop username (the same user name that you created when you downloaded Tasktop) and password in the subsequent authentication dialog.
  4. Select all available features under the two added tasktop update sites and press Install.
  5. After accepting the subsequent license agreements and choosing to install all plug-ins, restart Eclipse when prompted to complete installation of your Tasktop plug-ins.

Tip: Looking for the uninstallation instructions?

 

Installing the Tasktop Pro for Windows application

NOTE: Do not use the single click update to upgrade your Tasktop Spring 2008 application. Download the Tasktop Summer 2008 application and install.

Upon accepting the user license agreement when you trial or buy the application, download of the Tasktop install executable will commence. Once the download is complete run the installer:

  1. Click Next to continue installation of Tasktop

     
  2. Read the Tasktop End User License and if you wish to continue choose the "I accept..." option and press Next.

     
  3. Choose the installation location (c:\Program Files\Tasktop is recommended), and click Next.

     
  4. Either accept the default Start menu folder and shortcuts or customise then press Install to complete installation

     
  5. Tasktop is now installed. Pressing finish will launch your newly installed Tasktop.
     

 

First Launch for Tasktop Pro

Welcome to your new Tasktop. Upon first launching Tasktop you will be presented with a recommendations wizard:

Pick the recommended settings that suit your needs and and press Finish. The chosen settings will be applied and Tasktop will finish loading.

You will now be prompted for your Tasktop credentials (i.e., your Tasktop user name and password).

After entering your credentials, the Tasktop Feature Overview is presented.  Tasktop is now ready for use.

 

Tasktop Feature Overview

Learn about each of the key Tasktop features from the Tasktop Feature Overview, accessible by pressing the Home toolbar button then follow the Feature Overview link or click on the Feature Overview tab at the bottom of the editor. The Tasktop Feature Overview is an interactive page that shows where features are located and how to use them. Each feature is named and hyperlinked within the page. Clicking on hyperlinks will open the feature being described. A short description accompanies each feature hyperlink. Mouse over feature hyperlinks to reveal a tooltip with more details about the feature. Once you have explored your Tasktop via the Feature Overview page, consider reading up on more detailed usage and configuration of these features in this User Guide.

There is also a UI Legend section in the Feature Overview page that shows a legend of various icons used throughout Tasktop.

 

Support Channels

Community Page

Tp leep in touch with what is happening in the Tasktop community, select the Community tab from the bottom of the Tasktop Home editor to reveal the Community page. The Community page includes useful links along with a Bugs section that displays the Most Voted bugs, Recent Enhancements and any bugs you personally have submitted about Tasktop. Additionally, a live Tasktop blog feed is available with the latest news, tips and tricks straight from the Tasktop.com blog (http://tasktop.com/blog).

Community & Support

File a new bug, access the forums, browse the latest bugs or read the FAQ, all from the Community & Support page accessible via the Home toolbar button > Tasktop Support. You can also get easy access to the latest Less is More blog entries, as well as links to preferences and software updates within the page.

 

Note: A Tasktop account is required to view and create bugs for Tasktop. If you do not have an account, you can create one here or click on the Create an Account link in the Bugs table. Sign up is quick and easy and provides you with access to try Tasktop Pro, and view bugs and forums. If you already have a Tasktop account, you can login using your Tasktop username and password.

 

Note that the Tasktop support channels can also be accessed via the following web links:

  Bug Reports
Do not hesitate to file a bug report for problems or feature requests
Community Forums
View online forums for help and usage discussions
Survey
Fill out our short survey and help make Tasktop better.
FAQ
Get answers to the most frequently asked questions

 

 

 

 

 

 

General comments or questions may be directed to help@tasktop.com.

 

Tasks and Calendars

Task List

Tasks - externalize, prioritize, schedule

The first step towards achieving a Task-Focused workweek is to create tasks in your Tasktop Task List for everything you need to get done. Once all of your tasks are captured in the task list (offloaded from your mind into your Tasktop), you will be free to concentrate completely on the task at hand rather than worrying about remembering the other tasks that need to get done.

Lets get started by adding a new task to book a flight to Hawaii next month. In the toolbar of the Task List view, click on the New Task button . The New Task wizard (shown below) will open requesting you select a repository to hold your new task. For tasks of a personal nature (not intended to be shared with others), select the "Local Tasks" option. For now select "Local Tasks" and press Finish.

 

Pressing finish will result in a "New Task" being created in the Uncategorized folder of the Task List and its associated editor opening in the main (central) area of your Tasktop. To open the editor for this task again in the future, double click on the task in the Task List. In the text box near the top of the editor you will find the summary, currently "New Task". The summary is the text that will be visible in the Task List and is used for all identification and search within Tasktop. Giving tasks a memorable name with pertinent keywords helps and starting your task summary with a verb is recommended. Replace the current summary "New Task" with your own i.e. "book trip to Hawaii" and press the save button located in the main Tasktop toolbar. Notice that the label has been updated accordingly in the Task List.

   

Just below the task summary are a number of attributes that can optionally be set on your newly created task:

  • Priority - Choose between five different levels of priority:  Very Low,  Low, Normal, High, Very High
  • Status - Personal tasks can be in one of two states: Incomplete, Complete
  • Created - This is the date the task was created and is not modifiable
  • Completed - Upon changing the task Status to Complete, this field will report the completion date automatically
  • URL - If a task is tightly coupled to a specific web site, enter the url here and use the trailing buttons to:  reset the task summary to match the given web page title, open the web page

Tip: Most of these fields can be ignored with the exception of Priority. As the number of tasks increases, determining which to work on first can become a tough decision. To help this decision process, we recommend setting the Priority of a task upon initial creation then reprioritizing as part of your regular weekly planning process.

The next section of the local task editor is the Personal Planning section which allows you to optioanlly schedule a task. Note that if you do not schedule a task or set a due date for the task, it might not be shown in  the task list if the focused mode is selected. Only tasks that have incoming changes or that are scheduled for this week will be shown when the task list is focused.

Here is a description of the main fields for a task:

  • Scheduled for - if you have some sense for when you would like to make progress on a particular task, set a scheduled for date and Tasktop will remind you when it is time to work on this task via a subtle notification popup. (Note that notifications can be turned off via Window (menu) > Preferences > Tasks and unselecting Display notifications for overdue tasks and incoming changes) Additionally, the task is guaranteed to be visible in a timely fashion within your Task List when it is focused on your work week (details of focusing the Task List on the workweek is available in the developerworks article).
  • Due - if there is a hard deadline for this task, set it here. Tasks with a due date have a decoration in the Task List - .  Over due tasks have a decoration in the Task List - . If the Task List is in focused mode, tasks with due dates in the current work week will be included, and tasks that have due dates on or before the current day will be displayed in red.
  • Estimated hours - Set a time estimate for this task and enable the Task timing and progress bar to get visual feedback about your progress on a task.
  • Active - reports the time spent working on this task

And finally, the Notes section of the local task editor is useful for jotting down information pertinent to task.

You've now successfully created, prioritized, and scheduled your task.

Where to go from here:

  • Start working on your new task - lean about Task Activation and how a single click can quickly reveal just the important resources and simplify multitasking
  • Learn how to organize your tasks into Categories
     

Task Activation - work Task-Focused

One of the core principles of working Task-Focused is that only the important resources (files, websites, etc) that pertain to your current task should be visible. The files and resources that are important to a task comprise what we term a Task Context.  Any other uninteresting resources represent noise and only compounds the problem of information overload. By reducing the number of extraneous documents visible, Tasktop helps you spend less time searching for documents and more time working towards your goals. Now that you've entered your tasks in the Task List, the key to working Task-Focused in your Tasktop is to activate each task as you work. This simple act of activating each task as you work will leverage your Tasktop's focused web and document management, make multitasking a snap and enabling task time reporting.

In the Task List view, each task has a faint button to the left of its summary (see screenshot below).  Pressing this button will activate the task. Upon activation the button will turn to .  Inactive tasks that have been work on in the past and have files and/or web sites associated with it will have their activation button appear slightly filled in  .  Additionally, you can activate/deactivate a task from the task editor itself. Have a look again at the top banner section of the task editor and you will notice a button in the top right corner. Pressing this button will toggle the task active, depressing will deactivate the task. 

 

Task-Focused Web Browsing

If you've been following along with our "book trip to Hawaii" task example, active this task now.  With the "book trip to Hawaii" task active, open a new browser tab - press the button in the main Tasktop toolbar (or press Ctrl+T). In the location bar of the browser tab, paste the following url: http://en.wikipedia.org/wiki/Hawaii

Press enter while watching what happens in the Navigator view The Navigator view gives you access to file folders as well as web pages. If this view is focused, it shows you only the files/web pages that have been accessed for the activated task. Once the Hawaii Wikipedia page has finished loading, you will notice that the Navigator view's web node has a new entry for the Hawaii Wikipedia page you have just visited.

Navigating to a couple of the sections of this Hawaii wiki page will result in further population of the Navigator view with the portions of the page visited making it simple to navigate to the pertinent sections of the web site.

This reduces the need for explicit book marking although you can make a bookmark of one of these nodes by right clicking on the node and selecting "Add to bookmarks" from the popup menu.

The more pages you visit the more will be added to the Web node of the Navigator view. Obviously if you visit many pages, the number of entries would soon become unmanageable. Fortunately, Tasktop will eventually hide from view the pages you do not re-visit.

Tip: You can always expose hidden file and web content in the Navigator by holding down the Alt key while concurrently clicking on parent node (i.e., Web in this case) in the Navigator view or unfocus the view.

Tip:  Accessing this Wikipedia page and other can be done quickly by entering your search terms (i.e. Hawaii in this case) into the web search text box and selecting Wikipedia from the search dropdown menu.

Where to go from here:

  • Work task focused with your documents (i.e. Word, and Excel files) just as easily as we have here with web sites
  • Learn how your Tasktop can report on the time and progress made on tasks

 

Task-Focused Document Access

So far we've seen how to activate a task and work with web sites. We've seen the benefit of Task Activation and how it enables Task-Focused web browsing.  Your Tasktop also supports working Task-Focused with files such as images, and documents (i.e. Word, and Excel files). To get started working task-focused with your documents, you must first do a one time configuration step of linking the folders into Tasktop that hold your documents. When working under Windows, a common practice is to link in your My Documents folder ("Documents" on Vista).  

Now that all of your document folders are linked in, create and activate a new task called "explore my documents". At this point you might be wondering why those document folders you previously linked into your Tasktop are not visible under the Folders node in the Navigator view. The reason for this is that the Navigator view is in focused mode - indicated by the depressed focus button in the Navigator toolbar . When in focused mode, the Navigator only displays the files that you have interacted with (opened, saved, browsed, etc) while the current task was active. At this point, we have yet to open or create any files as part of the "explore my documents" task therefore nothing appears. You can temporarily disable the focus filter by toggling the focus button. When not depressed, the Navigator will reveal all content you previously linked in. You can then locate and open a desired file.  Pressing the focus filter button will again hide all your linked content but will now reveal the file you just opened. Another way to quickly add existing files to the context of this active task so they are revealed is to search for a familiar document title using the Find field in the Navigator view.

Similar to when the focus filter is off, upon clicking on a file or opening the document, the file will become part of the task's context and remain visible even when the focus filter is on.  Clearing the find filter will result in just the selected file being visible in the Navigator.

Now, to see the effects of all we've learned, activate the "book trip to Hawaii" task in the task list. Note that you do not have to explicitly deactivate the "explore my documents" task as it will first be deactivated and the "book trip to Hawaii" activated immediately after for you.  With the "book trip to Hawaii" task now active the browser are restored and the web sites visible in the Navigator that we worked with previously as part of this task.  We can now easily switch back to the "explore my documents" task by activating it in the Task List.  The web pages associated with the previous task are cleared away for us and the Navigator reveals the files we were working with on the "explore my documents" task.

 

Effortless Multitasking

How often have you been deeply involved in your work only to be interrupted by a more immediate, possibly higher priority fire to deal with? Once the emergency is dealt with, returning to your previous work is often difficult and time consuming. Sometimes simply recalling what you were doing is difficult, let alone remembering and locating all the related documents and web pages you were working with.  Tasktop solves this problem for you making returning to a previously postponed task effortless.  To see this in action, imagine you have just been asked to do some other work, you would start by deactivating the "book trip to Hawaii" task by pressing thebutton next to the task in the Task List. The web pages are closed and Tasktop is ready for the next task. Follow the steps described above to create a new task.  Upon returning to the "book trip to Hawaii" task whether it be hours, days, or months later, simply re-activate it by pressing on the task in the Task List and watch as your previously browsed web pages are restored automatically and the Navigator view is populated with familiar web sites and documents related to this task.  Multitasking is now a single click experience.

 

Task Timing

When you have a task active, Tasktop will track the exact time you spend within Tasktop. Tasktop Pro will also track the time spent working in applications outside of Tasktop.

To view the time spent on a task, open the task editor and select the Planning tab.  Under the Personal Planning section, the time spent working on the task is presented under the "Active" time. Note that time is accumulated while you are using your computer, time spent away form the computer (no interaction detected) will not be accumulated even if the task is active. This will help give you a realistic indication of how much time was spent on this particular task.

To make the time spent on a task more visible in Tasktop, enable the task timing counter and progress bar via Window (menu) > Preferences > Tasktop. Once enabled, look for the timing progress widget in the lower right corner of Tasktop:    Once you activate a task and begin to work, the hours and minutes you spend working will be reported here backed by a green progress bar:   The green progress bar grow from left to right until the time you have spent exceeds the estimate time set within the Personal Planning section of the Planning editor. Once you have exceeded your estimate, a red bar will begin to grow from right to left indicating the proportion of time spent over the estimated time:  

 

Categories - organize your tasks

As you create more tasks in your Task List you may find the need to group related tasks together. To facilitate this need, the Task List has Categories. Right click in the Task List view and from the context menu, select New > Category. Enter a name for you new category in the resulting dialog. A category will now be present in your Task List.  You can now move tasks into categories in a number of ways:

  • Tasks can be dragged in and out of Categories in the Task List
  • Right clicking on tasks in the Task List or right clicking within the Task editor to reveal the popup menu and selecting Move to > MyCategory will move the chosen task to MyCategory

 

Queries & Task Repositories - collaborate with others

Please see the developer works article regarding task repositories and queries.

Tip: Tasktop Technologies is the creator and maintainer of the Eclipse Mylyn technology upon which Tasktop is built. For more in-depth information on working in a task-focused manner using your Tasktop Task List, please see the following articles written by Dr. Mik Kersten, President and CTO of Tasktop Technologies:

 

Agenda

The Agenda is a compact overview of your weekly schedule of tasks and events drawn from your Task List, Google, and Outlook calendars. To open the Agenda, click the button or nearby hyperlink in the lower right corner of the Tasktop application window. Along with the scheduled tasks, the Agenda also includes an interactive calendar to aid planning. To configure calendar synchronization, click the Configure... link in the bottom right of the popup and follow the instructions outlined in Configuring Tasktop.

Once configured and a synchronization has occurred (manually initiate event synchronization by pressing the Refresh Events hyperlink), the Tasks you have scheduled or have set due dates for and any events from your chosen calendars will be present in the Agenda view.  Clicking on events within the Agenda will either result in the task opening in the task editor or events opening in their associated calendar. Changes you make when within the calendar will be reflected in the Agenda.  Rescheduling a task in your Google calendar will result in the task being rescheduled in your Task List and will be updated in the Agenda. Likewise, when a task's schedule or due date changes in the task list, these changes will propagate to the synchronized calendars

Use the links provided on the right column of the popup to open your Google or Outlook calendars within Tasktop.

To view your agenda in further detail, press the Show All button in the lower left corner of the popup to reveal the This Week's Events page. 

 

 

Calendars

Tasktop comes complete with Outlook and Google calendar integration allowing synchronization of tasks to your calendars and retrieval of upcoming events from calendars to your Agenda. View Outlook and Google calendars directly from within Tasktop by following the appropriate links  on the Agenda.  You can easily view and modify your Google and Outlook calendars without leaving Tasktop. Tasks within your Task List can be synchronized to calendars based on scheduled or due dates. Setting a date on a task will result in the task appearing in your calendar.  Drag tasks to reschedule within in your chosen calendar and Tasktop will propagate these changes to your Task List for you. Get started synchronizing to and from calendars by configuring your chosen calendaring application via the Calendars view in the Configuration Perspective (Help > Configure Tasktop).

For details see Outlook or Google calendar configuration.

Tip: A number of the Tasktop's features including Calendar integration, Task sharing via Task Repositories, and Web Applications can be configured and customized via the Configuration Perspective. Open the Configuration Perspective via the Help (menu) > Configure Tasktop.

When done with configuration, return to your previous perspective by pressing the Close Configuration button located in the top right corner of the window.

  Outlook Integration

  • Create Outlook email tasks in Tasktop from Outlook
  • Synchronize your Outlook tasks to Tasktop
  • View your Outlook calendar from within Tasktop

 

Outlook Email Tasks

Many tasks originate in email. Often, these tasks become lost in your inbox, scattered amongst various appointment requests, informational items, news alerts, and so on. With the Outlook Email Task support in Tasktop, you can easily create tasks for these email and manage them along with all your other tasks within a single task list. In addition to providing support for scheduling email tasks in your Task List, you can also associate files and web sites with the task making it easier to locate when returning to the task at a later date.

To get started working with Outlook Email Tasks, click the Outlook Email link under the Tasks and Calendar section of the Feature Overview page (accessible via Help (menu) > Feature Overview).  Clicking this link will result in the following:

1) An @Tasktop folder is created in Outlook

2) An '@Email ' query is added to your Task List in Tasktop. Upon dragging an email into the @Tasktop folder in Outlook, it will appear within the @Email query within the Tasktop Task List (once the Task List synchronizes). Task List synchronization occurs once every 1/2hr by default (configure via Window (menu) > Preferences > Mylyn > Task List). You can force synchronization on a particular query by selecting the query in the Task List and pressing F5.

You can now view your Outlook email tasks within Tasktop or open, forward, and reply to the original email in Outlook using the associated editor toolbar button. Tip: If you get warnings about Outlook security permissions see the related FAQ entries.


Tip: The Tasktop toolbar includes a button for launching new email creation using your default email client.

 

Outlook Tasks

Tasktop integrates with Outlook Tasks allowing you to manage, synchronize and create new Outlook Tasks directly from within Tasktop. To get started using Outlook Tasks within your Tasktop:

  1. Click the Outlook Tasks... hyperlink on the Feature Overview page (accessible from Help (menu) > Tasktop Feature Overview).
  2. Select Outlook Tasks in the resulting New Repository Query dialog and press Next.
  3. Enter a title for the Outlook Tasks query
  4. Choose from the available Outlook task folders

 

Outlook Calendar Configuration

Task Synchronization

To get started synchronizing tasks to your Outlook calendar do the following:

  1. Double click Outlook Calendar in the Calendars view to open the Outlook calendar configuration properties
  2. Press the Refresh Calendars button to update the list of available calendars
  3. Under the Synchronize Tasks To group, choose the calendars you wish to synchronize your tasks to
  4. Directly below calendar selection within this same group are two check boxes:

    • Synchronize Due Dates - Synchronize tasks with a due date set to the chosen calendars (Recommended)
    • Synchronize Scheduled Dates - Synchronize tasks with a scheduled date set to the chosen calendars

.  In order for tasks in your Task List to be synchronized to the calendars you chose in step 2, at least one of these two options must be selected.

Upcoming Events

The Tasktop Agenda displays upcoming events and tasks from your configured calendars. To configure display of events from your Outlook calendars perform the following steps:

  1. If not already open, double click Outlook Calendar in the Calendars view to open the Outlook calendar configuration page.
  2. Within the Retrieve Upcoming Events group, choose the calendars you wish to see events for.

From the Tasktop Agenda you can now get a quick overview of your tasks and events synchronized from your Outlook calendars as well as view and edit your Outlook Calendar from within Tasktop.

 

  Google Integration

  • View your Google calendars from within Tasktop
  • Create email tasks from your Gmail account

Google Calendar Configuration

Task Synchronization

  1. Switch to the Configuration Perspective. Double click Google Calendar in the Calendars view to open Google calendar configuration properties.
  2. Under Credentials, enter your Google account id (including the @gmail.com) and password (a functioning Google account is required before proceeding). Press the Refresh Calendars button to retrieve a listing of your Google calendars.
  3. Beneath the Credentials group is the Synchronize Tasks To group. This group controls synchronization of tasks from your Tasktop Task List to the selected calendar. Start by placing a check mark in the box next to the calendar you wish to synchronize your tasks to.
  4. Directly below calendar selection within this same group are two check boxes:
    • Synchronize Due Dates - Synchronize tasks with a due date set to the chosen calendars (Recommended)
    • Synchronize Scheduled Dates - Synchronize tasks with a scheduled date set to the chosen calendars

In order for tasks in your Task List to be synchronized to the calendars you chose in step 3, at least one of these two options must be selected. You may choose to synchronize tasks with only a due date set, only a scheduled date set, or both.

Tasks will now be synchronized with your Google calendars.

Upcoming Events

The Tasktop Agenda displays upcoming events and tasks from your configured calendars. To configure display of events from your Google calendars perform the following steps:

  1. Double click Google Calendar in the Calendars view to open Google calendar configuration page.
  2. Within the Retrieve Upcoming Events group, choose the calendars you wish to see events for.

Tasks and Events from the selected Google calendars will now appear in the Agenda.

 

Gmail Email Task Configuration

To get started creating tasks from you Gmail messages, first open the browser to your Gmail account. Locate an email you would like to track as a task in Tasktop and give it a special label, "Task" for example. If this label does not already exists you will need to choose the New label.. option and enter Task for the label name.

The next step is to configure Tasktop to synchronize all Gmail messages with the Task label to your Task List. To do so will require a one time setup of a Gmail task repository within Tasktop and addition of a special Gmail query to your Task List.

Open the Task Repositories view located in the top left corner of the Tasktop Configuration perspective (Tasktop Home toolbar button > Configure Tasktop). Within the Task Repositories view toolbar, click the Add Task Repository button and choose the Gmail option:

With your Gmail task repository configured, create a Gmail query (right click in the Task List and select New.. > Query, Gmail), give it a name and choose the label previously applied to the email message (i.e. Task).

 

The Gmail message you previously tagged will appear as a task in your Task List under the Gmail query you just created. Now you are free to open, review, schedule and plan your Gmail tasks along with all your others.

Tip: You can easily create a new task for yourself from any web enabled device using Gmail's email filter/labelling.  Configure a Gmail filter to automatically apply the "Task" label to any email received with a subject that starts with "task:". Then send yourself an email with "task: take out the garbage" in the subject from any web enabled device (i.e. a cell phone) and upon synchronizing, your Tasktop will have this new task in the task list when you next open Tasktop!

 

IMAP Integration (advanced)

Your Tasktop supports creation of email tasks from IMAP email accounts. To get started, create a folder in your IMAP account using your standard email client naming it "Tasks" for example. To create a task from an email, move or copy an email into the newly created "Tasks" folder using your email client. Once the one time configuration steps are completed below, dragging email into the "Tasks" folder in your email client will be all that is necessary to have the email appear as a task in your Tasktop.

IMAP email configuration

  1. Open the Task Repositories view (Task List view menu > Show Task Repositories View)
  2. Right click within the view and select "Add Task Repository"
  3. Select "Generic IMAP (Advanced)"
  4. Enter your IMAP repository settings in the resulting dialog, press the Validate button to ensure they are correct, and press Finish
  5. Create a query in the Task List. This query will being in your IMAP email messages form a specific folder ("Tasks" for example). Right click in the Task List and select New > Query. Choose to query over the IMAP Repository you created in step (4)
  6. Specify the label for your query (i.e. Imap Tasks) and the select the folder your email tasks should be created from ("Tasks" if you're following along with our example)

Upon synchronization, any email you now place in the "Tasks" folder using your email/IMAP client will now be synchronized to the "Imap Tasks" query in your Task list. You can now work with these email tasks just as you would any other task i.e. activating to build up context.

 

Web Browsing

Tasktop is a fully functional web browser.  The Tasktop browser is an enhanced version if Internet Explorer but can manage web sites for you, those you would usually have to bookmark and manager yourself. Return to a previously active task with a click of a button watch as all your important web sites are restored for you leaving you right were you last left off.  To get started, activate a task and open a new browser tab ((Window > New Browser Tab).  Enter a web site address of your choice into the navigation toolbar and press enter. See an overview of each site you have visited as part of this task within the Navigator:

Deactivate the task and the web pages are closed and your Tasktop is ready for the next task. Re-activate the previous task and watch as your browsing context is restored in the Navigator and your most recently viewed pages are restored for viewing.

For those with multiple monitors, it is often desirable to browse the web on one screen while working on another. Tasktop supports this mode of operation in two different ways:

  1. From main toolbar menu's browser launch drop down menu choose "New Focused Browser Window". This will open a secondary window that acts as a browser but is aware of the active task (so the pages you visit are added to the task).

  2. The second option is to launch a "New Browser Window" which acts as a regular browser and is not aware of your task activity. Pages viewed in this browser window are not added to the active task nor become part of your browsing history.

 

The location bar of any browser tab in Tasktop supports entering search text.

Upon entering search terms in the location bar, pressing enter will result in execution of your search with your default search engine (configurable via Windows > Preferences > Tasktop > Web Browsing).


Password Management

Tasktop's web browser provides simple password management to ensure that you don't need to repeatedly enter login credentials for protected sites. When logging into a new website, Tasktop will ask if you would like to save your credentials. On subsequent visits, Tasktop will automatically enter in your previously saved credentials.  When multiple accounts exist for the same web site, Tasktop will prompt you to choose which account to use.

 

Web Search

To quickly execute a search,  enter search terms in the Web Search box in the top right corner of your Tasktop application window and either click the magnifying glass or press enter.

You can select your default search engine right within the search selection popup. Open the popup by clicking the search engine icon to the right of the web search text box. In the top right of the launch popup you will see a combo box from which you can choose your default search engine.

Temporarily search using an alternate search engine, Wikipedia for example, by clicking the search engine icon and choosing Wikipedia from the Launch popup. Execute this same search but using a keyboard shortcut by pressing Right-Arrow, w, Enter. Click the Configure link at the bottom of the popup to open the Configuration Perspective and start adding your own engines to the list via the Web Applications view.

 

Web Bookmarks

There are times when you want to create an explicit bookmark and have it easily accessible from any task. For this reason, all your existing Firefox and Internet Explorer bookmarks are readily available within Tasktop. Additionally you can create new Tasktop bookmarks via the Send To button on the Browser navigation toolbar.

 

del.icio.us Bookmarks

Setting up your del.icio.us account

  • Open the Web Browsing preference page, select Preferences... from the Tasktop Home drop down toolbar menu and expand the Tasktop node in the left panel to Web Browsing.
  • Place a check mark in the "Enable del.icio.us bookmarks" option and enter your account information.
  • Press the Validate button to make sure your credentials are correct, then press OK.
  • Your del.icio.us bookmarks will now appear in your Navigator beneath the Bookmarks node. Each bookmark is visible under its corresponding tag.
                                   

Adding a bookmark

  • Navigate to the website that you want to bookmark
  • From the SendTo menu (drop-down menu located in the top right corner of the browser window), select Add to del.icio.us Bookmarks
  • Enter additional notes or tags in the pop up window, then click OK
  • The new bookmark appears in the navigator view under the specified tag(s)

                         

Removing a bookmark tag

  • Right click on the bookmark under the tag that you want to remove from the Navigator
  • Select Remove Tag from the drop down menu
  • If the selected tag is the only tag that this bookmark belongs to, the bookmark is removed; otherwise, the bookmark is still present under the other tags that it belongs to

Tip: URLs can be long and illegible if a title is not provided within the page contents. You can rename bookmarks within the Navigator by right-clicking and viewing the bookmark's properties page or pressing F2 on the bookmark.

 

Starring Web Sites

Sites you access regularly as part of your work day should be easily accessible. To facilitate this, you can 'Star' web sites through the popup menu in the Navigator view or via the Send To button in the browser toolbar. Starred web pages are available under the Starred node in the Navigator. The list of starred sites is a flat list (no folders) unlike bookmarks that can be organized into folders. The default location of the starred list is at the bottom of the Navigator view. You also the have the option of the starred list displayed as a window trim by going to Tasktop->Web Browsing and select Show starred list on window trim.

 

Send To

The Send To button in the browser navigation toolbar gives you quick access to common actions when web browsing including:

  • Add To Bookmarks - Current web page is added under the Bookmarks node in the Navigator
  • Add to Starred - Current web page is starred and added under the Starred node in the Navigator
  • Mark as Landmark - Site is made a landmark (turns dark back in the Navigator)
  • Set current page as home page - Site is set as default home page (also configurable via Window (menu) > Preferences > Tasktop > Web Browsing)
  • Print - print the contents of the current web page
  • Save As... - Save the contents of the current web page to your file system
  • Create Task From Web Page - Create a new local task using the content from the current web site for the new task's tile, and url field
  • New Browser Tab - Duplicate the current page in a new browser tab

 

Files and Desktop

Linking Folders

To add files to your task context you must access them through the Navigator view. This requires a one time configuration step of linking in the folders that contain the documents you work with daily. Usually this is the My Documents folder or some subset of the folders within it.  To being linking in folders, press the Link Folders button in the Navigator view's toolbar. In the wizard page, select the desired folders and upon pressing Finished they will become available in the Tasktop Navigator view.

 

Finding and Searching Files

To locate files within the Navigator, enter the name of the file in the Find: text field and press enter. If many results are found that match your query, you may see a button appear after finding. If you don't immediately see the file you are searching for within the present results, pressing this button will reveal files more deeply nested in your file system that mach the search criteria.

To search based on file contents, press the button available to the right of the Find section of the Navigator view. The Find text entered in the Navigator's Find field will be added for you in the File Content Search dialog.

 

Tip: When working within the Tasktop's Navigator view it is often desirable to reveal a file or folder in the native system file explorer. With Tasktop, you can achieve this by right clicking on the desired file or folder and selecting "Locate on Disk".

Creating Documents

Once your document folders are linked into the Tasktop's Navigator view, they are accessible and can become part of your task contexts.  You can create Office documents within linked folders by right clicking on the desired folder, choosing the New option, and selecting from one of the available document types. When you create a document within a linked folder through another application, for example when saving an email attachment or creating a new document in Word, Tasktop will notice this new file adding it to your context (when a task is active).  Instead of having to re-locate the document in your files system, it is immediately accessible via Tasktop's Navigator view.

 

Working sets

For those whose work week spans multiple organizational units, working sets help further focus the user interface and minimizes information overload.  Working sets allow grouping of task and resource containers together. Switching working sets exposes only the content in the working set, excluding all others from views such as the Task List and Navigator. Below you can see the user has created three working sets: Mylyn, Personal, and Tasktop. Press the working set drop down button to create, edit, or choose your desired working set.

 

Tasktop's Navigator view supports working set visibility for both files and web content.  With a working set enabled, web content browsed as part of an active task will be visible only within this working set.  When switching to another working set, web pages viewed in other working sets will not be present in the Navigator nor in the web browser's history drop down.  Note that if you change the content being displayed in the Navigator view via the view's drop down men, be sure to re-enable window working set support via the view's menu option Select Working Set.

There is also a window trim that displays all available working set as well as number of incoming tasks for each working set. To display this trim, go to Tasktop under Preferences and select Show task working sets in the window trim. Clicking on the trim will toggle between the selected working set or show all working sets.

To clear all web history select Show All working sets, right click the History node in the Navigator view:

 

 

Time Tracking

Dashboard

Get an overview of where you have spent time via the Dashboard by clicking the Time Tracking Dashboard button . The Dashboard shows all of the tasks on which you have been working this week. The information is shown in a table that lists tasks that you have spent time on as well as in three charts: a bar chart that shows time spent per day and two pie charts that show time spent per category and per working set.

Select the date range you are interested in by selecting Today, This Week, or Last 4 Weeks. To see date ranges other than those predefined, you will need to create an activity report. Next to the three date range buttons is the Refresh button . Click on this to regenerate the charts and Tasks table with the latest task activity data.

Note: All information present on the Dashboard or in an activity report are gathered from the task list and the stored activity data. Only tasks that are on the Task List would show up in the Tasks table. If you have to delete tasks from your task list or you want to get a snapshot of the current information, you can create an activity report and export the report to csv or html format.

Each task in the Tasks table has a context menu that is accessible if you select the task and click the right mouse button. Selecting Highlight in Charts from the context menu for a task will highlight in the Time Spent chart and the Category and Working Set pie charts where the selected tasks that were worked on belong to. Similarly you can select a bar in the Time Spent chart and the corresponding task is highlighted in the table and the pie charts. Hovering over elements reveals tooltips that show more information about the element.

Each chart uses the same coloring scheme. Each color represents a different working set. To differentiate completed tasks in the Time Spent charts, click the Show Completed Tasks in Green button in the table section header. Enabling this option shows all completed tasks as green in the Time Spent chart. A Working Set Legend at the bottom of the dashboard shows the five working set slices that you have spent the most time on and their corresponding colors.

There is also a summary section that shows the total time spent during the specified time period as well as total time spent with no task active. It also provides you information about how many tasks have been worked on during the specified time and how many were completed.

Activity Report

The Dashboard is intended to be a quick overview of how your time was spent. A report gives you more control over what data to display as well as allowing you to adjust the data. To create a report, select Create New... from the Report section in the Dashboard. Enter the name for the report. By default, a new report uses the same date range as the Dashboard.

A report presents all the information from the Dashboard, as well as showing task ID, repository, project and activity in the Tasks table. It provides the following additional controls:

Selecting Date Range

To change the date range of the report, click on the down arrow of the date range picker at the top right of the report editor. Inside the popup dialog, select one of the predefined date ranges or click on the desired start and end date in the corresponding calendar. Click Apply to regenerate report.

Working Set and Category Selections

To bring up the working/category selection, click on the Select Working Set / Categories... button next to the date range picker. If no working set exists, the Select Categories dialog appears.

By default all available categories and queries are selected. Remove or add from or to the right table until you have selected the set of categories or queries for the report. Click Finish to regenerate report to display tasks that only belong to the selected categories or queries.

If you have working sets in your workspace, the Select Working Set dialog will appear first. By default the Show All option is selected. To select a subset of the working sets, uncheck that option and make your selection. You can then click Finish (in which all categories or queries inside the selected working sets are selected) or click Next to modify the category / query selection.

Data Editing

Adjusting Time Spent on Task - The Tasks table shows all tasks that were worked on in the specified date range and the recorded amount of time that was spent on each task. To adjust these time entries, click on a task under the Adjusted column. Enter actual time spent on the task in the format hour:minute. For more descriptive time adjustment entries, right click on the task and select Add Activity. A new row is added as a child to the selected task. Enter description (for example Meeting) and time spent on the activity. The actual time on the parent task is incremented by the time spent amount on the activity. Time adjustments are stored per report once the report is saved.

Adjusting Project or Activity for Task - For a local task, the default project is the parent category name; for a repository task, the default project is the value of the product attribute and the default activity is the value of the component attribute. To change the project and activity values of a task, click on the task under the corresponding column to bring up a combo box. Select from the list (which consists of the default value, as well as all custom entered entries) or enter a new item in the text box.

Adding a task - In the case where a task was not activated even though work was done for the task, you can include it in the report manually by selecting Add Task... after right clicking on a day. Select a task from the Select Task dialog. A new row with the selected task information is added to the Tasks table. You can then adjust the actual time spent on the task.

Adding an Activity - To add an activity that does not fall under any predefined task, you can right click on a day, then select Add Activity. A new row is added to the Tasks table where you can enter summary, project, activity and actual time spent. This entry appears in the same level as other tasks.

Remove a task / activity - You can remove any task, task activity or activity by right clicking on the row and selecting Remove Selected. You can restore any deleted task by selecting Restore Removed Tasks... on a day (or anywhere in the Tasks table in the non-day view) which brings up a dialog with all the removed tasks. Select task(s) to restore from the dialog.

Tasks table View Controls

On the top right of the Activity section, there are three buttons for toggling different views for the Tasks table.

View By Day - By default this is selected. When selected tasks are organized per day with time spent on each day displayed. If unselected, the total time spent for each task in the date range specified are displayed.

View by Project and Activity - By default this is unselected. When selected tasks are grouped according to the specified project and activity and total time spent per project per activity is shown.

Filter/Include Incomplete Tasks - By default this is selected (Include Incomplete Tasks). This control toggles whether incomplete tasks are shown in the Tasks table.

Export Report

To get a snapshot of your activity report or to share your report, export it to HTML or CSV format by selecting Export to HTML or Export to CSV in the Actions section at the bottom of the report editor.

Partner Connectors

Tasktop makes it easier than ever to install connectors for some of the industry's leading task repositories including JIRA, CollabNet (SourceForge Enterprise Edition - SFEE, Issuezilla, Project Tracker), and Rally.  With Tasktop's new installation technology, partner connector installation is effortless. In addition, each connector is tested to work with the supported version of Tasktop and Eclipse, saving you the time and configuration debugging that can result from manual installation.

To install a partner connector, click on the button in the main toolbar to open the Feature Overview and select the Partner Connectors tab. Each partner connector has the option to install, create an account, or find out more about the partner connector via their web site. To install, simply click the install hyperlink. After accepting the license agreement the partner connector will be installed. It is that simple.

 

Tasktop Services

Automatic Tasktop Updates

During your Tasktop trial period (30 days) or while your purchased subscription is valid, your Tasktop will automatically install updates weekly as the become available.  This functionality can be disabled on the Tasktop preferences page: Window > Preferences > Tasktop. To manually initiate a Tasktop update, open the Community and Support page via Help (menu) > Tasktop Home and select the Community and Support tab at the bottom of the editor. Under the Configuration section press the Check for Updates hyperlink.

 

Uninstalling Tasktop

Uninstalling the Tasktop application

  1. Close Tasktop (File > Exit)
  2. From the Windows Start menu navigate to Programs > Tasktop and launch the Uninstall application

     
  3. Press the Uninstall button and the Tasktop program components will then be removed.
  4. After removal you are given the option to either reboot  your computer now or later. We recommend closing all open applications and rebooting now.

Uninstalling the Tasktop plug-ins for Eclipse

Uninstalling plug-ins from Eclipse can be error prone and time consuming.  For this reason we outline two different procedures for removal of your Tasktop plug-ins.

Removal of plug-ins via Manage Configuration (requires multiple Eclipse restarts):

  1. Navigate in the toolbar menu to Help > Software Updates > Manage Configuration
  2. Expand the Eclipse node until you see all the Tasktop features listed

     
  3. Enable display of disabled plug-ins, press the button in the toolbar
  4. Select all Tasktop features, right click to reveal the popup and choose disable. Restart Eclipse when prompted
  5. Repeat steps 1 - 4 until all Tasktop features are disabled. This may take a few iterations.
  6. Now that all Tasktop features are disabled, select all of the Tasktop features, right click to reveal the popup menu and choose Uninstall. Restarting Eclipse when prompted.
  7. Tasktop features and plug-ins have now been removed. Note that you can get an installable application version of Tasktop from http://tasktop.com.

Note: Uninstalling Tasktop can potentially leave you with a later version of Mylyn then before you installed Tasktop.

Removal of plug-ins via file system (requires single Eclipse restart):

  1. Shutdown Eclipse
  2. Open a windows explorer view to your Eclipse application install folder
  3. Remove all com.tasktop.* features from the features folder
  4. Remove all com.tasktop.* folders and plug-in jars from the plugins folder
  5. Restart Eclipse

FAQ

Please see the Tasktop FAQ.