Window-Plugs: Startup und Exit 

Jedes Web-Dynpro-Window besitzt, analog zu einer Web-Dynpro-View, Inbound- und Outbound-Plugs. Eine beliebige Anzahl dieser Plugs kann jeweils als Startup- bzw. Exit-Plugs gekennzeichnet sein.

Startup-Plug

Der Startup-Plug ist ein spezieller Inbound-Plug.

Die Eigenschaft Startup, die Sie auf der Registerkarte Inbound-Plugs im Window Editor festlegen können, deklariert für den jeweiligen Inbound-Plug die Option, eine Component zu instanziieren und damit eine neue Anwendung zu starten. Daher ist ein Startup-Plug nur dann sinnvoll, wenn er auch dem Interface des Windows zur Verfügung steht. Über alle, als Startup-Plugs markierten Plugs kann eine Component von außen angesprochen werden. Wenn Sie also eine Web-Dynpro-Anwendung zu dieser Interface-View anlegen, werden Ihnen nur solche Plugs für die Anwendung angeboten, die als Startup-Plugs gekennzeichnet sind. Da immer mindestens ein Inbound-Plug eines Web-Dynpro-Windows als Startup-Plug markiert sein muss, finden Sie auf der Registerkarte Inbound-Plugs zu jedem neuen Window bereits einen solchen Plug mit Namen DEFAULT.

Exit-Plug

Der Exit-Plug ist ein spezieller Outbound-Plug.

Wenn ein Web-Dynpro-Window über einen Exit-Plug verlassen wird, bedeutet dies, dass die dazu gehörige Anwendung automatisch beendet wird. Somit ist auch ein Exit-Plug nur dann sinnvoll, wenn er am Interface-View des Windows zur Verfügung steht.

 

Das Konzept der Exit-Plugs funktioniert nicht in einer Portal-Umgebung!

CLOSE_WINDOW

Bei einem Exit-Plug können Sie den Parameter CLOSE_WINDOW mitgeben, mit dem das Framework versucht, das betreffende Window zu schließen.

Beachten Sie, dass CLOSE_WINDOW nicht für Firefox unterstützt wird.

Beachten Sie außerdem, dass CLOSE_WINDOW nur für 7.1-Portale zur Verfügung steht.

Ob die Voraussetzungen für die Verwendung von CLOSE_WINDOW gegeben sind, können Sie mit der Methode GET_IS_CLOSE_WINDOW_SUPPORTED des Interface IF_WD_APPLICATION abfragen.

Im folgenden Code-Beispiel wird ein Exit-Plug des Windows von einer Ereignisbehandlermethode am Controller einer eingebetteten View gerufen und übergibt eine externe URL sowie CLOSE_WINDOW:

method onactionto_exit .   data url type string.   data close_window   type wdy_boolean.   data close_window2  type string.   wd_context->get_attribute( exporting name = 'ENTERED_URL' importing value = url ).   wd_context->get_attribute( exporting name = 'CLOSE_WINDOW' importing value = close_window ).   wd_this->fire_to_exit_plg( url = url close_window = close_window ). endmethod.

Sie finden ein Beispiel im System in der Web-Dynpro-Anwendung WDR_TEST_EXIT_WITH_CLOSE.

URL-Parameter

Exit-Plugs haben die spezielle Eigenschaft, dass sie über den ausgezeichneten Parameter URL verfügen. Nachdem Sie den Parameter URL in der Parameterliste der Registerkarte Outbound-Plugs im Window Editor angelegt haben, können Sie in der den Exit-Plug rufenden Methode einen Wert für diesen Parameter übergeben. Der Parameter ist optional, er kann, muss jedoch nicht notwendigerweise mit einem Wert gefüllt sein.

Im folgenden Code-Beispiel wird ein Exit-Plug des Windows von einer Ereignisbehandlermethode am Controller einer eingebetteten View gerufen und übergibt eine externe URL:

method ONACTIONGO_EXIT . data: L_REF_MAIN_WINDOW type ref to IG_MAIN_WINDOW . L_REF_MAIN_WINDOW =   WD_THIS->GET_MAIN_WINDOW_CTR( ).   L_REF_MAIN_WINDOW->FIRE_MY_EXIT_PLUG_PLG(     URL =   'http://www.sap.com'                    " String   ). endmethod..

Eine auf diese Weise beendete Anwendung schließt die aktuelle Component-Instanz und springt zu der übergebenen Web-Anwendung ab.

Analog dazu haben Sie die Möglichkeit, eine Anwendung zu einer zweiten Anwendung hin zu verlassen, die erste dabei jedoch nicht zu beenden, sonder lediglich still zu legen um sie später wieder zu aktivieren. Sie finden die Beschreibung solcher Suspend-Aufrufe unter Weiterführende Konzepte.

Parameter an Inbound- und Outbound-Plugs

Wie bei allen anderen Plugs eines Windows auch, können Sie Startup- und Exit-Plugs mit obligatorischen oder optionalen Parametern nutzen. Diese müssen vom Typ String oder vom Typ TIHTTPNVP sein.

Weitere Informationen finden Sie unter Window: Parameter an Inbound- und Outbound-Plugs.