Show TOC

Procedure documentationTutorial Part 8: Register Apps

 

This tutorial is part of a course that explains how to create and register apps for the Dashboard Framework. In this step, you register the apps that you created in the previous step of the tutorial. 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.

You perform this registration in the eighth part of the tutorial.

Note Note

Ensure that you have already performed the previous steps, as described in Tutorial Part 8: Create Dashboard with Context App.

End of the note.

Procedure

You register all three apps in your SAP Solution Manager system.

  1. Start the registration by double-clicking your entry, Registration of Apps, in the SAP Easy Access Menu.

    Note Note

    For more information about creating an entry in the SAP Easy Access menu, and for information about registering apps within this tutorial, see Tutorial Part 1: Register App.

    End of the note.
  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_8_COSTS.

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

    • The app is to be assigned to the z_tutorial namespace. Create the namespace first by choosing Create Namespace.

      For more information about namespaces, see Registering User Apps in the Dashboard Framework.

    • In the Category dropdown list box, choose Not Assigned.

    • In the Authorization Group dropdown list box, choose the Public entry.

    • 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 ztut8_costs_month.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 ztut8_costs_month.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. In this case, select only the Data from BW Query flag, since the app requires data from a BW query.

    Note Note

    Although the app determines the month for which data is to be displayed using a context app, you leave the Data from Dashboard Context flag empty. The reason for this is that the context acts only as a filter for the data that you want to read from a BW query and not as an actual data source.

    End of the note.

    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 again ZTUT4_METRICS_MONTH, which you enter in the BW Queries subscreen.

    • 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 case, you filter by the month set in the context app. To do this, you need to specify a technical name for the context, which you specify later when you register the context app.

      However, since the context app is not yet registered with the Dashboard Framework, specify a technical name with CONTEXT_MONTH, which you enter again when you register the context app.

      Enter the following row in the table:

      Filter Type

      InfoObject/Variable

      Source Type

      Source/Value From

      BW InfoObject

      0CALMONTH

      Context

      CONTEXT_MONTH

    • 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 FROM_QUERY_COSTS.

      The month 0CALMONTH is also used as a data source in the app; for this purpose, enter the app connection MONTH in a separate row.

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

  6. In Navigation, you can define further navigation options. This is not used in this part of the tutorial.

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

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

  8. You have now registered one of the three apps that you want to display in your dashboard. Register the other two apps that you created in Tutorial Part 8: Preparing Apps for Using Contexts in the same way:

    • Register an app with the technical name Z_TUTORIAL_8_DURATION that displays the overall duration of the telephone calls. To do this, specify the storage location of ztut8_duration_month.swf for the App Flash File (SWF) and the storage location of ztut8_duration_month.xlf for the Xcelsius File (XLF).

    • Register an app with the technical name Z_TUTORIAL_8_DURATION that displays the number of telephone calls. To do this, specify the storage location of ztut8_number_month.swf for the App Flash File (SWF) and the storage location of ztut8_number_month.xlf for the Xcelsius File (XLF).

    Note Note

    From step 2 on, the registration of all three apps is identical.

    End of the note.

Result

You have registered the app that you created in the dashboard framework. However, before you can display it in a dashboard, you first have to register the context app (see Tutorial Part 8: Register Context App).