SAP bietet diverse Hilfsfunktionen in Form von Service-BAPIs an, die die Programmierung von Dialoganwendungen unterstützen.

In einer Dialoganwendung können Sie bei Bedarf von folgenden Hilfsfunktionen Gebrauch machen. Die entsprechenden BAPIs sind in der Anwendungskomponentenhierarchie des BORs unter Basis ® Middleware angelegt:

Jede Dialogtransaktion, die mit Hilfe von BAPIs die Daten eines oder mehrerer Objekte verändert, muß zum Festschreiben der Daten explizit das "COMMIT WORK"-Kommando ausführen. Hierfür steht das BAPI BapiService.TransactionCommit() zur Verfügung, mit dem Änderungen auf die Datenbank geschrieben werden.

Sollen Daten allerdings nicht auf die Datenbank geschrieben werden, können diese mit dem BAPI BapiService.TransactionRollback() zurückgesetzt werden. Voraussetzung hierfür ist jedoch, daß diese Änderungen nicht bereits mit dem BAPI BapiService.TransactionCommit() an die Datenbank übergeben wurden.

Um in einer Anwendung die Wertehilfe (F4-Hilfe) für ein Eingabefeld bereitzustellen, das im Aufruf eines BAPIs übergeben wird, können Sie in Ihr Programm das Service-BAPI HelpValues.GetList() integrieren. Dieses BAPI liefert die zulässigen Eingabewerte zu einem Feld in einem BAPI-Parameter.

Um in Ihrer Anwendung die Eingabehilfe (F1- oder Feldhilfe) zu Eingabefeldern bereitzustellen, können Sie das BAPI BapiService.FieldHelpGetDocu() verwenden. Diese Methode liest die Dokumentation (F1-Hilfe) zu den entsprechenden Feldern eines BAPI-Parameters.

Jedes BAPI enthält einen Parameter mit dem Namen Return, mit dem Nachrichten über Ausnahmesituationen oder Erfolgsmeldungen an ein aufrufendes Programm zurückgemeldet werden.

Für eine tiefgreifendere Diagnose und Behandlung von Fehlermeldungen aus BAPI-Aufrufen stehen zwei Service-BAPIs zur Verfügung:

• BapiService.MessageGetDetail(), mit dem die Kurz- und Langtexte zu den Fehlermeldungen eines BAPIs ausgelesen werden können.
• BapiService.ApplicationLogGetDetail(), mit dem Informationen zu Einträgen im Anwendungs-Log ausgelesen werden können.

Weitere Informationen zu diesen BAPIs finden Sie in der entsprechenden BAPI-Dokumentation im Business Object Repository.