EA Mapping is an add-in for Enterprise Architect that allows you to map data models of all kinds to each other.

You can either map regular data models, or message models. The main difference between the two is that message models always start from a root element, whereas regular data models start from a package.The mappings can be made between Classes, Attributes and Associations, and allows for many-to-many mappings. For each mapping you can add a description of the mapping logic to be applied.



EA Mapping requires .Net framework 4.5 which is already installed on most Windows installations.


EA Mapping is part of the Bellekens EA Toolpack which includes other useful add-ins such as

When installing you can choose which of the tools you wish to install.


You can reach the settings by choosing the ribbon option Specialize | Add-Ins | EA Mapping | Settings

In this screen you can set the following options

Link Tag Names

  • Attribute Tag
    The name to use for tagged values that link to attributes
  • Association Tag
    The name to use for tagged values that link to associations
  • Element tag
    The name to use for tagged values that link to elements


All features are accessible from the ribbon menu Specialize | Add-Ins | EA Mapping


Select either the source element or package and choose Specialize | Add-Ins | EA Mapping | Map

This will bring up the mapping overview window and show the complete list of mapped items together with their mapping logic.Drag an item from one view to the other to create a new mapping.

Items that can be mapped are Classes, Attributes and Associations.


When opening EA Mapping  only shows  the mapped items. To see all the item on a node click the Expand button.

Empty Mapping

Sometimes an item is not really mapped to anything in particular, but we still want to record the mapping logic. It could be a fixed value,  something calculated, or simply some other description you want to store in the mapping info for this node. You can do that by adding an empty mapping.

Export mapping

The export feature is available from the overview and will export the mapping in the same format as the import format.

Import mapping

Choose Specialize | Add-Ins | EA Mapping | Import Mapping

EA Mapping import

You can import a mapping from a “;” separated csv file.

The csv file should contain the following fields:

  • Source Path
  • Target Path
  • Mapping logic (optional)

Depending on whether you start the mapping from a root element or from a package the paths should be such that it can be found from the starting point.

Import Cobol Copybook

First select the package where you wan to import the cobybook into and select Extensions | EA Mapping | Import Copybook. Then select the copybook you want to import. This feature will parse the copybook and translate it into a UML class model
Copy Book import example

Open Source

This software is free and open source under the FreeBSD license.

The code is managed on Github


The EA Mapping add-in has been developed with the support of:

0 replies

Leave a Reply

Want to join the discussion?
Feel free to contribute!

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.