Tutorial part 4: Create Complex App with Configuration App

In this fourth part of the Tutorial on Creating and Registering Your Own Dashboard Apps, you extend the app to display various metrics. The method uses a BW query that returns all available metrics, but only displays those specified in the settings of the config app. You can choose among telephone charges, and the number and duration of telephone calls in a month, by the subsidiaries of a fictitious company.

This part of the tutorial shows you how to make your apps more flexible, using a config app, not the BW query .

Prerequisites

This part of the tutorial builds on the third part (Tutorial Part 3: Creating and Registering an App with a Configuration App), which you should have completed first.However, if you only want to perform this part of the tutorial, you can replace the files required from the third part with files delivered by SAP.

Note Note

The app in the third part of the tutorial uses the BW query from the first part.

End of the note.

Required File	Steps to create the required file
Xcelsius file of the app from part 3(`ztut3_costs_month.xlf`)	Start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_1_APP , and choose Details. You can now download the required file by choosing the Download Xcelsius File for Editing in the Xcelsius File (XLF) row, and saving the file locally under the name at the left.
Xcelsius file of the config app from part 3 (`ztut3_config.xlf`)	Start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_3_APP , and choose Details. You can now download the required file by choosing the Download Xcelsius File for Editing in the Xcelsius File (XLF) row, and saving the file locally under the name at the left.
BW query from part 1 (`ZTUT1_COSTS_MONTH`)	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 BW query with the technical name `TUT1_COSTS_MONTH`, and save it under the name `ZTUT1_COSTS_MONTH`.

Required File

Steps to create the required file

Xcelsius file of the app from part 3(ztut3_costs_month.xlf)

Start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_1_APP , and choose Details.

You can now download the required file by choosing the Download Xcelsius File for Editing in the Xcelsius File (XLF) row, and saving the file locally under the name at the left.

Xcelsius file of the config app from part 3 (ztut3_config.xlf)

Start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_3_APP , and choose Details.

You can now download the required file by choosing the Download Xcelsius File for Editing in the Xcelsius File (XLF) row, and saving the file locally under the name at the left.

BW query from part 1 (ZTUT1_COSTS_MONTH)

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 BW query with the technical name TUT1_COSTS_MONTH, and save it under the name ZTUT1_COSTS_MONTH.

Process

Creating the User Interface of the App with Xcelsius

You extend the app from the third part of the tutorial to display the metrics specified in the configuration. You change the display and the data transfer from the BW query, and create a new connection, through which the metric is transferred from the config app (see Tutorial Part 4: Creating an App with Xcelsius).

Creating a BW Query as the Data Source of the App

Use the BW query from the first part of the tutorial (see Tutorial Part 1: Create BW Query), in which only the telephone charges are displayed, and enhance it to display the number and duration of calls. The query returns all these metrics, but only those specified in the config app are displayed in the user interface of the app (see Tutorial Part 4: Creating the BW Query).

Creating the User Interface of the Config App with Xcelsius

This step adds a dropdown list box, in which the user can select the metric to be displayed, to the user interface of the config app from the third part of the tutorial. You create a connection via which tells the the standard app which metric to display (see Tutorial Part 4: Creating a Config App with Xcelsius).

Registering the App and Config App with the Dashboard Framework

You register the newly-created apps with the Dashboard Framework, so that you can add the app to dashboards (see Tutorial Part 4: Registering the App and Config 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_4_APP is displayed in the list. Select your app and choose OK. The app and the config app are displayed next to each other; select the desired month, and choose the Apply button to display the app.
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 (`ztut4_metrics_month.xlf`)	`SAP_TUTORIAL_4_APP.xlf` To download this file, start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_4_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.
Xcelsius file of the config app (`ztut4_config.xlf`)	`SAP_TUTORIAL_4_CONFIG.xlf` To download this file, start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_4_CONFIG , 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 data for the app (`ZTUT4_METRICS_MONTH`)	`TUT4_METRICS_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.

Created File

Corresponding File Delivered by SAP

Xcelsius file of the app

(ztut4_metrics_month.xlf)

SAP_TUTORIAL_4_APP.xlf

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

Xcelsius file of the config app

(ztut4_config.xlf)

SAP_TUTORIAL_4_CONFIG.xlf

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

(ZTUT4_METRICS_MONTH)

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