Tutorial part 3: Register App and Configuration App 
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.
Prerequisites
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.
Procedure
You register both apps in your SAP Solution Manager system.
Registering the Standard App
Start the registration by double-clicking your entry, Registration of Apps, in the SAP Easy Access Menu.
NoteFor 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.
End of the note.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:
Filter Type
InfoObject/Variable
Source Type
Source/Value From
BW InfoObject
0CALMONTH
Fixed Value
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.
Registering the Config App
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.
NoteYou can delete the row RESULT, which is always displayed.
End of the note.
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.
Result
You have registered the apps that you created in the Dashboard Framework and can display them in your dashboards.