Importing Agile Work Items

An agile work item is a user story, defect, epic, goal story, impediment, or task. Agile work items can be associated with projects, releases, sprints, and backlogs. All agile work items are part of a hierarchical structure called the project tree, which orders every agile work item in relation to its parent, peers, and children.

You can use the import data template to import an agile work item. Each row on the Work Types tab represents an agile work item that you want to import. Each column on the Work Types tab represents an attribute (required or optional) that is used to define where the imported agile work item will be placed in the project hierarchy, what it's name will be, and so on.

The Agile Work Items tab has the following columns:

Column	Description
Import	Required. Values: True, False. Set this column to True to import the data contained in the row.
AgileWorkItemType	Required. The following agile work item types may be imported: Impediment, Task, or User Story. Use the system name for the user story. This can be found in the System Name field on the Work Types tab in the Types Setup tab of the Configuration module.
Name	Required. The name of the agile work item.
Description	Optional. The description of the agile work item.
Product	Required. The name of the project under which the agile work item will be placed.
Release	Optional. The name of the release under which the agile work item will be placed.
Team	Optional. The name of the team under which the agile work item will be placed.
Sprint	Optional. The name of the sprint under which the agile work item will be placed.
Parent Agile Work Item	Optional. The name of a parent agile work item in the investment hierarchy. This is valid only for assignable tasks, and tasks must be associated with a user story.
Attributes	Optional. The system name and value of an attribute that can appear in a view for the agile work item being imported. This must be a valid attribute for the agile work item type. Valid attributes can be found in the Attributes tab on the Work Types tab in the Types Setup tab of the Configuration module. For each attribute that you want to appear in a view, add a column in the template using the system name for the attribute as the column header. The system name of an attribute can be found on the Attributes tab in the Attributes Setup tab of the Configuration module. Enter the value that you want to import in the column. This must be a valid value for the attribute. List values associated with attribute lists can be found on the Lists tab in the Attributes Setup tab of the Configuration module.