Implementing the solution for the scenario to transform SOAP messages

You can transform a SOAP message by using a message map. You can use message maps to route, transform and enrich existing messages in your integration solution.

Before you begin

To start the scenario, create the initial configuration. For more information, see Creating the scenario initial configuration.

Procedure

Complete the following steps to create a message map that transforms a SOAP message:

  1. Create a message map. For more information, see Creating a message map to transform SOAP messages.
  2. Optional: Configure the Override function to transform some elements of the Properties folder. For more information, see Transforming elements in the Properties folder by using the Override function.
  3. Optional: Customize the message map to include the local environment tree. For more information, see Customizing a message map to include the local environment tree.
  4. Optional: Configure the local environment tree variables folder by using the Cast function. For more information, see Configuring the local environment tree Variables folder by using the Cast function.
  5. Configure the message map by using the schema that is associated with the integration service operation request on the map input and either the schema for the operation response or a SOAP_Domain_Msg for the output of the map. In this scenario we will select the SaveAddress schema type for the map input to the subflow for the SaveAddress operation. For the output of the map we selected the SOAP_Domain_Msg, so that the transform can set all parts of the SOAP envelope.

    In IBM® App Connect Enterprise, a SOAP message is described by a generic model. For more information, see SOAP tree overview.

    In addition to the standard SOAP parts, the IBM App Connect Enterprise SOAP message generic model includes a Context part that includes contextual information about the current SOAP message being processed. This is the only part in a message map whose structure is included automatically. You must define the other SOAP message parts manually by using the Cast function. You must customize the message map to include your SOAP envelope and SOAP attachments.

Results

You have a message map that transforms your SOAP message.