Defining Header Mappings

Use

You use a header mapping to map the values of the following key fields in the receiver agreement to other values:

Sender party
Sender communication component
Receiver party
Receiver communication component

The address fields (sender, receiver) are then transformed correspondingly in the header of the outbound message.

The header mapping is particularly important when configuring business-to-business scenarios in which the business partners want to replace the names of their internal business systems with neutral representatives (party, business component) for further use by the receiving business partner.

You can do the following in the header mapping:

Specify fixed values
Define that the conversion of the field values is to be determined dynamically from the message payload

Note

Header mappings are only supported by the following receiver adapters at runtime:

Adapter on the Integration Engine (only available for dual stack installation) :
- XI adapter
- IDoc Adapter (Integration Engine)
- HTTP Adapter
Adapter on Advanced Adapter Engine:
- IDoc Adapter (Advanced Adapter Engine)
- RNIF Adapter 2.0
- RNIF Adapter 1.1
- CIDX Adapter
- HTTP Adapter (Advanced Adapter Engine)
- SOAP Adapter with Message Protocol XI 3.0

Procedure

To specify the header mapping for an address field, perform the following steps:

If you are defining header mapping on dual-stack installation, specify Header Mapping details in the Receiver Agreement .
If you are defining header mapping on AEX installation, specify Header Mapping details in the Outbound Processing tab of the Integrated Configuration .
In the Header Mapping section, select the required field, such as Sender Communication Component ).
Enter the target value for the key field.

If you want to specify a fixed target value for parties or communication components, select the relevant party or communication component using input help ( F4 ).

If you want the parties or communication components to be determined dynamically from the message payload, follow the substeps below:
1. Select the arrow beside the input help icon.
2. Choose Advanced .
  
  The party editor or expression editor for communication components is opened.
3. To determine the party or the communication component dynamically, select the Dynamic radio button and enter a context object or an XPath expression.
  
  For more information, see:
  
  Using Party Editors
  
  Using the Expression Editor
Choose OK .

Example

If you want to replace the internal name of a sender business system in the outbound message with a neutral name of a party and communication component, specify the fields for Sender Communication Party and Sender Communication Component in the header mapping. You can also specify the Receiver Communication Party and Receiver Communication Component of the receiving business partner.