Show TOC

Define Header MappingsLocate this document in the navigation structure


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).

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


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

  • Adapters in the Integration Engine

    • XI adapter

    • IDoc adapter

    • HTTP Adapter

  • Adapters in the Advanced Adapter Engine

    • RNIF Adapter 2.0

    • RNIF Adapter 1.1

    • CIDX Adapter


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

  1. Select the relevant field under Header Mapping (for example, Sender Communication Component ).

  2. 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 ().

    If you want to define that parties or communication components be determined dynamically from the message payload, proceed as follows:

    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

  3. Choose Copy .


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 Party and Sender Communication Component in the header mapping.