Show TOC

Procedure documentationTutorial Part 8: Register Context App

 

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 context app that you created in a previous step of the tutorial. Only once you have done this can you display the associated apps 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 the context app 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 Configuration App radio button, since a context app is technically a configuration app.

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

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

    • The app should also be assigned to the z_tutorial namespace, which you created in Tutorial Part 8: Register Apps.

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

    • In contrast to a conventional configuration app, a context app does not have a partner app, since it enables settings across all apps of a dashboard. Do not select the Has Partner 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 Dashboard Context indicator.

    Also select the Wait for Changes indicator for the BUTTON app connection in the App Connections table. You created this connection in Tutorial Part 8: Create Context App with Xcelsius; it contains a cell whose content changes each time data is to be displayed for a different month. The Wait for Changes indicator ensures that the dashboard framework reacts to the changed month in this case.

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

  5. On the Data from Dashboard Context screen, specify the connections through which the context data is to be transferred. In most cases, the context data is transferred through an inbound and outgoing connection – in this tutorial, this is MONTH_IN and MONTH_OUT for the selected month. You also specify a technical name for the context here. You specified this technical name already in Tutorial Part 8: Register Apps with CONTEXT_MONTH.

    In the used context data table, enter the following two rows:

    Dashboard Context Name

    Incoming App Connection

    Outgoing App Connection

    CONTEXT_MONTH

    MONTH_IN

    CONTEXT_MONTH

    MONTH_OUT

    Go to the fourth step of 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.

Result

You have registered the context app that you created in the dashboard framework. You cannot add a context app to a dashboard in the usual way; you do this for the required dashboard using a BAdI implementation, which you create in the next step (see Tutorial Part 8: Create BAdI Implementation).