Migrating an XML Map

In IBM® Integration Designer 6.1 and the versions that follow, the Mapping transformation primitive has a new XML map editor. Before you can edit XML maps that were created in a prior version of IBM Integration Designer, you must migrate them to the new format.

Before you begin

The new map files use a different extension than the previous versions. The *.xmx extension has been replaced by *.map. The XML map editor now supports custom mapping so that you can write or reuse custom XSL code already written. You can also use submaps to reuse mapping files as needed and inline maps to help with organizing and mapping more complex structures.

About this task

You can migrate the old maps in one of the following ways:

• When you view a Mapping transformation primitive in the Properties view, you will see a warning indicating that the mapping file is in an old format. Click Migrate and the map will be automatically converted to the new format.
• When you load a mediation module or library that was created in a previous release into the workspace, you will see warning messages in the Problems view indicating that mapping files are in an old format.
  1. Right-click the warning message and select Quick Fix.
  2. Optional: Click Find Similar Problems to see a list of maps that need to be migrated. Choose the maps that you want to migrate and click OK. Follow the instructions in the Migrate Old Mapping to New Format wizard.
  3. Click OK and the Migrate Old Mapping to New Format wizard opens. Follow the instructions in the wizard.
• You can click an old map file and it will open in the Mapping Migrator. Click Find All Old Mappings to display all of the old maps in your module. Select all of the maps that you want to migrate to the new format and click Migrate.