Executing Integrated Configuration 

Use

Using Integrated Configuration you can specify the complete configuration settings for the clear exchange of a message in one single object. This object replaces the 'classic' configuration objects (sender agreement, receiver determination, interface determination, and receiver agreements).

The Integrated Configuration supports elementary communication scenarios for which the message receiver is already defined at the time of configuration and whose message processing only requires a simple mapping (multiplicity 1:1).

You cannot configure additional communication scenarios that contain, for example payload-based routing or a message split, with Integrated Configuration. You must define separate receiver determinations, interface determinations, and communication agreements to configure communication scenarios of this type.

You can only use Integrated Configuration to set up communication scenarios where the message is only to be transferred within an Adapter Engine from a sender to a receiver adapter.

More information: Advanced Adapter Engine

Integrated Configuration is not supported when using communication channels with the following adapter types:

-          IDoc

-          XI

-          HTTP

-          RNIF

-          CIDX

-          WS

Procedure

1. Specifying Integrated Configuration

To specify an Integrated Configuration, you must first define a sender. Specification of a receiver is optional. Follow these steps.

...

       1.      Call the Integration Builder.

       2.      ChooseNew.

       3.      Choose Communication Agreement → Integrated Configuration in the create dialog.

       4.      Specify the communication party (optional), the communication components and the interface for the sender.

       5.      Optional: Specify the communication party and communication component for the receiver. Select Sender Uses Virtual Receiver to show these fields.

       6.      You can optionally specify a description and assign the overall configuration to a configuration scenario.

       7.      Choose Create.

2. Defining Inbound Processing

You perform the following steps to configure the inbound processing of the message.

...

       1.      Choose the Inbound Processing tab.

       2.      Choose the communication channel.

Only the sender communication channels that are assigned to the communication component and which correspond to a supported adapter type are offered.

       3.      Specify whether XML validation must be executed.

More information: XML Validation

       4.      Enter the rest of the settings for the inbound processing. Note that the settings that are available depend on the adapter type chosen.

If you have assigned a sender RFC channel to the Integrated Configuration, you can, for example, specify whether user identities are to be sent from the sender to the receiver (principal propagation).

For more information on the possible settings, see Define Sender Agreement.

3. Specify Receiver and Mapping

Follow these steps to specify the receiver interface, receiver component, and, if necessary, a mapping.

...

       1.      Choose the Receiver Interfaces tab.

       2.      Under Receiver choose a receiver for the message (partner/communication component).

To do so, call input help ().

       3.      Under Receiver Interfaces and Mappings specify a receiver interface for each outbound interface operation (Name and Namespace fields).

Only interfaces that are defined for the receiver component are offered in the input help.

       4.      Additionally, you can specify an operation mapping for each receiver interface (Operation Mapping field).

4. Defining Outbound Processing

You perform the following steps to configure the outbound processing of the message.

Outbound Interface Contains One Operation

...

       1.      Choose the Outbound Processing tab.

       2.      Choose a communication channel.

Only receiver communication channels that fulfill the following criteria are offered in the input help:

○       Communication channels are assigned to receiver communication component.

○       Communication channels correspond to one of the supported adapter types.

For the outbound processing, you can only activate Integrated Configuration if you specify a communication channel that runs on the same Adapter Engine as the communication channel specified for inbound processing.

       3.      You can also, optionally, specify a header mapping.

More information: Defining Header Mappings

...

Outbound Interface Contains More Than One Operation

If the outbound interface contains more than one operation, follow these steps:

       1.      Under Assigned Receiver Interfaces, choose the operation with the receiver interface.

       2.      Under Configuration for Interface <Name of Chosen Receiver Interface> specify the communication channel and, if necessary, further configuration settings (header mapping).

5. Specify Authorized Service User

If you want to restrict the access to the runtime to particular service users for a sender communication component, you can refine these restrictions with respect to the outbound interface. Assign the authorized users to the Integrated Configuration that contains the communication component and the interface in the object key. Choose the Assigned User tab page.

More information: Defining a Sender Collaboration