Show TOC

Plug und Navigations-LinkLocate this document in the navigation structure

Verwendung

Zur Navigation zwischen verschiedenen Views dienen Plugs, die sich in Inbound- und Outbound-Plugs unterteilen lassen. Während Inbound-Plugs die möglichen Einstiegsstellen einer View definieren, kann über die Outbound-Plugs einer View eine Folge-View aufgerufen werden. Plugs sind Bestandteil des Controllers einer View. Sie sind immer genau einer View zugeordnet.

Hinweis

Da sich Interface-Views in Bezug auf die Navigation genau gleich verhalten wie Views, sind die im Folgenden beschriebenen Eigenschaften ebenso für Interface-Views gültig.

Innerhalb eines Web-Dynpro-Windows werden im Allgemeinen mehrere Views eingebettet. Daher ist es nötig, eine View als genau die View auszuzeichnen, die beim Aufruf eines Windows als Erstes angezeigt wird. Diese View wird mit der Eigenschaft Default versehen. Von dieser View aus wird dann die weiterführende Navigationsstruktur aufgebaut.

Das Betreten einer View über einen Inbound-Plug löst immer den Aufruf einer Ereignisbehandler-Methode aus. Zu jedem Inbound-Plug wird daher automatisch eine Ereignisbehandler-Methode generiert, deren Nutzung jedoch optional ist. Der Inbound-Plug selbst stellt in diesem Fall das zu behandelnde Ereignis dar.

Hinweis

Ist eine View innerhalb eines Windows als Default-View gekennzeichnet, erfolgt ihr Aufruf nicht über den Inbound-Plug.

Um von einer View zu einer anderen navigieren zu können, müssen jeweils ein Outbound-Plug der ersten mit einem Inbound-Plug der zweiten View mit Hilfe eines Navigations-Links verbunden werden.

  • Von einem Outbound-Plug kann genau ein Navigations-Link ausgehen, welcher jedoch zu einer Reihe von Ziel-Views führen kann. Diese Ziel-Views sind in ihrer Anordnung nicht ausgezeichnet, das heißt, alle Ziel-Views werden dann gleichzeitig angesteuert.

  • Im Gegensatz dazu kann ein Inbound-Plug von mehreren Outbound-Plugs angesteuert werden.

Hinweis

Die Information, welche Plugs miteinander verbunden sind, ist in den einzelnen Views selbst nicht enthalten. Sie wird in der Navigation separat gespeichert.

Mit der Implementierung der Navigation stellen Sie eine statische, potentielle Verbindung zwischen zwei Views einer Web-Dynpro-Anwendung her. Sie legen damit die View-Reihenfolge beim Ablauf der Web-Dynpro-Anwendung fest. Für jeden möglichen View-Wechsel muss ein Navigations-Link definiert werden.