BSP-Elemente definieren (SAP-Bibliothek - Applikationsentwicklung auf AS ABAP)

BSP-Elemente definieren

Verwendung

Zu einer BSP-Extension legen Sie einzelne Elemente an, die später auf BSP-Seiten als Tags eingefügt werden. Zu jedem BSP-Element ist eine Handler-Klasse zugeordnet, die seine spezifische Funktionalität implementiert. Ferner können Sie Attribute zu jedem BSP-Element anlegen und deklarieren.

Voraussetzungen

Die BSP-Extension existiert bereits.

Vorgehensweise

BSP-Element anlegen

Wählen Sie die gewünschte BSP-Extension aus der Objektliste aus.

Wählen Sie die Funktion Anlegen → BSP-Element aus dem Kontextmenü.

Das Dialogfenster BSP-Element anlegen wird angezeigt.

Geben Sie den Namen des BSP-Elements, einen gültigen Namen für die Elementhandler-Klasse und eine aussagekräftige Beschreibung für die BSP-Extension als Kurztext ein.

Empfehlung

Als Elementhandler-Klasse können Sie eine bereits existierende gültige ABAP-Klasse angeben. Eine gültige Klasse muß das Interface IF_BSP_ELEMENT unterstützen.

Es empfiehlt sich aber, diese Klasse von der automatisch generierten Basisklasse (Z)CLG_<Name der BSP-Extension>_<Name des BSP-Elements> abzuleiten. Diese Basisklasse enthält bereits eine Standard-Implementierung der Interface-Methoden und wird bei Änderungen der Element-Daten automatisch aktualisiert.

In der Regel tragen Sie also den Namen einer nicht existierenden Klasse als Elementhandler-Klasse in das entsprechende Eingabefeld ein und lassen sich diese sowie die zugehörige Basisklasse generieren.

Bestätigen Sie mit Diese Grafik wird im zugehörigen Text erklärt

Weiter.

Die Eigenschaften des angelegten BSP-Elements werden im Editor angezeigt.

Eigenschaften des BSP-Elements definieren

Sie können die Definition eines BSP-Element durch eine Reihe von Attributen erweitern. Zum einen können Sie den Element-Inhalt gegenüber dem Standardwert ändern, zum anderen haben Sie die Möglichkeit über Weitere Optionen zum Element auf den Element-Inhalt zuzugreifen oder ihn zu manipulieren und somit die Ablauflogik zu beeinflussen.

Weitere Datails erfahren Sie in:

Element-Inhalt festlegen

Ferner stehen Ihnen die folgenden Optionen zur Verfügung:

Benutzerdefinierte Validierung

Iteration über Element-Inhalt

Manipulation des Element-Inhalts

Attribute zu einem BSP-Element deklarieren

Um Attribute zu einem BSP-Element anzulegen, wählen Sie die Registerkarte Attribute in der Element-Ansicht und schalten Sie gegebenenfalls in den Änderungsmodus um.

Um ein Attribut anzulegen und zu deklarieren, machen Sie die folgenden Angaben:

Attribut	X	In dieser Spalte tragen Sie einen Namen ein, mit dem das Attribut eindeutig identifiziert wird. Nach dem Aktivieren der BSP-Extension wird ein gleichnamiges öffentliches Attribut in der Basisklasse (CLG_* bzw. ZCLG_*) generiert.
Obligatorisch		Durch Setzen des Flags legen Sie fest, daß das Attribut bei Verwendung des BSP-Elements in einer BSP-Seite zwingend angegeben werden muß.
Dynamischer Wert erlaubt		Durch Setzen des Flags legen Sie fest, daß der Wert des Attributs in einer BSP-Seite auch dynamisch über eine BSP-Expression (<%= ...%>) angeben werden darf. Anderenfalls sind lediglich statische Werte in Form eines Strings möglich.
Referenzübergabe		Durch Setzen des Flags legen Sie fest, daß das Attribut als Referenz an die Eventhandler-Klasse übergeben wird. Anderenfalls findet eine Werteübergabe statt. Weitere Informationen hierzu erhalten Sie unter: Referenzübergabe bei Attributen.
Typisierungsart	X	Zur Auswahl stehen die beiden Werte TYPE und TYPE REF TO, je nachdem es sich um Daten- oder Objektreferenzen handelt. Beachten Sie, daß die Auswahl von TYPE REF TO nur in Kombination mit aktivierter Option Dynamischer Wert erlaubt sinnvoll ist, da Objektreferenzen in BSP-Seiten nur mit Hilfe von BSP-Expressions, nicht jedoch statisch in Form eines Strings übergeben werden können.
Bezugstyp	X	Als Bezugstyp stehen elementare ABAP-Typen (jedoch keine generische Typen) und die Objekttypen (Klassen und Interfaces) zur Verfügung. Generische Typen wie C, N, X, P usw. sind nicht zulässig, da generisch typisierte Attribute in ABAP-Klassen ebenfalls nicht erlaubt sind. Zwischen den Attributen von BSP-Elementen und den Klassenattributen besteht eine 1:1 - Entsprechung.
Defaultwert		Hier tragen Sie einen Wert immer dann ein, wenn das Attribut mit einem Wert vorbelegt werden soll. Dieser Wert wird beim Einfügen des Attributs bzw. des gesamten BSP-Elements aus dem Tag Browser in die BSP-Seite übernommen.
Beschreibung		Geben Sie hier eine erläuternde Attribut-Beschreibung an.

Die mit X gekennzeichneten Angaben sind für jedes Attribut zwingend anzugeben.

Ergebnis

Das neue BSP-Element wird als Teilobjekt der BSP-Extension zugeordnet und inaktiv in die Objektliste übernommen.

Mit dem neuen BSP-Element wird automatisch die Basisklasse (Z)CLG_<Name der BSP-Extension>_<Name des BSP-Elements> und eventuell die angegebene Elementhandler-Klasse selbst angelegt, sofern diese noch nicht existiert.

Sie haben ferner das Verhalten des BSP-Elementes zur Laufzeit durch weitere Eigenschaften spezifiziert und die zugehörigen Attribute deklariert. Im nächsten Arbeitsschritt können Sie die BSP-Extension aktivieren.