Window-Plugs: Startup und Exit

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.

Durch einen Exit-Plug wird eine Applikation immer beendet. Dies kann auf die folgenden Arten geschehen:

Die Applikation wird beendet.
Die Applikation wird beendet und das Browser-Fenster wird geschlossen.

Dies geschieht über die CLOSE_WINDOW-Funktionalität (Parameter CLOSE_WINDOW).
Die Applikation wird beendet und es wird eine Navigation zu einer anderen URL durchgeführt.

In den beiden letzten Fällen steht der LOGOFF-Parameter zur Verfügung (siehe unten).

Achtung

In einer Portal-Umgebung darf das Exit-Plug nur mit dem Parameter CLOSE_WINDOW verwendet werden. Die Navigation zu einer anderen Anwendung durch Übergabe einer URL ist nicht zulässig.

Beenden und CLOSE_WINDOW Parameter

Bei einem Exit-Plug können Sie den Parameter CLOSE_WINDOW vom Typ WDY_BOOLEAN hinzufügen und beim Auslösen des Plugs den Wert ABAP_TRUE mitgeben, mit dem das Framework versucht, das betreffende Window zu schließen.

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.

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

Achtung

CLOSE_WINDOWüberstimmt im Portal ggf. den WorkProtect-Modus, d.h. es gibt bei CLOSE_WINDOW=TRUE kein WorkProtect-Popup (z.B. You have unsaved data oder eine ähnliche Meldung).

Weitere Informationen finden Sie unter Einschränkungen bei der CLOSE_WINDOW Funktionalität.

Beenden und URL-Navigation

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' ).
            
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, sondern lediglich still zu legen, um sie später wieder zu aktivieren.

Weitere Informationen finden Sie unter : Suspend-Resume-Aufrufe.

Beenden mit Logoff-Parameter

Sie können einem Exit-Plug den Parameter LOGOFF mitgeben. Die Security-Session im Backend wird gelöscht, siehe auch HTTP-Sicherheits-Session-Management auf dem AS ABAP aktivieren. Zusätzlich wird im Stand-alone-Fall das SSO2-Ticket gelöscht.

Hinweis

Beachten Sie, dass die Security-Session, falls sie aktiv ist, immer gelöscht wird.

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.