Create Roadmaps

Print this topicEmail this topic

New Editable Detail Pages

Rally has released new Editable Detail Pages (EDPs) that allow you to directly edit fields. If you can see a field and have the correct permissions, you can edit it. Fields are automatically saved when you leave a field.

All user story, defect, task and portfolio item detail pages automatically default to the new version. For a limited time, you can switch back to the old version of the portfolio item editor.

Creating roadmaps consists of the following topics:

Portfolio items:

  • Must have a type value assigned to them
  • May only have parents of the next-higher type in the hierarchy, you cannot skip levels
  • May only have children of the next-lower type in the hierarchy; if there is no lower type of portfolio item, then children must be user stories
  • Cannot have defects, defect suites, test cases, tasks, or other associated artifacts except for attachments and discussions

Create a new portfolio

If you are creating a new portfolio that you have not previously modeled using Rally's user story hierarchy, here are a few options to help you get started quickly:

  • Import portfolio items from a CSV file
    • The CSV import for portfolio items does not allow automatic parenting—use the bulk chooser in the Page Tools menu to multi-select.
  • Create portfolio items from the Portfolio Items page for each type
  • Create portfolio items from the Portfolio Items page for the highest type, then add children going down the hierarchy until you reach the lowest type in the hierarchy

Once you have created your portfolio item hierarchy, you may create new user story children from a portfolio item of the lowest level type, or you may parent existing user stories to a portfolio item of the lowest level type.

Your portfolio is administered at the workspace level. You cannot share a portfolio across workspaces.
Portfolio items, projects, and custom fields cannot be shared or rolled up across different workspaces. Rally recommends you limit the number of workspaces you create.

Create a portfolio from an existing user story hierarchy

If you are creating a portfolio that you already modeled in Rally's user story hierarchy:

  1. Import portfolio items from a CSV file or create portfolio items from the Portfolio Items page for upper-level types.
  2. Convert a user story to a portfolio item of the lowest level type. The conversion process will move user story children to the portfolio item, and will keep the original user story in its pre-conversion schedule state along with any associated defects, defect suites, test cases, and tasks.
  3. Associate the newly converted portfolio item to its appropriate portfolio item parent.

Convert a user story to a portfolio item

You can only convert a user story's basic fields to a portfolio item of the lowest level type. The original user story remains in its original location and schedule state.

To convert a user story to a portfolio item:

  1. Locate the user story you wish to convert and access its detail page.
  2. Select Actions → Convert to Portfolio Item.
  3. The children user stories, attachments, and discussions are moved with the parent story. Custom fields, defects, defect suites, and test cases are not converted. The original user story remains behind in the state it was in before it was converted.

User stories can have either portfolio items or other user stories as parents, but not both.

Note: If the portfolio item has any required fields other than Portfolio Item Type, you cannot convert it.

Bulk choose user stories and portfolio items

Assign multiple user stories or portfolio items to a parent portfolio item in a single action with the bulk chooser. The chooser allows you to search by FormattedID, Name, and Parent fields. Bulk choosing allows for automatic parenting.

  1. Do one of the following:
    • For user stories: On a lowest-level portfolio item detail page, select User Stories from the sidebar.
    • For portfolio items: On any level of a portfolio item detail page (except the highest level), select Children from the sidebar.
  2. From Page Tools, select Bulk Choose User Stories or Bulk Choose Children.

    Note: If the parent of the user story is a portfolio item, the parent portfolio item does not display. Be careful not to inadvertently re-parent a story.

  3. On the chooser, further refine your search by selecting Parent, Formatted ID, or Name from the drop-down menu.
  4. Enter any search criteria in the search field and click Search.

    The search does not support wildcards.

  5. Select the checkboxes of the stories you wish to add and click Done.
  6. If you do not have editing permissions to a user story or portfolio item, it will not be added. A brief message displays, listing the work items that could not be added.

    If you choose a large number of children, it may take a few moments to load. You can monitor the progress of a large bulk selection from the number of user stories indicated in the sidebar.


Manually rank portfolio items

If you have manual ranking set up in your workspace and  you  drag-and-drop a portfolio item on the Kanban board in either the same column or across columns, Rally shows you where that card will automatically fall according to its manually entered rank.

For example, if you have a portfolio item that is ranked second in the column according to its manual rank and you try to drag it up or down in the column, a green bar displays between the first and second cards—the only place it can land regardless of where you drop it in the column.

User access and permissions

There are no special permissions for Rally Portfolio Manager. Instead, user permissions for projects enable Rally users to create and change portfolio items, or to see portfolio items associated with user stories.

Consider creating a new project for your portfolio items if you do not want to co-locate them in a project where development teams have editing privileges (although this is no different than restricting access to organizing user stories in your user story hierarchy).

If you wish to create a new project for your portfolio items, make sure to locate it above the team projects in the project hierarchy so that users in lower projects can easily scope up in the project tree views. If you have portfolio managers or other users who only want to track status and progress of portfolio items, give them view permissions for this project.

Create portfolio items

To create a new portfolio item:

  1. Click the Portfolio tab, then select Portfolio Items.
  2. On the Portfolio Items page, click +Add New.
  3. Do one of the following:
    • Enter a description in the New Theme field, then click Add. You can add details later.
    • Click the Add with Details button.
  4. On the Create Portfolio Item editable detail page, complete all required fields.
  5. Complete any of the optional fields on the editable detail page.
  6. Click Save & Close.

Portfolio item fields

Field Description
IDA system-assigned value. Click on the ID of a portfolio item in the summary view to go to the detail view. You can change the portfolio item prefix.
NameEnter a unique, meaningful name for the portfolio item. This is a required field.
Portfolio Item TypeSelect a type for the portfolio item from the drop-down menu if the portfolio item has no parent or children. Otherwise, Rally will assign this value for you. For information on how to edit these values, see Manage Roadmaps. This is a required field.
TagsSelect one or more tags to associate to the portfolio item. Assigning tags helps with sorting, filtering, and reporting.
DescriptionEnter a meaningful description to help other users understand the purpose of the portfolio item. Use the rich text editor to apply fonts, formatting, links, and more. You can copy and paste images in this field.
AttachmentsClick the Browse button to upload any attachments, such as images or .pdf files that help describe the portfolio item.
OwnerSpecify the owner for the portfolio item. This value defaults to the user who creates the portfolio item, but can be changed at any time.
ProjectSpecify the project within Rally to which the portfolio item is assigned. This is a required field.
DiscussionsFrom the detail page, click on the Discussions link in the sidebar to add or view discussions. Discussions has a rich text editor.
RevisionsFrom the detail page, click on the Revisions link in the sidebar. Revisions include a revision number, detailed description, date stamp, and author.
ParentClick the magnifying glass icon to assign a parent portfolio item. Click the red X to unassign a parent. A parent may not be assigned to a portfolio item of the highest type. A portfolio item can only have a portfolio item parent. A user story may have either a portfolio item parent or a user story parent.
ChildrenFrom the detail page, click on the Children link in the sidebar to view or add children to the portfolio item. Portfolio items of the lowest level type will see a User Stories link instead, since they can only have user stories as children.
ReleaseUse the Release attribute on the lowest level of portfolio item (typically referred to as 'Feature') to schedule a feature into a roadmap timeframe.
StateUse this drop-down to filter portfolio items as they display on summary pages or Kanban boards.
Tracking Indicators (summary page)
% Done by Story Plan EstimateThe value of this field is calculated by dividing the number of accepted points by the total user story points for user stories associated with the portfolio item.
% Done by Story CountThe value of this field is calculated by the number of accepted user stories divided by the total number of user stories associated with the portfolio item.
            Hover over either of the % Done fields to see the number of accepted points and user stories. If these fields have a red warning flag in the upper-left corner, the callout describes the warning.
Actual Start DateThe earliest date an associated user story is moved to an In-Progress schedule state.
Actual Start Dates for portfolio items with work-in-progress before 11/19/2011 will be null until another associated user story goes into progress, then the Actual Start Date will reflect that user story's in-progress date.
Actual End DateThe latest date the final associated user story is moved to a Accepted (or later) schedule state.
StateSpecify the status of a portfolio item. This value also determines which state column on the Portfolio Kanban Board a portfolio item is located.
State Changed Date The date on which a portfolio item moved from its previous state to its current state. If a portfolio item already has a state prior to 4/28/2012, the value is set to the current system date until the state changes again.
Planning Fields
Preliminary EstimateGauge the size of a portfolio item during planning.
Refined Estimate Enter an updated estimate during capacity planning as more is known about the features being planned.
Investment CategoryAssign portfolio items to an investment category to ensure they align with your organization's goals.
Value ScoreEnter the value this portfolio item could bring to a feature or initiative. Use a score determined by your organization.
Risk ScoreEnter the potential risk to deliver the portfolio item. Use a score determined by your organization.
Planned Start DateEnter the date you intend to begin work on this item.
Planned End DateEnter the date you intend to finish work on this item.
WSJF Prioritization
WSJF ScoreThe Weighted Shortest Job First (WSJF) Score is a prioritization method that many Program Managers and PMOs use to choose which features to schedule soonest.
NotesEnter any relevant notes that will help team members understand the progress of the portfolio item. Notes display on callouts.


Need more help? The Rally Success Community is your one-stop shop for self-service and support. To submit feedback or cases to Rally Support, find answers, and collaborate with others, please join us at
© 2015 Rally Software Development Corp | Legal