Tutorial Teil 3: App und Konfigurations-App registrieren 
Dieses Tutorial ist ein Teil eines Kurses, der Ihnen die Erstellung und Registrierung von Apps für das Dashboard-Framework nahe bringen soll. In diesem Schritt registrieren Sie die App und die Konfigurations-App, welche Sie in den vorigen Schritten des Tutorials erstellt haben. Erst danach können Sie die App im Rahmen Ihrer Dashboards anzeigen lassen.
Voraussetzungen
Diese Vorgehensweise ist Teil eines umfassenden Tutorials zum Thema Erstellung und Registrierung von eigenen Dashboard Apps. Im Verlauf dieses Tutorials erstellen und registrieren Sie verschiedene Apps und ihre zugehörigen BW-Querys.
Im Rahmen des dritten Teils des Tutorials erweitern Sie eine einfache App um die Möglichkeit einer Konfiguration, d. h. um die Möglichkeit, dass nicht immer Daten des vergangenen Monats dargestellt werden, sondern dass der Benutzer in einer Konfigurations-App den gewünschten Monat auswählen kann.
Hinweis
Stellen Sie sicher, dass Sie die vorhergehenden Schritte, wie sie in Tutorial Teil 3: App mit Konfigurations-App erstellen beschrieben sind, bereits durchgeführt haben.
Vorgehensweise
Sie registrieren beide Apps in Ihrem SAP-Solution-Manager-System.
Registrierung der Standard-App
Starten Sie die Registrierung, indem Sie Ihren Eintrag Registrierung von Apps im SAP Easy Acess Menü mit Doppelklick wählen.
HinweisDetails zur Erstellung eines Eintrags im SAP Easy Acess Menü sowie zu weitere Informationen zur Registrierung von Apps innerhalb dieses Tutorials finden Sie unter Tutorial Teil 1: App registrieren.
Ende des Hinweises.Wählen Sie die Drucktaste Neue App registrieren.
Geben Sie im Bild Allg. Einstellungen die folgenden Daten ein:
Markieren Sie den Auswahlknopf Standard-App.
Geben Sie im Eingabefeld Technischer Name den technischen Namen der App ein. In diesem Tutorial sei dies Z_TUTORIAL_3_APP.
Geben Sie in den Eingabefeldern Kurztext und Beschreibung eine beliebige geeignete Kurzbeschreibung der App ein.
Wählen Sie in der Dropdown-Listbox Namensraum einen beliebigen Namensraum. Möglicherweise müssen Sie zunächst einen passenden Namensraum erstellen. Weitere Informationen hierzu finden Sie in Eigene Apps in der Dashoard-Infrastruktur registrieren.
Wählen Sie in der Dropdown-Listbox Kategorien den Eintrag ohne Zuordnung.
Wählen Sie in der Dropdown-Listbox Berechtigungsgruppe den Eintrag Public.
In App-Flash-Datei (SWF) geben Sie den Speicherort der Flash-Datei an, welche die App enthält. In diesem Fall ist es der Speicherort von ztut3_costs_month.swf, die Sie in diesem Tutorial bereits erstellt haben.
In Symboldatei (JPG) geben Sie den Speicherort einer Bilddatei an, welches in den entsprechenden Oberflächen die App repräsentieren soll. Wählen Sie in diesem Tutorial eine beliebige Bilddatei des Typs JPG.
In Xcelsius-Datei (XLF) geben Sie den Speicherort der Xcelsius-Datei an, welche die App enthält. In diesem Fall ist es der Speicherort von ztut3_costs_month.xlf, die Sie in diesem Tutorial bereits erstellt haben.
Lassen Sie die Eingabefelder Customizing-Auftrag für App-Typ und Workbench-Auftrag für Dateien leer, wenn die Einstellungen in Ihrem System dies zulassen.
Zur App gehört auch eine Konfigurations-App. Da diese zu diesem Zeitpunkt aber noch nicht registriert ist, markieren Sie das Kennzeichen Hat Konfigurations-App nicht.
Wechseln Sie nun zum zweiten Schritt der Registrierung, indem Sie die Drucktaste Weiter wählen.
Geben Sie im Bild Datenquellen für Apps an, aus welchen Quellen die Daten stammen, die in der App angezeigt werden sollen.
Die App, welche Sie erstellt haben, benötigt ihre Daten aus einer BW-Query. Markieren Sie darum in diesem Schritt des Wizards lediglich dieses Kennzeichen.
Wechseln Sie nun zum dritten Schritt der Registrierung, indem Sie die Drucktaste Weiter wählen.
Im Bild BW-Daten geben Sie die Beziehung zwischen der App und der BW-Query an, welche die anzuzeigenden Daten bereitstellt. In diesem Tutorial ist ZTUT1_COSTS_MONTH die zugehörige Query, die Sie im ersten Abschnitt des Tutorials erstellt haben Geben Sie also diese Query im Teilbild BW-Querys ein.
In der Tabelle Filter für BW-Query geben Sie an, auf welche Merkmale die anzuzeigenden Werte in der Query gefiltert werden sollen. In diesem Fall filtern Sie auf den Monat, der in der Konfigurations-App gesetzt wird. Da die Konfigurations-App aber noch nicht am Dashboard-Framework registriert ist, geben Sie jetzt lediglich einen beliebigen Standardwert für den Monat (0CALMONTH) ein. Die Quellenart ist also momentan ein Fester Wert.
Geben Sie also die folgende Zeile in die Tabelle ein:
Filtertyp
InfoObjekt/Variable
Quellenart
Quelle / Wert von
BW InfoObject
0CALMONTH
Fester Wert
201111
In der Tabelle Verwendung von BW-Query-Ergebnis in App geben Sie an, wie die Ergebnisse der Query verwendet werden.
In der Spalte Datenquelle existiert bereits eine Zeile mit dem Eintrag RESULT. Geben Sie hier die Verbindung der App an, an welche die Resultate der Query weiter geleitet werden. In diesem Tutorial ist dies die Verbindung FROM_QUERY_COSTS.
Außerdem wird der Monat 0CALMONTH als Datenquelle in der App verwendet; hierfür tragen Sie in eine eigene Zeile noch die Verbindung der App MONTH ein.
Wechseln Sie nun zum nächsten Schritt der Registrierung, indem Sie die Drucktaste Weiter wählen.
In Navigation haben Sie Gelegenheit, weiter gehende Navigationsmöglichkeiten zu definieren. Dies wird in diesem Teil des Tutorials nicht verwendet.
Wechseln Sie nun zum letzten Schritt der Registrierung, indem Sie die Drucktaste Next wählen.
Im Schritt Einstellungen App-Typ können Sie Ihre Einstellungen nochmals überprüfen. Beenden Sie den Wizard, indem Sie die Drucktaste Fertigstellen wählen.
Registrierung der Konfigurations-App
Starten Sie die Registrierung, indem Sie Ihren Eintrag Registrierung von Apps im SAP Easy Acess Menü mit Doppelklick wählen.
Wählen Sie die Drucktaste Neue App registrieren.
Geben Sie im Bild Allg. Einstellungen die folgenden Daten ein:
Markieren Sie den Auswahlknopf Konfigurations-App.
Geben Sie im Eingabefeld Technischer Name den technischen Namen der App ein. In diesem Tutorial sei dies Z_TUTORIAL_3_CONF.
Geben Sie in den Eingabefeldern Kurztext und Beschreibung eine beliebige geeignete Kurzbeschreibung der App ein.
Wählen Sie in der Dropdown-Listbox Namensraum den Namensraum, den Sie bereits in der Standard-App angegeben haben.
Wählen Sie in der Dropdown-Listbox Kategorien den Eintrag ohne Zuordnung.
Wählen Sie in der Dropdown-Listbox Berechtigungsgruppe den Eintrag Public.
In App-Flash-Datei (SWF) geben Sie den Speicherort der Flash-Datei an, welche die App enthält. In diesem Fall ist es der Speicherort von ztut3_config.swf, die Sie in diesem Tutorial bereits erstellt haben.
In Symboldatei (JPG) geben Sie den Speicherort einer Bilddatei an, welches in den entsprechenden Oberflächen die App repräsentieren soll. Wählen Sie in diesem Tutorial eine beliebige Bilddatei des Typs JPG.
In Xcelsius-Datei (XLF) geben Sie den Speicherort der Xcelsius-Datei an, welche die App enthält. In diesem Fall ist es der Speicherort von ztut3_config.xlf, die Sie in diesem Tutorial bereits erstellt haben.
Lassen Sie die Eingabefelder Customizing-Auftrag für App-Typ und Workbench-Auftrag für Dateien leer, wenn die Einstellungen in Ihrem System dies zulassen.
Bei der Registrierung der zugehörigen App im vorher gehenden Abschnitt konnten Sie noch nicht die Konfigurations-App angeben. Diese Verbindung erstellen Sie jetzt, indem Sie das Kennzeichen Hat Partner-App markieren, und aus der Dropdown-Listbox den Eintrag für die zugehörige App Z_TUTORIAL_3_APP auswählen.
Wechseln Sie nun zum zweiten Schritt der Registrierung, indem Sie die Drucktaste Weiter wählen.
Geben Sie im Bild Datenquellen für Apps an, aus welchen Quellen die Daten stammen, die in der App angezeigt werden sollen:
Die App, welche Sie erstellt haben, benötigt ihre Daten aus einer BW-Query. Markieren Sie darum in diesem Schritt des Wizards dieses Kennzeichen.
Stellen Sie außerdem sicher, dass das Kennzeichen Datenquellen von Partner-Apps einschließen aktiviert ist. Damit stehen die Datenquellen der App auch der zugehörigen Konfigurations-App zur Verfügung.
Wechseln Sie nun zum dritten Schritt der Registrierung, indem Sie die Drucktaste Weiter wählen.
Im Bild BW-Daten geben Sie die Beziehung zwischen der App und der BW-Query an, welche die anzuzeigenden Daten bereitstellt.
In der Tabelle Filter für BW-Query geben Sie an, auf welche Merkmale die anzuzeigenden Werte in der Query gefiltert werden sollen. Dabei werden die Einstellungen der zugehörigen App übernommen.
Für den Monat (0CALMONTH) existiert daher in der Tabelle bereits der Standardwert, den Sie bei der Registrierung der App angegeben haben. Dieser Standardwert soll aber auch durch die Einstellungen der Konfigurations-App überschrieben werden können, weshalb Sie hier zusätzlich die Verbindung der Konfigurations-App MONTH_OUT angeben müssen, welche den gewählten Monat übermittelt.
Geben Sie darum in einer neuen Zeile für das BW:InfoObject 0CALMONTH die Verbindung der Konfigurations-App mit dem Verbindungsnamen MONTH_OUT an.
In der Tabelle Verwendung von BW-Query-Ergebnis in App geben Sie an, wie die Ergebnisse der Query verwendet werden.
Der Monat 0CALMONTH wird auch als Datenquelle in der Konfigurations-App verwendet; hierfür tragen Sie in eine eigene Zeile noch die Verbindung der App MONTH_IN ein.
HinweisDie Zeile RESULT, die immer angezeigt wird, können Sie löschen.
Ende des Hinweises.
Wechseln Sie nun zum vierten Schritt der Registrierung, indem Sie die Drucktaste Weiter wählen.
In Navigation haben Sie Gelegenheit, weiter gehende Navigationsmöglichkeiten zu definieren. Dies wird in diesem Teil des Tutorials nicht verwendet.
Wechseln Sie nun zum letzten Schritt der Registrierung, indem Sie die Drucktaste Weiter wählen.
Im Schritt Einstellungen App-Typ können Sie Ihre Einstellungen nochmals überprüfen. Beenden Sie den Wizard, indem Sie die Drucktaste Fertigstellen wählen.
Ergebnis
Sie haben die von Ihnen erstellten Apps im Dashboard-Framework registriert und können Sie in Ihren Dashboards anzeigen lassen.