Introduction to the "Transforming SOAP messages by using a message map" scenario
You can create a message map that transforms an existing SOAP message. You can configure the map properties and define data transformations between simple elements, complex elements, and repeating elements. Review the topics in this section to understand what is covered in this scenario, the situations in which a business might want to follow the scenario, and an overview of the solution that is proposed by the scenario.
About this task
In IBM® App Connect Enterprise, you can use graphical data maps to transform messages. Message maps offer the ability to transform a message without the need to write code, providing a visual image of the transformation and simplifying its implementation and ongoing maintenance.
If you want to deploy legacy message maps (.msgmap format) in IBM App Connect Enterprise, you must first convert them into message
maps in .map format, which the Mapping node can consume. For more information, see
Using or converting legacy resources into message maps.
Message maps are based on XML schema and XPath 2.0 standards. You can use these maps to transform and enrich messages in your integration solution. These maps offer the ability to achieve the transformation without the need to write code, providing a visual image of the transformation, and simplifying its implementation and ongoing maintenance.
IBM App Connect Enterprise supports SOAP 1.1 and SOAP 1.2 messages. A SOAP message is encoded as an XML document, consisting of an Envelope element, which contains an optional Header element, and a mandatory Body element. The Fault element, contained in the Body element, is used for reporting errors.
Message maps provide a simple way to transform SOAP messages since they are messages encoded as an XML document.
Although using message maps is very intuitive, you might need help creating a map that transforms SOAP messages due to the multi part structure of a SOAP message. This scenario explains how to create a message map that transforms a SOAP message, how to configure the map properties, how to define transformations between the different parts of a SOAP message, and how to define transformations between simple elements, and complex elements.