IBM BPM, V8.0.1, All platforms > Migrating and upgrading your IBM BPM environment > Migrating from previous versions > Migrating from WebSphere Integration Developer > Migrating from previous versions of WebSphere Integration Developer

Migrating XML maps

The underlying structure of xml maps was changed between releases of WebSphere Integration Developer. Use the migration wizard or the quick fix feature to migrate your maps to the current version.

XML maps that were created in versions of WebSphere Integration Developer earlier than version 7.0.0.3 need to be migrated to the current version for the following reasons:

When you import existing maps from previous versions into IBM Integration Designer V8.0.1, the older maps are detected and a migration wizard is launched to help you migrate the maps to the current version. The migration wizard handles the migration for both situations described previously, and once migration is completed no further action is required. For the maps that have the extension of .xmx, the .xmx files will be deleted and a .map file will be created for each .xmx file. For the maps that have the extension of .map, the existing .map files will be updated.

If you choose to exit the wizard and migrate the maps at a later time, you can launch the wizard by invoking the Run workspace migration action from within the Migration Results view.

If : If the Migration Results view is not visible, you can bring it into perspective by selecting Window from the main menu and choosing Show view > Other. Then, from the Show View page, select the Migration Results view.

If you do not migrate the maps using the migration wizard, and you choose to use the Configure Business Object Parsing Mode option to set the business object parsing mode of a module or library to lazy, the associated older maps will be automatically migrated for you during this action. However, if you manually change the business object parsing mode to lazy by editing the properties of the module or library, older maps will not be migrated automatically and you will see errors in the problems view for the associated older maps. When you see such errors in the problems view for .xmx or .map files, use the quick fix function to migrate the maps as follows:

  1. Right-click the error message and select Quick Fix.

  2. Optionally choose to migrate all the maps, and click Finish.

Migrating from previous versions of WebSphere Integration Developer