Skip to main content
Jump to: navigation, search


This page is for users and developers of EATOP MMGen Tool, which is a tool generator that generates Ecore model and implementation for EATOP Enterprise Architect metamodel, as well as XSD schema. It aims at providing a guide to setup and use EATOP MMGen Tool.



  1. Windows Vista, 7 or 10 (Linux or Mac is not supported)
  2. Enterprise Architect 9.1 or greater
  3. Download and install the latest Eclipse Modeling Tools

Getting the source code

The source code of EATOP MMGen Tool is managed in a Git repository.

Adding Enterprise Architect API

Make sure the Enterprise Architect 9.1 or greater has been installed on your computer.

  • Copy eaapi.jar from your installation, e.g., C:\Program Files (x86)\Sparx Systems\EA\Java API, to:
  • Depending whether your Eclipse is 32 or 64 bits, copy SSJavaCOM.dll or SSJavaCom64.dll from your installation, e.g., C:\Program Files (x86)\Sparx Systems\EA\Java API, to:

If you use the 64-bit version of file SSJavaCom64, modify the MANIFEST.MF files of the two plugins: replace processor=x86 with processor=x86_64

Setting the target platform

EATOP MMGen Tool provides target platform definitions for the two latest Eclipse releases. These target definitions are in the project org.eclipse.eatop.metamodelgen.tool.targetdefs.

  • Open the target definition file that corresponds to the Eclipse release you want to work with;
  • Wait for the completion of the Resolving Target Definition operation. This may take a while, in particular at the first time, because all directly and indirectly required target platform plug-ins and features are being downloaded or updated as necessary during that operation. If errors occur, try to close and reopen the target definition file so as to re-trigger the target platform resolution;
  • Click on link Set as Target Platform (in the upper right corner of the target editor).

You can also manually add required plugins, notably:

User guide

Step 1: Create a project for EATOP metamodel

  1. Open menu File > New > Other..., select Java Projec. Click on Next.
  2. Set the project name, “org.eclipse.eatop.eastadl2112”. Click on Finish.
  3. Create a new folder “model” under this project. Copy the EATOP metamodel Enterprise Architect EAP file into the “model” file. Rename the file to be “eastadl2112.eap”.

Step 2: Import EATOP projects

Import the following projects from EATOP repository into the MMGen’s runtime workspace:


Step 3: Create EATOP Ecore metamodel

Right click on the “eastadl2112.eap” file, open menu “EATOP – Generate EATOP Ecore MM”, select one of the following command:

  • Generate (persistence mapping only) Ecore only: to generate persistence mapping Ecore only
  • Generate Ecore + MM EMF Code: to generate persistence mapping Ecore and the metamodel code implementation
  • Generate Ecore + XSD Schema: to generate persistence mapping Ecore and the XSD shcema
  • Generate All (Ecore + MM EMF Code + XSD Schema): to generate persistence mapping Ecore, metamodel code implementation and the XSD schema.

Wait until the Ecore metamodel generation has been finished.


  • Please make sure that the following resources should be removed before you start to generate the metamodel:
   org.eclipse.eatop.eastadl2112: /src-gen, /META-INF, /model/eastadl2112.*, /model/geastadl.*,,, plugin.xml
  • At the end of the generation, a validation of the Ecore is performed. Some validation failure error is pumped up: "Generated the Ecore. Attention, the generated Ecore contains errors, please validate it to see the errors". It does not affect the generated metamodel, the reason is caused by some default values not setting. Just click on “OK”.

Back to the top