Programmieren von ExistenceCheck()-BAPIs (SAP-Bibliothek - Referenz zum BAPI-Programmierleitfaden (CA-BFA))

Programmieren von ExistenceCheck()-BAPIs

Verwendung

Mit dem BAPI ExistenceCheck() wird geprüft, ob zu einem SAP-Business-Objekttyp ein Eintrag in der Datenbank existiert, beispielsweise ob der Kundenstamm angelegt ist.

Es kann sinnvoll sein, gleichzeitig auch die Existenz von Teilobjekten zu prüfen, beispielsweise ob für einen Kunden Informationen innerhalb eines bestimmten Buchungskreises vorhanden sind.

Das BAPI ExistenceCheck() ist eine Instanzmethode.

Funktionsumfang

Sie können diese Methode als BAPI und/oder als Methode des SAP Business Workflows implementieren. Wenn Sie diese Methode als BAPI realisieren, ist nur eine Implementierung nötig, da ein ExistenceCheck()-BAPI auch vom SAP Business Workflow verwendet werden kann.

Um eine höchstmögliche Perfomance des BAPIs ExistenceCheck() zu erzielen, sollten Sie vor dem Selektieren der Tabellenzeilen möglichst viele Spalten einschränken, z.B verwenden Sie:

select single bukrs from bkpf into lv_bukrs

where bukrs = bkpf-bukrs

and belnr = bkpf-belnr

and gjahr = bkpf-gjahr.

anstelle von

select single * from bkpf

where bukrs = bkpf-bukrs

and belnr = bkpf-belnr

and gjahr = bkpf-gjahr.

Import-Parameter

Bei der Festlegung der Import-Parameter sind folgende Aspekte zu beachten:

Das BAPI enthält als Import-Parameter im Funktionsbaustein nur die Schlüsselfelder des zugehörigen Business-Objekttyps. Dabei müssen die Namen dieser Parameter mit den Namen der Objektschlüssel im BOR übereinstimmen und die gleichen Datenelemente besitzen.

Bei der entsprechenden Methodendefinition im BOR dürfen die Schlüsselfelder jedoch nicht zusätzlich als Methodenparameter aufgeführt werden. Aus diesem Grund nimmt der BOR/BAPI-Wizard beim Anlegen eines BAPIs die Funktionsbaustein-Parameter für die Schlüsselfelder nicht in die Methodendefinition auf.

Möchten Sie gleichzeitig die Existenz von Teilobjekten prüfen, legen Sie weitere, optionale Parameter an.
Beispiele:

- Mit einem Parameter CompanyCode im BAPI Customer.ExistenceCheck() kann das Vorhandensein einer bestimmten Buchungskreissicht des Kunden mitgeprüft werden.

- Mit dem Parameter Items im BAPI SalesOrder.ExistenceCheck() kann geprüft werden, ob es mindestens eine Position zu diesem Kundenauftrag gibt.

Soll einem Kunden die Möglichkeit gegeben werden, die Import-Parameter des BAPIs modifikationsfrei zu erweitern, so ist der Parameter ExtensionIn anzulegen.
Informationen zu Extension-Parametern und Empfehlungen, wie das Kundenerweiterungskonzept in einem ExistenceCheck()-BAPI realisiert werden sollte, finden Sie unter Kundenerweiterung und -modifikation von BAPIs.

Export-Parameter

Bei der Festlegung der Export-Parameter sind folgende Aspekte zu beachten:

Legen Sie als Export-Parameter nur den Parameter Return an, um Meldungen aus dem Methodenaufruf an das aufrufende Programm zurückzugeben. Insbesondere im Fehlerfall müssen Meldungen zurückgegeben werden, die den Fehler konkret beschreiben. Deshalb sollte der volle Funktionsumfang des Typs BAPIRET2 Verwendung finden. Insbesondere sollten die Felder Parameter, Row und Field gefüllt werden.
Informationen zu diesem Parameter finden Sie unter Return-Parameter (Fehlerdarstellung).

Aktivitäten

Wenn ein Business-Objekttyp angelegt wird, erbt dieser standardmäßig über das Interface IFSAP eine Definition der Methode ExistenceCheck(). Aus diesem Grund ist es nicht möglich, ein BAPI ExistenceCheck() über den BOR/BAPI-Wizard anzulegen, da der Methodenname ExistenceCheck() an dem Business-Objekttyp bereits existiert.

Es wird deshalb empfohlen, die bereits existierende Methode ExistenceCheck() über die Menüfunktion Bearbeiten ® Überdefinieren manuell im BOR neu zu definieren, indem Sie:

den Funktionsbaustein eintragen, der das ExistenceCheck()-BAPI implementiert
den Parameter Return als Methoden-Parameter anlegen (die Schlüsselfelder des Business-Objekttyps werden nicht in die Methodendefinition im BOR aufgenommen).

Siehe auch:

Beispiel für ein ExistenceCheck()-BAPI