Entering content frameBackground documentation Filtering Data Locate the document in its SAP Library structure

There are two filtering services provided for asynchronous BAPI calls using the BAPI-ALE interface.

If you want to reduce the BAPI interface, you do not have to define any filter object types.

The BAPI reduction does not have any conditions - it is a projection of the BAPI interface.

The developer of the BAPI whose interface is to be reduced must create the BAPI as a reducible using appropriate parameter types.

The optional BAPI parameters and/or BAPI fields are deactivated in the distribution model for the data transfer.

You can reduce an interface in two ways, see Reducing Interfaces

Structure link Filter Object Types are assigned to the business object method. The valid filter object values must be defined in the distribution model.

The BAPI parameter filtering is linked to conditions, it is therefore content-dependent: The lines in table parameters of asynchronous BAPIs are determined depending on the values in the lines (or dependent lines) for the receiver.

Filters are used to define conditions in the form of parameter values that must be satisfied by BAPIs before they can be distributed in ALE outbound processing.

The table dataset of a BAPI is determined when the parameters are filtered.

Hierarchy relationships between table parameters of the BAPI can also be defined.

Distribution by Structure link Classes is also supported.

For more information see Filtering BAPI Parameters

BAPI filtering is the term used for the shared use of both the filter services of the BAPI interface. BAPI filtering is implemented as a service in ALE outbound processing.

Prerequisites for Using Filter Services

The table below lists the prerequisites that the BAPI interface must satisfy, so that ALE filter services can be used.

The BAPI can have the following parameter types:
 

Field Reduction

Full Filtering

Parameter Filtering

  1. Unstructured without checkbox
     

  • Unstructured with checkbox
    		•

    X

    		    

  • Single-line structured without checkbox
    		•      

  • Single-line structured with checkbox

    • X

    		    

  • Multiple-line structured without checkbox
    		•  

    X

    X

  • Multiple-line structured with checkbox

    • X

    X

    X

  • Multiple-line unstructured without checkbox
    		•  

    X

    		  

  • Multiple-line unstructured with checkbox
    		•      

    Note: The fields filled with X satisfy the prerequisites.

    Explanation of above table:

    1. An unstructured parameter without a checkbox is, for example, a BAPI key field (e.g. the parameter Material in methods of the business object Material).
      This parameter type cannot be reduced.
    2. If there is an unstructured checkbox parameter with the name PX and the data element BAPIUPDATE for an unstructured parameter with the name P, the parameter P is reducible.
      The parameter is reduced by setting the value of P and of the checkbox parameter PX to EMPTY.
    3. A single-line, structured parameter without a checkbox is not reducible.
    4. A single-line, structured parameter P with structure S and associated checkbox PX with structure SX can be reduced by fields, provided that:

    The FUNCTION field in P and the key fields must be marked as mandatory fields. All the other fields you can chose whether to label them as mandatory. Mandatory fields cannot be reduced. Non-mandatory fields are reduced by setting the field values and the corresponding checkbox to EMPTY.

    1. Multiple-line structured parameters (table parameters) without a checkbox cannot be reduced by fields. Parameter filtering and full filtering are possible.

      2. If the hierarchy is maintained and, if dependent tables exist in the hierarchy, records of the dependent tables will also be filtered.

    2. A multiple-line structured parameter P with checkbox PX can be reduced by fields, fully filtered or filtered by parameters.

    7. A multiple-line, unstructured parameter can only be fully filtered and cannot be used in a hierarchy.
    Parameter filtering is not allowed.

    8. Multiple-line, unstructured parameters with a checkbox cannot be filtered.

     

     

     

     

    Leaving content frame