Show TOC

Absolute NavigationLocate this document in the navigation structure

Use

You can trigger navigation to a specific navigation target by calling WDPortalNavigation.navigateAbsolute() , which takes the following main parameter:

  • navigationTarget: Specifies the navigation target URL, that is, the URL of a specific navigation node. For role-based navigation nodes, the URL is the PCD address of the iView or page, preceded by the ROLES:// prefix.

    The following is an example of a URL:

    ROLES://portal_content/myFolder/myRole/myWS/myPage

Other Parameters

The following are additional parameters for the navigateAbsolute() method:

  • mode: Specifies whether the navigation target is displayed in the same browser window or in a new window. The following are valid modes:

    • Show in Place: The navigation target is displayed in the same browser window.

    • Show external: The navigation target is displayed in a new browser window with no portal frame (just the iView or page).

    • Show external portal: The navigation target is displayed in a new browser window with the standard portal frame. The new browser window clears the navigation history, so you cannot use the BACK/FORWARD functionality of the page header.

  • historyMode: Specifies how the navigation is visible in the navigation history in the page title bar. The following are valid modes:

    • No history: The navigation is not visible in the navigation history. You cannot use the BACK/FORWARD functionality to navigate back.

    • No duplications: The navigation is visible in the navigation history. If there are several navigation steps to the same target destination, they are only visible once.

    • Allow duplications: The navigation is visible in the navigation history. If there are several navigation steps to the same navigation target, but with different parameters, they are visible as different entries.

      This option is useful when you navigate to an iView displaying details of a customer. The customer ID can be a parameter. This results in different entries in the navigation history.

      Using the History Title parameter as described below, you can define the title of the entry in the navigation history, like Details for Customer 4711 and Details for Customer 007 to indicate that the same navigation target is used but with different parameters.

  • targetTitle: Sets the title of the entry in the navigation history.

  • contextURL: Specifies the navigation context, which is the navigation node that is highlighted in the top-level and detailed navigation iViews. This is useful when navigating to an invisible navigation node.

    The context URL has the same format as the absolute target URL.

  • windowFeatures: Specifies the browser window features, such as window size and position, when displaying the navigation target in a new window.

  • windowName: Specifies the window name when displaying the navigation target in a new window.

  • launcherParameters: Specifies parameters for navigation. When navigating to SAP-based portal content, you can define parameters that should only be passed to the Application Integrator portal component to launch the specific SAP content, like a Web Dynpro application or a BSP application.

    The parameter value is in the following format:

    param1=value&param2=value2&

  • businessParameters: Specifies URL parameters that are passed to the target iView. The parameter value is in the following format: param1=value&param2=value2&

    Note

    The value of businessParameters is passed as a URL parameter called DynamicParameter .

    Web Dynpro applications automatically parse this URL parameter, and make the key-value pairs available as separate URL parameters. Non-Web Dynpro applications must retrieve the DynamicParameter parameter and parse it themselves.

  • useSAPLauncher: A boolean value that indicates that the navigation target is content based on SAP technology (that is, BSP, ITS, BI or Web Dynpro Java or ABAP).

  • postParameters: A boolean value that indicates to use post for sending parameters.