Please note : This help page is not for the latest version of Enterprise Architect. The latest help can be found here.
Migrate ArchiMate or ArchiMate 2 to ArchiMate 2 or 3
If you have created a model for ArchiMate® or ArchiMate 2, you can migrate all or part of it to ArchiMate 2 or ArchiMate 3 using the Automation Interface function Migrate(). This function updates the Tagged Values and, if required, stereotypes to the later version of ArchiMate for all elements, attributes, connectors and diagrams under the selected Package or element.
When you migrate your model, you must have both releases of the Technology enabled; when the migration is complete, disable the older release of the Technology.
Migrate ArchiMate model to ArchiMate 2
You must create a script to call the Migrate() function to migrate a Package or element to ArchiMate 2: this is a VB script example of such a script:
Sub MigrateElement (sGUID, lngPackageID)
Dim proj as EA.Project
set proj = Repository.GetProjectInterface
proj.Migrate sGUID, "ArchiMate", "ArchiMate 2"
'refresh the model
If lngPackageID<>0 Then
Dim selElement as EA.Element
Dim selPackage as EA.Package
selType = GetTreeSelectedItemType
If selType = 4 Then 'means Element
set selElement = GetTreeSelectedObject
MigrateElement selElement.ElementGUID, selElement.PackageID
MsgBox "Element Migration Completed",0,"ArchiMate 2 Migration"
ElseIf selType = 5 Then 'means Package
set selPackage = GetTreeSelectedObject
MigrateElement selPackage.PackageGUID, selPackage.PackageID
MsgBox "Package Migration Completed",0,"ArchiMate 2 Migration"
MsgBox "Select a Package or Element in the Project Browser to initiate migration",0,"ArchiMate 2 Migration"
Notes (Migrate ArchiMate to ArchiMate 2)
Migrate ArchiMate 2 model to ArchiMate 3
The MDG Technology for ArchiMate 3 has a migration script built into it, to upgrade a model built for ArchiMate 2 to ArchiMate 3. To execute this script:
- Select the 'Code > Tools > Scripting' ribbon option.
- Expand the ArchiMate® 3 folder.
- Right-click on the 'Migrate ArchiMate 2 to ArchiMate 3' script.
- Click on the 'Run Script' option from the context menu.
- Monitor the execution of the script in the System Output window.
When the script has finished executing, disable the ArchiMate 2 technology.
Notes (Migrate ArchiMate 2 to ArchiMate 3)