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 and the config app that you created in the previous steps 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 on the topic Creating and Registering Dashboard Apps. During this tutorial, you create and register a number of apps and their associated BW queries.
In this third part, you extend a simple app with the option of configuring the app, that is, instead of always displaying data for the previous month, the user can select the desired month in a config app.
Note
Ensure that you have already performed the previous steps, as described in Tutorial Part 3: Creating an App with a Config App.
You register both 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: Registering the 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_3_APP.
In the Short Text
and Description
input fields, enter any suitable 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 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 ztut3_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 ztut3_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.
There is also a config app for the app. However, since you have not yet registered it, 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.
The app that you have created requires data from a BW query. In this step of the wizard, therefore, select only this indicator.
Now move to the third step of the registration by choosing the Next
button.
On the BW Data
screen, specify the relationship between the app and the BW query that provides the data to be displayed. In this tutorial, the associated query is ZTUT1_COSTS_MONTH, which you created earlier in the tutorial. Therefore enter this query 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 are filtering by the month set in the config app. However, since the config app is not yet registered with the Dashboard Framework, enter only a default value of your choice for the month at this stage (0CALMONTH). The Source Type
is therefore currently a Fixed Value
.
Enter the following row in the table:
|
|
|
|
|
0CALMONTH |
|
201111 |
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.
Start the registration by double-clicking your entry, Registration of Apps
, in the SAP Easy Access Menu.
Choose Register New App
.
On the General Settings
screen, enter the following data:
Select the Configuration App
radio button.
In the Technical Name
field, enter the technical name of the app. In this tutorial, this is Z_TUTORIAL_3_CONF.
In the Short Text
and Description
input fields, enter any suitable short description of the app.
In the dropdown list Namespace
, choose the namespace which you specified in the default app.
In the Categories
dropdown list box, choose the entry 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 ztut3_config.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 ztut3_config.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.
When registering the associated app in the previous section, you could not yet specify the config app. You create this connection now, by selecting the Has Partner App
indicator, and selecting the entry for the associated app, Z_TUTORIAL_3_APP
, from the dropdown list box.
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.
The app that you have created requires data from a BW query. In this step of the wizard, therefore, select this indicator.
Ensure that the Include Partner App Data Sources
indicator is also selected. This means that the app's data sources are also available to the associated config app.
Now move to the third step of the registration by choosing the Next
button.
On the BW Data
screen, specify the relationship between the app and the BW query that provides the data to be displayed.
In the Filter for BW Query
table, specify the characteristics to be used in the query to filter the values to be displayed. The settings of the associated app are copied.
The default value that you specified when registering the app therefore already exists in the table for the month (0CALMONTH
). However, it should also be possible to overwrite this default value with the settings of the config app, which means that you now also specify the connection of the config app MONTH_OUT
, which passes the selected month.
Therefore, in a new row for the BW:InfoObject
0CALMONTH, specify the Configuration App Connection
with the connection name MONTH_OUT
.
In the Usage of BW Query Result in App
table, you specify how the results of the query are used.
The month 0CALMONTH is also used as a data source in the config app; for this purpose, enter the app connection MONTH_IN
in a separate row.
Note
You can delete the row RESULT
, which is always displayed.
Now move to the fourth step of 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 registered the apps that you created in the Dashboard Framework and can display them in your dashboards.