Time Reports

Task Timing

When you have a task active, Tasktop Dev will track the exact time you spend within Tasktop Dev. Tasktop Dev Pro will also track the time spent working in applications outside of Tasktop Dev. 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 view the time spent on an individual task open the task editor and expand the Time Tracking Section, shown here:

This section shows you a graph of the time spent on the task and can be adjust to show time for today, this week, last week, and the last four weeks.

The Time Tracking Section can also be used to upload time worked to a JIRA or Bugzilla repository. In the above picture the user has checked "Submit Time" and thus upon next submit he will upload 1:15 hours to his repository. The dialog automatically populates the "To Submit" time based on the user's active time and the time he has already submitted, but allows the user to adjust this time if needed prior to submission. If the Active time - Submitted time is not the same as the To Submit time then the refresh button will become enabled, and the user can press this button to automatically populate the To Submit time.

Submitting time in this way is convenient for users who want to submit time for a single task. If the user wants to submit time for all the tasks he has worked on in the past week it may be more convenient to use the Time Reporting Time Push Feature.

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

report actions

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.

Submit Time

Tasktop Dev's time reporting feature takes the pain out of submitting time accumulated on both JIRA and Bugzilla task repositories. Easily make adjustments to your task time and then submit to both JIRA and Bugzilla repositories all from within Eclipse. 

Adjust times within the time report (a black outgoing arrows appears in columns with unsubmitted time) then press the Submit Time button to preview the time being submitted.

report actions

Press Finish to submit your time to the respective JIRA and Bugzilla tasks.

Progress Bar

To make the time spent on a task more visible in Tasktop Dev, 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 Dev:    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: