Show TOC

Process documentationTutorial part 1: Create and Register a Simple App


In this first part of the Tutorial on Creating and Registering Your Own Dashboard Apps, you create a simple app without drill down or configuration options. This app is supplied with values from the Business Warehouse using a BW query. The primary purpose of this part of the tutorial is for you to become familiar with the tools used, and to understand that you can create an app with little effort.


Creating the User Interface of the App with Xcelsius

You use Xcelsius to create the user interface of the app. You need not yet have set up data provision at this time. You can concentrate on the design of the user interface, and use any example data in the Microsoft Excel worksheet that is integrated into Xcelsius (see Tutorial Part 1: Creating an App with Xcelsius).

Creating a BW Query as the Data Source of the App

You create a BW query as data source. You can use any data stored in the Business Warehouse system assigned to the SAP Solution Manager system (see Tutorial Part 1: Creating the BW Query.

Registering the App with the Dashboard Framework

Finally, you need to register the app with the Dashboard Framework, so that you can add the app to all appropriate dashboards (see Tutorial Part 1: Registering the App).

Displaying the App in Your Own Dashboard

Once you have created and registered your app, display your app in your personal dashboard. To call your personalized dashboard, and to display the app that you created there, proceed as follows:

  1. You call your personalized dashboard using a Web Dynpro application called my_dashboard. If you have not yet added this Web Dynpro application to your favorites in your SAP Easy Access Menu, you can create this entry as follows:

    1. In the SAP Easy Access menu, call Start of the navigation path Favorites Next navigation step Add Other Objects End of the navigation path.

    2. From the list in the Restrictions screen, choose Web Dynpro Applications.

    3. On the Web Dynpro Application screen, in the Web Dynpro Application field, enter the name generic_dashboard_viewer.

    4. Enter a description, for example Personal Dashboard.

    5. Insert a row in the table Parameter, in the Name column, enter ALIAS, and in the Value column, enter PERSONAL_DASHBOARD.

    Start your personal dashboard by double-clicking the relevant entry in you favorites.

  2. To add a new app to the dashboard, choose the Configure button, and then Add New App.

  3. A list of the available apps appears, grouped by category. The app that you created in this tutorial is not assigned to a category. Therefore expand the Not Assigned category.

  4. Your app Z_TUTORIAL_1_APP is displayed in the list. Select your app and choose OK.

  5. To save the dashboard with the app that you have just added, choose the Save Dashboard button.


You have completed this part of the tutorial and displayed the relevant app in your personal dashboard. If you have not achieved the desired result, compare your results with the apps delivered by SAP.

Created File

Corresponding File Delivered by SAP

Xcelsius file of the app



To download this file, start the registration tool, select the app Start of the navigation path Tutorial Samples Next navigation step SAP_TUTORIAL_1_APP End of the navigation path, and choose the Details button. You can now download the required file by choosing the Download Xcelsius File for Editing in the Xcelsius File (XLF) row.

BW Query to Supply the App with Data



To display the query, start the BEx Query Designer, and enter the BW system or the BW client that is assigned to your SAP Solution Manager system. Open the file specified above.