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 You can now download the required file by choosing the |
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. |
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).
Register the app with the Dashboard Framework, so that you can add the app to dashboards (see Tutorial Part 6: Registering the App).
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).
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:
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:
In the SAP Easy Access menu, call
.From the list in the Restrictions
screen, choose Web-Dynpro Applications
.
On the Web Dynpro Application
screen, in the Web Dynpro Application
field, enter the name generic_dashboard_viewer.
Enter a description, for example Personal Dashboard.
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_6_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.
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
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.
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 (ztut6_translatable.xlf) |
SAP_TUTORIAL_6_APP.xlf To download this file, start the registration tool, select the app |