Funktionsbausteine aus Ihrem Coding aufrufen (SAP-Bibliothek - BC

Funktionsbausteine aus Ihrem Coding aufrufen

Mit folgender ABAP-Anweisung können Sie einen Funktionsbaustein aus einem ABAP-Programm heraus aufrufen:

CALL FUNCTION <funktionsbaustein>
[EXPORTING f₁ = a ₁.... f _n = a _n]
[IMPORTING f₁ = a ₁.... f _n = a _n]
[CHANGING f₁ = a ₁.... f _n = a _n]
[TABLES f₁ = a ₁.... f _n = a _n]
[EXCEPTIONS e₁ = r ₁.... e _n = r _n
[ERROR_MESSAGE = r_E]
[OTHERS = r_o]].

Der Name des Funktionsbausteins <funktionsbaustein> wird als Literal angegeben. Die Parameter werden übergegeben, indem die Aktualparameter den Formalparametern in der Liste nach den Optionen EXPORTING , IMPORTING , CHANGING oder TABLES explizit zugewiesen werden.

Die Zuweisungen haben die Form: <Formalparameter> = <Aktualparameter>
Finden mehrere solche Zuordnungen innerhalb einer Option statt, so werden sie nacheinander durch Leerzeichen (oder mit einem Zeilenumbruch) getrennt, aufgeführt.

Mit der Option EXPORTING geben Sie die Aktualparameter a _i an die Formal-eingabeparameter f _i weiter. Die Formalparameter müssen im Funktionsbaustein als Import-Parameter deklariert werden. Diese Parameter können einen beliebigen
Datentyp aufweisen. Bei angegebenem Bezugsfeld findet eine eine Überprüfung statt.

Mit der Option IMPORTING geben Sie dagegen die Formalausgabeparameter f _i des Funktionsbausteins an die Aktualparameter a _i weiter. Die Formalparameter müssen im Funktionsbaustein als Export-Parameter deklariert werden. Es sind beliebige Datentypen der Parameter möglich.

Mit der Option CHANGING geben Sie die Aktualparameter a _i an die Formalparameter f _i weiter. Nach der Verarbeitung des Funktionsbausteins gibt das System die (geänderten) Werte der Formalparameter f _i an die Aktualparameter a _i zurück. Die Formalparameter müssen im Funktionsbaustein als CHANGING-Parameter deklariert werden. Auch diese Parameter können einen beliebigen Datentyp aufweisen.

Mit der Option TABLES übertragen Sie interne Tabellen zwischen den Aktual- und den Formalparametern. Dabei erfolgt die Übertragung der internen Tabellen stets über Referenz. Die Parmeter dieser Option müssen auf interne Tabellen verweisen.

Mit der Option EXCEPTIONS wird die Behandlung von Ausnahmen ermöglicht. Ausnahmen sind als spezielle Parameter dafür vorgesehen, um auf mögliche Fehlerereignisse während der Abarbeitung des Funktionsbausteins zu reagieren. Die Ausführung des Funktionsbausteins wird in solchen Fällen unterbrochen. Wird also konkret eine Ausnahme e _i ausgelöst, unterbricht das System die Abarbeitung des Funktionsbausteins und gibt keine Werte vom Funktionsbaustein an das Programm weiter. Das aufrufende Programm nimmt die Ausnahme e _i entgegen durch Zuweisung des Wertes r _i an das Systemfeld SY-SUBRC, der als Rückgabecode fungiert. Dabei muß r _i als Zahlenliteral angegeben werden. Im aufrufenden Programm kann dann eine weitere Auswertung des Systemfeldes vorgenommen werden.

Durch die Angabe von ERROR_MESSAGE in der EXCEPTION-Liste können Sie die Ausnahmenbehandlung in Funktionsbausteinen beinflussen. Normalerweise sollten Nachrichten in Funktionsbausteinen nur über die Ausnahmebehandlung (mit Hilfe der Anweisungen MESSAGE....RAISING oder mit RAISE innerhalb des Funktionsbausteins) aufgerufen werden. Mehr dazu erfahren Sie unter Überblick über das Coding von Funktionsbausteinen

Mit ERROR_MESSAGE bewirken Sie, daß das System Nachrichten, die im Funktionsbaustein ausnahmsweise ohne diese explizite Behandlung aufgerufen werden, wie folgt behandelt:

Nachrichten der Klassen S, I, und W werden ignoriert (bei Hintergrund-verarbeitung im Protokoll vermerkt).

Nachrichten der Klassen E und A beenden die Ausführung des Funktions-bausteins als ob die Ausnahme ERROR_MESSAGE ausgelöst wurde (SY-SUBRC wird auf r _E gesetzt).

Wenn Sie OTHERS in der EXCEPTION-Liste angeben, können Sie auch alle
Ausnahmen berücksichtigen, die nicht ausdrücklich in der Liste aufgeführt werden. Diese fungiert dann als Standardausnahme.

Für unterschiedliche Ausnahmen kann die gleiche Zahl r _i verwendet werden, sofern eine weitere Spezifizierung der Ausnahme nicht verlangt wird.

Um einen Funktionsbaustein in Ihrem Coding aufzurufen, können Sie die Funktion Muster im ABAP-Editor verwenden. Führen Sie dazu folgende Arbeitsschritte durch:

Stellen Sie den Cursor an die Stelle in Ihrem Coding, wo die Funktion aufgerufen werden soll.
Wählen Sie die Funktion Muster.
Auf dem erscheinenden Dialogfenster markieren Sie das Auswahlfeld vor CALL

FUNCTION.

Geben Sie in dem Eingabefeld den Namen des Funktionsbausteins ein.

Sofern Sie den Namen nicht kennen, können Sie die Werthilfetaste zur Suche benutzen.

Wählen Sie die Funktion Weiter.

In Ihrem Coding wird der Funktionsbaustein mit der Schnittstelle eingefügt.

Pflegen Sie die entsrechenden Parameter und behandeln Sie die Ausnahmen.

In unserem Bespiel wird der der Funktionsbaustein in folgender Form wiedergegeben:

Sofern Sie Information zu dem Funktionsbaustein benötigen, können Sie diese über die Informationsikone abrufen. Es erscheint das Dialogfenster Hilfe, auf dem Sie den Auswahlknopf Funktionsbaustein markieren und den Namen des Funktionsbausteins eintragen. Wählen Sie dann Weiter.
Sie verzweigen in die Schnittstellendefinition des Funktionsbausteins und können von dort aus zu den anderen Elementen des Funktionsbausteins navigieren.

Die nicht als Kommentar gekennzeichneten Parameter müssen auf jeden Fall von Ihrem Programm mit Werten versorgt werden. Sie können dazu Festwerte oder Parameter benutzen.

Die Importschnittstelle ist immer als Kommentar gekennzeichnet. In Ihrem Coding sollten Sie den Stern (*) vor IMPORTING löschen und die für Sie interessanten Daten des Funktionsbausteins an Variablen übergeben.

Die Anweisung CALL FUNCTION kann auch mit anderen Parametern verwendet werden, wenn die Funktion in einer Verbuchungstask oder auf Remote-Maschinen ablaufen soll.

Wenn ein Funktionsbaustein in einer Verbuchungstask läuft, verarbeitet das System den Baustein asynchron. Der Aufruf wird dann nicht sofort durchgeführt. Stattdessen wartet das System bis die nächste Aktualisierung der Datenbank mit dem Befehl COMMIT WORK angestoßen wird. Einen Funktionsbaustein auf einer Remote-Maschine ablaufen zu lassen, bedeutet, daß eine Funktion eines anderen SAP-Systems oder Fremdsystems aufgerufen wird.

Weitere Informationen darüber, wie Sie Funktionsbausteine aus Ihren Programmen aufrufen, finden Sie unter Funktionsbausteine im ABAP/4-Benutzerhandbuch.