Start of Content Area

Background documentation BAPI/ALE Integration  Locate the document in its SAP Library structure

BAPIs are integrated into the ALE communication model. ALE communication is asynchronous and message-based. ALE communication is the preferred way to integrate distributed SAP Systems, for example, for distributing master data.

Since Release 4.0 BAPIs are the standardized interfaces for ALE-supported communication. ALE services, such as asynchronous BAPI calls, distribution model, monitoring and error handling can be used for BAPIs. The IDoc types required for the ALE services can be generated from BAPIs.

See also: Using the ALE Services

When you use BAPIs for asynchronous messaging, the application in the sending system calls the generated ALE IDoc interface instead of the BAPI. The ALE IDoc interface performs the following tasks:

You can use Transaction BDBG to create the other objects required for the asynchronous communication (message type, IDoc type, inbound and outbound function module).

See also: Maintaining the BAPI ALE Interface.

A BAPI should only be implemented as an asynchronous interface, if at least of the following conditions is satisfied:

BAPI/ALE integration requires that:

This graphic is explained in the accompanying text

Message types are created and IDoc types are generated for all write BAPIs.
See also: Maintaining BAPI ALE Interfaces.

This graphic is explained in the accompanying text

All IDoc types and the associated segments are released.

This graphic is explained in the accompanying text

The BAPI interface and the IDoc interface are identical. Make sure that the message type, IDoc type and segments are regenerated, particularly if the BAPI is changed.

Note

All BAPI export parameters with the exception of the return parameter are ignored and are not included in the IDoc type that is generated.

Note

SAP internal: If the BAPI serves integration purposes between the various SAP products, then the interface information must be made available to the relevant systems. To do this, the data structures that the BAPI uses (including the data elements and domains), and the ALE interface have to move to the application basis.

If the applications have restricted usability, you have to explicitly release the BAPI function module for cross-application use.

To do this, contact a member of the integration team.