Change tracking in xDI Designer

When working on projects in Semarchy xDI Designer, you may want to see how resources such as metadata, mappings, and processes have changed over time. You can compare changes from inside Designer directly.

The basic comparison tool shows project file differences in a text-based form. Designer also comes with the Eclipse EMF Compare add-on, which enhances the comparison tool, and shows differences in a more user-friendly way. You can enable EMF Compare from a Project Explorer menu.

Change tracking functionality in Designer is not meant to replace a source control strategy. You should use change comparisons alongside source control software such as Git.


As you work on project resources, xDI Designer saves change sets, and displays them in the History view of the Designer window. By default, the current change revision is at the top of the list in bold text.

Right-click another revision to open a context menu with multiple options.

Screenshot of change sets with the context menu

Click on Compare Current with Local to open a comparison window. The default comparison tool shows revisions in text form, as they exist on the filesystem.

To activate EMF Compare and enhance the comparison view, go to the top of the Project Explorer, and click on the overflow menu. Select Activate EMF Compare.

Screenshot of Project Explorer context menu with EMF compare

Activating EMF Compare adds an enhanced graphical interface to the next comparison windows you open.



The example starts in a sample HTTP Rest project, with a sample mapping.

Screenshot of xDI Designer with an open project and an open mapping

Make some changes: move datastores around, add a datastore, and map a field. Save after every change. Designer tracks every time you save the resource.

Screenshot of an open mapping in xDI Designer

Basic comparisons

For a basic comparison with the current mapping, open the context menu on a change set that is not in bold.

Screenshot of an open mapping in xDI Designer

Select Compare Current with Local, and the comparison window opens.

Screenshot of a diff tab in xDI Designer

The comparison window shows the recent version on the left, and the older version on the right. It displays the resource as it exists on the filesystem, in plain text.

Comparisons with EMF Compare

Return to the mapping. From the Project Explorer, open the overflow menu and activate EMF Compare.

Screenshot of xDI Designer with an open mapping and the Project Explorer context menu open

Go to the mapping, open the context menu on one of the change sets, and select Compare Current with Local. A graphical comparison window opens.

Screenshot of a graphical EMF Compare tab in xDI Designer

In the comparison window, you can select different resource nodes at the top, which shows side-by-side visual comparisons of that node. In this example, there was a change to a field with a value CUS_LAST_NAME.

You can also navigate to other nodes, and look at the mapping resources in more detail:

Screenshot number 2 of a graphical EMF Compare tab in xDI Designer

The view of mapping nodes shows that a T_CUSTOMER field changed in the mapping.