Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This article is for the Legacy Table View. This feature is currently undergoing a phased rollout to users across all deployments and may not reflect the behaviour of the version you see in RoadmunkStrategic Roadmaps. For more details on the Modern Table View, check out our article on Getting Started in the Table View.

Create Roadmap Items

There are two main ways of creating and adding roadmap items: creating them from scratch or importing them from a CSV. In this article, learn how to create items from scratch using the Items Table and drag-and-drop new items onto a Timeline or Swimlane.

Iframe
srchttps://fast.

...

wistia.com/embed/medias/e7hts4quis
width100%
height400

Creating items in the Items Table

The Items Table is a tabular view of the items in a roadmap. Each row in the table is an item, and each item is made up of Fields, one Field per column in the table. With every item you create, a new row is added to the table.

...

To go to a roadmap's Items Table, click the Items icon on the View navbar.

Create an Item

...

1. Click the Create New Item button (only appears when the roadmap has no items).
OR

...

Tip

The dialogue stays open until you close it so you can continue to add more items, one after another.

Create another item from the item card

...

When creating multiple items that share the same fields, you can create another item by checking the "Create another" option in the item card. 

This will replicate all the same fields as the previous item created except for the item's description.

Inline item creation

The Items Table also has support for inline item creation, letting you quickly add items to your roadmap.

...

  1. Navigate to the Items Table.

  2. Hover your cursor between two rows and click the green + symbol to create a new item. 

  3. Input your item name and press Enter when done. You can add consecutive items without interruption.

 

Set the item's date

An item's datecan be a range of dates or a specific date.

...

Tip

You can also set the date(s) in the item card.

...

Add the item to a time Bucket instead

If you don't have fixed dates for an item yet, or you're adding the item to a "no-dates" roadmap or a more agile roadmap that can be pivoted on flexible or "fuzzy" time in a Swimlane visualization, you can add the item to a time Bucket such as Soon or Future. Time Buckets are used instead of dates.

...

Info

If you can't add a new value to the list, it means you don't have the permissions required to edit the Bucket field.

 

Drag-and-dropping a new item onto a Timeline or Swimlane

The Items Table is not the only place you can add items to a roadmap. You can also add an item by creating and drag-and-dropping it onto a Timeline or Swimlane. Here's how in a Timeline.

...

If you need to refresh your memory on how Timelines and Swimlanes work and are created, go to Visualizations: Timelines vs. Swimlanes, Create a Timeline visualization, and Create a Swimlane visualization.

Who can add items to a roadmap?

To add an item to a roadmap, you must be the roadmap's Owner OR the roadmap must be shared with you as an Editor

If a roadmap has been shared with you as a Viewer, you have view-only access to the roadmap and can't add items to it. As a Viewer, the + Item button on the View navbar will be grayed out and you will see a View Only icon on the Roadmap navbar. 

...

View Items in the Items Table View

The Items Table provides a tabular view of a roadmap's data and makes it easy for you to browse and work with the roadmap's items, including hiding and showing fields, sorting and ranking items, and changing the order of the columns (fields) in the table.

Hiding and showing fields

The hide/show field feature in the Items Table is a great way to get more horizontal screen space so you minimize the need to scroll horizontally.

Hide a field

...

  1. Mouse over the field you want to hide until the Hide Field (-) icon appears, then mouse over the icon and click it when it turns blue.

Show a hidden field

...

  1. Click the Add Field (+) icon that's at the end of the table header.

  2. In the dropdown's Hidden Fields list, click the field you want to show.

Sorting items

By default, items in the Items Table are ranked in the order they were added (first item at the top). The Items Table's sort feature lets you sort items in alphabetical order by any field in the table.  

NOTE: Multi-Select fields do not have sorting ability 

 

Sort items

...

  1. Mouse over the field you want to sort by until the Cogwheel icon appears, then mouse over the icon and click it when it turns blue.

  2. In the dropdown, select Sort A to Z for ascending order or Sort Z to A for descending order. 

You'll know which field items are sorted by and in what order by the up or down arrow next to the field's name. 

Toggle between ascending and descending, and reset the sort order

...

  1. You can click the arrow next to the field to toggle between ascending and descending alphabetical order.

  2. To reset the sort order to the default, click Clear Sort.

 

Ranking items 

The ranking feature lets you change the default ranking of items in the Items Table  by moving one or more items around on the table so they're ranked in a way that's more logical for you (for example, by level of importance or complexity).

...

IMPORTANT: Unlike sorting, there's no way to automatically reset items back to their original ranking order. Once you move an item to a different place in the table, it stays there until you move it again. 

Re-order table columns

You can also change the order of the field columns in the Items Table.

...

  1. Click the header of the column you want to move.

  2. Drag-and-drop the column onto its new location. 

Browsing and finding items

Find the items you’re looking for by either using pages at the bottom of the Items Table and browsing or use the Item search to find a specific item.

...

Choose between entering the page number you want to see, moving forward or backward a single page, or to the beginning or end of your table. 

Bulk updating items

If you hover over the top left of the Items Table, there is a checkbox that will select all items on the page. With Select All clicked, this is a great way to bulk update field values of items or push multiple items to Jira at once.

...

View All Data

Every roadmap you create in Roadmunk Strategic Roadmaps comes with an All Data view in addition to the default View 1. The All Data view displays ALL the items in a roadmap in the Items Table, which makes it a handy, useful reference for when your roadmap has over 100 views!

Opening the All Data view

You open the All Data view the same way you open any other view.

...

  1. All Data is selected in the View dropdown instead of a roadmap view.

  2. The Filter icon on the View navbar is grayed-out and disabled. That's as it should be, since All Data provides an unfiltered view of the roadmap's items.

  3. The Milestones Table is accessible from the View navbar but the navbar doesn't provide access to a Timeline or Swimlane. To access the roadmap's visualizations, you have to select the corresponding view in the View dropdown.

  4. The Export icon on the View navbar is enabled so you can export ALL the items to a CSV file.

Why do you need the All Data view?

There are a number of reasons why you need the All Data view.

...

Export ALL items and ALL milestone to CSV. Although you can export a roadmap's items or milestones to a CSV file from any view, a view's filterset is applied when you do an export, so only the filtered items or milestones are exported. All Data is the only way you can export ALL the items or milestones in the roadmap.
For more on exporting items and milestones, go to Export roadmap items and milestones.

...

View and Edit Item Details

You can edit an item's individual field values directly in the Items Table. But if you want to view or edit everything associated with a roadmap item in one go, the item card is the better choice. 

You can open the item card from any of the roadmap's Timelines or Swimlanes as well as from the Items Table. 

Editing item details in the Items Table

Edit individual fields

Other than Description, you can edit any field directly in the Items Table. 

...

  1. Click inside the field in the table and make your edits.

  2. When you're done, click anywhere outside the field.

Bulk Select and Edit items

If you want to change a field in more than one item to the same value (for example, change Status to Backlog), you can do a bulk edit.

...

Info

A checkmark in the column indicates the item is selected. To unselect an item, click its checkmark. To unselect all items, click Clear All at the top of the column.

Viewing and editing item details in the item card

You can open an item card from any of the roadmap's Timelines or Swimlanes as well as from the Items Table. 

Open the item card

From the Items Table:
Click the item's Items field.

From a Timeline or Swimlane:
Click the item on the Timeline or Swimlane.

What can you do in the item card?

The item card is like command central for items, where you can view and edit everything associated with an item.

...

  1. Default fields - Edit the item's default fields: Item/Name/Title, Date, and Description. You can also delete the item by clicking the Garbage can icon.

  2. Activity and Fields tabs - The Activity tab displays the item's Activity Feed. The Activity Feed is a log of all the changes made to an item since it was created, including posted comments and mentions. The Fields tab lets you view and edit the item's custom fields (more about this below). 

  3. Item attachments - Upload, view, download, and delete file attachments. To learn more, go to the section below - Add, View and Download Item Attachments.

  4. Linked Items - With Roadmunk Strategic Roadmaps and Linked Items, you can create multiple relationships between Items and roadmaps across your organization to allow for better collaboration and strengthened decision making.  To learn more, go to Working with Linked Items.

  5. Sub-items - Sub-items allow you to break your initiatives into smaller, more manageable pieces and groups, which allow you and your team to easily visualize the parent & child relationship in both the Items Table and Roadmap views. To learn more, go to Introduction to Sub-items.

  6. Ideas - To ensure visibility into the ideas and feedback that impacted your team's decision-making process when roadmapping, RoadmunkStrategic Roadmaps's Idea module allows you to link ideas to roadmap items in your roadmaps and quickly view the ideas from the respective item cards in your roadmap views. To learn more, go to Attaching Ideas to Roadmap Items.

Edit default fields

To edit the item's Name/Title:
Click inside the field and enter the new value.

...

To edit the item's Description:
Click inside the field and start typing. You can use Markdown in the description. Click the ... icon below the textbox to get help on Markdown syntax.

Edit custom fields

You can edit all the item's custom fields in the Fields tab, including List, Multi-select List, and Free-form Text fields.

...

  1. Click Fields to open the Fields tab.

  2. To edit a List field, click to open the field's dropdown and select a new value. If it's a Multi-select List field, edit the field by adding and/or removing one or more values.

  3. To edit a Free-form Text field, click inside the field and start typing.

Editing item details in a Timeline or Swimlane

You can edit an item's details directly in a Timeline or Swimlane (to add an item to a Timeline or Swimlane, see Create roadmap items).

Drag an item on a Timeline to change its Date

To change an item's Start and End Dates directly in a Timeline, drag the item horizontally along its stream until you see the new date range. 

Drag an item on a Timeline or Swimlane to edit field values

If you need to edit an item's field values, you don't need to go back to the Items Table. Just drag-and-drop the item vertically and/or horizontally across the pivot headers. The item's pivot field values are automatically updated based on the item's new location in the Timeline or Swimlane.

To lock an item's date on a Timeline as you drag it vertically, press and hold the Shift key. Other items will move out of the and new streams will be added if necessary.

Drag and add new streams in a Timeline

To move a stream on a Timeline, click and drag the stream up or down to its new location. Other streams will move out of the way as needed. To add a new stream, drag an item up or down and drop it onto the newly created stream. You can also add a new item and drag it to the bottom of any header row, then drag the new stream to where you want it in the Timeline.

Who can edit items in a roadmap?

To edit items in a Roadmunk roadmap you must be the roadmap's Owner or the roadmap must be shared with you as an Editor

If a roadmap has been shared with you as Viewer, you have view-only access to the roadmap. This means you can view items in the Items Table and all roadmap Timelines and Swimlanes, and view item details in the item card (View items in the Items Table). You can also post item comments and mentions in the item card.

Add, view and download item attachments

You can attach files to a roadmap's items through the item card, each item card supports files up to 10MB in size. With that being said, please note that the file attachment allowed per item is different from the total item attachment allowed for your account - you can check out here to see the total item attachment available for your account.

...

  1. To attach a file to the item, click the + Attach Files button.

  2. To view an attached file, click the file name on the file's panel.

  3. To download an attached file, mouse over the file's panel and click the Download icon that appears.

  4. To delete an attached file, mouse over the file's panel and click the Delete icon when it appears, then click Delete It in the confirmation popup.

Who can add, download, and delete file attachments?

To attach a file to a roadmap item and delete attached files, you must be the roadmap's Owner OR the roadmap must be shared with you as an Editor

...

Info

Attachments are only visible to Account Admins, Collaborators and Reviewers on your account, and will not be visible to users accessing roadmaps through published URLs. 

...

Move Multiple Items on a Roadmap at Once

To move multiple items in a roadmap, use your mouse to drag and highlight the items that you want to move. 

NOTE: You can select individual items to move on a roadmap by holding down the Shift key. If you want to reverse any immediate changes made to items on a roadmap, simply press the Undo button that appears at the bottom left of the screen. A maximum of 30 items can be moved at once. 

Timeline View

...

Swimlane View 

...

The bulk actions menu

...

Using your mouse to drag and highlight the items that you want to move will bring up the bulk actions menu. This menu will let you: 

...

NOTE: You can only string and waterfall items that share the same Header

String items

...

  1. Select the items that you want to move.

  2. On bulk actions menu, select the String icon. 

...

NOTE: The item with the earliest start date will take the first position in the newly formed string of items. Subsequent items are adjusted to have their dates set to be back-to-back. 

Waterfall items

...

  1. Select the items that you want to move.

  2. On bulk actions menu, select the Waterfall icon. 

...

NOTE: Items will waterfall in order of their start dates, the dates of individual items are not changed. 

Moving items by date

You can choose to move your selected items forwards, backwards, or by a specific date. 

...

NOTE: Although you can drag your mouse over items you want to move in both Timeline and Swimlane view, certain actions such as being able to string, waterfall, or move items by a specific date, are only available in the Timeline view.

Who can move, string, or waterfall multiple items on a roadmap?

To move, string, or waterfall multiple items on a roadmap, you must be the roadmap's Owner OR the roadmap must be shared with you as an Editor. If a roadmap has been shared with you as Viewer, you have view-only access to the roadmap and cannot move, string, or waterfall multiple items.

Move items to another roadmap

The Items Table move feature lets you move items from one roadmap to another. You can move items to an existing roadmap or you can create a new roadmap for the items.

...

Items which are linked to Jira cannot be moved

...

Duplicate Items

From the Items table view, users are able to create exact copies of items by selecting the items that they're looking to duplicate and selecting the Duplicate button in the roadmapping toolbar. This will create an exact duplicate of the items on the roadmap while retaining all dates, field values, and sub-items associated with the original item.

...

Duplicate items are technically copies and not the original items, so comments and item activity will not be carried over to the duplicate and will remain on the original.

...

Delete Items

There are a number of ways to delete a roadmap's items. You can bulk-delete items in the Items Table. You can delete an item in a Timeline or Swimlane. And you can delete an item in the item card.

Note

Deleting items from a roadmap deletes them from the Roadmunk Strategic Roadmaps account. You can't undo an item delete. Once you delete an item, it's gone forever.

Bulk-deleting items in the Items Table

You can bulk-delete items by selecting them in the Items Table.

...

Note

Deleting items from a roadmap deletes them from the Roadmunk Strategic Roadmaps account. You can't undo an item delete. Once you delete an item, it's gone forever.

Deleting an item in a Timeline or a Swimlane

  1. On the Timeline or Swimlane, right-click the item you want to delete, then click the Delete popup that appears.

  1. In the Confirm Deletion dialog, click Delete it.

Deleting an item in the item card

Open the item card

From the Items Table:
Click the item's Description field.

From a Timeline or Swimlane:
Click the item on the Timeline or Swimlane.

Delete the item

...

  1. In the item card, click the Delete item icon.

  2. In the confirmation popup that appears, click Delete It.

Who can delete roadmap items?

To delete items in a Roadmunk roadmap you must be the roadmap's Owner or the roadmap must be shared with you as an Editor. If a roadmap has been shared with you as Viewer, you have view-only access. 

To find out more, go to Sharing and collaboration in the Quick Guide.

WARNING: Deleting items is permanent

Deleting items from a roadmap deletes them from the Roadmunk Strategic Roadmaps account. You can't undo an item delete. Once you delete an item, it's gone forever.