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.
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
Ensure that you have already performed the previous steps, as described in Tutorial Part 8: Create Dashboard with Context App.
You register all three apps in your SAP Solution Manager system.
Start the registration by double-clicking your entry, Registration of Apps
, in the SAP Easy Access Menu.
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.
Choose Register New App
.
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.
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
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.
Now go to the third step of the registration by choosing Next
.
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:
|
|
|
|
| 0CALMONTH |
| 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.
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.
In the App Type Settings
step, you can check your settings again. Exit the Wizard by choosing the Finish
button.
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
From step 2 on, the registration of all three apps is identical.
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).