Start of Content Area

Function documentation Navigation in the Portal  Locate the document in its SAP Library structure

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 in 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 API.

Features

Navigation in the portal is part of the Enterprise Portal Client Framework (EPCF) and enables you to call other iViews at runtime. The BEx Web application iView is displayed as an iFrame on 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])

Example

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.

Parameter target in JavaScript function EPCM.doNavigate comprises NavigationTarget and DynamicParameter.

Example

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');

Note

Parameter target always starts with ROLES://. Unlike parameter DynamicParameter, parameter name NavigationTarget cannot be specified in the parameter target.

 

Determining the Path of the iView, explains how to find the NavigationTarget component for JavaScript function EPCM-doNavigate.

For an explanation of how to create the DynamicParameter component, see Transferring Parameters to a BEx Web Application iView and Transferring Parameters to SAP-Transactions .

 

End of Content Area