Technical solution for the message map conversion scenario
To complete the scenario, you must convert a message map, and verify the transform behavior of the converted map.
Use the scenario steps to go through the conversion process, review the new map to check the created transform logic, and if necessary, complete any required manual steps to provide equivalent behavior for the converted transform.
When you convert a message map, the transform logic is automatically converted so that it becomes valid behavior for a graphical data map.
- Automatically convert to a valid mapping transform. After conversion, you can then test and verify that the resultant behavior is not changed.
- Automatically convert to a valid mapping transform, but with possible minor changes in the behavior you might want to consider. For example, a date or time function might give a slightly different output format.
- Cannot be converted automatically, and requires manual reconfiguration by using the facilities in the Graphical Data Mapping editor to provide equivalent behavior. This requirement is indicated by a Task transform in your converted map.
Most transformations that are used in .msgmap files automatically convert to working transforms in a .map file. However, in complex maps you might need to make changes to the graphical data map, or check that the behavior matches what you expect after the conversion.
If you experience problems with the behavior of a converted transform in the runtime, it is always best to try to resolve those problems in the mapping, by using the Graphical Data Mapping editor, rather than create a workaround in the runtime. This ensures that your mapping solutions remain robust for future versions of WebSphere® Message Broker/IBM® App Connect Enterprise. If the problem is not resolvable in the mapping, then contact your IBM service provider.
You cannot convert a .map file back into a .msgmap file, but a backup of the file is created when you start conversion. The backup file name is in the format filename.msgmap_backup. To restore your message map, rename the file extension.
The following topics explain the initial configuration that is used to start the scenario, and the target configuration that is the result of following the steps that are documented in the scenario: