Service-BAPIs für Hilfsfunktionen 

Verwendung

Eine Reihe von Service-BAPIs steht für grundlegende Hilfsfunktionen zur Verfügung. Die Service-BAPIs stellen Informationen oder Dienste für die BAPIs aus den einzelnen Anwendungskomponenten bereit.

In der Anwendungskomponentenhierarchie des BORs sind die Service-BAPIs unter Basis ® Middleware angelegt.

Detaillierte Informationen zu den einzelnen Service-BAPIs finden Sie in der Dokumentation, die im BOR mit dem entsprechenden BAPI angelegt ist.

Funktionsumfang

BAPIs für den Zugriff auf die Schnittstellendokumentation

Mit Hilfe der folgenden Service-BAPIs können Sie auf die Dokumentation und Beschreibungen einer BAPI-Schnittstelle zugreifen:

Diese Methode ermittelt die zulässigen Eingabewerte (F4-Hilfe) zu einem Feld in einem BAPI-Parameter. Mit dieser Methode können Sie Endanwendern die gültigen Eingabewerte zu einem bestimmten Feld eines BAPI-Parameters anbieten und ihnen somit ermöglichen, in einem Eingabefeld eine korrekte Angabe zu machen.

Diese Methode liest die Dokumentation (F1-Hilfe) zu den Feldern eines BAPI-Parameters. Sie ermöglicht Ihnen, Endanwendern die Beschreibungen zu den Feldern eines BAPI-Parameters bereitzustellen.

Diese Methode liest die gesamte Schnittstellendokumentation zu einem BAPI. Mit dieser Methode können Sie auf die Dokumentation zum Business-Objekttyp, zur Methode, zu den Parametern und den Parameterfeldern zugreifen.

Diese Methode liest die Dokumentation zu R/3-Objekten, die über Hyperlinks in ein Dokument eingebunden sind, das mit der Methode BapiService.InterfaceGetDocu() bzw. der Methode BapiService.HyperLinkGetText() selbst erstellt wurde.

 

BAPIs zur Interpretation von Fehlermeldungen

Folgende BAPIs helfen bei der Interpretation der Fehlermeldungen eines BAPIs:

Diese Methode gibt die Kurz- und Langtexte zu den Fehlermeldungen eines BAPIs zurück.

Diese Methode liest die Informationen zu Einträgen im Anwendungs-Log.

BAPIs zur Commit- und Rollbacksteuerung

Das Transaktionsmodell (siehe Transaktionsmodell für die BAPI-Entwicklung) schreibt vor, daß jedes BAPI, mit dem Objektinstanzen erstellt oder die Daten eines Objekts verändert werden, für die Konsistenz der Datenbank verantwortlich ist.

Die Kommandos, mit denen Änderungen auf der Datenbank festgeschrieben oder potentielle Änderungen zurückgesetzt werden (COMMIT und ROLLBACK), dürfen jedoch nicht vom BAPI selbst ausgeführt werden, sondern müssen explizit vom externen Anwendungsprogramm aufgerufen werden.

Für diese Aufrufe stehen dem externen Programm folgende Service-BAPIs zur Verfügung:

Diese Methode führt ein COMMIT WORK-Kommando durch. Wenn Sie in Ihrem Programm BAPIs aufrufen, die Daten im R/3-System verändern sollen, müssen Sie anschließend diese Methode aufrufen, um die Änderungen an die Datenbank zu übergeben.

Diese Methode führt ein ROLLBACK WORK-Kommando durch. Wenn Sie in Ihrem Programm BAPIs aufrufen, die Daten im R/3-System verändern, können Sie mit dieser Methode verhindern, daß diese Änderungen auf die Datenbank geschrieben werden. Voraussetzung hierfür ist jedoch, daß die Änderungen nicht bereits mit dem BAPI BapiService.TransactionCommit() an die Datenbank übergeben wurden.

BAPIs zur Konvertierung zwischen interner und externer Datendarstellung (Domänenkonvertierung)

BAPIs sind keine Endanwenderschnittstellen sondern Programmierschnittstellen. Aus diesem Grund muß in BAPIs - mit einigen Ausnahmen - eine neutrale Datendarstellung verwendet werden. Felder in BAPI-Parametern werden somit nicht in einer aufbereiteten Form an der BAPI-Schnittstelle präsentiert oder erwartet, sondern in der internen Form, die in der Datenbank verwendet wird.

Wenn Sie im Rahmen Ihres Programmes ein BAPI aufrufen, benötigen Sie ggf. die externe Datendarstellung, zum Beispiel um Daten am Bildschirm darzustellen. Sie können folgende Konvertierungs-BAPIs verwenden, um die jeweils erforderliche Datendarstellung zu erhalten:

Mit diesem BAPI kann von der internen Datendarstellung in die benötigte externe Datendarstellung konvertiert werden.

Mit diesem BAPI kann von der externen Datendarstellung in die benötigte interne Datendarstellung konvertiert werden.

Diese Konvertierungen sind jedoch nur dann möglich, wenn im ABAP Dictionary zu den Domänen, die den zu konvertierenden Daten zugrundeliegen, Konvertierungsroutinen gepflegt sind. Andernfalls wird der zu konvertierende Wert unverändert zurückgegeben.

Folgende Abbildung veranschaulicht, wo Konvertierung-BAPIs eingesetzt werden.

Konvertierungs-BAPIs