EA Mapping

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 laid between attributes and associations, and allows for many-to-many mappings.

Secondly you can also define mapping logic for a certain mapping. This mapping logic can be specific for a particular mapping, or shared between mappings.



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 menu/ribbon option Extensions | EA Mapping | Setting

EA Mapping Settings

In this screen you can set the following options

  • Link Type
    • Tagged Values
      Create links between elements using tagged values
    • Link to Element Feature
      Create links between elements using associations using the link to element feature function in EA
  • Mapping Logic Type
    • Mapping Logic Element Type
      Choose the type of element to be used when importing a new mapping
    • In-line
      Don’t create elements for mapping logic but instead store the mapping logic on the link itself
  • Link Tag Names
    This is only relevant in case the chose Link Type is Tagged Values

    • AttributeTag
      The name to use for tagged values that link to attributes
    • AssociationTag
      The name to use for tagged values that link to associations


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

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.


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

This will bring up the mapping overview window and show the complete list of mapped items together with their mapping logic if appropriate.

This grid-like overview window is a temporary GUI until the more suitable GUI using tree views on both sides, and lines between the mapped items is being finished.

From the overview mapping you can either use the arrows on the bottom left, or just doubleclick on the left or right side of the grid to select the source or target item in the project browser.

Export mapping

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

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: