Determining the Receiver of a BAPI
Use
How data is distributed by an object method can depend on the requirements specified in the distribution model (in the R/3 Implementation Guide). Basis ® Application Link Enabling (ALE) ® Modelling and Implementing Business Processes ® Maintain Distribution Mode).
The prerequisite for this filtering is that a filter object type has been assigned to the relevant BAPI in your SAP applications. For some BAPIs SAP has already defined and assigned filter object types. You can also define your own filter object types and assign them to a BAPI (
Defining Filter Object Types and Assigning Them to a BAPI.)The receiver must be determined before the BAPI of a generated BAPI-ALE interface is called. The receiver determination checks whether the filter objects satisfy the specified requirements and verifies the receivers.
In the ALE distribution model the following dependencies can be mapped:
These dependencies must be implemented by a function module on the application side.
In ALE Development the function module must be assigned to the relevant object type (via Dependencies ® Define function module for dependent business object).If a dependency is defined as a condition in the ALE distribution model, the receiver of the referenced BAPI or message type is determined.
Example of a BAPI dependency on a message type:
The distribution of organization addresses has been integrated in the object maintenance of the vendor. This address data is then distributed together with the object data using ALE. The address data is dependent on the object data and is distributed using BAPIs. The object data is distributed using the message type CREMAS.
So there is a dependency between a BAPI and a message type.
In the distribution model an active receiver filter is assigned to the BAPI to distribute organization addresses (AddressOrg.SaveReplica). The dependency has been activated using the attribute dependent distribution in the filter display.
Based on the receiver determination the object data with the BAPI address data is only distributed, if the filter conditions for CREMAS are fulfilled
ALE provides a range of function modules for receiver determination with the function group BDAPI.
Features
The function modules of the function group BDAPI are used for:
Function module |
Features |
ALE_BAPI_GET_FILTEROBJECTS |
Determining Filter Objects of a BAPI |
ALE_ASYNC_BAPI_GET_RECEIVER |
Determining Receivers of Asynchronous BAPIs |
ALE_SYNCH_BAPI_GET_RECEIVER |
Determining Receivers of Synchronous BAPIs |
ALE_BAPI_GET_UNIQUE_RECEIVER |
Determining Unique Receivers of Synchronous BAPIs |
The following examples programs for receiver determination are provided: