Show TOC

Process documentationTutorial part 6: Create App with Translatable Texts


In this part of the Tutorial to Create and Registrer Dashboard Apps you enhance a simple app with translatable texts, i.e. you use the dashboard infrastructure to flag texts as translatable, and to translate them.


Since the different parts of the tutorial build on each other, you should have completed the previous part of the tutorial (Tutorial Part 1: Creating and Registering a Simple App), as you need the Xcelsius file and the query from the first part, in this part. 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 Start of the navigation path Tutorial Samples Next navigation step SAP_TUTORIAL_1_APP End of the navigation path, 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.


Creating the User Interface of the App with Xcelsius

In this step, you enhance the app from the first part of the tutorial with translatable text elements, and specify the title and subtitle of the app as to be translated. You must connect the cells in the Excel table to the Dashboard Framework via an Xcelsius connection (see Tutorial part 6: Create App with Xcelsius).

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 6: Registering the App).

Translate Text Elements

In this step, you translate the texts flagged as translatable in the app which you registered in the previous step of the tutorial. You can then display the app in your dashboard in the translated languages (see Tutorial part 6: Translate Texts).

Displaying the App in Your Dashboard

Once you have created and registered your app, and translated the text elements, display it app in your dashboard. To call your dashboard and display the app that you created, in it, proceed as follows:

  1. Call your dashboard with the Web Dynpro application 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_6_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.

  6. The translatable texts of the app (title and subtitle) are displayed in your logon language, if they are available in it. Change it, to check if the elements are displayed in the desired language.

    Note Note

    • If you display your dashboard in its own browser window, you can change the display language directly in the URL in the browser address field. Adjust the language key in the URL after sap-language=.

    • The app contains other translatable text elements as well as the title and subtitle, in the graphic. These are short descriptions of BI info objects delivered by SAP, so they are already available in various languages.

    End of the note.


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