Show TOC

Process documentationTutorial part 5: Create App with Data Provision by BAdI


In this part of the Tutorial to Create and Register Dashboard Apps, you provide values to an app via your own BAdI implementation, not from the SAP Business Warehouse. Use this data capture option if it is not possible to supply the data using BW queries, for example if you read your current data directly from the SAP Solution Manager. SAP provides an enhancement spot, under which you can create your BAdI implementation. The data flow between app and BAdI implementation is handled by 2 BAdI methods and Xcelsius connections in the app. This part of the tutorial explains how to use them.

This part of the tutorial explains how to supply apps with data via an other method.


This part of the tutorial does not depend on the previous parts, so you can work through it independently of them. The creation of a BAdI implementation requires detailed knowledge of ABAP, which this part of the tutorial assumes.


Creating the User Interface of the App with Xcelsius

Use Xcelsius to create the user interface of the app. You need not yet have set up data capture at this time. You can concentrate on the design of the user interface, and use example data in the Excel spreadsheet in Xcelsius. Create the Xcelsius connection, via which the app gets the data to be displayed, from the BAdI implementation (see Tutorial part 5: Create App with Xcelsius).

Create BAdI implementation as data source

Create a simple BAdI implementation which supplies an app with values. The implementation passes additional information about the subsidiaries of a fictional company, in a table that is forwarded to the app via an Xcelsius connection, and displayed in the app (see Tutorial part 5: Create BAdI Implementation).

Registering the App with the Dashboard Framework

Register the app with the Dashboard Framework, so that you can add the app to dashboards (see Tutorial Part 5: 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_5_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 element

Element 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_5_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.

BAdI implementation



To display the BAdI implementation, start the Object Navigator (transaction SE80), and expand the package AI_DSH_CORE along the path Start of the navigation path AI_DSH_CORE Next navigation step Enhancements Next navigation step Enhancement Spots Next navigation step DFWK_DS_BADI_DATA Next navigation step Enhancement Implementations Next navigation step DSHB_TUTORIAL_DATA_SUPPLIER End of the navigation path