For more information on user permissions, click here.
In this Article:
- Import from Asana to Roadmunk
- Import from Excel to Roadmunk
- Import from Pivotal Tracker to Roadmunk
- Import from Rally to Roadmunk
- Import from Trello to Roadmunk
- Import from VersionOne to Roadmunk
Import from Asana to Roadmunk
Export from Asana to CSV
In Asana, users have the option to export a CSV of their data by project or by tasks assigned to a user.
By Project
By Personal Tasks
CSV Changes for Roadmunk
When opening the CSV it will contain the data from your Asana project. Please note you will have to format it differently in order to make it compatible with Roadmunk.
Mandatory Changes
The following changes must be made to the CSV file:
- That the first column is called "Item". Must contain the title of the feature or project task.
- That there are separate columns for both start and end date.
- There there are columns called "bucket" and description. Neither need to be filled out.
For more information on formatting including examples, please download a free template from our templates page.
Import to Roadmunk
Once changes have been made the CSV can be imported to Roadmunk.
See the importing tutorial for further steps.
Import from Excel to Roadmunk
In this guide, we'll walk through the 5 easy steps to follow when preparing an Excel roadmap for import into Roadmunk. Here's a snapshot of what a typical roadmap spreadsheet in Excel looks like.
Step 1 - Identifying Data Pivots
The first step in the transition is identifying the data pivots in the Excel roadmap:
- The tasks being tracked
- The owner of the task
- The months that the task is being completed in
- The colour of the task to indicate status
Step 2 - Formatting the Data
The next step is to format the data in the spreadsheet by putting the pivot data identified in the previous step into separate columns for import into Roadmunk columns.
Here's a snapshot of what the data might look like before the formatting changes.
And here's a snapshot of what the data should like after the formatting.
The roadmap spreadsheet should now have:
- an Owner column identifying owner of each item (e.g., Jerry, Elaine)
- a Status column identifying the status of each item (e.g., In progress, Completed).
Step 3 - Adding Real Dates
The next step before the import is adding real start and end dates for each date range represented in the spreadsheet using colored cells. The added dates should be formatted as Numbers, and the format should be consistent across all items.
Here's a snapshot of what the spreadsheet might look like before adding the dates.
And here's a snapshot of what it should look like after adding the dates.
The roadmap spreadsheet should now have:
- A Start Date and an End Date column containing the start and end dates of each date range represented in the spreadsheet using colored cells
- Dates in the columns formatted as Numbers using a consistent format (e.g, 01-Dec-16)
NOTE: For the import to Roadmunk to be successful, each item in the Excel roadmap must have a Start and End Date. Even if you don't know what an item's dates are, add a best-guess date. You can always change this once the date is in Roadmunk.
Step 4 - Removing Extra Cells
Remove the Month Header Row
Now that you've added real dates, you can remove the month header row at the top of the spreadsheet. When you're done, the spreadsheet should look like this:
Remove Owner Names
You should also remove the owner names that are above the listed items, delete any empty rows, and add Item as the row header (in the same row as Owner, Status, Start Date, and End Date). When you're done, the spreadsheet should look like this:
The roadmap spreadsheet should now have:
- an Item column for the items in the roadmap
- Owner and Status columns with appropriate values
- Start Date and End Date columns, containing the start and end dates of each item, formatted as Numbers, and using a consistent format.
- No blank rows or cells
Step 5 - Importing to Roadmunk
Finally, save the Excel file as a CSV and import it into Roadmunk following the instructions in Import items from CSV.
Import from Pivotal Tracker to Roadmunk
Exporting from Pivotal Tracker to CSV
The first step in the import is exporting data in a Pivotal Tracker roadmap to a CSV. Here's a snapshot of what a Pivotal Tracker roadmap might look like.
1. Go to the Settings tab and select Export CSV.
2. Select the stories and epics you want to export, then click the Export button.
3. Save the CSV file and open it in a spreadsheet application (for example, Excel).
For more details, go to Pivotal Tracker's exporting walkthrough.
Making Changes to the CSV
Here's a snapshot of what the exported CSV might look like.
There are some mandatory changes you must make to the CSV before the import, as well as some optional and advanced changes.
Mandatory Changes
The following changes must be made to the CSV file:
- Title -> Item
- Iteration Start -> Start Date
- Iteration End -> End Date
Optional Changes
The following changes can also be made but are not mandatory:
- Delete Created at
- Delete Accepted at
- Delete Deadline
- Delete URL
- Delete Owned By
- Delete Comment
Advanced Changes
If Roadmunk will be regularly updated from Pivotal Tracker, we recommend renaming the ID field in the CSV to ExternalID. Roadmunk uses this field to match existing items so they're updated instead of overwritten.
Importing the CSV into Roadmunk
Once changes have been made the CSV, you can start the import to Roadmunk. For details, see our article on importing data from CSV into Roadmunk.
Import from Rally to Roadmunk
Exporting from Rally to CSV
The first step in the Rally import is exporting data in a Rally view, such as the User Stories Summary, to a CSV. Here's a snapshot of what the view might look like.
1. In the Actions menu select Export to CSV.
2. Save the CSV file and open it in a spreadsheet application (for example, Excel).
For more details, go to Rally's exporting walkthrough.
Making Changes to the CSV
Here's a snapshot of what the exported CSV might look like.
There are some mandatory changes you must make to the CSV before the import, as well as some optional and advanced changes.
Mandatory Changes
The following changes must be made to the CSV file:
- Name -> Item
Optional Changes
The following changes can also be made if desired but are not mandatory:
- Delete Plan Estimate
- Delete Task Estimate Total
- Delete To Do
- Delete Parent ID
Advanced Changes
If Roadmunk will be regularly updated from Rally, we recommend renaming the ID field in the CSV to ExternalID. Roadmunk uses this field to match existing items so they're updated instead of overwritten.
Importing the CSV into Roadmunk
Once changes have been made the CSV, you can start the import to Roadmunk. For details, see our article on importing data from CSV into Roadmunk.
Import from Trello to Roadmunk
The first step in the import is exporting data in a Trello board to a CSV file. Here's a snapshot of what a Trello board might look like.
1. On the Trello menu, click Print and Export, then click Export CSV.
2. Save the CSV file and open it in a spreadsheet application (for example, Excel).
For more details, go to Trello's exporting walkthrough.
Making Changes to the CSV
Here's a snapshot of what the CSV file might look like.
There are some mandatory changes you must make to the CSV before the import, as well as some optional and advanced changes.
Mandatory Changes
The following changes must be made to the CSV file:
- Card Name -> Item
- Card Description -> Description
- Due Date -> End Date
Optional Changes
The following changes can also be made if desired but are not mandatory:
- Delete CardID
- Delete ListID
- Delete Board ID
- Delete Last Activity Date
Advanced Changes
If Roadmunk will be regularly updated from Trello, we recommend renaming the CardID field in the CSV to ExternalID. Roadmunk uses this field to match existing items so they're updated instead of overwritten.
Importing the CSV into Roadmunk
Once changes have been made the CSV, you can start the import to Roadmunk. For details, see our article on importing data from CSV into Roadmunk.
Import from VersionOne to Roadmunk
Exporting from Version One to CSV
The first step in the import is exporting the data in the project to a CSV file.
1. In the project's Reports menu, click Project Burndown.
Here's a snapshot of what the Project Burndown report might look like.
2. Open the menu in the upper-right corner of the report and click Download CSV.
Making changes to the CSV file
The following changes must be made to the CSV file:
- The first column in the CSV (Item) must contain the title of the feature or project task.
- The file must contain separate columns for Start Date and End Date.
- The file must contain a Bucket field and a Description field. Both fields can be left blank.
Importing the CSV into Roadmunk
Once changes have been made the CSV, you can start the import to Roadmunk. For details, see our article on importing data from CSV into Roadmunk.