Backlog item actions

Action Description Availability
Add Acceptance Test Define the criteria that a user story must meet in order to be considered complete. Sprint Backlog, Details page
Add Attachment

Add an attachment to the selected item.

Most common file types are supported as attachments.

Avoid attachment names with special characters (~!@#$%()^&), as these can cause unexpected results when uploading the attachment or when synchronizing with ALM.

Caution: Attachment files can contain dangerous content, and must be downloaded and opened with caution.

We strongly recommend implementing anti-virus protection for any file storage used when accessing Agile Manager.

Add New Item dialog box, Details page

Add Comment Add a comment to the selected item. Details page

Add Item

Create a new theme, feature, user story, or defect, depending on the grid you are viewing.

When creating a new user story or defect on the Release Backlog, Sprint Backlog, and Task Board pages, the new item is included in the selected release or sprint backlog, and added to the product backlog.

Add Linked Item Create a user story or defect that is linked to the selected backlog item. Based on your settings, a backlog item cannot be closed while it has open items linked to it. Product Backlog > Backlog, Release Backlog, Sprint Backlog pages
Add Task Define the actions necessary for fulfilling a user story or defect. Sprint Backlog, Task Board, Details page
Block Item / Unblock

Indicate that a backlog item should not be worked on, and specify the reason. A blocked icon is displayed in the grid alongside the item, on the Details page, and in the Blocked Items Dashboard widget.

Hover over the icon to view the reason.

Note: Technically, you can assign blocked items to release and sprint backlogs, and change their statuses. However, the best practice is to avoid working on items while they are marked as blocked.

When work on the backlog item may resume, unblock the item.

Break Story

Break a large user story into two or more smaller stories. The original story is converted into a group story that contains the parts you define, and is linked to them.

  • Each of the new stories inherits the original story's tasks, acceptance tests, and entity links.
  • Story points assigned to the original user story are removed. The group story's story points are the sum of the story points assigned to the new parts.

Use the Group Story View on the Product Backlog > Backlog page to view the group story and drill down to its children.

Note: You can continue to break the new user stories into lower-level parts. These are all maintained under the same hierarchy as the original user story.

See also:

Product Backlog > Backlog, Release Backlog, Sprint Backlog pages, Task Board
Convert to Feature

If you have a large user story, you can convert it to a feature. You are given the option of keeping the original user story and associating it with the feature.

See also:

Product Backlog, Release Backlog
Copy a backlog item

Make a copy of a user story or defect.

The newly created item is an exact copy of the original item, with a new ID, a modified name, and with Status set to New.

Product Backlog > Backlog, Release Backlog, Sprint Backlog, Storyboard, Defects
Export Backlog to Excel / Export Backlog to CSV

Export a grid to an Excel or CSV file. Grid data is exported as displayed, based on the current filter and selected columns.

Tip: When you export to Excel, you can include related tasks and acceptance tests.

All Backlog pages, Task Board, Defect Management
Import Backlog

Import backlog items from an Excel or CSV file.

Tip: When you import from Excel, you can include related tasks and acceptance tests.

Product Backlog, Release Backlog
Mark as Done

Set a backlog item to 'Done'. By using this action, all of the backlog item's tasks are set to 'Completed'.

Based on your project settings, you may be prevented from closing a backlog item while it has open linked defects or non-passed acceptance tests.

Release Backlog, Sprint Backlog, Task Board, Storyboard
Navigate to Previous or Next Item If you accessed the details view from a grid page, such as the Release Backlog or Sprint Backlog grid, use the Previous and Next arrow buttons in the top right-corner of the page to navigate to the previous or next item in the grid's filter. Details page
Planning Plan the selected items to a specified release, sprint, and team. For defects and user stories, you can specify a release together with a sprint or team, or both. Product Backlog > Backlog, Release Backlog, Sprint Backlog pages, Task Board, Sprint Closure, Feature Board, Storyboard
Print backlog grid Print all of the user stories and defects that match the current filter. Product Backlog > Backlog, Release Backlog, Sprint Backlog
Rank Highest / Rank Lowest Send backlog items to the top or bottom ranks in the backlog. All Backlog pages
Send by E-Mail Send items to other project users via email. You can select and send multiple items at the same time. General
Set Applications Associate a theme, feature, or backlog item with one or more applications. All Backlog pages
Set Feature Associate a backlog item with a feature. Product Backlog > Backlog, Release Backlog, Defect Management
Set Theme Associate a feature with a theme. Product Backlog > Features, Feature Board
Show in Backlog Items View Display the selected user story in the Backlog Items View. Group Stories view
Show in Group Story Display the selected user story under its group story in the Group Stories View. Backlog Items view
Show Position in Backlog Locate the item in the current backlog. This action clears the filter and highlights the selected item. All Backlog pages
Split Story

At the end of a sprint, all user stories should be closed. If you invested time in a user story, but not all its tasks and acceptance tests are completed, you can split the story. Remaining effort and non-passed acceptance tests are moved under a new user story, which you can assign to a future sprint.

Right-click a user story, and select Split Story.

See also:

Sprint Backlog, Task Board, Sprint Closure
Split Feature

At the end of a release, split unfinished features. User stories and defects that are not completed are moved under a new feature, which you can assign to a future release.

Product Backlog > Features, Feature Board
Update Selected Update properties of multiple backlog items at once. All Backlog pages, Defect Management
View Details / View Details in New Tab

Click an item's ID to view an item's details in a form layout on the Details page.

  • Right-click and select View Details in New Tab to view the details in a separate tab.

  • Hover over a backlog item to display a tooltip with some basic information and links to the item's feature and theme.

Some properties are available only in the Details page and cannot be viewed from the grid.