Customizing a message map to include a message assembly component

To customize your message map to include more message assembly components, you must add message assembly components to the input message and to the output message, and then define transforms between them.

Before you begin

Check whether you need additional message assembly components to transform your input message. For more information, see Choosing a mapping action.

About this task

You configure additional message assembly components for a message map in the Graphical Data Mapping editor.

Note: The Environment tree is configured differently. For more information, see Mapping the environment tree.

By default, when a message map is created, the only message assembly component that is configured automatically is the Properties tree. The input Properties tree is connected to the output Properties tree with a Move transform.


To add a message assembly component in a message map, complete the following steps:

  1. Open the message map in the Graphical Data Mapping editor.
  2. Add a message assembly component such as the local environment tree to the input message.
    • Method 1:

      Right-click the input or output message assembly. Then, select Add or remove headers and folders.

    • Method 2:
      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 3:
      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 one or more message assembly components, and then click OK.

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

What to do next

Define transforms between the input message assembly and the output message assembly. Depending on the data that you want to transform from the added header or folder, it might be necessary to first define the content of a generic element, such as the Local Environment Variables folder, by using Mapping casts or adding user-defined functions. For more information, see Mapping data in the local environment tree.