Tutorial part 3: Create App with Configuration App

In this third part of the Tutorial on Creating and Registering Your Own Dashboard Apps, you extend the simple app from the first part with the option of configuration. You can use this config app to make settings for the app so that the telephone costs of a company are not always displayed for the previous month, but rather for any month that you set in the config app, by selecting the desired calendar month and year.

The primary aim of this part of the tutorial is to introduce you to the possibility of a config app.

Prerequisites

This part of the tutorial builds on the first part (Tutorial Part 1: Creating and Registering a Simple App), which means that you should have completed it first. However, if you only want to work through this part of the tutorial, you can replace the files required from the first part with files delivered by SAP.

Required File	Steps to create the required file
Xcelsius file of the app from part 1(`ztut1_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.
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 1(ztut1_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.

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 use the app from the first part of the tutorial, and extend it with the option of being able to set the month for which you want to display the data with a config app. To do this, you need to create a connection in the app to pass this month. You do not need to have set up the data provision yet. You can concentrate on the design of the user interface, and use example data in the Microsoft Excel worksheet that is integrated into Xcelsius (see Tutorial Part 3: Creating an App with Xcelsius)..

Creating the User Interface of the Config App with Xcelsius

You can use Xcelsius to create the user interface of the config app, that is, the app that is called if the user wants to configure his or her app. In this config app, the user can select the calendar month and year (for example, July 2011), for which he or she wants to display the telephone costs (see Tutorial Part 3: 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 3: 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_3_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 (`ztut3_costs_month.xlf`)	`SAP_TUTORIAL_3_APP.xlf` To download this file, start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_3_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 (`ztut3_config.xlf`)	`SAP_TUTORIAL_3_CONFIG.xlf` To download this file, start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_3_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 from the first part of the tutorial (`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.

Created File

Corresponding File Delivered by SAP

Xcelsius file of the app

(ztut3_costs_month.xlf)

SAP_TUTORIAL_3_APP.xlf

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

(ztut3_config.xlf)

SAP_TUTORIAL_3_CONFIG.xlf

To download this file, start the registration tool, select the app Tutorial Samples SAP_TUTORIAL_3_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 from the first part of the tutorial

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