Tutorial 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.

Prerequisites

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.

Process

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:

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 Favorites Add Other Objects .
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.
To add a new app to the dashboard, choose the Configure button, and then Add New App.
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.
Your app Z_TUTORIAL_5_APP is displayed in the list. Select your app and choose OK.
To save the dashboard with the app that you have just added, choose the Save Dashboard button.

Result

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 (`ztut5_more_info.xlf`)	`SAP_TUTORIAL_5_APP.xlf` To download this file, start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_5_APP , 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 (`Z_TUTORIAL_DATA_SUPPLIER`)	`DSHB_TUTORIAL_DATA_SUPPLIER` To display the BAdI implementation, start the Object Navigator (transaction `SE80`), and expand the package AI_DSH_CORE along the path AI_DSH_CORE Enhancements Enhancement Spots DFWK_DS_BADI_DATA Enhancement Implementations DSHB_TUTORIAL_DATA_SUPPLIER

Created element

Element delivered by SAP

Xcelsius file of the app

(ztut5_more_info.xlf)

SAP_TUTORIAL_5_APP.xlf

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

(Z_TUTORIAL_DATA_SUPPLIER)

DSHB_TUTORIAL_DATA_SUPPLIER

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 Enhancement Spots DFWK_DS_BADI_DATA Enhancement Implementations DSHB_TUTORIAL_DATA_SUPPLIER End of the navigation path