Customizing a message map to include the local environment tree

To customize your message map to include the local environment tree, you must add the local environment tree to the input message and to the output message, and then define transforms between them.

Before you begin

  1. Create a message map. For more information, see Creating a message map to transform SOAP messages.
  2. Define transformations between elements of the Properties folder. For more information, see Transforming elements in the Properties folder by using the Override function.

About this task

By default, when a message map is created, the only message assembly component that is configured automatically is the Properties folder. The input Properties folder is connected to the output Properties folder with a Move transform. It is also possible to map other message assembly components such as transport headers and the local environment tree.

In this scenario you configure the local environment tree as an additional component for a message map in the Graphical Data Mapping editor.

Procedure

To configure the local environment tree in a message map, complete the following steps:

  1. Open the message map in the Graphical Data Mapping editor.
  2. Add the local environment tree to the input message.
    • Method 1:
      1. Select Message Assembly .

        This figure shows where the Message Assembly is located in the input message.

      2. In the Properties view, select the General tab.

        This figure shows the General tab. In this tab, you can see that only the Properties tree is included because there are no other message assembly components included.

      3. Click Properties.
        Note: If you have other structures included in your message assembly, the option that you can click includes all the different message assembly components that you have currently selected. For example, if you had the Properties tree and the local environment tree selected, you click LocalEnvironment, Properties.
    • Method 2:
      1. Select the information This icon is represented by an i within a square. icon located by the input message body type.

        This figure shows the location of the icon in the input message.

      2. Select Header: Properties.

        This figure shows the pop-up that appears when you select the icon, where you select Header: Properties.

  3. In the Add or Remove Headers and Folders window, select LocalEnvironment, and then click Ok.

    This figure shows the Add or Remove Headers and Folders window that opens.

  4. Follow the previous steps to add the local environment tree to the output message.
  5. Define a Move transform between the input local environment tree and the output local environment tree. You can add other transforms. For more information, see Specifying a transform and Transform types in the Graphical Data Mapping editor.

Results

The following figure shows the message map in the Graphical Mapping Data editor after you create a message map to transform a SOAP message and configure the local environment tree:

This figure shows the message map that you have created in the Graphical Mapping Data editor in previous steps of the scenario. It shows how the Header, Body and Attachment parts are described with a generic element of type any.

What to do next

Add variables defined in the local environment tree variables folder, see Configuring the local environment tree Variables folder by using the Cast function.