Show TOC

Function documentationNavigation in the Dashboard Framework


You can specify additional navigation options, in the Dashboard Framework, when you create user apps. Navigation is calling other functions from the context menu, or by clicking on a UI element. Such navigation can, for example, display other dashboards or dashboard apps (detail apps). Navigation can be a drill-down through several levels.


To specify navigation options when registering your app, proceed as follows:

  1. Register as in Registering User Apps in the Dashboard Framework.

  2. You can assign the navigation ottions to your app, in the last-but-one step of the registration. Enter the following data in the Navigation Targets table for each navigation option:




    Unique navigation ID; you can set these freely in the registration


    Navigation name; this name is displayed in the context menu (if the navigation can be performed there) and as the screen header when the navigation is performed

    Target Type

    Specifies what is to be done when the navigation is performed; the possible navigation targets are listed below

  3. Under Start Time, specify the conditions under which the navigation is to be performed. The possibilities are:

    • Call in Context Menu

      You can specify context menu entries when you register the app. If the user displays the app and chooses this entry in the context menu, the corresponding navigation is performed.

    • (Change in App Connection) using an Xcelsius connection

      In the graphical Xcelsius component, which you can put in the UI, you can drill-down. You can, for example, specify a drill-down in a diagram, in which the user can click on data displayed in the diagram. Xcelsius writes the selected data (e.g. the position of the data row) in a cell of the associated Excel table, which is connected by an Xcelsius connection. Specify this connection in the drop-down list box next to Change in App Connection.

      The Dashboard Framework can react to changes to a connection, so it can navigate when the user clicks on specific UI elements.

  4. Specify how the navigation is to be performed, under Entry Point:

    • Choose New Window, to perform the navigation in a new window.

    • Choose Embedded, to perform the navigation in the current window.

  5. Specify further information, depending on the Target Type:

    Target Type


    Static URL

    A fixed URL is assigned to the navigation; enter this address in the input field URL.

    Other Dashboard

    Another dashboard, which you specify in Dashboard Alias, is assigned to the navigation. Further information about creating dashboards is under Creating and Editing Dashboards.

    You can pass dashboard parameters via an Xcelsius connection, by specifying the connection in the Outbound App Connection column, and linking it to a context of the dashboard to be called (column Target Name). For apps of the dashboard to be able to process data in this context, you must link the context with an incoming Xcelsius connection when you register the app.

    List of Apps

    One or more apps to be displayed in the navigation, are assigned to it. Specify the technical name of the detail app. Thie parameters are passed as in Other Dashboard.

    Other Web Dynpro

    A Web Dynpro component which you specify in the drop-down list box WD Component Name, is assigned to the navigation.

    Note Note

    The Web Dynpro component must use the interface DFWK_ACTION_STARTER_IF. This ensures that the component can process the data written by the outgoing Xcelsius connection in the target context.

    End of the note.

    BAdI-Generated URL

    A URL which is created by a BAdI, is assigned to the navigation. No further parameters are required, as the implementation to be called is determined by the BAdI implementation filter values. The implementation must belong to the enhancement spot IF_DFWK_ACTION_CALL_URL.

  6. In the App Type Settings step, you can check your settings again. Exit the Wizard by choosing the Finish button.

More Information

An example of the use of navigation in user apps is in Tutorial: Creating and Registering Dashboard Apps.