Absolute Navigation

Use

You can activate absolute path navigation for the portal in Web Dynpro ABAP, by using the portal manager (interface IF_WD_PORTAL_INTEGRATION, method NAVIGATE_ABSOLUTE). You can generate a template using the wizard, in which you then enter values.

With the absolute navigation tool, you must know the name of the page to be displayed in order to pass it to the method.

The navigation target is the only parameter required here. It stands for an absolute address in the portal. The other parameters are used for controlling the navigation and are optional. You can set business parameters and parameters for the respective application launcher in the portal. To transport business parameters correctly to the target application, you have to set the parameter USE_SAP_LAUNCHER. If it is an SAP application (for example, BSP Web Dynpro, and so on), you have to set the switch to TRUE.

Overview of Parameters

Name

Optional

Possible Values

Description

NAVIGATION_TARGET

No

Address,

For example, ROLES://portal_content/

web_dynpro_abap/

web_dynpro_abap_tester/

portal_integration/

portalNavigation/portal_navigation_target

Absolute address, path for page or iView in the portal content directory. This path is displayed in the portal catalog, for instance, when you edit a page or an iView.

NAVIGATION_MODE

Yes

INPLACE″

Displays the navigation target on the same page

Navigation mode

″EXTERNAL″

Displays the navigation target on a new page, but only as an iView, without the portal

″EXTERNAL_PORTAL″

Displays the navigation target to a new portal display of the standard toolbar page

WINDOW_FEATURES

Yes

″TOOLBAR″

Displays the standard toolbar

Additional JavaScript parameter for the external window, for example, character set or size specification, such as width=300 or height=250. These parameters are separated with commas. No spaces are allowed.

″LOCATION″

Displays the Web address

″DIRECTORIES″

Displays the directory buttons of the browser

STATUS

Displays the status bar

″MENUBAR″

Displays the menu bar of the browser

″SCROLLBARS″

Displays the scroll bar

RESIZABLE

Windows can be resized

"WIDTH"

Width of the window

″HEIGHT"

Height of the window

WINDOW_NAME

Yes

string

Title of the target page in the external browser. The specified Web address is loaded into a window of this name, for instance MyWindowName. This name is used to access the address.

HISTORY_MODE

Yes

″ALLOW_DUPLICATIONS″

A navigation entry can be listed more than once in the history.

Specifies whether the visited Web address should be listed in the navigation history.

″NO_DUPLICATIONS″

A navigation entry can be listed only once in the history.

″NO_HISTORY″

No navigation entry in the history

TARGET_TITLE

Yes

string

Title of the portal page

CONTEXT_URL

Yes

string

Determines the navigation context used

POST_PARAMETERS

Yes

″TRUE″

Transfer parameters as a POST request

Transfer options for parameters

"FALSE" (default value)

Transfer parameters as a GET request

USE_SAP_LAUNCHER

Yes

″TRUE″ (default value)

Target is called using the SAP launcher, for example BSP

SAP launcher is used

″FALSE″

Target is not called using the SAP launcher

BUSINESS_PARAMETERS

Yes

Parameter list of type WDY_KEY_VALUE_LISTGEN. You can therefore use structure WDY_KEY_VALUE with name/value pairs.

Transfer parameters for navigating to the target application (Web Dynpro or other Web application), for example, a specific customer number customerID=4711 for the target application..

These parameters are transferred by URL.

See also: Application Parameters and URL Parameters

LAUNCHER_PARAMETERS

Yes

Parameter list of type WDY_KEY_VALUE_LISTGEN. You can therefore use structure WDY_KEY_VALUE with name/value pairs.

Parameter list for the application launcher, parameter list, for example, WebDynproNamespace=myNamespace

Example

You can find an example in the system in component WDR_TEST_PORTAL_NAV in Web Dynpro application WDR_TEST_PORTAL_NAV_PAGE.