PPM Express Help Center

What do you need help with?

How to export/import roadmap items to/from .csv file

In this article, we will review how to export/import roadmap items to/from the .csv file. 

This functionality may be helpful when there is a need to bulk edit the item fields. The items can be exported to the .csv file, edited quickly using Excel tools, and then imported back to PPM Express. The same functionality may be used to bulk-create items. Another use case is when there is a need to copy the items from one roadmap to another. 

For this purpose, we will be using export and import options that are available on the Roadmap dashboard.

Please note: The export/import option is only available in the table view. 

Please note: Users should have permission to edit the Roadmaps to export/import the information to/from the .csv file format. Users who have permission to view the Roadmap will be able to use the export option only. 

To export the items from the roadmap to the .csv file perform the following:

1. Open the Roadmap dashboard.

2. Select the items you would like to export to the .csv file for editing.

Please note: Only the selected items will be exported to the .csv file and only those fields displayed in the current view will appear in the .csv file and will be available for editing.  If you need to include more fields in the .csv file, it is required to add these fields to the roadmap view. 

3. As the required items are selected, click the File => Export option to export the items to the .csv file.

4. Open the .csv file and edit the information there as required. 

Please note: If editing the values (especially dates, and statuses) in the .csv file, it is required to preserve the format used in the columns, as a different format is not supported. For example, if the value is provided as 'At Risk' and will be changed to 'AT RISK' or 'at risk', the changes will not be applied. 

Please note: The start/finish dates can be changed only for the items from the Backlog section. For items from the Planned section, these fields are read-only. 

Also, If the calculated fields are edited in the .csv file, these changes will be skipped during import and the fields will be recalculated automatically. 

Please note: The items are found by UIDs and updated accordingly. If the UID is deleted from the .csv file or updated there, new items will be created in PPM Express when importing data from this .csv file. If new items are created in the .csv file, the UID field should be left empty, it will be added automatically on importing new items to PPM Express. All new items are added to the Backlog section, a default lane will be applied. If no dates are set for the new item, the current date will be set automatically as start and finish. 

If any invalid data is provided in the .csv file, it will be ignored when importing to PPM Express. 

5. Open the Roadmap dashboard of the roadmap where you would like to import these items to. 

6. Select the Import option from the options panel. 

7. Select the required file from your PC and click Open. 

8. The items will be imported to the roadmap at once, and the item fields will be updated accordingly. 

The same .csv file can be re-used to copy the items to other roadmaps within PPM Express. 

Please note: If the items are imported to another roadmap, they will be created with new UIDs, the items are not shared between the roadmap. 

Was this article helpful?

Table of contents

    Back To Top