Manage backlog items

Perform actions on individual backlog items.

In this topic:

Break items into tasks

Tasks enable you to break down backlog items into smaller activities.

To create tasks:

1. Do one of the following:

   • While creating a new backlog item, you can type tasks in the Tasks to generate text box. Each line in the text box will be converted to a task.
   • In existing backlog items, you can create tasks in the Tasks tab.

2. To assign a task to a team member, select a user in the Owner field. If you are working in the Team Backlog, you can drag a task to a user bucket in the Team pane.

3. Estimate the effort needed for each task, in hours.

   You define the estimated hours as integers or decimal fractions.

   To use decimal fractions, the TASK_SUPPORTS_FLOAT_VALUES parameter must be turned on. For details, see Configuration parameters.

Import tasks

You can also import tasks from an Excel file.

Choose one of the following options:

• To import tasks to one specific backlog item, open the item's Tasks tab, and click Import from Excel.
• To import tasks to several backlog items, in the Settings menu, under the Import section, click Tasks.

For details, see Import from Excel.

Back to top

Use the task board

Use Board View to manage task progress.

To use the Task Board:

Board View is displayed by default in the following locations:

• In the Backlog or Quality modules: In the Tasks tab when you open an individual user story, quality story, or defect.

• In the Team Backlog module: In the Tasks tab.

Tasks are grouped per user story, quality story or defect. The board displays each task phase in its own column. Drag the tasks from column to column to update the phase.

To add tasks, click the + Task button in a Task board column. Provide a name for the task. Then, click on the task number link to define other necessary attributes.

Back to top

Move through the workflow

As you make progress, advance an item through its workflow phases. For details, see Phases.

Back to top

Block an item

Occasionally, when working on a backlog item, you cannot proceed with your work due to a dependency or other reasons. You can indicate this by blocking the item.

To block an item:

1. In the grid or details view, select items and click the Block button.

2. The Block reason dialog box opens. Enter the reason for the item being blocked. You can enter plain text.

   The Blocked field automatically changes to Yes.

To unblock an item:

Select a blocked item and click the Unblock button. The item's Blocked field automatically changes to No.

Blocked item indicators

Blocked items have special indicators in the grid and board views.

In the grid view, ensure that the Blocked column is selected.

Back to top

Track work completion progress

Track your work completion progress to ensure you finish items at the right time.

To track work completion progress:

Chart/graph	Where?	Description
Task board	Backlog module and Team Backlog module	The story details show the completion status of the tasks in the selected story:
Team buckets	Team Backlog module	Each team member bucket shows the progress for assigned items (stories and tasks): Tip: Hover over the graph to see a numerical breakdown of progress by hours. This graph does not show the individual per-story breakdown.

Back to top

Update your task hours

Update your task hours using the following time counters:

Counter	Description
Estimated hours	The time estimation for the task. The Remaining hours counter is initially set to equal the Estimated hours. If you adjust the Estimated hours before the Remaining or Invested hours are updated, the Remaining hours will be adjusted to match the new Estimated hours.
Remaining hours	The number of hours remaining for the task. This is initially equal to the Estimated hours. As you decrease the Remaining hours, the Invested hours counter increases accordingly. Adding to the Remaining hours does not subtract from the Invested hours.
Invested hours	The time invested in the task. As you increase the Invested hours, the Remaining hours counter decreases accordingly. Subtracting from the Invested hours adds time back to the Remaining hours.

To disconnect the Remaining hours and Invested hours counters, click the lock button.

To re-establish the connection between the counters, click the lock button again.

Back to top

Split unfinished user stories

Usually, at the end of a sprint, you should close all user stories. If you are unable to complete all the tasks, split the user story.

To split user stories:

1. In the backlog or Team Backlog module, select the user story to split.

2. In the toolbar, click the Split Backlog Item button .

3. In the Split Story dialog, specify the details for the current user story and new user story.

4. If necessary, use the Move open tasks option to define how to resolve all open tasks.

When you split the user story, another user story is created in the New phase.

All tasks not marked as Done are moved to the new user story. These attributes and items are also added to the new user story:

• The value of any field other than the Name, Sprint, or Phase

• Tests associated with the original user story

• Attachments included in the original user story

Back to top

Next steps:

• Create and run tests
• Release quality
• Track release progress