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 attributes from a CSV text file.

Notes:
  • 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 an EAGUID field included. If there is, Enterprise Architect attempts to locate the element identified by the EAGUID and, if successful, updates the current element rather than creating a new one. If no EAGUID 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:

CSVReqs

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.
     
    CSVImpDiag
     
  1. Set the required options; as outlined below:

Option

Use to

Package

Confirm the name of the current selected package.

Specification

Specify the name of the import specification to use.

Edit/New

Edit the import specification or create a new one.

File

Specify the spreadsheet filename to import from.

Types

Not used for import.

Action

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.

Run

Perform the import.

Close

Exit this dialog.