Import/Export Maps

Maps can be imported and exported to and from CSV files. This is useful when working on a large project where multiple Maps require edits at once, especially when naming conventions need to change. Exporting the Maps to a CSV file allows changes to be made easily. Additionally, it is also possible to create all the Maps needed first in the CSV file and then import it into the program to save time when creating many Maps for a project.

Export Maps to a CSV File

To use Export Maps:

  1. In Project Explorer right-click on Maps and click on Export Maps
  2. This will generate a CSV file with the following headers:
    • MapId
    • Map Title
    • Navigation Title
    • Width
    • Height
    • Background Color
    • Background Resource ID
    • Background Image Display
    • Background Image Horizontal Alignment
    • Background Image Vertical Alignment
      Note: Each Map file in the project is added as a line item in the resulting CSV file.
  3. After exporting, the Map CSV file will open automatically on the computer.
  4. To create a new Map in the CSV file, enter the information needed, but leave the MapId blank. This will create a new Map with that configuration.
    Note: Import/Export does not include assets, location surfaces, shapes, or display items. It only includes the Map Properties.
  5. It is also possible to modify the Maps by changing the information in the CSV file.
    Note: Maps cannot be deleted using Import/Export.

Import Maps From a CSV File

To use Import Maps:

  1. In Project Explorer right-click on Maps and click on Import Maps
  2. Find the desired CSV file on the device that follows the same format as the one shown in Step 2.
    Warning: If the MapId field is filled in, this action will edit an existing Map's properties. If the MapId field is left blank, it will create a new Map with the provided properties.
    Note: The following objects will not be created or modified by the Map Import:
    • Asset Icons
    • Drawing Objects (text, rectangles, etc)
    • Buttons and other display layout objects

The imported Maps now will show up in the Project Explorer under Maps.