Table Of Content1315.book Seite 103 Dienstag, 31. März 2009 11:16 11
Web-Dynpro-Anwendungen repräsentieren die Sicht für
einen Benutzer auf eine oder mehrere Web-Dynpro-Compon-
ents. Sie werden in diesem Kapitel lernen, wie Web-Dynpro-
Anwendungen entwickelt werden und welche verschiedenen
Aspekte Sie dabei zur Verwendung bringen können.
3 Entwicklung von Web-Dynpro-
Anwendungen
In diesem Kapitel werden Sie eine Web-Dynpro-Anwendung entwi- Web-Dynpro –
ckeln, in der Sie das bis dato erarbeitete Wissen einsetzen können. Wissensvertiefung
und Erweiterung
Zusätzlich erhalten Sie einen tieferen Einblick in die Programmie-
rung des Contexts, von View-Layouts und der Container, in die Ver-
wendung von wichtigen UI-Elementen, Tabellen, Wertehilfen und
Nachrichten sowie die Internationalisierung.
Die unterschiedlichen Themen werden Schritt für Schritt in eine Web- Beispiel-
Web-Dynpro-
Dynpro-Anwendung integriert, um Ihnen die praktische Anwendung
Anwendung
der Theorie zu vermitteln. Dabei werden vier Ziele verfolgt:
(cid:1) die Präsentation und Vermittlung von detailliertem Wissen über
die Elemente der Web-Dynpro-Entwicklung
(cid:1) die Vorgehensweise bei der Entwicklung und die Verwendung der
präsentierten Techniken bei der Erstellung einer Web-Dynpro-An-
wendung
(cid:1) eine vollständige – aus Sicht einer funktionsfähigen Web-Dynpro-
Anwendung – und integrierte Sammlung von Beispielen, die Sie
für Ihre Entwicklungsprojekte als Vorlagen wiederverwenden
können
(cid:1) die Präsentation von Zusatzthemen, wie die Run Time Type Iden-
tification (RTTI) oder Service-Aufrufe, die Ihnen das Leben erleich-
tern
Die Anwendung, die im Laufe dieses Kapitels entstehen wird, wurde
Klassen-Browser getauft: Benutzer können in dieser Anwendung Such-
103
1315.book Seite 104 Dienstag, 31. März 2009 11:16 11
3 Entwicklung von Web-Dynpro-Anwendungen
kriterien für eine ABAP-Klasse eingeben. Falls die ABAP-Klasse gefun-
den wird, werden die Beschreibung und die Methoden zur ABAP-
Klasse angezeigt Die Darstellung der Methoden erfolgt einerseits über
eine Baum- und andererseits über eine Tabellendarstellung.
Web-Dynpro- Wie Sie bereits erahnen können, erfordert die Realisierung dieser Web-
Werkzeugkasten Dynpro-Anwendung die Nutzung zahlreicher Techniken aus dem
Web-Dynpro-Werkzeugkasten. Entsprechend sind die Abschnitte auf-
gebaut: Begonnen wird mit der Programmierung des Contexts. Sie wer-
den eine Web-Dynpro-Component anlegen und eine Context-Struktur
definieren, danach werden Sie sich den Werkzeugen für die View-Ge-
staltung und -Programmierung zuwenden. Dabei wird die Verwen-
dung von Layouts und Containern betrachtet und eine Menge von
View-Elementen zur Gestaltung des View-Layouts benutzt.
Fragestellungen
In diesem Kapitel werden die folgenden Themen besprochen:
(cid:1) Context-Programmierung
(cid:1) Layouts und Container
(cid:1) Verwendung wichtiger View-Elemente
(cid:1) Nachrichten und Internationalisierung
3.1 Context-Programmierung
Wie Sie bereits gelernt haben, verfügt jeder Controller über einen
Context, in dem die verwendeten Daten hierarchisch abgelegt sind.
Die grundlegenden Elemente, die zur Strukturierung des Contexts
eingesetzt werden, sind Context-Knoten und Context-Attribute. In die-
sem Abschnitt wird das bisher aufgebaute Wissen zur Erzeugung,
Veränderung und Löschung von Daten im Context vertieft.
Zum Aufwärmen und Wiederholen des in den vorangegangenen Ka-
piteln bereits Gelernten, legen Sie die Web-Dynpro-Component ZWDC_
03_KLASSEN_BROWSER an. Diese Web-Dynpro-Component, die Sie als
Lokales Objekt anlegen, wird im Laufe des Kapitels Stück für Stück
ausgebaut. Der Name des von Ihnen anzulegenden Views lautet V_
MAIN_LAYOUT und der Name des Windows W_MAIN. Zusätzlich zu der
Web-Dynpro-Component legen Sie eine Web-Dynpro-Anwendung
mit dem Namen ZWDC_03_KLASSEN_BROWSER_APP an. Sollten Sie mit
104
1315.book Seite 105 Dienstag, 31. März 2009 11:16 11
Context-Programmierung 3.1
dieser Aufgabe noch Schwierigkeiten haben, finden Sie in Abschnitt
2.1, »Components und Anwendungen«, das benötigte Wissen.
Für die Programmierung des Contexts werden noch Context-Struktu- Context-Struktur
ren benötigt, die Sie nun aufbauen werden. Dabei lernen Sie eine Al- aufbauen
ternative zum Aufbau der Context-Struktur kennen: die Definition
von Context-Knoten über ABAP-Dictionary-Strukturtypen.
ABAP-Dictionary-Strukturtypen
Um mehrere skalare Variablen – das heißt einfache Datentypen, wie zum
Beispiel Datum, Zeit und ganzzahlige Werte – zu einer Einheit zusammen-
zufassen, werden in ABAP Strukturvariablen angeboten. Falls der Aufbau
(der Typ) der Strukturvariable mehrfach benötigt wird, ist es möglich, im
ABAP Dictionary (Transaktion SE11) einen sogenannten Strukturtyp anzu-
legen, der dann für die Typisierung von Strukturvariablen verwendet wer-
den kann. Es gibt drei Arten von Strukturtypen im ABAP Dictionary; wel-
che Art verwendet wird, hängt vom geplanten Einsatzgebiet des
Strukturtyps ab:
(cid:1) ABAP-Dictionary-Struktur
ABAP-Dictionary-Strukturen werden hauptsächlich für die Typisierung
von Variablen und Schnittstellenparametern angelegt.
(cid:1) Transparente Tabelle
Eine transparente Tabelle ist eine Datenbanktabelle, die im ABAP Dic-
tionary definiert und dann in der Datenbank angelegt wird. Sie kann wie
eine ABAP-Dictionary-Struktur für Typisierungen verwendet werden.
(cid:1) ABAP-Dictionary-View
Hierbei handelt es sich um eine virtuelle Tabelle, die keine Daten ent-
hält, sondern eine anwendungsorientierte Sicht auf eine oder mehrere
ABAP-Dictionary-Tabelle(n) ist.
Die Elemente des Strukturtyps werden als Felder oder Komponenten be-
zeichnet.
Erinnern Sie sich noch an die Einzelanlage von Context-Knoten und Context-Struktur
Context-Attributen in Abschnitt 2.4, »Context«? Dort wurde zuerst mit Strukturtyp
aufbauen
der Context-Knoten und dann jedes benötigte Context-Attribut zum
Context-Knoten einzeln angelegt. Alternativ dazu können Sie folgen-
dermaßen vorgehen:
1. Definieren Sie einen Strukturtyp im ABAP Dictionary mit den ge-
wünschten Strukturkomponenten.
2. Legen Sie einen Context-Knoten im gewünschten Controller an,
und verwenden Sie für die Typisierung den zuvor angelegten
Strukturtyp.
105
1315.book Seite 106 Dienstag, 31. März 2009 11:16 11
3 Entwicklung von Web-Dynpro-Anwendungen
Sehen Sie sich das beschriebene Vorgehen an einem Beispiel an. Dem
Benutzer soll ein Selektionsbild zur Suche von ABAP-Klassen angebo-
ten werden. Der Benutzer muss den Namen der ABAP-Klasse ange-
ben, die zu suchen ist. Falls die ABAP-Klasse gefunden wird, wird im
Selektionsbild auch die Beschreibung der ABAP-Klasse angezeigt. Um
diese Anforderung realisieren zu können, müssen Sie, wenn Sie dem
beschriebenen Vorgehen folgen, zuerst eine ABAP-Dictionary-Struk-
tur für die Selektionskriterien im ABAP Dictionary anlegen:
Strukturtyp 1.Wechseln Sie dazu mit der Transaktion SE11 in das Einstiegsbild
anlegen des ABAP Dictionarys.
2.Wie beschrieben, stehen mehrere Arten von Strukturtypen zur
Verfügung. Da Sie den Strukturtyp ausschließlich zur Typisierung
des Knotens und von Variablen verwenden werden, wählen Sie als
Strukturtypart die Struktur. Selektieren Sie dazu den Radiobutton
Datentyp im ABAP-Dictionary-Einstiegsbild.
3.Geben Sie im Eingabefeld zum Radiobutton Datentyp den Namen
der Struktur an: ZST_03_WD_KLASSE_SEL_KRIT. Der Name beginnt
mit dem Buchstaben Z und liegt somit im Kundennamensraum.
4.Drücken Sie auf die Taste Anlegen, und setzen Sie im erscheinen-
den Auswahldialog den Radiobutton Struktur. Quittieren Sie Ihre
Eingabe mit einem Klick auf das grüne Häkchen.
5.Im Pflegebild der Struktur vergeben Sie eine passende Kurzbe-
schreibung für die ABAP-Dictionary-Struktur, wie zum Beispiel
»Klassen Selektionskriterien«.
Nun legen Sie die Komponenten der Struktur an. Als Komponenten
sind der Name und die Beschreibung einer ABAP-Klasse erforderlich:
(cid:1) Name
(cid:1) Komponente: NAME_KLASSE
(cid:1) Komponententyp: SEOCLSNAME
(cid:1) Beschreibung
(cid:1) Komponente: BESCHR_KLASSE
(cid:1) Komponententyp: SEODESCR
Datenelement 1.Um die Komponententypen zu ermitteln, wurde in diesem Bei-
ermitteln spiel das Einstiegsbild des Object Navigators (Transaktion SE24)
analysiert. Dort steht das Eingabefeld für den Namen eines ABAP-
Interface oder einer ABAP-Klasse zur Verfügung. Wenn Sie den
106
1315.book Seite 107 Dienstag, 31. März 2009 11:16 11
Context-Programmierung 3.1
Cursor in das Eingabefeld Objekttyp platzieren und auf die Taste
(F1) drücken, erscheint die semantische Hilfe zum Eingabefeld.
Drücken Sie nun auf die Taste Technische Information, erscheint
die technische Information zum Eingabefeld. In der Gruppe Feld-
Daten finden Sie im Anzeigefeld Datenelement den Namen des
Datenelementes (SEOCLSNAME), das zur Typisierung des Eingabefel-
des verwendet wurde.
2. Für die Struktur ZST_03_WD_KLASSE_SEL_KRIT müssen Sie noch Erweiterungs-
kategorie
festlegen, wie diese in Zukunft erweitert werden kann. Verwen-
den Sie dazu den Menüpfad Zusätze (cid:1) Erweiterungskategorie...
Setzen Sie im erscheinenden Auswahldialog den Radiobutton be-
liebig erweiterbar, und bestätigen Sie Ihre Eingabe über die
Drucktaste Übernehmen.
3. Wählen Sie die Struktur über die Drucktaste Aktivieren (Tasten- Aktivieren
kombination (Strg)+(F3)) an. Das Ergebnis Ihrer bisherigen Ar-
beit sehen Sie in Abbildung 3.1.
Abbildung 3.1 Struktur ZST_03_WD_KLASSE_SEL_KRIT im ABAP Dictionary
Damit haben Sie die ABAP-Dictionary-Struktur ZST_03_WD_KLASSE_
SEL_KRIT vollständig angelegt und können diese in der Definition der
Context-Struktur einsetzen. Zuvor gibt es jedoch noch eine Übung
zur Festigung Ihres Wissens. Legen Sie eine ABAP-Dictionary-Struk-
tur an, die für die Typisierung des Context-Knotens für die ABAP-
Klassen-Methoden dient. Der Name der ABAP-Dictionary-Struktur
lautet ZST_03_WD_KLASSE_METHODE. Die benötigten Komponenten
und deren Typen finden Sie in Tabelle 3.1. Vergessen Sie nicht, die
Erweiterungskategorie zu setzen und die Struktur zu aktivieren.
107
1315.book Seite 108 Dienstag, 31. März 2009 11:16 11
3 Entwicklung von Web-Dynpro-Anwendungen
Komponente Komponententyp
NAME SEOCPDNAME
ART_ICON ICONNAME
IS_CLASS WDY_BOOLEAN
IS_INTERFACE WDY_BOOLEAN
IS_REDEFINED WDY_BOOLEAN
Tabelle 3.1 Komponenten und Komponententypen für die ABAP-Dictionary-Struktur
ZST_03_WD_KLASSE_METHODE
Context-Struktur Nun ist alles bereit, um die Context-Struktur in der Web-Dynpro-
definieren Component ZWDC_03_KLASSEN_BROWSER zu definieren. Wie bereits er-
wähnt, benötigen Sie einen Context-Knoten, der die Daten vom Se-
lektionsbild übernehmen und einen Knoten, der die gefundenen Me-
thoden zu einer ABAP-Klasse aufnehmen kann.
Context-Knoten Begonnen wird mit dem Context-Knoten für die Selektionskriterien.
für die Selektion
Die Daten aus dem Selektions-View sollten auch dem Component-
Controller zur Verfügung stehen, da die Zugriffe auf den Context, die
später implementiert werden, alle vom Component-Controller aus-
geführt werden. Das bedeutet, dass der Context-Knoten für die Selek-
tion im Component-Controller angelegt und später durch Context-
Mapping der Zugriff für andere Controller ermöglicht wird.
1.Wechseln Sie dazu in den Component-Controller-Context der
Web-Dynpro-Component ZWDC_03_KLASSEN_BROWSER, den Sie auf
der Karteikarte Context im Component-Controller finden.
Knoten anlegen 2.Legen Sie dort den Context-Knoten KLASSEN_SEL_KRIT an: Über
das Kontextmenü auf dem Context-Wurzelknoten und den Menü-
eintrag Anlegen (cid:1) Knoten öffnet sich der Pflegedialog für den
Context-Knoten (siehe Abbildung 3.2).
3.Geben Sie im Eingabefeld Knotenname den Namen des Context-
(cid:1)
Knotens KLASSEN_SEL_KRIT ein ( ).
4.Nun kommt eine Neuerung! Geben Sie im Eingabefeld Dictionary-
Struktur den Namen der von Ihnen angelegten ABAP-Dictionary-
Struktur für die Selektionskriterien ein: ZST_03_WD_KLASSE_SEL_
(cid:2)
KRIT ( ). Damit legen Sie fest, aus welchem Strukturtyp die Con-
text-Attribute zum Context-Knoten ermittelt werden sollen.
108
1315.book Seite 109 Dienstag, 31. März 2009 11:16 11
Context-Programmierung 3.1
(cid:2)
(cid:1)
(cid:3)
(cid:4)
Abbildung 3.2 Anlegen des Context-Knotens KLASSEN_SEL_KRIT mithilfe einer
ABAP-Dictionary-Struktur
5. Kicken Sie auf Attribute aus Struktur hinzufügen, um die von Attribute
Ihnen gewünschten Attribute auszuwählen ((cid:3)). Es erscheint ein hinzufügen
Auswahldialog für die Komponenten der angegebenen Struktur.
6. Markieren Sie alle Komponenten, um diese in Attribute umzuwan-
(cid:4)
deln ( ).
7. Bestätigen Sie zum Abschluss Ihre Selektion mit einem Klick auf
das grüne Häkchen.
Damit haben Sie einen Context-Knoten mit Context-Attributen ange-
legt. Dieser Anlageweg wird in der Praxis sehr häufig eingesetzt, da
die über den Strukturtyp angelegten Context-Knoten Vorteile gegen-
über einzeln angelegten Context-Attributen bieten, wie zum Beispiel
umgebungssensitive Eingabehilfen. In Abbildung 3.3 sehen Sie das
Ergebnis Ihrer Mühen.
Wenn Sie sich, ebenfalls zur Wiederholung, einige der Eigenschaften Eigenschaften
des Context-Knotens KLASSEN_SEL_KRIT ansehen, werden Sie feststel-
len, dass von diesem Context-Knoten genau ein Context-Element an-
gelegt wird. Dieses wird durch die Kardinalität 1..1 definiert ((cid:1)).
Zudem wird durch das Web-Dynpro-Framework die Initialisierung
Lead-Selection durchgeführt, da diese Eigenschaft selektiert ist ((cid:2)).
109
1315.book Seite 111 Dienstag, 31. März 2009 11:16 11
Context-Programmierung 3.1
Startet der Benutzer die Web-Dynpro-Anwendung, soll ihm ein Vor-
schlagswert für einen ABAP-Klassennamen im Selektionsbild ange-
boten werden, zum Beispiel CL_GUI_ALV_GRID. Dafür stehen Ihnen
prinzipiell zwei Möglichkeiten zur Verfügung: Default-Werte und
Programmierung.
Default-Wert eines Attributes
Sie belegen die Context-Eigenschaft Default-Wert des Context-At-
tributes NAME_KLASSE mit dem Wert CL_GUI_ALV_GRID. Diese Vorge-
hensweise dürfte Ihnen aus der ABAP-Programmierung bekannt
sein, bei der es möglich ist, für die Deklaration einer Variablen über
den VALUE-Zusatz zur DATA-Anweisung die Variable mit einem An-
fangswert zu belegen. Wenn Sie die Anfangsbelegung in den Con-
text-Eigenschaften des Context-Attributes NAME_KLASSE durchführen,
(cid:1)
sollte das Ergebnis ( ) wie in Abbildung 3.4 aussehen.
(cid:2)
Abbildung 3.4 Setzen des Default-Wertes eines Context-Attributes
Programmierung
Bei der Programmierung weisen Sie dem Context-Attribut NAME_
KLASSE den Wert CL_GUI_ALV_GRID mithilfe der Context-Programmie-
rung zu. Sehen Sie sich das prinzipielle Vorgehen zu dieser Möglich-
keit genauer an.
Um auf das Context-Attribut NAME_KLASSE zugreifen zu können, müs- Navigation in der
sen Sie gewissermaßen durch die Context-Hierarchie navigieren. Die Context-Hierarchie
Navigation beginnt beim Wurzelknoten CONTEXT. Von diesem ausge-
111
1315.book Seite 112 Dienstag, 31. März 2009 11:16 11
3 Entwicklung von Web-Dynpro-Anwendungen
hend, navigieren Sie zum Unterknoten KLASSEN_SEL_KRIT, der das
Attribut NAME_KLASSE besitzt. Der Zugriff auf den Inhalt des Context-
Attributes geschieht über das Element zum Context-Knoten (siehe
Abschnitt 2.4, »Context«). Da die Eigenschaft Kardinalität des Con-
text-Knotens KLASSEN_SEL_KRIT auf den Wert 1..1 gesetzt wurde, ist
gesichert, dass das Element zum Context-Knoten vorhanden ist.
Haben Sie den Zugriff auf das Element, können Sie für das Context-
Attribut NAME_KLASSE den Wert setzen. So weit zur Idee, jetzt folgt
die Theorie.
get_child_node( ) Das ABAP-Interface IF_WD_CONTEXT_NODE dient der Arbeit mit Con-
text-Knoten, wie zum Beispiel dem Anlegen, Lesen, Ändern und Lö-
schen der Elemente eines Knotens. In Tabelle 3.2 sehen Sie die wich-
tigsten Methoden aus diesem Interface, die im Laufe dieses
Abschnittes besprochen und verwendet werden.
Methode Beschreibung
get_child_node( ) Referenz des Unterknotens ermitteln
get_element( ) Element aus der Knoten-Collection
ermitteln
get_element_count( ) Anzahl der Elemente in der Knoten-
Collection
get_static_attributes_table( ) alle Attribute aller Elemente in Form
einer internen Tabelle
create_element( ) Element anlegen
bind_element( ) Element der Knoten-Collection hinzufü-
gen
bind_structure( ) aus der Struktur ein Element in der Kno-
ten-Collection erzeugen und hinzufügen
bind_table( ) aus einer internen Tabelle pro Eintrag ein
Element in der Knoten-Collection erzeu-
gen und hinzufügen
remove_element( ) ein Element aus der Knoten-Collection
entfernen
Tabelle 3.2 Ausgewählte Methoden des ABAP-Interface IF_WD_CONTEXT_NODE
Unter den Controller-Attributen zu jedem Controller finden Sie das
Attribut wd_context, das mit diesem ABAP-Interface typisiert ist. Die
ABAP-Interface-Methode get_child_node( ) aus eben diesem ABAP-
112
Description:den eine Web-Dynpro-Component anlegen und eine Context-Struktur definieren Legen Sie einen Context-Knoten im gewünschten Controller an,.
