Show TOC

Procedure documentationTutorial part 6: Register the App Locate this document in the navigation structure

 

This tutorial is part of a course that explains the creation and registration of apps for the Dashboard Framework. In this step, you register the app which you created in the previous step in the tutorial, and specify the default values of the translatable texts. Only once you have done this can you display the app in your dashboards.

Prerequisites

This procedure is part of a comprehensive tutorial about Creating and Registering Dashboard Apps. During this tutorial, you create and register a number of apps and their associated BW queries.

In the sixth part of the tutorial, you create a simple app with translatable texts, which you register in your SAP Solution Manager system in this step.

Note Note

You must have already performed the previous steps, as described in Tutorial Part 6: Creating an App with Translatable Texts.

End of the note.

Procedure

You register the app in your SAP Solution Manager system.

  1. Start the registration by double-clicking the entry that you created above, Registration of Apps, in the SAP Easy Access Menu.

  2. Choose Register New App.

  3. On the General Settings screen, enter the following data:

    • Select the Standard App radio button.

    • In the Technical Name field, enter the technical name of the app. In this tutorial, this is Z_TUTORIAL_6_APP.

    • In the Short Text and Description input fields, enter a short description of the app.

    • In the Namespace dropdown list box, choose a namespace. You may have to create it first. For more information, see Registering User Apps in the Dashoard Infrastructure.

    • In the Categories dropdown list box, choose the entry that represents the appropriate topic for the app from the user's point of view; you can specify multiple categories. In this tutorial, choose the category Not Assigned.

    • The Authorization Group dropdown list box specifies whether an authorization check is to be performed when the app is called. In this tutorial, choose the entry Public, which means that no additional authorization check is performed.

    • In App Flash File (SWF), specify the storage location of the flash file that contains the app. In this case, this is the storage location of ztut6_translatable.swf, which you created earlier in the tutorial.

    • In Icon File (JPG), specify the storage location of an image file that is to represent the app in the relevant interfaces. In this tutorial, choose any image file of the type JPG.

    • In Xcelsius File (XLF), specify the storage location of the Xcelsius file that contains the app. In this case, this is the storage location of ztut6_translatable.xlf, which you created earlier in the tutorial.

    • Leave the input fields Customizing Request for App Type and Workbench Request for Files empty, if the settings in your system permit this.

    • Since there is no config app for this app, do not select the Has Config App indicator.

    Now move to the second step of the registration by choosing the Next button.

  4. On the Data Sources of Apps screen, specify the sources of the data that is displayed in the app.

    The app which you have created needs a BW query (Data Provides by BW Query) for your data, and Other Values (Text, Numbers, etc.) with the translatable texts. Set these two flags.

    Now go to the third step of the registration by choosing Next.

  5. On the BW Data screen, specify the relationship between the app and the BW query that provides the data to be displayed. The query in this tutorial is ZTUT1_COSTS_MONTH, which you created earlier in the tutorial. enter this under BW Queries.

    • In the Filter for BW Query table, specify the characteristics to be used in the query to filter the values to be displayed. In this example, there are no filters of this type. Although only data for the last month is displayed, this filtering is done in the BW query itself.

    • In the Usage of BW Query Result in App table, you specify how the results of the query are used.

      In the column Source of Data, there is already a row with the entry RESULT. Specify here the app's connection to which the results of the query are forwarded. In this tutorial, this is the connection FROM_QUERY_COSTS, the connection that you created earlier in the tutorial.

    Go to the fourth step of the registration by choosing the Next button.

  6. In the screen Texts, Values, etc. enter the default values of translatable texts or configurable values. They belong to Xcelsius connections. In this tutorial, they are the connections TITLE and SUBTITLE, which are in translatable texts. Proceed as follows:

    1. Add a new Data Group Name by entering a name in the table. This can be any name, you define it during registration, so it is not specified in the connections or elsewhere in the associated Xcelsius file. Enter TITLE (the match with the Xcelsius connection is coincidental).

    2. The text is not configurable by app, but is translatable. Set the flags appropriately.

    3. The Xcelsius connection is TITLE. Choose this connection in the drop-down list Incoming App Connection.

    4. In the following table, enter the contents of the cells which was transferred to the app via the Xcelsius connection, i.e. map the cell area of the connection. In the Header Field of Field 1, enter a technical name. You can respond to the contents of this cell in Xcelsius, but as this function is not used in the tutorial, the contents are arbitrary (but must not be empty); enter Title again here, for example.

    5. In the Data Field of Field 1, enter the text. Enter Monthly Costs per Subsidiary. The text is assigned to the language in which you are registered in the registration tool.

    6. For the subtitle, add a second Data Group Name with Add, and enter the arbitrary data group name SUBTITLE.

    7. The text is not configurable by app, but is translatable. Set the flags appropriately.

    8. The Xcelsius connection is SUBTITLE. Choose this connection in the drop-down list Incoming App Connection.

    9. In the following table, in the Header Field of Field 1 with Subtitle, enter an arbitrary technical name.

    10. In the Data Field of Field 1, enter Last Month.

    Go to the next step in the registration by choosing the Next button.

  7. In Navigation, you can define further navigation options. Since you do not want to use this in this part of the tutorial, do not enter anything here.

    Now move to the final step of the registration by choosing the Next button.

  8. In the App Type Settings step, you can check your settings again. Exit the Wizard by choosing the Finish button.

Result

You have registered the app that you created in the Dashboard Framework and can display it in your dashboards. To actually translate the texts (to display the app in the translated language), perform the section Tutorial part 6: Translate Texts.