7pace Timetracker's "Timesheet" Page

Timesheet Filters Bar

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 option 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. Note: This filter is available only if the “Current project” filter is checked.
• "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. Note: This filter is available only if the “Current project” filter is checked.
• "Show items from ..." is enabled - With this option enabled, the page shows work items from previous weeks even if there are no tracks assigned to these items in the displayed week. This makes the process of filling your timesheet easier if you work on the same items for multiple weeks. Once enabled, you can choose to show items from 1 week, 2 weeks or 4 weeks prior to the current week.

Blue Highlighted Cells

• You might notice that some cells within your timesheet are highlighted with a bold 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 17, below).
• Rows highlighted with a light blue background indicates that there are items without worklogs during this week; they are displayed because the "Show items from previous weeks" option is enabled.

Add Time

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.

Keyboard Optimization

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. 

Timesheet View

The following table lists the keyboard shortcuts that you can use on the "Timesheet" page to quickly perform various operations.

Adding Time

The "Timesheet" page allows you to add your time on a weekly basis. You can:

• Click the "Add Time" link at the top-left of the "Timesheet" page and use the "Add Time" dialog box to enter your time details.
• Double-click within a table cell and add time directly within that cell.
• Click the ( or ) icons within the table cells and use the "Add Time" dialog box to enter your time details. 

Note: If “Prevent Time Entry Against Closed Items” is enabled under “Settings” -> “Rules”, you will see "This workitem is closed" when you hover over a corresponding cell:

Add time with the "Add Time" link

1. On the Timesheet page, click the Add Time link.

2. Fill in the fields that display that your admin has configured in Settings.

3. Click the Save button.

Add Time Directly Within the Timesheet Table

1. Double-click in an empty or single-time entry table cell where you want to add or edit time.

The cell becomes an editable textbox.

• Enter your time in HH:MM format.
• Use the arrow keys to select hours and minutes.

2. Press Tab or Enter on your keyboard to save the time entry.

Add Time with the "Add Time" list editor

You'll notice that the Timesheet table features icons ( and ) in its table cells. The () icon indicates that there is either no time entry or just a single time entry in that cell. the () icon indicates that there are multiple time entries within that cell.

1. Click on the () icon or the () icon within a cell.

The "Add Time" list editor, which can only be opened from within the Timesheet table, displays. The "Add Time" dialog box shows multiple time entries (you can add up to five (5) time entries here).

The ID and name of the work item for which you are adding time displays, as well as the weekday and date on which you are adding time.

2. Click in an empty row to add a new worklog.

A new empty row automatically displays under the current one (up to 5 entries).

The Total time of all the entries also displays.

(Clicking the "x" icon at the end of a row deletes the row/entry.)

3. Add the following into each corresponding cell within the new row:

• Length: The duration of your work.
• Start: The start time of your work.
• Activity Type: Displays when enabled in "Settings". You can categorize your time entries by the activity types created by your administrator.
• Comment: Any extra information relevant to your time entry.

4. Click "Save".

Editing and deleting time

If a cell in the "Timesheet" table contains a single worklog (), you can click directly in that cell and delete the worklog using just the delete key on your keyboard. Clicking within a single worklog or blank cell also turns it into a text editor, so you add or edit time directly in the cell, also using your keyboard. If a cell contains multiple worklogs (), the "Add Time" text editor box opens when you click "Delete" on your keyboard, allowing you to delete worklogs one-by-one.

You can also delete single or multiple worklogs by clicking on the () or () icons within a cell, which opens the "Add time" text editor box. This allows you to delete worklogs with the "Remove row" () icon.

Note: If a user is tracking time and edits (removes) the worklog currently being tracked by the Windows Client or Timetracker Web Client, the system will automatically stop tracking.

Also, if “Prevent Time Entry Against Closed Items” is enabled under “Settings” -> “Rules”, you will see "This workitem is closed" when you hover over a corresponding cell.

1. In the Timesheet table, navigate to a table cell with a single worklog ()and click within the cell.

2. From your keyboard, press the Delete key.

The time entry is deleted immediately.

3. Tap the "Enter" key

The deletion is complete.

4. Now, navigate to a table cell with multiple worklogs () and press the Delete key on your keyboard.

The "Add Time" text editor box displays.

5. Click the Remove row () icon on the worklog(s) you want to delete.

The time entry/row is removed.

6. Click the Save button.

The deletion is saved.

7. You can also delete time on the Timesheet page by clicking on either a single-time entry () icon or a multiple-icon entry () icon.

This causes the "Add Time" dialog box to display.

8. Click the Remove row () icon on the worklog(s) you want to delete.

The time entry/row is removed.

9. Click the Save button.

The deletion is saved.

Submitting and revoking time

Submitting your time

1. Click the icon beside "Week is in progress".

2. Click "Submit for approval". 

3. Select your approval manager from the "Send for approval to" dropdown and then click the blue "Send for approval" button.

The timesheet is submitted for approval. The week's status and button change accordingly.

Revoking your time

4. (Optional) Hover over the "Submitted for approval" icon if you want to make changes to your submitted timesheet, before it is approved by your manager. 

5. Click the blue "Revoke submission" button.

The status of the week changes to "Week is reopened". The timesheet is revoked and you can now make changes to it.