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 you've tracked or entered time on during a given week, the level of effort assigned to PBIs, features, and epics, the total time you've tracked for all 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 worklogs.
In an effort to optimize performance on the "Timesheet" page, some changes have been made to the original page filters to reduce page load time, starting with Timetracker 5.1. If the DevOps organization is large, it creates requests that take a long time for DevOps Services to get information on all projects and all Iterations within those projects and then all work items within those iterations. In order to see the "View by This Week's Iterations" option, please ensure that the "Current Project" filter is checked/enabled. This will show all iteration work items, but only for the current project. You can also filter by "My Items Only".
- All filters disabled - With no filters checked, the page will display only work items that you have already tracked time on during the selected week. Results will display on the page quickly, as only those work items on which you have tracked time will show.
- "Current project" selected - With "Current Project" enabled, the results will show only items from the currently selected project (work items with time tracks from different projects will be filtered out). Therefore, page results may display even faster.
- "View by This Week's Iterations" is ON - With this filter enabled, the system will search for and add all active iterations and all work items of those iterations to the Timesheet results, in addition to building and processing its relations tree. This filter may slow page load time if you have a large project and a lot of active iterations/work items.
- "My Items Only" is selected - With this filter enabled, the system will filter out the previous request and will display work items that are assigned directly to you. This significantly reduces the number of work items and decreases the load time of the page.
Blue Highlighted Cells
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 DevOps Server/DevOps Services.
The "Timesheet" page is also keyboard-optimized. Just by using the "Tab", "Enter" and arrow keys 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 Time" dialog box, which can be configured in different modes: Timeframe, Duration or Mixed mode.
An administrator can configure different modes on your behalf under "Settings" -> Rules.
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.
Filters the page results to the current project only. Enabling this allows you to also view and/or select the selections "View by This Week's Iterations" (choose "On" or "Off") and when you turn "View by This Week's Iterations" to "On", you also have the option to enable the filter "My Items Only".
"View by This Week's Iterations"
Turning this "On" filters the page by the current week's iterations. This will show all iteration work items for the current project. This action also displays the "My Items Only" checkbox.
If "View by This Week's Iterations" is off, then only your items with worklogs remain.
"My Items Only"
With this "On", the page is filtered by current project, "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 effort value assigned to PBIs, features, and epics.
The total time that you have tracked for the work item up until the present time.
The () icon indicates that you have not entered time or only have a single worklog for that work item ID on that day.
When you click this icon, the "Add Time" dialog box opens with the worklog details. Here, you can add, edit or delete worklogs and it fully integrates with the rest of Dev Ops Server/Services and 7pace Timetracker.
If you make any changes, click the Save button to save the changes and have those changes reflected on the timesheet.
Note: For single worklogs per work item ID per day, you can directly edit or delete a worklog 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 worklog, go to that cell and press the Delete key from the keyboard.
The time that you tracked or added for the work item on that day.
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.
|13||"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.).
"Submit for Approval"
The button to submit your timesheet for approval displays when you hover over "Week is in progress". A pop-up window will then display to allow you to choose your approval manager. Once your timesheet is submitted, this button will then display as "Week is submitted for approval". Hovering over this will allow you to "Revoke submission" any time before your manager approves your timesheet.
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 worklogs will display in read-only mode.
The total time that you spent on each work item during that 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 worklog from the "Add Time" dialog box.|
|Ctrl + S||Saves the worklog entries in the "Add Time" dialog box.|
Left, Right, Up, Down arrows
|Easily navigates within in the Timesheet table and "Add Time" dialog box.|
In the Timesheet table: