Task (Agile)

You can learn how to fill in the details of a task work item in this topic. For information about how to create a task work item, see Work Items and Workflow (Agile).

Required Permissions

To view a task, you must be a member of the Readers group or your View work items in this node must be set to Allow. To create or modify a task, you must be a member of the Contributors group or your Edit work items in this node permissions must be set to Allow. For more information, see Managing Permissions.

Defining a Task

A task communicates the need to do some work. Each team member can define tasks to represent the work that they need to accomplish. For example, a developer can define development tasks to implement user stories. A tester can define test tasks to assign the job of writing and running test cases. A task can also be used to signal regressions or to suggest that exploratory testing should be performed. Also, a team member can define a task to represent generic work for the project.

The form for task work items stores data in the fields and tabs that are shown in the following illustration:

When you define a task, all fields are optional except for Title.

To define a single task

1. In the top section of the work item form for a task, specify one or more of the following types of information:

   • In Title, verify and, if necessary, update the title to better define the area of work to be accomplished.

     The title provides a concise overview of the task to be completed. The title should be descriptive enough to allow the team to understand what area of the product is affected and how it is affected.

   • In the Assigned To list, click the appropriate owner for the task.

     Note

     You can assign work items only to members of the Contributors group.

     Note

     You can assign only one resource to each task. If more than one team member will work on the same task, divide it into separate tasks or subtasks, and assign a single team member to each.

   • In Stack Rank, type a number or leave this field blank.

     In general, teams work on items that have a lower value in this field first.

   • In the Priority list, click a value to specify the importance of the task on a scale of 1 to 4, 1 being most important.

     The default value is 2.

   • In the Area and Iteration lists, click the appropriate area and iteration, or leave these fields blank to be assigned later during a planning meeting.

     Note

     The project administrator for each team project defines area and iteration paths for that project so that the team can track progress by those designations. For more information, see Create and Modify Areas and Iterations.

   • In Original Estimate, type a number that represents the hours of work that the task will take to complete.

     Important

     If you subdivide a task into subtasks, specify hours for the subtasks only. In Team Foundation reports, hours that you define for the subtask are rolled up as summary values for the parent task and the user story. If you assign hours in both place, hours will be counted twice in those reports that track hours. For information about how to correct this condition, see Address Inaccuracies Published for Summary Values.

   • In Completed, type 0 to specify that no work has been completed.

   • In Remaining, type the same value that you specified in Original Estimate.

     If your team is using the Original Estimate, Completed, and Remaining fields to determine team capacity, burndown, and burn rate, you will want to update the Completed and Remaining fields as you perform the work. Also, these fields are synchronized with Office Project, which you can use to schedule the project plan. For more information, see Scheduling Tasks and Assigning Resources Using Microsoft Project.

2. (Optional) On the DESCRIPTION tab, type as much detail as you want to describe the work to be performed.

3. On the HISTORY tab, type comments that you want to capture as part of the historical record. Every time that a team member updates the work item, its history shows the date of the change, the team member who made the change, and the fields that changed.

4. (Optional) Link the task to other work items, such as user stories, bugs, or issues. For more information about these activities, see the following sections in this topic:

   • Linking a Task to a User Story

   • Linking a Task to a Bug

5. Click Save Work Item.

   Note

   After you save the task, the identifier appears under the work item toolbar.

Linking a Task to a User Story

You link tasks to a user story to track the progress of work that has occurred to complete that story. After you define a task, you can link it to the user story that it implements by using the following procedure.

To link a task to an existing user story

1. On the Implementation tab, click Link to.

   The Add Link to Task dialog box opens.

   

   Leave the Link Type set to Child, which is the only type of link that is supported for links that you add on the Implementation tab.

2. Click Browse.

   The Choose Linked Work Items dialog box appears.

   

3. In Saved query, click the Open User Stories team query, and then click Find.

4. Select the check box next to the user story you want to link to the task.

   For more information, see Find Work Items to Link or Import.

5. (Optional) In Comment, type a description for the tasks to which you are linking.

6. Click OK.

7. Click Save Work Item.

   Note

   Both the task and the user story that you linked are updated.

Linking a Task to a Bug

You might want to link the task to a bug that it addresses.

To link a task to an existing bug

1. On the All Links tab, click Link to.

   The Add Link to Task dialog box opens.

   

2. In the Link Type list, click Related.

3. Perform one of the following actions:

   • Type the items in Work item IDs.

   • Click Browse to specify bugs from a list.

     The Choose Linked Work Items dialog box appears.

     

     In Saved query, click the My Bugs or Active Bugs team query to locate the item to which you want to link. Click Find, and select the check box next to each bug you want to link to the task.

     For more information, see Find Work Items to Link or Import.

4. (Optional) Type a description for the items to which you are linking.

5. Click OK.

6. Click Save.

   Note

   Both the task and the items to which you linked it are updated. A Related link to the task is defined for each bug or issue that you added.

Adding Details, Attachments, or Hyperlinks to a Task

You can add information to a task that supports its implementation. You add details to tasks in the following ways:

• Type information in the Description or History field.

• Attach a file.

  For example, you can attach an e-mail thread, a document, an image, a log file, or another type of file.

• Add a hyperlink to a Web site or to a file that is stored on a server or Web site.

To add details to a task

1. Click the Details tab.

2. In Description, type information.

3. In History, type information.

   You can format information to provide emphasis or capture a bulleted list. For more information, see Titles, IDs, Descriptions, and History Field Reference.

4. Click Save Work Item.

To add an attachment to a task

1. On the Attachments tab, perform one of the following actions:

   • Drag a file into the attachment area.

   • Click or press CTRL-V to paste a file that you have copied.

   • Click Add, and then click Browse. In the Attachment dialog box, type or browse to the name of the file that you want to attach.

     (Optional) In the Comment box, you can optionally type additional information about the attachment. To close the Attachment dialog box, click OK.

2. Click Save Work Item.

To add a hyperlink to a task

1. On the All Links tab, click Link to.

   

2. In the Link Type list, click Hyperlink.

3. In the Address box, perform one of the following actions:

   • If the link target is a Web site, type the URL, or copy it from your Internet browser and paste it into the Address box.

   • If the target is a server location, type the address in the form of a UNC name.

4. (Optional) In the Comment box, type additional information about the hyperlink.

5. Click OK, and then click Save Work Item.

Workflow Progression

Typical workflow progression: A team member creates a task in the New state. A team member changes the state from New to Active when the task has been started. A team member changes the state from Active to Closed when the task has been completed.

Task State Diagram

See Also

Concepts

User Story (Agile)

Other Resources

Plan the Sprint

Agile Process Template for Visual Studio ALM

Work Items and Workflow (Agile)