Anfang des Inhaltsbereichs

Hintergrunddokumentation Daten filtern  Dokument im Navigationsbaum lokalisieren

Für die asynchronen BAPI-Aufrufe über die BAPI-ALE-Schnittstelle stehen Ihnen zwei Filterdienste zur Verfügung:

Wenn Sie die BAPI-Schnittstelle reduzieren, müssen Sie keine Filterobjekttypen definieren.

Die BAPI-Reduzierung ist bedingungslos, d.h. es handelt sich um eine Projektion der BAPI-Schnittstelle.

Das BAPI, dessen Schnittstelle reduziert werden können soll, muß vom BAPI-Entwickler über entsprechende Parameterarten als reduzierbar angelegt werden.

Dabei werden optionale BAPI-Parameter und/oder -Felder über das Verteilungsmodell für die Datenübermittlung ausgeschaltet.

Sie können auf zwei Arten eine Schnittstelle reduzieren:

Dazu werden der Business-Objektmethode einer Verbindung Filterobjekttypen zugeordnet. Die zulässigen Filterobjektwerte müssen im Verteilungsmodell definiert werden.

Die BAPI-Parameterfilterung ist an Bedingungen geknüpft, also inhaltsabhängig: Zeilen in Tabellenparametern eines asynchron aufgerufenen BAPIs werden abhängig von Werten in den Zeilen (oder abhängiger Zeilen) zum Empfänger übermittelt.

Mit Filtern definieren Sie Bedingungen in Form von Parameterwerten, die von BAPIs erfüllt werden müssen, um von der ALE-Ausgangsverarbeitung verteilt zu werden.

Bei der Parameterfilterung wird die Datenmenge der Tabellen eines BAPIs bestimmt.

Zwischen den Parametern der Tabellen eines BAPIs können auch Hierarchiebeziehungen definiert werden..

Eine Verteilung über Klassen wird ebenfalls unterstützt.

Einzelheiten finden Sie unter BAPI-Parameter filtern.

BAPI-Filterung ist der Begriff für die (wahlweise) gemeinsame Verwendung der beiden Filterdienste der BAPI-Schnittstelle. Eine BAPI-Filterung wird nur als Service in der Ausgangsverarbeitung realisiert.

Voraussetzungen für die Verwendung der Filterdienste

Nachfolgend sind die Voraussetzungen aufgeführt, die von der BAPI-Schnittstelle erfüllt sein müssen, damit die ALE-Filterdienste verwendet werden können.

Das BAPI kann folgende Parameterarten haben:
 

Feldweise Reduzierung

Vollständige Filterung

Parameterfilterung

  1. Unstrukturiert ohne Ankreuzleiste.
      

  • Unstrukturiert mit Ankreuzfeld.
    		•

    X

    		    

  • Einzeilig strukturiert ohne Ankreuzleiste.
    		•       

  • Einzeilig strukturiert mit Ankreuzleiste.
    		•

    X

    		    

  • Mehrzeilig strukturiert ohne Ankreuzleiste.
    		•   

    X

    X

  • Mehrzeilig strukturiert mit Ankreuzleiste.
    		•

    X

    X

    X

  • Mehrzeilig unstrukturiert ohne Ankreuzleiste.
    		•   

    X

    		  

  • Mehrzeilig unstrukturiert mit Ankreuzleiste.
    		•      

    Anmerkung: Die mit X versehenen Felder erfüllen die Voraussetzungen.

    Erläuterung zur obigen Matrix:

    1. Ein unstrukturierter Parameter ohne Ankreuzleiste ist z.B. ein Schlüsselfeld des BAPIs (z.B. der Parameter Material in Methoden zum Business Objekt Material).
      Diese Parameterart kann nicht reduziert werden.
    2. Gibt es zu einem unstrukturierten Parameter mit Namen P einen unstrukturierten Ankreuzparameter mit Namen PX und Datenelement BAPIUPDATE, so ist der Parameter P reduzierbar.
      Die Reduzierung erfolgt durch Setzen des Wertes von P und des Ankreuzparameters PX auf LEER.
    3. Ein einzeiliger, strukturierter Parameter ohne Ankreuzleiste ist nicht reduzierbar.
    4. Ein einzeiliger, strukturierter Parameter P mit Struktur S und zugehöriger Ankreuzleiste PX mit Struktur SX ist feldweise reduzierbar, wenn folgendes zutrifftt:

    Das FUNCTION Feld in P, sowie die Schlüsselfelder müssen als Mußfelder gekennzeichnet werden. Alle anderen Felder können wahlweise als Mußfelder gekennzeichnet werden. Mußfelder sind nicht reduzierbar. Die Reduzierung für nicht-Mußfelder erfolgt durch Setzen des Feldwertes und des korrespondierenden Ankreuzfeldes auf LEER.

    1. Mehrzeilig strukturierte Parameter (Tabellenparameter) ohne Ankreuzleiste sind nicht feldweise reduzierbar. Parameterfilterung und vollständige Filterung sind möglich.

      2. Ist die Hierarchie gepflegt und existieren in der Hierarchie abhängige Tabellen, so werden Sätze der abhängigen Tabellen mitgefiltert.

    2. Ein mehrzeiliger, strukturierter Parameter P mit Ankreuzleiste PX ist feldweise reduzierbar, vollständig filterbar und Parameterfilterung ist möglich.

    7. Ein mehrzeiliger, unstrukturierter Parameter kann nur vollständig gefiltert werden und darf nicht in eine Hierarchie aufgenommen werden.
    Parameterfilterung ist nicht erlaubt.

    8. Für einen mehrzeiligen, unstrukturierten Parameter mit Ankreuzleiste kann keine Filterung durchgeführt werden.

     

     

     

    Ende des Inhaltsbereichs