Anfang des InhaltsbereichsVorgehensweisen Neue BSP-Extension mit Elementen erstellen Dokument im Navigationsbaum lokalisieren

Vorgehensweise

Um die neue BSP-Extension für die beschriebene Lösung zu erstellen, definieren Sie zuerst die Extension selbst und danach die darin beinhalteten Elemente. Am Ende aktivieren Sie die Extension.

  1. Legen Sie eine neue BSP-Extension in der ABAP Workbench an (siehe auch BSP-Extensions anlegen).
  2. In unserem Beispiel hat sie den Namen BSP_TUTORIAL_COMPLEX.

  3. Geben Sie auch einen Default-Präfix an.
  4. Der Default-Präfix wird für diese BSP-Extension verwendet, wenn Sie mit Drag & Drop Elemente dieser Extension in die Seite mit Ablauflogik oder in den View einfügen wollen, ohne diese Extension vorher verwendet zu haben.
    Sie können den Default-Präfix später jederzeit ändern, wenn Sie die BSP-Extension verwenden, indem Sie das Präfix-Attribut der Extension-Direktive umbenennen.

    In unserem Beispiel ist es TutCmplx.

  5. Legen Sie in Ihrer neuen Extension das Element <SimpleForm> an (siehe auch BSP-Elemente definieren).
  6. Empfehlung

    Wir empfehlen, das Default-BSP-Extension-Präfix in den Namen der Elementhandler-Klasse zu integrieren.

    In unserem Beispiel ist der Name der Elementhandler-Klasse CL_BSP_TUTCMPLX_SIMPLE_FORM.

  7. Definieren und konfigurieren Sie das BSP-Element wie gewohnt.
  8. In unserem Beispiel besteht der Element-Inhalt ausschließlich aus inneren BSP-Elementen und hat damit keinerlei frei definierten Text.

    In unserem Beispiel hat das Element ein (obligatorisches) Attribut namens id vom Typ String.

  9. Legen Sie das neue BSP-Element <SimpleFormItem> an.

Dieses Element stellt ein Element dar, das sowohl <htmlb:label> als auch <htmlb:inputField> verschalt. Da das <htmlb:inputField>-Element die meisten Attribute beinhaltet, die Sie für das neue <TutCmplx:SimpleFormItem>- Element benötigen, kopieren Sie einfach das <htmlb:inputField>-Element.

    1. Dazu verzweigen Sie in der BSP-Extension HTMLB zum Element <inputField> und wählen auf dem markierten Element im Kontextmenü Kopieren....
    2. Danach geben Sie als Ziel die BSP-Extension BSP_TUTORIAL_COMPLEX und als Ziel-BSP-Element SimpleFormItem an.
    3. Da durch die Kopier-Operation lediglich die logische Definition des Elements kopiert wird, müssen Sie noch einige weitere Änderungen vornehmen. Insbesondere ist die neue Definition noch an die ursprüngliche Implementierungsklasse (Elementhandler-Klasse) gebunden.

    4. Ändern Sie über den Tabreiter Eigenschaften die Anbindung an die Elementhandler-Klasse ab und geben Sie CL_BSP_TUTCMPLX_SIMPLE_FORM_IT ein.
    5. Fügen Sie die zusätzlichen Attribute hinzu, die Sie für die Verarbeitung von <htmlb:label> benötigen. In diesem einfachen Beispiel ist nur ein neues Attribut notwendig, und zwar der Name der Beschriftung.
      Geben Sie hierfür auf dem Tabreiter Attribute das zusätzliche Attribut
      label vom Typ String ein.
  1. Sichern Sie die BSP-Extension und generieren Sie sie.

Ergebnis

Zu diesem Zeitpunkt wurden bereits die leeren Implementierungen für die Elemente generiert.

Nun können Sie eine einfache Testseite erstellen (die jedoch keine Ausgabe erzeugt).

Ende des Inhaltsbereichs