Show TOC

Filtering of BAPI ParametersLocate this document in the navigation structure

Use

Parameter filtering enables you to manage the number of datasets to be replicated in the BAPI interface using filter objects in the ALE distribution model. The parameters filtered are BAPI table parameters. Any lines in the BAPI parameter that do not match the distribution conditions are filtered out. The filtered table lines are not replicated.

Example

The logical system Q4VCLNT800 is the BAPI server for the BAPI RetailMaterial.Clone. Through the parameter filtering only the plant data of the material plant 001 is to be replicated in this system.

Prerequisites

The prerequisite for this filtering is that a filter object type is 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 and assign your own filter object types (see Defining and Assigning Filter Object Types).

You have to define the valid filter object values in the distribution model. For more information, see the Implementation Guide (IMG) under Start of the navigation path SAP Web Application Server Next navigation step IDoc Interface / ALE Next navigation step Modelling and Implementing Business Processes Next navigation step Maintain Distribution Model End of the navigation path.

Presently, BAPI parameters can only be filtered for distributing master data via BAPIs called asynchronously. For this reason the required ALE Customizing for parameter filtering is only allowed for asynchronous BAPIs with an ALE IDoc interface.

Parameter filtering is allowed for distributing transaction data via asynchronous BAPIs but for the most cases, it has no purpose.

BAPI parameter filtering for asynchronous parameters is always optional. You need to explicitly activate it by selecting a checkbox when you generate the BAPI-IDoc interface. Otherwise no coding can be generated in the BAPI-IDoc interface.

If a BAPI-IDoc interface has been generated without parameter filtering, you can specify no parameter filtering in ALE Customizing afterwards.

Features

Parameters are filtered dynamically at runtime using the current data in the BAPI table parameters and the distribution conditions specified in the ALE distribution model:

  • Reads the specified parameter filter objects in the distribution model

  • Reads the interface definition of the BAPI

  • Reads the table field values of a table entry for the associated filter objects

  • Compares the distribution conditions with the filter objects read and determines the value of the logical expression

  • Deletes the table entry

  • Examines hierarchy-dependent BAPI parameters and, if applicable, deletes dependent table entries

  • For synchronous BAPIs: calls associated function module and passes the filtered parameters

  • For asynchronous BAPIs: calls the generated BAPI-ALE interface and passes the filtered parameters

BAPI parameter filtering can also take into account a hierarchical dependency between BAPI table parameters (see Defining Hierarchies Between BAPI Parameters). You must specify any hierarchical dependencies before you generate the BAPI-ALE interface of the BAPI. The specified hierarchy is evaluated when the interface is generated and incorporated in the interface coding. The BAPI-ALE interface must be regenerated following all subsequent changes made to the hierarchy.

Once the generated IDoc type has been released, the specified hierarchy of the asynchronous BAPI cannot subsequently be changed for compatibility reasons.