The "Timesheet" page provides an alternate method of viewing, managing, and entering your work time details on a weekly basis. Time you've tracked displays with the work items associated with that time listed in rows, and the days of the week presented in columns. The design of the page allows you to view the work items for time you've worked or entered time during a given week, the level of effort assigned to PBIs, features, and epics, the total time you've tracked for work items, as well as the total hours logged on a work item on a given day or for the current week. Like an Excel spreadsheet, each cell in the "Timesheet" table can contain single or multiple time records.
You can choose to "View by This Week's Iterations" (you can turn this feature "On" or "Off") to view work items from the selected week's iterations, then choose to view "My Items Only" (by clicking the corresponding checkbox) which populates items from the current iteration assigned to you only, or you can uncheck the box to see items assigned to the whole team. If "View by This Week's Iterations" is off, then only your items with time records remain. You can also filter by "Current Project".
You might notice that some cells within your timesheet are highlighted with a light blue background. This means that during this period, the corresponding work item had an "In progress" state and was assigned to you, the current user. This makes it easy to add your time at the end of any given week (see number 14, below).
You can add, edit, and delete (and even submit) time in a variety of ways on this page, which are outlined in more detail, below. Any changes or additions made on the "Timesheet" page are fully integrated with the rest of Timetracker and of course, TFS/VSTS.
The "Timesheet" page is also keyboard-optimized. Just by using the "Tab" key, arrow keys, and "Enter" key on your keyboard, you can navigate everywhere within the timesheet, and add or edit your time. For additional and more detailed information on Keyboard Shortcuts and on the "Timesheet" page in general, please scroll below.
Clicking on this opens the "Add/Edit Time Record" dialog box, which can be configured in different modes, like Timeframe mode, Duration mode, or Mixed mode.
An administrator can configure different modes on your behalf.
Date range of the current week
If you are viewing a week that is not the current one, the "Current Week" link is enabled.
You can expand or collapse the items that display on the page by one level for a more concise or more detailed view.
This link is enabled only when you are not viewing the current week.
"View by This Week's Iterations"
Turning this "On" (the default) filters the page by the current week's iterations only. This action also displays the "My Items Only" checkbox (see #7, below).
If "View by This Week's Iterations" is off, then only your items with time records remain.
The effort value assigned to PBIs, features, and epics.
"My Items Only"
With this "On", the page is filtered "By Iterations" view and by items assigned to the user. You can then easily view and add your time to the items that have been assigned to you. With this selection turned "Off", the page populates with the items assigned to the whole team.
The total time that you have tracked for the work item up until the present time.
Filters the page results to the current project only.
The actual timesheet table where you can add or edit the time for your work.
|11||The time that you tracked or added for the work item on that day.|
The () icon indicates that you have not entered time or only have a single time record for that work item ID on that day.
When you click this icon, the "Add Time" dialog box opens with the time record details. Here, you can add, edit or delete time records and it fully integrates with the rest of TFS and Timetracker.
When "Activity Types" are configured by your administrator, an "Activity Type" column will also display on this dialog box, allowing you to add and edit activity types for your time records.
If you make any changes, click the Save button to save the changes and show them on the time sheet.
Note: For single time records per work item ID per day, you can directly edit or delete a time record in the table cell, similar to an Excel spreadsheet. Simply double-click within the cell and start typing the new time from your keyboard. To delete the time record, go to that cell and press the Delete key from the keyboard.
The () icon indicates that you have multiple time records for that work item ID on that day.
When you click this icon, the "Add Time" dialog box opens and displays the list of time records for that work item. The "Add Time" dialog box is unique to the Timesheet page. In this dialog box, you can view multiple time records and add, edit or delete time records. Any changes made are reflected throughout the rest of TFS and Timetracker.
When "Activity Types" are configured by your administrator, an "Activity Type" column will also display on this dialog box, allowing you to add and edit activity types for your time records. If your admin has not enabled this feature, it will not display here.
If you make changes, click the Save button and these changes will be reflected on the page.
Note: When there are multiple time records, you cannot edit or delete the time records directly in the cell by double-clicking the cell. Instead, the Add Time dialog box will open and you can make the necessary changes to the entries there.
Blue cells within the Timesheet table highlight Tasks, Bugs, User Stories and PBIs that are assigned to the current, logged-in user. It highlights only days when these items were "In Progress" (or a similar state, depending on your specific template).
If your data and sprint backlog is in good shape, the user only has to fill in the blue cells at the end of the week.
Please note that if a particular task is assigned to you until just Wednesday during a given week, for example, and then for the remainder of the week, that task is assigned to a different team member, your timesheet will only be highlighted in blue for that task until Wednesday.
"Week is in progress"
The status of the current week's timesheet ("Week is submitted for approval" displays if you have already sent your timesheet to your manager, etc.).
For more information about Timetracker approval statuses, see "Approval" Page: Approval Icons.
"Submit for Approval"
The button to submit your timesheet for approval. If it has already been submitted, this will displays as "Pull Back".
Once your manager approves your submitted timesheet, the Timesheet table becomes read-only for that week. If you open the "Add Time" dialog box, all time records will display in read-only mode.
Once submitted, the button caption changes to "Pull back". Until it is approved, you can click this button to revoke your submitted timesheet to make changes and resubmit it for approval.
The total time that you spent for each work item in the week.
The total time that you spent for each work item on each day in the week.
The following table lists the keyboard shortcuts that you can use on the "Timesheet" page to quickly perform various operations.
|Ctrl + Del||Removes the time record from the "Add Time" record dialog box.|
|Ctrl + S||Saves the time record entries in the "Add Time" record dialog box.|
Left, Right, Up, Down arrows
|Easily navigates within in the Timesheet table and "Add Time" dialog box.|
In the Timesheet table: