Tutorial Teil 2: App und Detail-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 Detail-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 zweiten Teils des Tutorials erweitern Sie eine einfache App um einen Drilldown, d. h. um die Möglichkeit, dass aus einer App heraus kontextabhängig eine weitere App aufgerufen wird.
Hinweis
Stellen Sie sicher, dass Sie die vorhergehenden Schritte, wie sie in Tutorial Teil 2: App mit zusätzlicher Navigation erstellen beschrieben sind, bereits durchgeführt haben.
Vorgehensweise
Sie registrieren beide Apps in Ihrem SAP-Solution-Manager-System.
Hinweis
Sowohl bei der Registrierung der App als auch der Detail-App gibt es Angaben, die sich auf die jeweils anderen Bestandteil beziehen. In diesem Tutorial registrieren Sie zunächst die Detail-App, bei dieser Registrierung geben Sie allerdings an, dass die gewählte Niederlassung in einem Kontext namens LOCATION dieser Detail-App übergeben wird. Diesen Kontext definieren Sie erst später bei der Registrierung der App.
Registrierung der Detail-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 Allgemeine 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_2_DETAIL.
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 ztut2_costs_day.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 ztut2_costs_day.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.
Da zu dieser App keine Konfigurations-App gehört, 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 sowie aus einem Dashboard-Kontext. Markieren Sie darum in diesem Schritt des Wizards die genannten 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 ZTUT2_COSTS_DAY die zugehörige Query, die Sie im vorigen 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. Da in dieser Detail-App nur die Daten der gewählten Niederlassung (BW-InfoObjekt 0CCM_SRCL) angezeigt werden sollen, ist dies genau ein solcher Filter. Er soll der Detail-App über einen Kontext namens LOCATION übergeben werden, den Sie bei der Registrierung der App weiter unten erstellen. Geben Sie darum die folgenden Werte in eine Zeile ein:
Spalte
Eingabe
Filtertyp
BW: InfoObject
InfoObjekt/Variable
0CCM_SRCL
Quellenart
Kontext
Quelle / Wert von
LOCATION
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_DAY, die Verbindung, welche Sie bei der Erstellung des Xcelsius-UI erstellt haben.
Wechseln Sie nun zum nächsten Schritt der Registrierung, indem Sie die Drucktaste Weiter wählen.
Geben Sie im Bild Über Dashboard-Kontext bereitgestellte Daten an, über welche Verbindung der Kontext (in diesem Fall LOCATION) mit Werten versorgt wird. Dies ist die Verbindung SEL_LOCATION, welche Sie in der Xcelisius-Benutzungsoberfläche der Detail-App angelegt haben. Geben Sie darum die folgenden Werte in eine Zeile ein:
Spalte
Eingabe
Beliebiger Name der Daten
LOCATION
Ausgehende App-Verbindung
SEL_LOCATION
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. Da Sie sich hier bereits auf der Ebene der aufgerufenen Detail-App befinden, von der aus kein weiterer Drilldown möglich sein soll, geben Sie hier nichts ein.
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.
Registrierung der Standard-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 Standard-App.
Geben Sie im Eingabefeld Technischer Name den technischen Namen der App ein. In diesem Tutorial sei dies Z_TUTORIAL_2_APP.
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 Detail-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 ztut2_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 ztut2_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.
Da zu dieser App keine Konfigurations-App gehört, 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 vorigen 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 unserem Beispiel gibt es keine solchen Filter. Zwar werden nur die Daten des letzten Monats angezeigt, aber diese Filterung geschieht bereits in der BW-Query selbst.
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, die Verbindung, welche Sie bei der Erstellung der Xcelsius-UI erstellt haben.
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 genau ist der eigentliche Kern dieses Teils des Tutorials. Geben Sie zunächst in der Tabelle Navigationsziele eine Navigationsmöglichkeit an. Eine solche Navigationsmöglichkeit beinhaltet einen eindeutigen technischen Namen (ID), den Sie hier frei wählen können, eine Beschreibung und eine Zielart, mit dem Sie angeben, was eigentlich bei einer solchen Navigation aufgerufen werden soll.
Geben Sie in diesem Tutorial die folgenden Werte in eine Zeile der Tabelle Navigationsziele ein:
Spalte
Eingabe
ID
JUMP_SELECTION
Beschreibung
Tägliche Kosten
Zieltyp
Liste der Apps
Die Navigation soll immer dann durchgeführt werden, wenn sich der Wert in der Verbindung SEL_LOCATION ändert, d. h. wenn der Benutzer eine andere Niederlassung in der übergeordneten App angeklickt hat. Markieren Sie darum den Auswahlknopf Änderung in App-Verbindung, und wählen Sie in der dazu gehörigen Dropdown-Listbox den Eintrag SEL_LOCATION.
Sie können bestimmen, ob die Detail-App in einem eigenen Fenster des Bestriebssystems angezeigt werden soll oder nicht. In diesem Fall soll die nicht der Fall sein, markieren Sie darum den Auswahlknopf Eingebunden.
Sie haben weiter oben bestimmt, dass bei der Durchführung der Navigation eine Liste von Apps angezeigt werden soll. In diesem Fall ist dies nur eine App, und zwar die Detail-App, die Sie weiter oben registriert haben. Fügen Sie darum in der Tabelle Liste der Detail-Apps mit Hilfe der Ausfüllhilfe die App Z_TUTORIAL_2_DETAIL ein.
Die Detail-App benötigt die ausgewählte Niederlassung; hierfür wird die Verbindung SEL_LOCATION verwendet. Die eigentliche Übergabe der Niederlassung erfolgt aber in dem Kontext LOCATION, den Sie bereits oben bei der Registrierung der Detail-App angebeben haben. Geben Sie also die folgenden Werte in eine Zeile der Tabelle Mapping von ausgehenden App-Verbindungen zu Zielkontext ein:
Spalte
Eingabe
Ausgehende App-Verbindung
SEL_LOCATION
Zielname
LOCATION
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.