Note: This article pertains to Timetracker 3 only. Please see "Work Item Automation" section for Timetracker 4.
When you expand the "Work Item Settings" of the "Configuration" tab's "Settings" section, you can control the integration of Timetracker with the time management capabilities of Team Services.
Important: In addition to enabling the settings, below, in order to make automatic completed/remaining work adjustment work, please ensure the following:
- VSTS: Authorize Timetracker in VSTS
- TFS: Set up a valid service account
This is what you will see when you expand the "Work Item Settings" section:
|Select the field used for "estimated effort":||
The value in this field is used to calculate pace. Select the "estimated effort" field in the drop-down list to view the effort and pace calculations on the "Iterations" page.
|Estimated Remaining Time|
|Enable automatic reduction of remaining time for a work item field||
If selected, the time tracked in Timetracker automatically reduces the value in the "Remaining Time" field.
The field remains fully writable by users, so it can be manually adjusted at any time.
This option provides a drop-down list that includes all fields as specified in the Work Item Template (WIT) that can be used with this feature. For additional information, see "Estimated Remaining Time/Work" section, below.
|Enable filling in total tracked time for a work item field||
If selected, the time tracked in Timetracker automatically updates in the "Completed Work" field.
The field remains fully writable by users, so it can be manually edited at any time. However, if a team member tracks 2 hours of time for a work item, the "Complete Work" field is automatically updated to the time that the developer tracked for it.
This option provides a drop-down list, which lists all fields as specified in the Work Item Template (WIT) that can be used with this feature. For additional information, see "Completed Work" section, below.
|Apply||The "Apply" button saves any changes you make in this section and applies them appropriately.|
Estimated Remaining Time/Work
The "Remaining Work" field from TFS helps keep your burndown organized, and is used by Timetracker to automatically update time left on a particular work item, based on the time you track for it. For example, let's say you estimate your remaining time on a work item to be two (2) hours. When you start tracking time for that work item, the "Remaining Time" field automatically starts decreasing from that estimated time, as soon as you start tracking on it.
You can enable this setting by clicking the "Enable automatic reduction of remaining time for a work item field" checkbox under "Estimated Remaining Time".
7pace Timetracker uses the Completed Work field from TFS to display the completed hours for a work item and sub-items.
The "Completed Work" field also provides you with the ability to manually edit time by adding, changing, or deleting time directly in the field. If you track time on a work item, then the "Completed Work" field is automatically updated with the total time that is tracked or added for that work item by all team members.
Important: Before you configure "Completed Work" in Timetracker's "Settings", if the corresponding TFS field already contains a value, then Timetracker will overwrite that value and keep updating the field based on your tracking and manual time adjustment. There is no option to prevent overwriting the original value in this field.
The "Completed Work" field can be configured on a project basis. You can create a new, custom field for a specific project in TFS, similar to the "Completed Work" field. You can then can select this new field in Timetracker under Configuration -> Work Item Settings -> Completed Work dropdown.