DEMO_VALUE_HELP

In Ihrem System finden Sie im Paket SWDP_DEMO die Web-Dynpro-Component DEMO_VALUE_HELP. Im Rahmen dieser Demo-Component werden verschiedene Wertehilfe-Techniken vorgestellt. Auf die anschließend auswertende Business-Logik wurde in diesem Beispiel bewusst verzichtet.

Setzten des Werthilfe-Modus in der Component DEMO_VALUE_HELP

Die Component DEMO_VALUE_HELP ist die Haupt-Component dieses Beispiels. Ihre View V1 enthält eine Reihe von InputFields zur Suche der Datensätze einzelner Flüge. Jedes InputField ist dafür an ein Attribut des View-Context-Knotens SFLIGHT gebunden, jedoch ist für jedes der Attribute ein anderer Wertehilfe-Modus aktiviert.

Für das Attribut CONNID ist der Wertehilfe-Modus mit der Auswahl frei programmiert belegt
Für das Attribut CARRID ist der Wertehilfe-Modus mit der Auswahl Dictionary-Suchhilfe belegt
Für das Attribut FLDATE ist der Wertehilfe-Modus mit der Auswahl Object Value Selector belegt

Dictionary-Suchhilfe

Die ABAP-Dictionary Suchhilfe ist vollständig in der Web-Dynpro-Laufzeit integriert und bedarf keiner weiteren Implementierung.

Frei programmierte Wertehilfe

Eine frei programmierte Wertehilfe wird immer über die Verwendung einer zweiten, vom Anwendungsentwickler selbst angelegten Component realisiert, für die alle Gestaltungsmöglichkeiten des Web-Dynpro-Frameworks zur Verfügung stehen. Die Verwendung dieser Component muss an der Haupt-Component eingetragen werden. Sie finden die Deklaration der benötigten Verwendungen auf der Registerkarte Eigenschaften der Component DEMO_VALUE_HELP selbst sowie auf der Registerkarte Eigenschaften der zugehörigen View V1.

Frei programmierte Wertehilfe-Component FREE_VALUE_HELP

In der Datenbanktabelle SPFLI werden alle vorhandenen Flugverbindungen aufgelistet, das heißt, jede Verbindungsnummer (CONNID) ist genau einmal enthalten. Diese Tabelle eignet sich daher als Wertehilfetabelle für die Eingabemaske der Suche auf der Flugtabelle SFLIGHT. Die View der frei angelegten Wertehilfe-Component FREE_VALUE_HELP enthält also eine tabellarisch dargestellte Auswahl an Attributen der Verbindungstabelle SPFLI.

Die Abbildung wird im Begleittext erläutert.

Wertehilfe mit frei programmierter Component

Implementierung des Interfaces IWD_VALUE_HELP

Die Component FREE_VALUE_HELP implementiert ihrerseits das System-seitig vordefinierte Web-Dynpro-Interface IWD_VALUE_HELP.

Mit der Implementierung dieses Interfaces wird der Interface-Controller der Component um die beiden Ereignisse VH_WINDOW_CLOSED und VH_WINDOW_OPENED erweitert. Mit Hilfe dieser beiden Ereignisse kann die Haupt-Component über Ereignisse in der Wertehilfe-Component informiert werden z.B. um daraufhin Clean-Up-Prozesse in Gang zu setzen. Im vorliegenden Beispiel werden diese beiden Ereignisse jedoch nicht ausgelöst.

Außerdem bringt das Interface eine Interface-View mit in die Component FREE_VALUE_HELP ein. In das Window zu dieser Interface-View muss die Wertehilfe-View V2 eingebettet werden.

Die Abbildung wird im Begleittext erläutert.

Window des Interfaces IWD_VALUE_HELP

Implementieren der Schließung des Dialogfensters der Wertehilfe nach der Auswahl eines Eintrags

Im vorliegenden Beispiel enthält das Wertehilfe-Fenster eine Schaltfläche Werte übernehmen. Mit dieser Schaltfläche wurde die Aktion DATA_SELECTED verknüpft. In deren Ereignisbehandlermethode wird zum einen das Folgeereignis VH_DATA_SELECTED ausgelöst, welches am View-Controller der Component DEMO_VALUE_HELP behandelt wird. Zum anderen wird jedoch auch die Methode CLOSE_WINDOW( ) am Interface IF_WD_VALUE_HELP_LISTENER gerufen. Dieses Interface wird der Wertehilfe-Component nach deren Erzeugung automatisch übergeben (mit Hilfe der Methode SET_VALUE_HELP_LISTENER). Der Aufruf der Methode CLOSE_WINDOW( ) hat zur Folge, dass sich das Wertehilfe-Fenster nach dem Klicken der Schaltfläche Werte übernehmen schließt.

Implementieren des Titels des Wertehilfefensters

Für den Titel des Wertehilfe-Fensters wurde mit Hilfe der Assistance-Klasse CL_ASSIST_FREE_VALUE_HELP ein Textelement angelegt (siehe unten), welches in der Methode WDDOONOPEN am Window-Controller der Wertehilfe-Component übergeben wird.

OVS-Wertehilfe

Als letztes Beispiel der Demo-Anwendung wurde das Eingabefeld für das Context-Attribut FLDATE mit einer OVS-Wertehilfe ausgestattet. In diesem Fall müssen in der Anwendungs-Component zwei Hauptschritte unternommen werden:

Einrichten einer Verwendung der System-Component WDR_OVS für die Anwendungs-Component, deren betreffende View sowie für das betreffende Context-Attribut
Ausprogrammieren des Ereignisbehandlers für das OVS-Ereignis am View-Controller der Anwendungs-Component

Die System-Component WDR_OVS ihrerseits stellt alle nötigen Bestandteile wie z.B. die Wertehilfe-View und das Ereignis OVS zur Verfügung. Beim Anlegen der Ereginisbehandler-Methode zum OVS-Ereignis wird für diese automatisch eine Quelltext-Vorlage generiert, an der Sie sich beim Ausprogrammieren orientieren können. Die eigentliche Beschaffung der benötigen Daten für die Wertehilfe wurde mit Hilfe eines BAPIs realisiert.

In der Assistance-Klasse WD_ASSIST_VALUE_HELP der Beispiel-Component DEMO_VALUE_HELP wurden zusätzlich noch einige Textelemente hinterlegt, die zur Beschriftung in der Wertehilfe-Component heran gezogen werden.

Den Zugang zur Pflege der Textelemente finden Sie im Menü des Class Builders unter Springen Textelemente .