Navigation in the Portal 

Use

Navigation in the portal comprises JavaScript functions that enable swapping iViews with other iViews. The initial navigation bar and detailed navigation are adapted accordingly. Implementation is carried out using JavaScript within a BEx Web application. Multiple parameters can be passed to other iViews (such as BEx Web applications or SAP transactions in SAP ERP, SAP CRM, and so on). Navigation in the portal can be displayed as a link or as an extension of the context menu.

For more information see Navigation and Navigation API.

Features

Navigation in the portal is part of the Enterprise Portal Client Framework (EPCF) and enables the jumping to other iViews at runtime. The BEx Web application iView is displayed as an iFrame within the HTML page. Due to this nesting, the EPCM Proxy is used. With the EPCM proxy, the EPCM API function EPCM.doNavigate is called.

Process Flow

       1.      A BEx Web application calls portal navigation using EPCMPROXY.doNavigate:

Syntax:

function EPCM.doNavigate(String target, [int mode, String winFeat, String winName, int history, String targetTitle, String context])

Schematic example:

EPCMPROXY.doNavigate("ROLES://portal_content/<Folder>/<Role>/<Workset>/.../<iView>?DynamicParameter=<coded parameter of the application>");

       2.      The portal navigates to the required iView and adapts the initial navigation bar and detailed navigation accordingly.

The parameter target of the JavaScript function EPCM.doNavigate comprises NavigationTarget and DynamicParameter.

Example: Portal navigation to a BEx Web Application with Default Variables and Suppression of the Variable Screen

EPCMPROXY.doNavigate('ROLES://portal_content/Pages/User/Content/Search?DynamicParameter=VAR_NAME_1%3D0D_SOLDT%26VAR_VALUE_LOW_EXT_1%3D' + parameter1 + '%26VAR_VALUE_HIGH_EXT_1%3D' + parameter1 + '%26VAR_OPERATOR_1%3DEQ%26VAR_SIGN_1%3DI%26VARIABLE_SCREEN%3D');

The parameter target always starts with ROLES://. In contrast to the parameter DynamicParameter, the parameter name NavigationTarget cannot be specified in the parameter target.

 

In the section, Determining the Path of the iView, you will learn how to determine the NavigationTarget component for the JavaScript function EPCM-doNavigate.

In the sections Transferring Parameters to a BEx Web Application iView and Transferring Parameters to SAP-Transactions  you can find explanations of how to create the DynamicParameter component.