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

Programmieren von GetDetail()-BAPIs

Verwendung

Das BAPI GetDetail() wird verwendet, um Detailinformationen zu bestimmten Objektinstanzen auszulesen.
Das BAPI GetDetail() ist eine Instanzmethode.

Funktionsumfang

Import-Parameter

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

Da das GetDetail()-BAPI eine Instanzmethode ist, müssen am Funktionsbaustein die Schlüsselfelder des zugehörigen Business-Objekttyps als Import-Parameter angelegt werden. 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.

Darüber hinaus können Sie weitere Import-Parameter anlegen, über welche der Umfang der angezeigten Details bestimmt werden kann.

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 GetDetail()-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:

Die Export-Parameter des BAPIs enthalten die Detailinformationen zu der Instanz. Je nach Umfang der Informationen sollten diese sinnvoll in mehrere Parameter mit aussagekräftigen Namen strukturiert werden.

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

Legen Sie den Export-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).

Siehe auch:

Beispiel für ein GetDetail()-BAPI