Überblick über das Coding von Funktionsbausteinen (SAP-Bibliothek

Überblick über das Coding von Funktionsbausteinen

Das System legt die Organisation der Objekte einer Funktionsgruppe und seiner Funktionsbausteine vorab fest. Wenn Sie eine Funktionsgruppe anlegen, erzeugt die Workbench automatisch ein Rahmenprogramm, globale Daten und einen Quelltext. Das System benennt das Rahmenprogramm in der Form SAPL<fgrp>. Die Variable <fgrp> steht für den Namen der Funktionsgruppe.

Die Workbench legt für jeden Funktionsbaustein einer Funktionsgruppe automatisch ein Include-Programm an, und zwar in der Reihenfolge, in der sie hinzugefügt werden. Sie können dieses Include-Programm anzeigen, indem Sie auf dem Einstiegsbild des Function Builders Quelltext markieren. Das System benennt das Include-Programm in der Form L<fgrp>U<nn>. Im Include-Programm der Funktionsgruppe FGRP beispielsweise liegt der erste Funktionsbaustein im Include LFGRPU01. Die folgenden Bausteine finden sich in den Include-Programmen LFGRPU02, LFGRPU03, LFGRPU04 usw.

Hauptfunktionsprogramm

Das Hauptfunktionsprogramm einer Funktionsgruppe wird vom Function Builder in einem Include L<funktgrp>UXX generiert, der nur vom Function Builder selbst bearbeitet werden darf. Für die Funktionsgruppe FGRP beispielsweise würde das Hauptfunktionsprogramm LFGRPUXX heißen.

Funktionsbausteine programmieren

Ist die Schnittstelle des Funktionsbausteins festgelegt, so kann mit der Programmierung des Funktionsbausteins begonnen werden.

Auf dem Einstiegsbild des Function Builders markieren Sie Auswahlknopf Quelltext. Damit verzweigen Sie in den ABAP-Editor, in dem Sie Ihre Anweisungen zwischen FUNCTION und ENDFUNCTION einfügen.
Die definierten Parameter und Ausnahmen erscheinen als Kommentare am Anfang des Quelltextes:

Diese Grafik wird im zugehörigen Text erklärt

Einige Besonderheiten der Programmierung von Funktionsbausteinen:

Datenbehandlung in Funktionsbausteinen

Export- und Importparameter werden nicht im Quelltext des Funktionsbausteins deklariert. Das System übernimmt diese Aufgabe und verwendet dazu ein INCLUDE-Programm, das eine Liste der definierten Parameter als Kommentarzeilen in den Quelltext einfügt.

Lokale Datentypen und Objekte können Sie in Funktionsbausteinen genauso wie in Unterprogrammen deklarieren.

Sie können Datendeklarationen mit den Anweisungen TYPES und DATA in L<fgrp>TOP schreiben. Diese Daten sind dann global für alle Funktionsbausteine einer Gruppe. Das System erstellt die Daten, sobald der erste Funktionsbaustein aufgerufen wird, und speichert immer die Werte des zuletzt aufgerufenen Funktionsbausteins.

Unterprogramme von Funktionsbausteinen aus aufrufen

Sie können verschiedene Unterprogramme von Funktionsbausteinen aus aufrufen.

Sie können das Programm-Coding interner Unterprogramme eines Funktions-bausteins direkt hinter die Anweisung ENDFUNCTION schreiben. Diese Unterprogramme können zwar auch von allen Funktionsbausteinen der Gruppe aus aufgerufen werden. Empfehlenswert ist es jedoch sie nur von dem Funktionsbaustein aus aufzurufen, in den Sie die Unterprogramme eingefügt haben. Dadurch wird eine bessere Übersichtlichkeit gewährleistet.

Möchten Sie interne Unterprogramme erstellen, die von allen Funktionsbausteinen der Funktionsgruppe <fgrp> aus aufgerufen werden können, verwenden Sie spezielle INCLUDE-Programme L<fgrp>F<XX>.

Sie können beliebige externe Unterprogramme aufrufen.

Ausnahmen auslösen

Innerhalb eines Funktionsbausteins sind alle Ausnahmen durch ihre definierten Bezeichner verfügbar. Die Ausnahmen können vom System oder vom aufrufenden Programm behandelt wird. Darüber entscheiden Sie erst beim Funktionsaufruf, etwa durch Zuweisung eines numerischen Wertes an die entsprechenden Ausnahmen. Näheres finden Sie dazu unter Funktionsbausteine aus Ihrem Coding aufrufen

Ausnahmen müssen innerhalb eines Funktionsbausteins explizit ausgelöst werden.
ABAP bietet dazu zwei Anweisungen, die ausschließlich in Funktionsbausteinen verwendet werden können:

Syntax

RAISE <Ausnahme>.
MESSAGE..... RAISING <Ausnahme>.

Die Wirkung dieser Anweisungen hängt davon ab, ob die Ausnahme vom aufrufenden Programm oder vom System verarbeitet wird.

falls die RAISE-Anweisung die Ausnahme auslöst und das aufrufende Programm die Verarbeitung der Ausnahme aufnimmt, so wird die Ausführung des Funktionsbausteins beedet und der numerische Wert, der dieser Ausnahme beim Aufruf zugewiesen wurde, ins Systemfeld SY-SUBRC gestellt. Eine weitere Auswertung erflogt dann im aufrufenden Programm.

Wird aber die Ausnahme nicht vom aufrufenden Programm behandelt, erzeugt das System einen Laufzeitfehler.

Mit der Anweisung MESSAGE..... RAISING verläuft die Verarbeitung analog, falls eine Behandlung im aufrufenden Programm vorgesehen ist. Im entgegengesetzten Fall reagiert das System nicht mit einem Laufzeitfehler, sondern setzt die Verarbeitung fort und sendet eine duch Nachrichtentyp definierte Nachricht. Dazu müssen Sie die MESSAGE-ID in der ersten Anweisung des INCLUDE-Programms L<fgrp>TOP angeben. Die Anweisung MESSAGE..... RAISING trägt zudem noch Werte in die folgenden Systemfelder ein.

SY-MSGID (Meldungskennung)

SY-MSGTY (Meldungstyp)

SY-MSGNO (Meldungsnummer)

SY-MSGV1 bis SY-MSGV4 (Inhalt der Felder <f1> bis <f4>, die in die Meldung eingeschlossen sind).

Für weitere Information lesen Sie auch die Schlüsselwortdokumentation zu MESSAGE).

Um das Vorgehen zu veranschaulichen, geben wir das folgende Beipiel an:

Beispiel

In diesem Beispiel verwenden wir den folgenden Funktionsbaustein:

Diese Grafik wird im zugehörigen Text erklärt

Wenn N1 nicht gleich Null ist, wird Z1 durch N1 dividiert. Andernfalls wird die Ausnahme DIV_ZERO ausgelöst.

Beispiel: Das Programm MDTEST ruft die Funktion MY_DIVIDE auf:

Diese Grafik wird im zugehörigen Text erklärt

Nach dem Start des Programms MDTEST sieht die Ausgabe so aus:

Result = 1,500000

Wenn Sie in der EXPORTING-Liste N1 = 4 durch N1 = 0 ersetzen, verarbeitet das Programm MDTEST die Ausnahme DIV_ZERO, indem es SY-SUBRC den Wert 1 zuweist. Dadurch entsteht folgende Ausgabe:

Division by zero