Show TOC

Process documentationTutorial part 1: Create and Register a Simple App Locate this document in the navigation structure

 

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.

Process

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

  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.

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 File

Corresponding File Delivered by SAP

Xcelsius file of the app

(ztut1_costs_month.xlf)

SAP_TUTORIAL_1_APP.xlf

To download this file, start the registration tool, select the app   Tutorial Samples   SAP_TUTORIAL_1_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.

BW Query to Supply the App with Data

(ZTUT1_COSTS_MONTH)

TUT1_COSTS_MONTH

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.