BSP-Elemente definieren

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 Dialogfenste BSP Element Anlegen wird angezeigt.
Geben Sie den Namen des BSP-Elements, einen gültigen Namen für die Element Handler Class und eine aussagekräftige Beschreibung für die BSP-Extension als Kurztext ein.

Empfehlung
Sie können eine existente, gültige ABAP-Klasse als Element-Handler-Class definieren. Eine gültige Klasse muss die Schnittstelle IF_BSP_ELEMENT. unterstützen.

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

Sie müssen den Namen einer nich existenten Klasse als element handler class im entsprechenden Eingabefeld angeben. Sie haben die Element-Handler-Class dann zusammen mit der entsprechenden Basisklasse generiert.

Ende der Empfehlung.
Bestätigen Sie Ihre Angaben mit (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. Einerseits können Sie den Standardwert des Feldes Elementinhalt ändern. Andererseits ist es auch möglich auf das Element über die Funktion Weitere Optionen des Elements zuzugreifen und es dort zu ändern, wodurch die Flow-Logik beeinflusst wird.

Weitere Datails erfahren Sie in:

Element-Inhalt festlegen

Ferner stehen Ihnen die folgenden Optionen zur Verfügung:

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:

Angabe	Obligatorisch?	Beschreibung
Attribut	ja	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_` or `ZCLG_`) generiert.
Nötig		Durch Setzen des Flags legen Sie fest, dass 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, dass 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, dass 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	ja	Zur Auswahl stehen die beiden Werte TYPE und TYPE REF TO, je nachdem es sich um Daten- oder Objektreferenzen handelt. Beachten Sie, dass die Auswahl TYPE REF TO nur in Kombination mit der aktiven Option Dynamischer Wert erlaubt (Dynamic Value Allowed) sinnvoll ist . Der Grund hierfür ist die Tatsache, dass Objektreferenzen in BSP-Paketen nur mithilfe von BSP-Ausdrücken und nicht in statischer Form durch eine Zeichenkette (String) weitergegeben werden können.
Referenztyp	ja	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.
Vorschlagswert		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.

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 of BSP extension>_<name of 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.