user guide series - enterprise architect · 2020. 9. 9. · user guide - model exchange7 september,...
TRANSCRIPT
Model ExchangeHow to transfer data between projects? In Sparx
Systems Enterprise Architect you can movedata between projects using Data Transfer of
models to file or repository, Import and ExportPackages in XMI format, and Import and
Export elements in CSV format.
Enterprise Architect
User Guide Series
Author: Sparx SystemsDate: 2021-04-29
Version: 15.2
CREATED WITH
Table of Contents
Model Exchange 5Publish Model Package 6Native XML File 12XMI Import and Export 20Export to XML 23Import from XML 27Merge Package with XMI Using Merge File 33Merge Package Directly with XMI 36Import EMX/UML2 Files 39Import a Rhapsody Model 42Import a MagicDraw MDZIP File 45Limitations of XMI 48The UML DTD 50
Copy Packages Between Projects 51Generate Model Document XML 54CSV Import and Export 57CSV Specifications 59Using Preserve Hierarchy 65
CSV Export 67CSV Import 71
Controlled Packages 75Controlled Package Menu 77Configure Packages 80
Remove Package from Control 85Save a Package 87Load a Package 89Batch XMI Export 91Batch XMI Import 94Manual Version Control with XMI 97Report Deletion of Cross Package References 100
Project Data Transfer 105Project Transfer using Native XML 108
Model Exchange 29 April, 2021
Model Exchange
Using Enterprise Architect, you can transfer data betweenprojects using one of these different mechanisms:
XMI Import and Export - Packages can be exported from·
and imported into your models; this greatly improves theflexibility and robustness of the models because Analystsand Modelers can externalize model elements in XMI forVersion Control, distributed development, post processingand transferring Packages between models
CSV Import and Export - You can import and export·
information on Enterprise Architect elements in CSVformat, and then store and retrieve the information fromspreadsheet tools such as Microsoft Excel
Generate an XML file from a Model Document element·
to enable separate Packages to be imported into anothermodel together rather than individually
Data Transfer - You can move complete models between·
files, and between files and repositories, row by row, tableby table
Data Miner - You can abstract data from a range of·
external data sources including databases (ODBC, ADO,OLEDB, JET), text files (XML, JSON, plain text), Excel(xls, CSV), and online files or URLs, creating areproducible import process defined in a model format
(c) Sparx Systems 2021 Page 5 of 114
Model Exchange 29 April, 2021
Publish Model Package
The Publish Model Package facility is used to export aPackage to a file in one of several XML formats, includingXMI 1.1, XMI 2.1, Enterprise Architect's Native XML,Ecore, ArcGIS and BPMN 2.0 XML; for example, youmight:
Export BPMN 2.0 models to BPMN 2.0 XML/XPDL2.2,·
or
Export Enterprise Architect model elements to Rational·
Rose and other tools that implement the: - UML 1.3 XMI 1.1 / XMI 1.0 standard - UML1.4 XMI 1.2 standard, or - UML 2.x XMI 2.x standard
Access
Select a Package in the Browser window, then:
Ribbon Publish > Model Exchange > PublishAs...
KeyboardShortcuts
Ctrl+Alt+E : Publish
(c) Sparx Systems 2021 Page 6 of 114
Model Exchange 29 April, 2021
Publish Model Package options
Option Action
Package Displays the name of thecurrently-selected Package.If this is not the required Package, clickon the button and select the correctPackage.
Filename Type in or browse for ( ) the file pathinto which the XML file is to begenerated.
XML Type Click on the XML/XMI version to whichto export the Package.
Select 'UML 2.1' to use XMI 2.1 in·
round-tripping a modelSelect 'UML 2.0, 2.1.1, 2.1.2, 2.2, 2.3,·
2.4.1', '2.5' or '2.5.1' if exporting to atool that requires that specific versionof the XMISelect 'Native" to export to Enterprise·
Architect's Native XML formatSelect 'Ecore' to export into a .ecore·
xmi fileSelect 'BPMN2.0 XML' to export into a·
(c) Sparx Systems 2021 Page 7 of 114
Model Exchange 29 April, 2021
BPMN2.0 xmi fileSelect 'XPDL 2.2' to export into an·
XPDL 2.2 xmi fileSelect 'ArcGIS' to export into an·
ArcGIS xmi fileThe selected version might render someof the next eight options unavailable.
ExportDiagrams
Select this checkbox to export all thediagrams in the selected Package.
ExportAlternateImages
Select this checkbox to export thealternative images used in the diagrams inthe selected Package.
Format XMLOutput
Select this checkbox to format the outputinto readable XML (this takes a few moreseconds at the end of the run).
Write LogFile
Select this checkbox to write a log of theexport activity (recommended).The log file is saved to the directory intowhich the XML file is exported.
Use DTD Select this checkbox to use the XMI DTDwhen exporting to XMI 1.0 or XMI 1.1.Setting this option validates thecorrectness of the model and checks that
(c) Sparx Systems 2021 Page 8 of 114
Model Exchange 29 April, 2021
no syntactical errors have occurred.
Exclude EAExtensions
Select this checkbox to excludetool-specific information from the export.
Unisys/RoseFormat
Select this checkbox to export inUnisys/Rose compatible XMI format.
GenerateDiagramImages
Select this checkbox to generate theexported diagrams in the format youselect from the 'Format' drop-down list.The generated diagrams are saved in aPackage called Images in the directoryinto which the XML file is exported.
Stylesheet (Optional) Click on the drop-down arrowand select an XSL Stylesheet topost-process the XML content beforesaving to file.You can post-process the XML contentbefore saving the Package to file, usingan XSLT to convert the output to HTML,XSL, code or other versions of XML; todo this, you must import the requiredstyle sheet into the project through the'Resources' tab of the Browser window.
View XML Click on this button to view the exportedXML file.
(c) Sparx Systems 2021 Page 9 of 114
Model Exchange 29 April, 2021
Export Click on this button to initiate the XMLexport.
Close Click on this button to abort theinstructions and close this dialog.
Help Click on this button to display this Helptopic.
Progress Monitor the progress of the XML export.
Notes
When exporting and importing with XMI 1.0 with·
Enterprise Architect, some loss of data occurs due to thelimitations of XMI 1.0
Exporting to BPMN 2.0 XML and XPDL 2.2 is supported·
in Professional, Corporate, Unified and Ultimate Editionsof Enterprise Architect
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must have'Export XML' permission to export to XML
When you select to apply a Data Type Definition (DTD)·
during an XMI 1.1 export, the UML_EA.DTD file iswritten to the output directory into which the XML files
(c) Sparx Systems 2021 Page 10 of 114
Model Exchange 29 April, 2021
are written (unless the UML_EA.DTD file is alreadypresent in the directory); no error is generated if theUML_EA.DTD file is not present in this directory duringthe XMI export
(c) Sparx Systems 2021 Page 11 of 114
Model Exchange 29 April, 2021
Native XML File
Native XML is an Enterprise Architect-specific format formodel exchange between various Enterprise Architectrepositories. Native XML is, therefore, a mechanism forround-tripping models (that is, performing EnterpriseArchitect-to-Enterprise Architect transfers). Compared toXMI 1.1/2.1, this format has a structure that closely mimicsthe Enterprise Architect repository, so exporting to NativeXML format is considerably faster compared to exporting toXMI 1.1/2.1.
By default, when importing an XMI 1.1/2.1 file over anexisting Package, all information in the current Package isdeleted from the model before the data is imported from theXMI file. With a Native XML file import, the existingPackage will not be deleted from the model, but will insteadbe updated with data from the XML file. Therefore,importing a Native XML file will also be considerably fasterthan importing from XMI 1.1/2.1.
When exporting a Package to Native XML, the Packagebeing exported will become the root Package in the XMLfile. The children of the Package being exported (that is, itselements, diagrams, connectors and so on) will be exportedunder the root Package in the XML file. When importingthis file into a model, the Native XML Importer will checkif:
The root Package in XML exists in the model·
Any of the children of the root Package in XML exist in·
(c) Sparx Systems 2021 Page 12 of 114
Model Exchange 29 April, 2021
the model
If the target model does not contain the root Package inXML or its children, then the contents of the XML file willbe created as new items in the model.
If the target model contains the root Package in XML and itschildren, then the existing items in the model will beupdated with the contents of the XML file.
Importing a Native XML file to a model thatcontains some of the imported items
Your model might contain at least one Package that is alsoused in other models, but not necessarily in the samecontext. For example, consider the two projects shown here:
Package 'Order' exists in two separate projects, 'Project X'and 'Project Y'. In 'Project X' the 'Order' Package isavailable as a child of Package 'Abstract Class Model',whereas in 'Project Y' it is a View Package.
When you export the Package 'Abstract Class Model' from'Project X' to Native XML, the XML file will contain:
(c) Sparx Systems 2021 Page 13 of 114
Model Exchange 29 April, 2021
'Abstract Class Model' as its root Package and·
All information on 'Abstract Class Model' and its children·
(including Package 'Order')
When this XML file is imported into 'Project Y', the NativeXML Importer will determine that:
The root Package in XML, 'Abstract Class Model', does·
not exist in the model
The child Package 'Order' does exist in the model·
In such a scenario, where the root Package in XML does notexist in the model but its children do, the 'Existing ImportItem(s)' dialog will be displayed, which will list the items inXML that already exist in the model:
Actions
Action Detail
(c) Sparx Systems 2021 Page 14 of 114
Model Exchange 29 April, 2021
Double-clickon an item inthe list
Selects the item in the Browser window.
ReplaceItem(s) inModel withXMLcontents
Select this radio button to:Delete these items from the model and·
Import them from the XML file·
In our example, after import 'ProjectY'will have this content:
RetainItem(s) inModel andimport entireXML withStrip GUIDs
Select this option to:Retain (that is, not modify) these·
existing Item(s) in the modelImport the entire XML with GUIDs·
stripped from themIn our example, after import, 'ProjectY'will have this content:
(c) Sparx Systems 2021 Page 15 of 114
Model Exchange 29 April, 2021
As you can see, two copies of Package'Order' will exist in 'ProjectY' afterimport. The View Package 'Order' thatexisted in the model before import willremain unchanged. The Package 'Order'from the XML file will be imported as anew Package under the imported'Abstract Class Model' Package.
Cancel Cancel the XML Import.
Importing Native XML files into Models thatcontain the root XML Package and children,in a different location
Consider the combination of Projects and Packages shownhere:
(c) Sparx Systems 2021 Page 16 of 114
Model Exchange 29 April, 2021
Packages 'Abstract Class Model' and 'Order' exist in twoseparate projects, 'Project X' and 'Project Y'. In 'Project X','Order' exists as a child of Package 'Abstract Class Model',whereas in 'Project Y' they are both peer Packages.
When Package 'Abstract Class Model' is exported from'Project X' to Native XML, the XML file will contain:
'Abstract Class Model' as its root Package·
All information about 'Abstract Class Model' and its·
children (including Package 'Order')
When this XML file is imported into 'Project Y', the NativeXML Importer determines that:
The root Package in XML. 'Abstract Class Model', exists·
in the model
The child Package 'Order' exists in the model·
The root Package and its children are in different·
locations in the model
In such a scenario, where the root Package in XML and itschildren exist in the model (albeit in different locations), theImporter will replicate the XML Package structure; that is, itwill automatically move Package 'Order' under Package'Abstract Class Model' in the model. The 'Existing ImportItem(s)' dialog will not be displayed. After import,
(c) Sparx Systems 2021 Page 17 of 114
Model Exchange 29 April, 2021
'ProjectY' will have the contents shown:
Notes
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you need tohave: - 'Export XMI' permission to export Packages toNative XML - 'Import XMI' permission to import Packages fromNative XML
Native XML files exported by Enterprise Architect·
version 15.0 or later cannot be imported by versions ofEnterprise Architect earlier than 15.0
Native XML files exported using the 'Export Package to·
XML' dialog will not be formatted (that is,'pretty-printed'), even if the 'Format XMI Output' option isenabled in the 'XML Specifications' option-group of the'Preferences' dialog
If you are connected to a SQL Server repository, you·
require ALTER permission on the t_image table in
(c) Sparx Systems 2021 Page 18 of 114
Model Exchange 29 April, 2021
Enterprise Architect, to be able to import model images
(c) Sparx Systems 2021 Page 19 of 114
Model Exchange 29 April, 2021
XMI Import and Export
XML Metadata Interchange (XMI), defined by the OMGand based on XML, is an open standard file format thatenables the interchange of model information betweenmodels and tools.
XMI and Enterprise Architect
Enterprise Architect uses XMI as a method of importing andexporting model specifications between different UMLPackages, Enterprise Architect projects and other tools thatsupport XMI. The system supports the XMI 1.1, 1.2, 2.1,2.4, 2.4.2 and 2.5.1 specifications. XMI 1.1 provides supportfor UML 1.3, whereas XMI 2.x is used for UML 2.0 - 2.5.1.
Enterprise Architect does not fully support the older 1.0specification. When importing or exporting to XMI 1.0,some loss of data occurs due to the limitations of XMI 1.0.
With XMI, model details can be exchanged betweendifferent UML tools and other tools that are capable of usingXMI. Limited support for export to Rational Rose isprovided using the Rose version of the XMI 1.1specification, as implemented by Unisys for Rationalproducts.
Packages can be exported from and imported into EnterpriseArchitect models, which greatly improves the flexibility androbustness of the models, helping Analysts and Modelers to
(c) Sparx Systems 2021 Page 20 of 114
Model Exchange 29 April, 2021
externalize model elements in XMI for:
Version Control·
Distributed development·
Post processing and·
Transferring Packages between models·
When importing an XML file over an existing Package, bydefault all information in the current Package is deletedbefore the data is imported from the XML file. Please makesure you do not have important changes that you do notwant to lose before importing from XML. Alternatively, usea merge file to merge the information in the XMI file withthe contents of the Package.
XMI Tasks
Tasks you might perform in importing and exporting XMIinclude:
Setting XML Options - XMI import, export and Package·
control all rely on saving and loading XML files; you canset a number of options to streamline this process
Exporting a Package to XMI in XMI 2.1 (and earlier)·
Importing from XMI with support for XMI 2.1 (and·
earlier)
Setting up controlled Packages·
Manually controlling a Package by linking it to an XMI·
file
(c) Sparx Systems 2021 Page 21 of 114
Model Exchange 29 April, 2021
Batch exporting controlled Packages·
Batch importing controlled Packages·
Factoring in the limitations of XMI·
Applying a UML Data Type Definition (DTD)·
Importing a model from IBM Rational Rhapsody·
Importing a model from a MagicDraw MDZIP file·
Notes
XMI 2.1 exported by Enterprise Architect 7.0 (or later)·
might not be correctly imported into earlier versions ofEnterprise Architect
When performing Enterprise Architect-to-Enterprise·
Architect transfers, ensure that XMI version 1.1, XMIversion 2.1 or Enterprise Architect's Native XML isselected
(c) Sparx Systems 2021 Page 22 of 114
Model Exchange 29 April, 2021
Export to XML
You use the 'Export Package to XML' dialog to export aPackage from your model to a file in one of several XMI(XML-based) formats. The dialog, by default, allowsexporting to either XMI 1.1, XMI 2.1, or EnterpriseArchitect's Native XML format. The exported XML filecontains all the information required for completelyround-tripping the Package within Enterprise Architect; thatis, performing Enterprise Architect-to-Enterprise Architecttransfers.
Access
Select a Package in the Browser window, then:
Ribbon Publish > Model Exchange > ExportXML > Export XML for Current Package
KeyboardShortcuts
Ctrl+Alt+E
Export a Package to an XML file
(c) Sparx Systems 2021 Page 23 of 114
Model Exchange 29 April, 2021
Option Action
Package Displays the name of thecurrently-selected Package.If this is not the required Package, clickon the button and select the correctPackage.
Filename Type in the file path of the XMI file to begenerated, or click on the button andbrowse for the location.
Export Type 'XMI 1.1' - Select this option to export·
the selected Package to XMI 1.1'XMI 2.1' - Select this option to export·
the selected Package to XMI 2.1'Native' - Select this option to export·
the selected Package to EnterpriseArchitect's Native XML format'Publish' - Click on this button to open·
the 'Publish Model Package' dialog forexporting to other versions of XML
GenerateMerge fileusingBaselineVersion
This option is enabled when:'Export Type' is set to 'XMI 1.1' and·
The selected Package has a baseline·
Click on the button to open the'Baselines' dialog and select the baseline.
(c) Sparx Systems 2021 Page 24 of 114
Model Exchange 29 April, 2021
Once the export is complete, the mergefile will be generated by comparing theselected Package with the selectedbaseline. The merge file will be generatedin the same location as the XMI file, withthe same name as the XMI file but withthe suffix _Merge.xml.This file is used to merge the contents ofa Package with that of the XMI file, usingthe 'Merge Package with XMI' dialog.
View XML Click on this button to view the exportedXML file.
Export Click on this button to initiate the XMLexport.
Close Click on this button to close this dialog.
Help Click on this button to display this Helptopic.
Progress Monitor the progress of the XML Export.
Notes
(c) Sparx Systems 2021 Page 25 of 114
Model Exchange 29 April, 2021
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must have'Export XML' permission to export to XML
Alternative Images used in the Package being exported·
are not included in the exported XMI file, unless the'Export Alternate Images' option is selected in the 'XMLSpecifications' section of the 'Preferences' dialog
The Log file for the Package being exported is not·
generated unless the 'Write Log' option is selected in the'XML Specifications' section of the 'Preferences' dialog
XMI 2.1 exported by Enterprise Architect 7.0 (or later)·
might not be correctly imported into earlier versions ofEnterprise Architect
(c) Sparx Systems 2021 Page 26 of 114
Model Exchange 29 April, 2021
Import from XML
You can copy Enterprise Architect model elements betweenmodels, for distributed development, manual VersionControl and other benefits. You do so by importing theparent Package from an XMI (XML-based) file in any ofthese formats:
UML 1.3 (XMI 1.0)·
UML 1.3 (XMI 1.1)·
UML 1.4 (XMI 1.2)·
UML 2.x (XMI 2.1)·
MOF 1.3 (XMI 1.1)·
MOF 1.4 (XMI 1.2)·
Enterprise Architect's Native XML·
You can also import the *.emx and *.uml2 files generatedby tools such as Rational Software Architect (RSA) andRational Software Modeler (RSM), as well as CanonicalXMI 2.1 files, BPMN 2.0 XML files, Rhapsody andMagicDraw models, and XML files exported by ArcGIS.
Access
Select your target Package in the Browser window, then:
Ribbon Publish > Model Exchange > ImportXML > Import Package from XML
(c) Sparx Systems 2021 Page 27 of 114
Model Exchange 29 April, 2021
KeyboardShortcuts
Ctrl+Alt+I
Import a Package from an XML file
Option Action
Filename Type the directory path and filenamefrom which to import the XML file.
Importdiagrams
Select the checkbox to import diagrams.
Strip GUIDs Select the checkbox to remove UniversalIdentifier information from the file onimport.By removing the GUID, you can import aPackage twice into the same model; thesecond import requires the checkbox tobe selected, to apply new GUIDs to avoidelement collisions.
Write log file Select the checkbox to write a log ofimport activity (recommended).The log file is saved in the directory from
(c) Sparx Systems 2021 Page 28 of 114
Model Exchange 29 April, 2021
which the file is being imported, with thesame name as that of the imported fileplus the suffix _ import.log.
Import usingsingletransaction
This option defaults to the setting of the'Import using single transaction'checkbox in the 'XML Specifications'page of the 'Preferences' dialog. If youprefer, you can change the option fromthe default setting.If the checkbox is selected, the XML fileis imported in one transaction. This is notrecommended for large imports.If the checkbox is not selected the dataitems are imported separately; you canidentify problem items without the wholeimport being blocked. If the import islikely to encounter locking issues, or ifyou are importing a large XML file,deselect the checkbox.
ImportDiscussionsby
This option defaults to the 'XMI/VCImport Policy for Discsussions' option inthe 'General' page of the 'Manage ProjectOptions' dialog.This option will be enabled when theoption 'Allow user to override ifprompted' is selected in the 'General' pageof the 'Manage Project Options' dialog.
(c) Sparx Systems 2021 Page 29 of 114
Model Exchange 29 April, 2021
If enabled, click on the drop-down arrowand select an option that determines howto import Discussions from XMI :
Merging from XML - select this option·
to retain the existing Discussions inModel and merge those in XMIRestoring from XML - select this·
option to delete the existingDiscussions in Model and import thosein XMI
Merge XMI Click on this button to display twooptions for merging the content of theXMI file with the content of the selectedPackage.
'Use Merge File' - Merge the contents·
of the XMI file with the contents of thePackage using a Merge File'Direct Merge' - Merge the contents of·
the XMI file directly with the contentsof the Package, without a Merge File
TreatImportedDatatypes
If you are importing from Rose XMI 1.1,click on the drop-down arrow and selectthe datatypes to add to the model.
BaselinePackage afterImport
Select this checkbox to open the 'CreateBaseline' dialog, through which tobaseline the imported Package once the
(c) Sparx Systems 2021 Page 30 of 114
Model Exchange 29 April, 2021
import is complete.Selecting this option also generates amerge file when exporting a Package toXMI 1.1 using the 'Export Package toXML' dialog.
Import Click on this button to start the import.
Close Click on this button to close the dialog.
Help Click on this button to display this Helppage.
ImportProgress
Indicates the progress of the import.
Notes
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must have'Import XML' permission to import Packages from XML
If you are connected to a SQL Server repository, you·
require ALTER permission on the t_image table inEnterprise Architect, to be able to import model images
When you import an XML file over an existing Package,·
ALL information in the current Package is deleted first,
(c) Sparx Systems 2021 Page 31 of 114
Model Exchange 29 April, 2021
unless you use the Use Merge File button; before youimport the XML file, please make sure you do not haveimportant changes that you do not want to lose
If you are importing an XMI 1.1 file that was previously·
exported with a UML_EA.DTD file, the UML_EA.DTDfile must be present in the directory into which the XMIfile is being written; an error occurs if the UML_EA.DTDfile is absent
(c) Sparx Systems 2021 Page 32 of 114
Model Exchange 29 April, 2021
Merge Package with XMI Using MergeFile
If you are working in a distributed environment, eachmodeler could be working on a separate file copied (as anXMI export/import) from the master model. At intervals youwould want to bring each person's work back into the mastermodel. One way of doing this is to also export eachmodeler's copy as an XMI file, and import and merge eachfile in turn with the corresponding Package in the mastermodel.
The logical next step would be to again export the mastermodel as an XMI file so that each modeler could thenimport that into their copy to synchronize their model withthe latest version of the whole team's work. However, if anyof the team have continued to work on their copy, they canalso merge the 'master' XMI file with their copy so that theydo not overwrite their latest work.
Access
Select your target Package in the Browser window, then useone of the methods outlined here to open the 'MergePackage with XMI' dialog.
Ribbon Publish > Model Exchange > ImportXML > Merge Model XML into Current
(c) Sparx Systems 2021 Page 33 of 114
Model Exchange 29 April, 2021
Package
KeyboardShortcuts
Ctrl+Alt+I : Merge XMI > Use MergeFile
Merge Package options
Option Action
Package Displays the name of thecurrently-selected Package, the contentsof which will be merged with theimported XMI file.If this is not the required Package, clickon the button and select the correctPackage.
XMI File Type in the directory path and filenameof the XMI file, or click on the Browsebutton and locate the file.
Merge File Type in or browse to the directory pathand filename of the merge file, generatedusing the 'Export Package to XMI' dialog.The field defaults to show the merge file
(c) Sparx Systems 2021 Page 34 of 114
Model Exchange 29 April, 2021
in the same location as the XMI file.
BaselinePackagebefore Merge
Select the checkbox to show the 'CreateBaseline' dialog, to baseline the selectedPackage before merging the XMI file.You can use this baseline to roll back tothe content of the pre-merged Package, ifrequired.
ComparePackage withBaseline afterMerge
Select the checkbox to automaticallycompare the Package with the Baselineonce the merge is complete.This checkbox is enabled when the'Baseline Package before Merge' optionhas been selected.
Merge Click on this button to merge the Packageand its contents with the contents of theXMI file.
Close Click on this button to close the 'MergePackage with XMI' dialog.
Help Click on this button to display this Helppage.
(c) Sparx Systems 2021 Page 35 of 114
Model Exchange 29 April, 2021
Merge Package Directly with XMI
You have two options for importing a Package into a modelfrom XMI, where that Package already exists in the model:
Merging the Package directly, as documented here, where·
Enterprise Architect simply merges the differencesbetween the XMI file and the existing Package in themodel
Using a merge file, as documented in the Merge Package·
with XMI Using Merge File topic, where EnterpriseArchitect deletes the existing Package from the model andimports the new Package information from XMI
Access
Select your target Package in the Browser window, then useone of the methods outlined here to open the 'Import Modelfrom XML' dialog.
On the 'Import Model from XML' dialog, click on the MergeXMI button, then choose the option 'Direct Merge'.
Ribbon Publish > Model Exchange > ImportXML > Import Package from XML :Merge XMI > Direct Merge
KeyboardShortcuts
Ctrl+Alt+I : Merge XMI > Direct Merge
(c) Sparx Systems 2021 Page 36 of 114
Model Exchange 29 April, 2021
Merge Package Options
Option Action
Package Displays the name of thecurrently-selected Package, the contentsof which will be merged with theimported XMI file.If this is not the required Package, clickon the button and select the correctPackage.
XMI File Type in the directory path and filenameof the XMI file, or click on the buttonand locate the file.
BaselinePackagebefore Merge
Select this checkbox to open the 'CreateBaseline' dialog, to create a baseline ofthe selected Package before merging theXMI file.You can use this baseline to roll back tothe content of the pre-merged Package, ifnecessary.
Compare Select this checkbox to automatically
(c) Sparx Systems 2021 Page 37 of 114
Model Exchange 29 April, 2021
Baseline withPackage afterMerge
compare the Package with the Baselineonce the merge is complete.The checkbox is enabled when the'Baseline Package before Merge'checkbox is selected.
Merge Click on this button to begin the merge ofthe Package content with the XMI filecontent.
Close Click on this button to close the 'MergePackage with XMI' dialog.
Help Click on this button to display this Helppage.
(c) Sparx Systems 2021 Page 38 of 114
Model Exchange 29 April, 2021
Import EMX/UML2 Files
In Rational Software Architect (RSA) you can add manyUML models under a single root. These models can havecross references between them. However, RSA cannot savethe entire root as one file - it saves each UML model as aseparate EMX file. This means that an EMX file withcross-references is not self-contained as it referenceselements in another EMX file.
In releases earlier than release 7.0, Enterprise Architecttreats each EMX file as a separate model and hence does notallow for cross-references between them. From release 7.0,Enterprise Architect enables these cross-references.
You therefore have the options of:
Importing a single EMX/UML2 file or·
Importing a group of related EMX/UML2 files together,·
thereby retaining the cross-references between thedifferent files
Access
Select your target Package in the Browser window, then useone of the methods outlined here to open the 'Import Modelfrom XML' dialog.
On the 'Import Model from XML' dialog, click on the OtherXML File Formats button, then choose the option'EMX/UML2'.
(c) Sparx Systems 2021 Page 39 of 114
Model Exchange 29 April, 2021
Ribbon Publish > Model Exchange > ImportXML > Import Package from XML :Other XML Formats > EMX/UML2
KeyboardShortcuts
Ctrl+Alt+I : Other XML File Formats >EMX/UML2
Import Files
Option Action
Package Displays the name of thecurrently-selected Package.If this is not the required Package, clickon the button and select the correctPackage.
Directory Click on the button.The 'Select Import EMX/UML2 File(s)'dialog displays, from which you canselect multiple files.Select the file or files (use Ctrl+click orShift+click to select several files) andclick on the Open button to return to the'Import Package from EMX/UML2'
(c) Sparx Systems 2021 Page 40 of 114
Model Exchange 29 April, 2021
dialog.
SelectedFiles
Lists the selected *.emx/*uml2 files.
Write LogFile
Select this checkbox to write a log of theimport activity (recommended).The log file is saved in the directory fromwhich the files are being imported, withthe name import.log.
Import Click on this button to import the*.emx/*uml2 files.
Close Click on this button to abort the importand close the dialog.
Help Click on this button to display this Helptopic.
ImportProgress
Monitor the progress of the import.
(c) Sparx Systems 2021 Page 41 of 114
Model Exchange 29 April, 2021
Import a Rhapsody Model
If you have developed a UML model in IBM RationalRhapsody, you can import it into an Enterprise Architectproject.
Each Rhapsody project contains one Project file (with thefile extension .rpy), which is associated with a folder withthe same name, ending in _rpy. For example, if theRhapsody project file is called CDPlayer.rpy, it is associatedwith a folder called CDPlayer_rpy.
The associated folder contains all the project-related files. Itcould also contain a file named filesTable.dat, which lists allthe files related to the Rhapsody project.
Access
Select your target Package in the Browser window, then useone of the methods outlined here to open the 'Import Modelfrom XML' dialog.
On the 'Import Model from XML' dialog, click on the OtherXML Formats button, then choose the option 'Rhapsody'.
Ribbon Publish > Model Exchange > ImportXML > Import Package from XML :Other XML Formats > Rhapsody
Keyboard Ctrl+Alt+I : Other XML File Formats >
(c) Sparx Systems 2021 Page 42 of 114
Model Exchange 29 April, 2021
Shortcuts Rhapsody
Import UML Model from Rhapsody ProjectFiles
Option Action
Package Displays the name of thecurrently-selected Package.If this is not the required Package, clickon the button and select the correctPackage.
RhapsodyProject
Click on the button.The 'Select Import Rhapsody Project'dialog displays.Select a Rhapsody Project file, then clickon the Open button to return to the'Import Model From Rhapsody' dialog.
RhapsodyFiles
Shows the name of the file located in theassociated project folder.
Import Click on this button to import theRhapsody model into Enterprise
(c) Sparx Systems 2021 Page 43 of 114
Model Exchange 29 April, 2021
Architect.
Close Click on this button to abort the importand close the dialog.
Help Click on this button to display this Helptopic.
ImportProgress
Indicates the progress of the import.
(c) Sparx Systems 2021 Page 44 of 114
Model Exchange 29 April, 2021
Import a MagicDraw MDZIP File
Enterprise Architect supports importing UML models fromMDZIP files generated by MagicDraw 17.0.1 and above.
Access
Select your target Package in the Browser window, then useone of the methods outlined here to open the 'Import Modelfrom XML' dialog.
Ribbon Publish > Model Exchange > ImportXML > Import Package from XML :Other XML Formats > MDZIP File
KeyboardShortcuts
Ctrl+Alt+I : Other XML File Formats >MDZIP File
Import UML Model from MDZIP File(s)
Option Action
Package Displays the name of thecurrently-selected Package.
(c) Sparx Systems 2021 Page 45 of 114
Model Exchange 29 April, 2021
If this is not the required Package, clickon the button and select the correctPackage.
Filename Click on the button.The 'Select MDZIP File(s)' dialogdisplays, from which you can selectmultiple files.Select the required MagicDraw MDZIPfile or files (use Shift+click or Ctrl+clickto select several files), then click on theOpen button to return to the 'Import FromMDZIP File(s)' dialog.
SelectedFile(s)
Lists the *.MDZIP files you haveselected for import.
Write LogFile
Select this checkbox to write a log ofimport activity.The log file is saved in the directory fromwhich the files are being imported, withthe name import.log.
Import Click on this button to import the MDZIPfile(s) into Enterprise Architect.
Close Click on this button to close this dialog.
Click on this button to display this Help
(c) Sparx Systems 2021 Page 46 of 114
Model Exchange 29 April, 2021
Help page.
ImportProgress
Indicates the progress of the import.
Notes
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must have'Import XMI' permission to import Packages from XML
(c) Sparx Systems 2021 Page 47 of 114
Model Exchange 29 April, 2021
Limitations of XMI
Whilst XMI is a valuable means of defining a UML modelin a common format, it is relatively limited in the amount ofadditional information it can tolerate using the standardsyntax.
Notes on Enterprise Architect
A lot of information from an Enterprise Architect modelmust be converted to Tagged Values, which import intoother modeling systems as additional information or areignored completely. Enterprise Architect can both generateand read:
XMI 1.0 and 1.1 using UML 1.3 format·
XMI 1.2 using UML 1.4 format, and·
XMI 2.1 using UML 2.x format·
Round-tripping model elements using XMI in EnterpriseArchitect is possible using XMI 1.1 or XMI 2.1; XMI 1.1uses the additional Tagged Values to store the UML 2.xinformation - this ensures model completeness whenround-tripping UML 2.x model elements using XMI 1.1.
Enterprise Architect exclusively uses XMI 1.1 forround-tripping models using Version Control.
(c) Sparx Systems 2021 Page 48 of 114
Model Exchange 29 April, 2021
Notes for Exporting to Rose and Other Tools
There are discrepancies in the Unisys/Rose implementationwith regard to spelling mistakes and slightly different syntaxto the official XMI 1.1 specification, so problems mightoccur. The way Packages are arranged in different modelscan impact successful import into other systems;experimentation is the only work around for this problem.
Some parts of the XMI import/export process do not workas expected in products such as Rational Rose; for example,Note Links are not supported, and State Operations importbut do not appear in diagrams. Rational Rose only supportsimport of a full project, not a single Package.
For best results, it is recommended that you keep the modelelements to export to Rose simple and that they conform asclosely as possible to the UML 1.3 specification.
(c) Sparx Systems 2021 Page 49 of 114
Model Exchange 29 April, 2021
The UML DTD
When you import or export Packages from an EnterpriseArchitect model to XMI, the import or export process can bevalidated using a Data Type Definition (DTD). SeveralDTDs for XMI/UML exist; the OMG defines a standardUML1.3 DTD for use in XMI 1.1, and Enterprise Architectuses an extension of this with some additional elementextensions for non-standard UML types, such as testingdetails.
The XML parser uses the DTD to validate the correctness ofthe model and to check that no syntactical errors haveoccurred. It is always best to use a DTD when movingPackages between Enterprise Architect models, as it ensurescorrectness of the XMI output and prevents attemptedimports of incorrect XML.
Whenever you read an XML file, the XML parser looks inthe current directory for the DTD - if specified - using theDOCTYPE element in the XML file. If the parser cannotfind the DTD, it records an error and aborts processing; theUML_EA.DTD file must be in the current XML output path(generated by default).
(c) Sparx Systems 2021 Page 50 of 114
Model Exchange 29 April, 2021
Copy Packages Between Projects
It is possible to copy and move individual Packages betweenprojects by exporting and importing the Packages as XMLfiles. You can also duplicate larger structures, such ascomplete models or projects. This gives you a high level offlexibility in building a project from re-usable parts andfrom elements produced in widely-dispersed geographicregions.
Access
Ribbon Publish > Model Exchange > ExportXML > Export XML for Current PackagePublish > Model Exchange > ImportXML > Import Package from XML
KeyboardShortcuts
Ctrl+Alt+E (export to XML)Ctrl+Alt+I (import from XML)
Copy a Package from one EnterpriseArchitect project to another
(c) Sparx Systems 2021 Page 51 of 114
Model Exchange 29 April, 2021
Step
Action
1 Open the project to copy from.
2 In the Browser window, click on the Package tocopy and use your preferred Export access method toopen the 'Export Package to XML' dialog.
3 Select the appropriate options and filename.
4 Click on the Export button to begin the exportprocess.
5 When the export is complete, open the project tocopy into.
6 In the Browser window, navigate to the location toimport the Package into.
7 Click on the target Package and use your preferredImport access method to open the 'Import Packagefrom XML' dialog.
8 Select the appropriate options and filename.
9 Click on the Import button.The Package is copied from the source project to the
(c) Sparx Systems 2021 Page 52 of 114
Model Exchange 29 April, 2021
destination project.
Notes
If the Package you are importing already exists in the·
target project (that is, it has been imported previously),you must either import over the existing Package or selectthe 'Strip GUIDs' option; in the latter case, the systemcreates a copy of the original Package
(c) Sparx Systems 2021 Page 53 of 114
Model Exchange 29 April, 2021
Generate Model Document XML
You generally use a Model Document element to create adocument report containing information from separatePackages in your model. However, you can use the sameconcept, structure and processes to generate an EnterpriseArchitect Native XML file for export to another model. Thishelps you to select Packages from any part of the model andtransport them to another model without having to processthem individually or create special structures to combinethem. You could use this to, for example, define a modelsubset that can be included in a restricted-user WebEAview.
You create a Model Document element, add the individualPackages to it, and generate the XML from that element toan external file location. The XML will contain all thePackages (and their child structures) specified in the ModelDocument element. You can then use the normal ImportXML facilities to import the file into another model.
You can generate an XML file from a Model Documentelement set up to generate a document report from aPackage list; the XML generator ignores the Tagged Valuesof the element. You could generate a report to accompanythe file, to show its content.
Set up the Model Document
Work through these procedures:
(c) Sparx Systems 2021 Page 54 of 114
Model Exchange 29 April, 2021
Create a Model Document element on a diagram (as·
described in the Create Model Document Help topic); youdon't need to set any Tagged Values
Drag the required Packages into it (as described in the·
Add Packages to Model Document Help topic); you don'tuse a model search to populate the element
If necessary, organize the Packages into an appropriate·
sequence (as described in the Document Order Help topic,Change Sequence of Packages... section)
Generate XML
Step
Action
1 When you have set up the Model Document element,right-click on it in its parent diagram and click on the'Documentation | Generate XML' option.
2 On the 'Generate Model Document XML' dialog,type in the file path of the XML file to be generated,or click on the button and browse for the location.Click on the Generate button to generate the XMLinto the file.
3 The XML Generator works through the definedcontent of the Model Document element, pulls in the
(c) Sparx Systems 2021 Page 55 of 114
Model Exchange 29 April, 2021
information from the listed Packages and generates aNative XML file, showing the progress of theoperation in the Progress field.Click on the Close button.You - or another user - can now import the XML fileinto a different model using the 'Import Packagefrom XML' dialog.
Notes
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must have'Export XML' permission to export to XML
The generated XML file cannot be imported into a version·
of Enterprise Architect earlier than version 15.0
A Log file for the Model Document being exported is not·
generated unless the 'Write Log' option is selected in the'XML Specifications' section of the 'Preferences' dialog
When you import the XML file into a model, Enterprise·
Architect will create a Package (with the same name asthe Model Document element) that will act as a containerfor the Packages specified in the Model Documentelement
(c) Sparx Systems 2021 Page 56 of 114
Model Exchange 29 April, 2021
CSV Import and Export
Within Enterprise Architect, you can import and exportinformation about elements to and from comma-separatedvalue (CSV) text files. This involves up to three possibleactions.
Actions
Action Detail
Set UpSpecifications
To import and export element data fromEnterprise Architect using CSV files, youmust first set up one or more filespecifications.You do this because the specificationdefines what types of value from thespreadsheet are to be imported, and howthe information is translated between thespreadsheet and Enterprise Architect.
Import FromCSV
Once you have defined a CSV importspecification, you can read in majorelement characteristics from a CSV textfile.
Export To Once you have defined a CSV export
(c) Sparx Systems 2021 Page 57 of 114
Model Exchange 29 April, 2021
CSV specification it is possible to write outmajor element characteristics to a CSVtext file.
(c) Sparx Systems 2021 Page 58 of 114
Model Exchange 29 April, 2021
CSV Specifications
To import and export element data to and from EnterpriseArchitect using CSV files, you must first set up one or moreCSV file specifications. A file specification defines the:
Fields from the spreadsheet in the order they are imported·
or exported
Source or target filename (optional) and·
Delimiter between columns·
Once you have defined one or more specifications, you canselect one in the 'CSV Import/Export' dialog as the currentspecification to apply during an import or export action. Thefacility only imports and exports elements (within Packages)and their properties; items such as Class attributes cannot beimported or exported through this mechanism.
XMI import/export provides a solution to this limitation, asdoes use of the Automation Interface.
Access
Ribbon Publish > Model Exchange > CSV >CSV Exchange Specification
(c) Sparx Systems 2021 Page 59 of 114
Model Exchange 29 April, 2021
Set Up a CSV Specification
Field Action
SpecificationName
If creating a new specification, type in aunique specification name.If editing an existing specification, clickon the drop-down arrow and select thespecification name.
Delimiter Click on the drop-down arrow and selectthe character delimiter to use betweenrecord fields.If a field contains an instance of thedelimiter, the field is exported wrapped in" (quotation marks) and any instances of "in the field are doubled (that is, "becomes "").
Notes Type in a brief description of thespecification.
DefaultFilename
Type in the default file location and filename to be used when importing andexporting.Alternatively, click on the button andbrowse for the location.
(c) Sparx Systems 2021 Page 60 of 114
Model Exchange 29 April, 2021
DefaultDirection
Click on the drop-down arrow and selectthe default action - 'Import' or 'Export'.Each specification can be used in eitherdirection, but this field provides thedefault.
DefaultTypes
Type in a comma-separated list to limitthe element types being exported; forexample:class,requirement,component,node,object.
If you specify element types, ONLY·
elements of those types are exported orimported; so, for the 'PreserveHierarchy' option to operate (ifselected) you must include Package asan element type, otherwise there are noPackages in which to preserve thehierarchyIf you do not specify any default·
element types, all elements includingPackages are exported or imported andthe hierarchy can be preserved
PreserveHierarchy
Select this checkbox to include fieldsgenerated by Enterprise Architect, toembed/reconstruct the Package hierarchy.
Available Click on the name of an available field,
(c) Sparx Systems 2021 Page 61 of 114
Model Exchange 29 April, 2021
Fields and double-click on it to add it to theSpecification (it displays at the end of the'File Specification' list).Press and hold Ctrl while you selectseveral fields, but use the Add fieldbutton to transfer them all to the 'FileSpecification' list.
FileSpecification
Review the record fields alreadyassigned, listed in the order in which theyare plotted across the spreadsheet.If you want to change the sequence offields, click on a field name and click onthe or button to move the field nameup or down the list.
Add TaggedValue Field
Click on this button to add a TaggedValue column to the CSV Specification,to import or export the value that anelement has for a particular tag.A prompt displays to select one of twooptions:
Value - to import or export the content·
of the Tagged Value 'Value' field; acolumn heading with the prefix'TagValue_' is added to theSpecificationNotes - to import or export the content·
of the Tagged Value 'Notes' field (some
(c) Sparx Systems 2021 Page 62 of 114
Model Exchange 29 April, 2021
Tagged Values use the 'Notes' field toaccommodate long values, such as<memo> text); a column heading withthe prefix 'TagNotes_' is added to theSpecification
In each case, the 'Add Tag Value Field'dialog displays. Select either the:
'Global Tagged Values' radio button, or·
'Tagged Values from the selected·
Element' radio button, click on theOther Element button and browse forthe name of the element that containsthe Tagged Value
Click on the 'Tagged Value' fielddrop-down list and select the requiredTagged Value, then click on the OKbutton.
Add Field Click on this button to move all selectedfields from the 'Available Fields' list tothe 'File Specification' list.
RemoveField
Click on this button to move all selectedfields from the 'File Specification' listback to the 'Available Fields' list.
New Click on this button to clear all the dialogfields to create a new specification.
(c) Sparx Systems 2021 Page 63 of 114
Model Exchange 29 April, 2021
Save Click on this button to save all changes tothe currently selected specification.
Save As Click on this button to save the currentspecification under a new name.
Delete Click on this button to delete the currentspecification.
Close Click on this button to close this dialog.
Notes
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must have'Export XMI', 'Import XMI' and 'Configure Resources'permissions to use the 'CSV Import/Export Specifications'option
In 'Available Fields' and 'File Specification', the record·
fields 'Created Date' and 'Modified Date' are not set whenimported from CSV
(c) Sparx Systems 2021 Page 64 of 114
Model Exchange 29 April, 2021
Using Preserve Hierarchy
The 'Preserve Hierarchy' option on the 'CSV Import/ExportSpecification' dialog includes fields generated by EnterpriseArchitect to embed/reconstruct the Package hierarchy in aCSV import or export.
When selected, the 'Preserve Hierarchy' option inserts twofields into the CSV specification that are:
automatically populated by Enterprise Architect on export·
and
used to reconstruct the exported Package's hierarchy upon·
import
It is highly recommended that you do not change thesefields if they have been automatically generated byEnterprise Architect's CSV exporter.
Inserted Fields
Field Action
CSV_KEY A unique identifier for the currentelement.This key is unique per export; subsequentexports produce different keys for thesame set of elements.
(c) Sparx Systems 2021 Page 65 of 114
Model Exchange 29 April, 2021
CSV_PARENT_KEY
The corresponding CSV_KEY of thecurrent element's parent.If the field is left blank or references anon-existent CSV_KEY, the element isadded to the top level of the Package.
External Data
If you intend to import hierarchical information from aspreadsheet that was not populated by exporting data fromEnterprise Architect, you must add these two fields to yourspreadsheet as the last two columns, and populate thecolumns yourself. For example:
(c) Sparx Systems 2021 Page 66 of 114
Model Exchange 29 April, 2021
CSV Export
It is possible to export information about elements fromyour project in Enterprise Architect to a CSV text file. Inthis operation you make use of a CSV export specification.
If you intend to re-import the exported information intoEnterprise Architect at some point, it is recommended thatyou include the 'GUID' field in the CSV exportspecification. This helps Enterprise Architect to identify andupdate existing elements, rather than create duplicates.
Access
Ribbon Publish > Model Exchange > CSV >CSV Import/Export
Export Data in CSV Format
Field Action
Package Confirm the name of the current selectedPackage.
(c) Sparx Systems 2021 Page 67 of 114
Model Exchange 29 April, 2021
Specification Click on the drop-down arrow and selectthe name of the existing exportspecification to use.
Edit/New Click on this button to edit the exportspecification or create a new one. The'CSV Import/Export Specification' dialogdisplays.
File Type in the name and path of the file toexport to, or click on the button andbrowse for the file.
Types Type in the element types to export: leaveblank for all, or enter a comma-separatedlist of types.If you specify element types, ONLYelements of those types are exported;therefore, to enable the 'PreserveHierarchy' option in the specification tooperate (if selected) you must include'Package' as an element type, otherwiseno Packages are exported in which topreserve the hierarchy.If you do not specify any element types,all elements including Packages areexported and the hierarchy can bepreserved.
(c) Sparx Systems 2021 Page 68 of 114
Model Exchange 29 April, 2021
Code Page Displays the Code Page used whenimporting and exporting. This can bechanged via the 'Source CodeEngineering' page of the 'Manage ProjectOptions' dialog.
Action Click on the 'Export' radio button toexport to file.
ExportColumnNames
Select this checkbox to include thecolumn names of the fields in the exportfile.
IncludeSubfolders
Select this checkbox to includesubfolders and their child elements in theexport.
Print Results Click on this button to print out the resultlist.
View File Click on this button to view the resultantCSV file with the default Windowsapplication for CSV files.
Run Click on this button to execute the export.
Close Click on this button to cancel the exportand exit the dialog.
(c) Sparx Systems 2021 Page 69 of 114
Model Exchange 29 April, 2021
Notes
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must haveboth 'Export XMI' and 'Import XMI' permissions to usethe 'CSV Import/Export' option
(c) Sparx Systems 2021 Page 70 of 114
Model Exchange 29 April, 2021
CSV Import
It is possible to import information about elements into yourproject in Enterprise Architect from a CSV text file. In thisoperation you make use of a CSV import specification. Youimport the CSV file into a selected Package; if this Packageor any element within the Package has a lock on it, youcannot import the CSV file into it. The 'Import' option on thedialog is grayed out.
The format and content of the CSV source data file shouldresemble this:
Access
Ribbon Publish > Model Exchange > CSV >CSV Import/Export
(c) Sparx Systems 2021 Page 71 of 114
Model Exchange 29 April, 2021
Import Data in CSV Format
Field Action
Package Confirm the name of the current selectedPackage.
Specification Specify the name of the importspecification to use.
Edit/New Edit the import specification or create anew one.
File Specify the spreadsheet filename toimport from.
Types Not used for import.
Code Page Displays the Code Page used whenimporting and exporting. This can bechanged via the 'Source CodeEngineering' page of the 'Manage ProjectOptions' dialog.
Action Select the 'Import' radio button to importfrom the file (grayed-out if the Packageor a child item in the Package is locked).
(c) Sparx Systems 2021 Page 72 of 114
Model Exchange 29 April, 2021
Print Results Print out the result list.
View File View the source CSV file with the defaultWindows application for CSV files.
Run Perform the import.
Close Click on this button to close this dialog.
Notes
When importing, Enterprise Architect checks the·
specification to see if there is a 'GUID' field included; ifthere is, Enterprise Architect attempts to locate theelement identified by the GUID and, if successful, updatesthe 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 iscreated and placed in the current Package; during import,'Type' is a mandatory field in the source file and mustmatch one or more of the legal Enterprise Architectelement types: for example: Requirement, or Class
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must haveboth 'Export XMI' and 'Import XMI' permissions to usethe 'CSV Import/Export' option
(c) Sparx Systems 2021 Page 73 of 114
Model Exchange 29 April, 2021
(c) Sparx Systems 2021 Page 74 of 114
Model Exchange 29 April, 2021
Controlled Packages
A Controlled Package is a Package configured to save andload in XML format to a named file; the XML output isUML 1.3 compliant XMI, with Enterprise Architectextensions to support diagrams and additional modelelements. Controlled Packages are a powerful means of'externalizing' parts of an Enterprise Architect model.
Package XML is standard XMI-compliant output that can beloaded into any XML viewer, or used by any XML-basedtool to perform manipulations and extracts, such asdocument or code generators.
Controlled Packages appear in the Browser window with asmall colored rectangle to the left of the Package icon, asshown for the CIM Package:
Using Controlled Packages you can support:
Widely distributed development by having team members·
submit Packages in the form of XML for import into acentral Enterprise Architect repository
Version Control, by writing model elements in XML text·
files suitable for Version Control using standard VersionControl softwareUsing XMI this way, you can manually connect tothird-party Version Control software outside theEnterprise Architect environment; Enterprise Architectinternally supports the configuration of Version Control
(c) Sparx Systems 2021 Page 75 of 114
Model Exchange 29 April, 2021
through SCC and CVS
Import and export of model elements between different·
modelsFor example, a Class library can be re-used in manymodels and kept up to date in target models usingControlled Packages, reloading Packages as requiredwhen new versions of the Class model become available
Notes
If you are importing an XMI 1.1 file that was previously·
exported with a UML_EA.DTD (Data Type Definition)file, the UML_EA.DTD file must be present in thedirectory into which the XMI file is being written; anerror occurs if the UML_EA.DTD file is absent
When you select to apply a DTD during an XMI 1.1·
export, the UML_EA.DTD file is written to the outputdirectory into which the XML files are written (unless theUML_EA.DTD file is already present in the directory); noerror is generated if the UML_EA.DTD file is not presentin this directory during the XMI export
(c) Sparx Systems 2021 Page 76 of 114
Model Exchange 29 April, 2021
Controlled Package Menu
If you are working on a Package that is not under VersionControl, you can select certain options on the 'ControlledPackage' context menu.
(Further options are available from the 'Model Exchange'panel of the Publish ribbon, and for a Package that isdirectly under Version Control you use the 'Package VersionControl' menu.)
Access
ContextMenu
Browser window > Right-click onPackage > Package Control
Package Control Options
Option Action
LockPackage
Select this option to apply a lock on theselected Package.(This option is only displayed when usersecurity is enabled in User/Group locking
(c) Sparx Systems 2021 Page 77 of 114
Model Exchange 29 April, 2021
mode.)
Apply/Release User Lock
Select this option to apply or release auser lock on the selected Package.(This option is only displayed when usersecurity is enabled in 'Require User Lockto Edit' locking mode)
Set VisibilityLevel
This menu item is only available in amodel that has been set up for VisibilityLevels, and when it is being accessed viaa Pro Cloud server connection. It isprimarily used by System Administratorsto manage user access to Packages withinthe model.You use this option to set a VisibilityLevel on a Package, which applies to thePackage and its child structures. TheVisibility Level has a matching useraccess level set in User Security. A userwith a given access level can only see,access and update Packages with theequivalent Visibility Level or lower.Select from the list of values, which startat 0 (no restriction on access) and can goup to 5 (for Packages requiring highsecurity of access). You will only be ableto set Visibility Levels at or below theaccess level to which you have been
(c) Sparx Systems 2021 Page 78 of 114
Model Exchange 29 April, 2021
assigned.To remove a Visibility Level from aPackage (and all its children), simply setthe Visibility Level back to zero. Anyuser can then view and update thePackage (within the limitations of anyuser security controls on their access tofunctions).
Import aModelBranch
Select this option to retrieve a modelbranch and import it into either the sourcemodel or another model.
VersionControlSettings
Select this option to display the 'VersionControl Settings' dialog.
(c) Sparx Systems 2021 Page 79 of 114
Model Exchange 29 April, 2021
Configure Packages
In order to configure a Package to save and load in XMLformat to a named file, you use the 'Package ControlOptions' dialog to flag the Package as being controlled andto set a number of options. These options include setting theXMI filename to save to/load from, the type of XMI toimport and export, and whether to export and/or import theXMI in a batch process. When the Package is configured,this is indicated by a small colored rectangle on the left ofthe 'Package' icon in the Browser window, as shown for theRQ01: Formal Requirements Package.
Access
Select a Package in the Browser window, then:
Ribbon Configure > Version Control >Package-VC orPublish > Model Exchange > PackageControl > Configure > Package Control
KeyboardShortcuts
Ctrl+Alt+P
(c) Sparx Systems 2021 Page 80 of 114
Model Exchange 29 April, 2021
Configure a controlled Package
Option Description
ControlPackage
Select the checkbox to indicate that this isa controlled Package.
For allpackages,createplaceholdersfor externalreferences
Select to force all XMI 1.1 imports of thisPackage to exclude incomingrelationships and instead create externalreferences.This overrides the 'Create placeholdersfor missing External References duringXMI 1.1/2.1 Import' checkbox in theXML Specifications options for a user, ifthat checkbox is not selected.
VersionControl
Leave this field set to '(None)', to managethe Package under XMI control.The 'Package Control Options' dialog isalso used in adding a Package to VersionControl and, in this context, is describedunder the Version Control section.
XMI Type or browse for the path and XMI file
(c) Sparx Systems 2021 Page 81 of 114
Model Exchange 29 April, 2021
Filename name into which to export the Packagedata and from which to import it.You can also enter Local PathSubstitution strings; for example, an XMIlocal path definition where: myLocalPath="C:\Documents andSettings\John\Desktop\EA Models"So that %myLocalPath%\CIM.xml isequivalent to: C:\Documents andSettings\John\Desktop\EAModels\CIM.xml
UML/XMIType
Click on the drop-down arrow and selectthe type of XMI to be generated; optionsinclude:
Enterprise Architect XMI 1.1·
Enterprise Architect XMI 2.1·
For complete import/export roundtripping of Packages, currently onlyEnterprise Architect XMI 1.1 issupported. This format uses additionalTagged Values to store the model's UML2.x information.
Version ID Type the version number you want toapply to the Package.This field is the same as the 'Version'
(c) Sparx Systems 2021 Page 82 of 114
Model Exchange 29 April, 2021
field on the Package 'Properties' dialog;any change to either field updates theother.
Owner Defaults to the name of the Packageowner; if necessary, type or select adifferent name.
Use DTD (Optional) Select the checkbox to use aData Type Definition (DTD) for theimports and exports.(This option is not available for theEnterprise Architect XMI/UML 1.3 orRational Rose/Unisys UML 1.3 types.)
LogImport/Export
(Optional) Select the checkbox to logimport and export activity to a log file.
Batch Import (Optional) Select the checkbox to markthe Package as a Batch Import Package.
Batch Export (Optional) Select the checkbox to markthe Package as a Batch Export Package.
Includesub-packages
(For an Enterprise Architect XMI/UML1.3 export) Select the checkbox toinclude the entire sub-Package hierarchyof this branch in the exported XMI
(c) Sparx Systems 2021 Page 83 of 114
Model Exchange 29 April, 2021
(default).Deselect the checkbox to include only theimmediate contents of the Package in anXMI export (XMI stubs).
OK Click on this button to set the PackageControl options and close the dialog.
Notes
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must have'Configure Packages' permission to configure controlledPackages and Package properties
For batch import, the file date of the XMI file is stored;·
you can bypass the batch import if there is no change -that is, the file date of the last import matches that of thecurrent file
(c) Sparx Systems 2021 Page 84 of 114
Model Exchange 29 April, 2021
Remove Package from Control
If required, you can remove the control from a Package.Before removing the Package control, and if it is being usedfor Version Control, you must check in the Package.
Access
Select a Package in the Browser window, then:
Ribbon Configure > Version Control >Package-VC orPublish > Model Exchange > PackageControl > Configure > Package Control
KeyboardShortcuts
Ctrl+Alt+P
Remove control from a Package
Step
Action
1 Select the Package and click on the 'Configure' menu
(c) Sparx Systems 2021 Page 85 of 114
Model Exchange 29 April, 2021
option.The 'Package Control Options' dialog displays.
2 Deselect the 'Control Package' checkbox.If the Package is under Version Control, this sets the'Version Control' field to '(None)'.
3 Click on the OK button to remove Package control.Package control for the selected Package has nowbeen removed.
Notes
When disconnecting a Package from Version Control, the·
association between the Package and the exported XMLfile is removed from your model; however, the XML fileitself is not removed from Version Control, nor is itdeleted from your local Version Control working copyfolder
This is because it is possible for another model to be usingthe Version Controlled Package and still referencing theassociated Version Controlled XML file
(c) Sparx Systems 2021 Page 86 of 114
Model Exchange 29 April, 2021
Save a Package
Once you have correctly configured a Package, you can savethe controlled Package to the designated XMI file.
Access
Select a Package in the Browser window, then:
Ribbon Publish > Model Exchange > PackageControl > Save to File
ContextMenu
Right-click on Package > PackageControl > Save Package to File
KeyboardShortcuts
Ctrl+Alt+S
Save a controlled Package to file
Step
Action
1 Select the Package and the Save Package to File
(c) Sparx Systems 2021 Page 87 of 114
Model Exchange 29 April, 2021
menu option.The export process executes automatically accordingto your configured preferences, overwriting anyexisting file.
Notes
If you are using a Version Control Package in conjunction·
with the exported Package files, you must check out theXMI file first to enable Enterprise Architect to overwritethe existing version
(c) Sparx Systems 2021 Page 88 of 114
Model Exchange 29 April, 2021
Load a Package
If a Package has been marked for control it is displayed inthe Browser window with a red rectangle to the left of thePackage icon. If you have previously saved the controlledPackage, you can reload it.
Access
Select a Package in the Browser window, then:
Ribbon Publish > Model Exchange > PackageControl > Load from File
KeyboardShortcuts
Ctrl+Alt+L
Load a controlled Package from an XMI file
Step
Action
1 Select the Package and the 'Load from file' ribbonoption.
(c) Sparx Systems 2021 Page 89 of 114
Model Exchange 29 April, 2021
If you have configured the Package Control details,the system prompts you to confirm the import.
2 Click on the Yes button to confirm the import.The current Package is deleted and the savedPackage is imported.
Notes
Importing deletes the current Package entirely from the·
model, and the action cannot be undone; you must becareful not to lose any current changes or information
(c) Sparx Systems 2021 Page 90 of 114
Model Exchange 29 April, 2021
Batch XMI Export
You can export a group of Controlled Packages to XMI inone step.
Access
Ribbon Publish > Model Exchange > ExportXML > Batch Export ControlledPackages
Export a group of Controlled Packages toXMI
Step
Action
1 Open the 'Batch XMI Export' dialog using one of theaccess methods.
2 The 'Batch XMI Export' dialog lists all of theControlled Packages in the current Project.Select the checkbox against each Package to include
(c) Sparx Systems 2021 Page 91 of 114
Model Exchange 29 April, 2021
in this export run.Select the 'Select All' checkbox to select allPackages in the list.
3 Select the 'Restore Cross References WithoutPrompting' checkbox to automatically restore anymissing cross-Package references without displayinga prompt.
4 To save this configuration as the default, click on theSave Settings button.
5 Click on the Run Export button.Enterprise Architect cycles through each checkedPackage and exports it using the options specified inthe 'Package Control Options' dialog.As long as a valid filename exists, EnterpriseArchitect exports the Package to XMI and proceedsto the next Package.
Notes
The 'Restore Cross References Without Prompting'·
checkbox is enabled only if the option 'Report CrossPackage Reference Deletions (XMI 1.1)' is set on the'XML Specifications' page of the 'Preferences' dialog
(c) Sparx Systems 2021 Page 92 of 114
Model Exchange 29 April, 2021
The option is applicable only to XMI 1.1 Controlled·
Packages
(c) Sparx Systems 2021 Page 93 of 114
Model Exchange 29 April, 2021
Batch XMI Import
You can import a group of Controlled Packages from XMIinto Enterprise Architect in one step.
As the system processes each Package, it updates the 'Status'column against each Package name on the 'Batch XMIImport' dialog.
If the import is successful, Enterprise Architect updates·
the Package status to 'Imported'
If the import is unsuccessful, Enterprise Architect updates·
the Package status to 'Not Imported'
Common reasons for an import to fail include:
The Package not being correctly configured·
The last import file date matches the import date of the·
file currently on disk
Access
Ribbon Publish > Model Exchange > ImportXML > Batch Import ControlledPackages
Import a group of Controlled Packages from
(c) Sparx Systems 2021 Page 94 of 114
Model Exchange 29 April, 2021
XMI
Step
Action
1 Open the 'Batch XMI Import' dialog using one of theaccess methods.
2 The 'Batch XMI Import' dialog lists all of theControlled Packages in the current Project.Select the checkbox against each Package to includein the import.Select the 'Select All' checkbox to select allPackages in the list.
3 To save this configuration as the default, click on theSave Settings button.
4 Click on the Run Import button.Enterprise Architect cycles through each checkedPackage and imports it.
Notes
To avoid re-importing the same module multiple times,·
(c) Sparx Systems 2021 Page 95 of 114
Model Exchange 29 April, 2021
select the Check file date before import checkbox;Enterprise Architect then does not import a file if the lastimport file date matches that of the one currently on disk
(c) Sparx Systems 2021 Page 96 of 114
Model Exchange 29 April, 2021
Manual Version Control with XMI
You can use XMI to support Version Control by writingmodel elements in XML text files suitable for use withstandard Version Control software.
Using XMI in this manner enables you to manually connectto third-party Version Control software outside theEnterprise Architect environment.
Enterprise Architect internally supports the configuration ofVersion Control through SCC and CVS configurations.
Prepare for using XMI for Version Control
Step
Action
1 Select suitable Packages in the Browser window, tobe marked as Controlled Packages.
2 Configure these with filenames that are visible to aVersion Control system of your choice.
3 Save the Controlled Packages to establish a modelbase and check these into the Version Controlsystem.
(c) Sparx Systems 2021 Page 97 of 114
Model Exchange 29 April, 2021
Apply Version Control
Step
Action
1 Continue working on a Package until versioning isrequired.
2 Check out the Package XMI file from the VersionControl system.
3 Save the relevant Package using the ControlledPackage support.
4 Check the Package back into the Version Controlsystem.
Recover an earlier version
Step
Action
1 Save the current version first.
(c) Sparx Systems 2021 Page 98 of 114
Model Exchange 29 April, 2021
This is important, because the Package is completelydeleted during the import process.If necessary, manually update the Version Controlsystem.
2 Get the required Package version from the VersionControl system.
3 Select the Package to reload.
4 Select the 'Package Control | Load package from file'menu option to import the previous version.Enterprise Architect deletes the Controlled Packageand restores the previous version.
(c) Sparx Systems 2021 Page 99 of 114
Model Exchange 29 April, 2021
Report Deletion of Cross PackageReferences
Your model might contain at least one XMI 1.1 ControlledPackage that is also used in other models, but notnecessarily in the same context.
For example, consider the combination of Projects andPackages described in this figure:
deployment Project X
Package B
+ Element B1
+ Element B2
Package A
+ Element A1
+ Element A2
Specialized Package X
+ Element X1
+ Element X2
X depends on A
X depends on B
deployment Project Y
Specialized Package Y
+ Element Y1
+ Element Y2
Package A
+ Element A1
+ Element A2
Package B
+ Element B1
+ Element B2
Y depends on B
Y depends on A
Two common Packages, 'Package A' and 'Package B', areshared across two separate projects, 'Project X' and 'ProjectY', through the use of XMI Package files. From the point ofview of the common Packages, each of these projects is'incomplete'. Project X does not contain 'SpecializedPackage Y' and similarly, Project Y does not contain'Specialized Package X'.
Problem
When 'Package B' is exported from 'Project X', its XMI filewill not contain the cross-Package reference 'Y depends on
(c) Sparx Systems 2021 Page 100 of 114
Model Exchange 29 April, 2021
B', as that relationship does not exist in 'Project X'. If theXMI file is subsequently imported into 'Project Y', therelationship 'Y depends on B' will be removed from 'ProjectY'.
Solution
You can easily check for and preserve the cross-Packagerelationships by selecting the option 'Report Cross PackageReference Deletions (XMI 1.1)' in the 'Preferences' dialog('Start > > Desktop > Preferences > Preferences' ribbonoption, then select the 'XML Specifications' tab). When yousave a controlled Package, Enterprise Architect comparesthe XMI for that save with the most recent XMI 1.1 revisionof the Package. Any items that are missing from thePackage are listed on the 'Missing Cross References' dialog.
Actions
Action Detail
Decide whichcross-references to merge
In some cases Enterprise Architect cannotdetermine whether a cross-reference ismissing or intentionally deleted by theuser. When the 'Missing CrossReferences' dialog displays, the basic
(c) Sparx Systems 2021 Page 101 of 114
Model Exchange 29 April, 2021
analysis process should be:If the item was deleted intentionally,·
deselect the checkbox beside itIf the item was not deleted·
intentionally, its presence in the listsuggests it is a missing cross referenceand you should leave the checkboxselected
Mergemissing items
Items missing from the exported Packageare listed in the 'Missing CrossReferences' dialog. To regenerate theminto the XMI file that is being saved:
Select the checkbox against each item·
typeClick on the OK button·
Items of any type that you do not selectare omitted from the saved XMI file.
Abort orcancel thisXMI Export
If you do not want to proceed with theexport (or Check-in or Put Latest)operation:
Click on the Cancel button·
Review thedetails of anentry
To display the details of an entry on the'Missing Cross References' dialog:
Double-click on the type name·
The details of each item are shown on the
(c) Sparx Systems 2021 Page 102 of 114
Model Exchange 29 April, 2021
'Missing <item type>' dialog. For anyitems where information is missing fromthe XMI file, the missing details aregrayed-out.To find the item with the missingcross-reference in the Browser window,either:
Right-click on the entry in the list and·
select the 'Find in Project Browser'option, orClick on the item and press Alt+G·
Copy a valuefrom acolumn onthe dialog tothe clipboard
To preserve a copy of an item from thedialog on the clipboard:
Click on the column value to highlight·
it; the selected value is shown in thebottom left corner of the dialogSelect the text in the bottom left corner·
and press Ctrl+C to copy that value tothe clipboard
Notes
If you are not sharing any common packages between·
multiple projects, then detection of missing crossreferences is not necessary, and you should disable the
(c) Sparx Systems 2021 Page 103 of 114
Model Exchange 29 April, 2021
feature by deselecting the 'Report Cross PackageReference Deletions (XMI 1.1)' checkbox.
(c) Sparx Systems 2021 Page 104 of 114
Model Exchange 29 April, 2021
Project Data Transfer
In normal system maintenance, it is likely that at some pointyou need to relocate data between storage systems. In anyedition of Enterprise Architect, you might need to transferall records from one project file to another (recommendedafter serious network crash or repeated database corruption).Project files can be either .eap (Access) files or .feap(Firebird) files, and you can transfer from one file type tothe other.
In the Corporate, Unified and Ultimate Editions ofEnterprise Architect, you might need to:
Transfer an existing project file to a DBMS repository·
such as SQL Server or MySQL
Transfer a DBMS repository to an existing project file·
Move a repository from one DBMS to another (including·
moving between servers using the same DBMS)
Copy all records from a JET 3.5 to JET 4 (Access 2000 or·
XP) repository - or back the other way
Access
Ribbon Configure > Model > Transfer > ProjectTransfer
(c) Sparx Systems 2021 Page 105 of 114
Model Exchange 29 April, 2021
Perform a project data transfer
Step
Action
1 Click on the radio button for the required transfertype:
File to File·
DBMS to File·
File to DBMS·
DBMS to DBMS·
2 In the 'Source Project' and 'Target Project' fields,type or select the name or connection string for theSource and Target projects.
3 If you want to capture the transfer in a log file, selectthe 'Logfile' checkbox and browse for theappropriate log file location.
4 Click on the Transfer button.
5 It is good practice to do a Project Compare after thisprocess to verify that all records are written.
(c) Sparx Systems 2021 Page 106 of 114
Model Exchange 29 April, 2021
Notes
Take a backup of the target project to ensure that you can·
recover any important information it already contains; in atransfer, all records in the target repository are overwritten
You cannot move a model from a source .eap file from an·
Enterprise Architect version earlier than 3.5.0
When performing a .eap file to DBMS transfer, if the .eap·
file has replication enabled, the replication must beremoved before performing the transfer
When transferring a model to a DBMS, you cannot·
transfer the data into an empty database - the tables mustalready exist; if they do not, run the corresponding scriptsupplied by Sparx Systems to create the required tables
When transferring a model into a project file, similarly,·
the target project file must already exist, to provide thedata structures to transfer data into
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must have'Transfer Data' permission to transfer project data betweenrepositories
(c) Sparx Systems 2021 Page 107 of 114
Model Exchange 29 April, 2021
Project Transfer using Native XML
We live in an age of information and digital disruption,where individuals and companies have an almost insatiablethirst for information and knowledge. While it is possible toaccess the valuable corporate modeling assets stored in anEnterprise Architect repository from any device in anylocation, there still remain scenarios where a modeler willwant to extract or exchange the information stored in therepository. Enterprise Architect is compliant with standardsand has always provided a facility to export the models tothe standards-based XMI format, but it now also provides aNative XML format export and import facility for thetransfer of an entire project's data. This is a two step processthat involves:
Opening the source project in Enterprise Architect and1.exporting it to Native XML using the 'Export Project toNative XML' dialog.
Opening the target project in Enterprise Architect and2.importing the Native XML files exported in the first step,using the 'Import Project from Native XML' dialog.
(c) Sparx Systems 2021 Page 108 of 114
Model Exchange 29 April, 2021
Regardless of the size of the repository, the model content -including all elements, connectors, documents and referencedata - can be conveniently exported and exchanged betweenrepositories at Internet speed. Exporting the data from onerepository and importing it into another is fast and canconveniently be used with any type of repository connection(Cloud, Server or file system) and any type of repository(RDBMS or file). There is a range of other uses for theexchange of repository content, including such things asbacking-up repositories, record keeping or exchange withother tools.
The feature is particularly useful for Cloud-based modelswhere a modeler does not have direct access to the Cloudhosting environment and the data sources are protected byprivate subnet security. The Native XML format export andimport can be used effectively as a project transfer optionfor Cloud repositories. The data transfers would typically besecured with secure socket layer connections, preventing thedata from being compromised in either the exporting or
(c) Sparx Systems 2021 Page 109 of 114
Model Exchange 29 April, 2021
importing phases of a transfer.
Access
Ribbon Configure > Model > Transfer > NativeXML > Export Complete ProjectConfigure > Model > Transfer > NativeXML > Import Complete Project
Export Project Data to Native XML files
Use the 'Export Project to Native XML' dialog to export thecurrent project to Native XML. The export process willgenerate multiple Native XML files, representing data of theproject.
Option Action
Project Displays the name of the current project(selected in the Browser window).
Directory Type in the path of the directory in thefile system into which the Native XMLfiles, representing the project data, are tobe generated; alternatively, click on the
(c) Sparx Systems 2021 Page 110 of 114
Model Exchange 29 April, 2021
button and browse for the directorylocation.Note:
If the directory already contains Project·
Transfer specific XML files (from aprevious Project Transfer export), allthese files will be deleted prior toexporting project dataIf the directory contains non-Project·
Transfer specific files, you will beprompted to create a sub-directory toexport project data
Export Click on this button to initiate the NativeXML export.When the export is successfullycompleted, the specified directory willcontain multiple Native XML filesrepresenting the project data.Note: The following data will not beexported as a part of the Project Transfer:
Audit Logs·
Image and Image-maps of diagrams·
HTML Pages of Linked Documents·
Close Click on this button to close the 'ExportProject to Native XML' dialog.
(c) Sparx Systems 2021 Page 111 of 114
Model Exchange 29 April, 2021
Import Project Data from Native XML files
Use the 'Import Project from Native XML' dialog to importNative XML files generated by the export process into thecurrent (target) project. The contents of the current projectwill be deleted prior to importing the Native XML files; ifnecessary, take a backup of the current project prior toimporting the files.
Option Action
Project Displays the name of the current project.
Directory Type in the path of the directory in thefile system into which the Native XMLfiles, representing the project data, weregenerated by the Export Project Data toNative XML files process; alternatively,click on the button and browse for thedirectory location.
Import Click on this button to initiate the NativeXML import.The import progress will be displayed inthe 'Project Import' tab in the SystemOutput window.
(c) Sparx Systems 2021 Page 112 of 114
Model Exchange 29 April, 2021
Close Click on this button to close the 'ImportProject from Native XML' dialog.
Notes
Take a backup of the target project to ensure that you can·
recover any important information it already contains; in atransfer, all records in the target repository are overwritten
In the Corporate, Unified and Ultimate Editions of·
Enterprise Architect, if security is enabled you must have'Transfer Data' permission and: - 'Export XMI' permission to export project data toNative XML - 'Import XMI' permission to import project data fromNative XML
Native XML files, representing project data, cannot be·
imported using the 'Import Package from XML' dialog
If you are connected to a SQL Server repository, you·
require ALTER permission on the t_image table inEnterprise Architect to be able to import model images
Project can also be exported to Native XML using the·
Automation Interface function ExportProjectXML()
(c) Sparx Systems 2021 Page 113 of 114
Model Exchange 29 April, 2021
(c) Sparx Systems 2021 Page 114 of 114