CSV Import

It is possible to import information about Enterprise Architect elements in CSV format. Once you have defined a CSV import specification you can read in major element characteristics from a CSV text file.


  • In the Corporate, Business and Software Engineering, System Engineering and Ultimate editions of Enterprise Architect, if security is enabled you must have both Export XMI and Import XMI permissions to use the CSV Import/Export option.
  • You import the CSV file into a selected package; if this package or any element within the package has a lock on it, you cannot import the CSV file into it. The Import option on the dialog is grayed out.

When importing, Enterprise Architect checks the specification to see if there is a GUID field included. If there is, Enterprise Architect attempts to locate the element identified by the GUID and, if successful, updates the current element rather than creating a new one. If no GUID field is defined, or Enterprise Architect cannot locate the identified element, a new element is created and placed in the current package. Note that during import, Type is a mandatory field in the source file and must match one or more of the legal Enterprise Architect element types. For example: requirement, or class.

The format and content of the source data file should resemble the following:


Import Data in CSV Format

To import data in CSV format, follow the steps below:

  1. In the Project Browser, right-click on the package to import into.
  2. Select the Import/Export | CSV Import/Export context menu option. The CSV Import/Export dialog displays.
  1. Set the required options; as outlined below:


Use to


Confirm the name of the current selected package.


Specify the name of the import specification to use.


Edit the import specification or create a new one.


Specify the spreadsheet filename to import from.


Not used for import.


Select the Import radio button to import from the file. (Grayed-out if the package or a child item in the package is locked.)

Print Results

Print out the result list.

View File

View the source CSV file with the default Windows application for CSV files.


Perform the import.


Exit this dialog.