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.
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:
- Open the message map in the Graphical Data Mapping editor.
- 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:
- Select Message Assembly .
- In the Properties view, select the General tab.
- 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:
- Select the information icon located by the input message body type.
- Select Header: Properties.
- Method 1:
- In the Add or Remove Headers and Folders window,
select one or more message assembly components, and then click OK.
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.