Tutorial Teil 4: Komplexe App mit Konfigurations-App erstellen

In diesem vierten Teil des Tutorial zur Erstellung und Registrierung eigener Dashboard-Apps erweitern Sie die App aus dem dritten Teil um die Möglichkeit, unterschiedliche Metriken anzeigen zu können. Dabei wird eine Methode verwendet, dass die zugrunde liegende BW-Query stets alle zur Auswahl stehenden Metriken liefert, aber je nach den Einstellungen in der zugehörigen Konfigurations-App nur die gewünschte Metrik angezeigt wird. Zur Auswahl stehen Telefonkosten, sowie Anzahl und Dauer der Telefonate eines beliebigen Monats, aufgeschlüsselt nach den verschiedenen Niederlassungen eines fiktiven Unternehmens.

Dieser Teil des Tutorials dient damit primär dazu, dass Sie die Möglichkeit kennenlernen, ohne den Weg über die BW-Query durch eine Konfigurations-App Ihre Apps flexibler zu machen.

Voraussetzungen

Dieser Teil des Tutorials baut auf dem dritten Teil auf (Tutorial Teil 3: App mit Konfigurations-App erstellen und regist), das Sie damit vorher abgeschlossen haben sollten. Falls Sie jedoch ausschließlich diesen Teil des Tutorials durcharbeiten möchten, können Sie die benötigten Dateien aus dem dritten Teil auch durch Dateien ersetzen, die von SAP ausgeliefert werden.

Hinweis Hinweis

Die App aus dem dritten Teil des Tutorials verwendet die BW-Query aus dem ersten Teil.

Ende des Hinweises.

Benötigte Datei	Schritte zum Erstellen der benötigten Datei
Xcelsius-Datei der App aus Teil 3(`ztut3_costs_month.xlf`)	Starten Sie das Registrierungswerkzeug, markieren Sie die App Tutorial Samples SAP_TUTORIAL_3_APP , und wählen Sie die Drucktaste Details. Sie können nun die benötigte Datei herunterladen, indem Sie in der Zeile Xcelsius-Datei (XLF) die Drucktaste Xcelsius-Datei zum Bearbeiten herunterladen wählen, und die Datei unter dem links genannten Namen lokal sichern.
Xcelsius-Datei der Konfigurations-App aus Teil 3(`ztut3_config.xlf`)	Starten Sie das Registrierungswerkzeug, markieren Sie die App Tutorial Samples SAP_TUTORIAL_3_CONFIG , und wählen Sie die Drucktaste Details. Sie können nun die benötigte Datei herunterladen, indem Sie in der Zeile Xcelsius-Datei (XLF) die Drucktaste Xcelsius-Datei zum Bearbeiten herunterladen wählen, und die Datei unter dem links genannten Namen lokal sichern.
BW-Query aus Teil 1(`ZTUT1_COSTS_MONTH`)	Starten Sie den BEx Query Designer, und geben Sie als System das BW-System bzw. den BW-Mandanten ein, das Ihrem SAP-Solution-Manager-System zugeordnet ist. Öffnen Sie die BW-Query mit dem technischen Namen `TUT1_COSTS_MONTH`, und sichern Sie diese Query unter dem Namen `ZTUT1_COSTS_MONTH`.

Benötigte Datei

Schritte zum Erstellen der benötigten Datei

Xcelsius-Datei der App aus Teil 3(ztut3_costs_month.xlf)

Starten Sie das Registrierungswerkzeug, markieren Sie die App Tutorial Samples SAP_TUTORIAL_3_APP , und wählen Sie die Drucktaste Details.

Sie können nun die benötigte Datei herunterladen, indem Sie in der Zeile Xcelsius-Datei (XLF) die Drucktaste Xcelsius-Datei zum Bearbeiten herunterladen wählen, und die Datei unter dem links genannten Namen lokal sichern.

Xcelsius-Datei der Konfigurations-App aus Teil 3(ztut3_config.xlf)

Starten Sie das Registrierungswerkzeug, markieren Sie die App Tutorial Samples SAP_TUTORIAL_3_CONFIG , und wählen Sie die Drucktaste Details.

BW-Query aus Teil 1(ZTUT1_COSTS_MONTH)

Starten Sie den BEx Query Designer, und geben Sie als System das BW-System bzw. den BW-Mandanten ein, das Ihrem SAP-Solution-Manager-System zugeordnet ist.

Öffnen Sie die BW-Query mit dem technischen Namen TUT1_COSTS_MONTH, und sichern Sie diese Query unter dem Namen ZTUT1_COSTS_MONTH.

Prozess

Benutzungsoberfläche der App mit Xcelsius erstellen

Sie verwenden die App aus dem dritten Teil des Tutorials und erweitern diese um die Möglichkeit, je nach Konfiguration verschiedene Metriken anzuzeigen. Hierfür müssen Sie sowohl den Anzeigebereich und die Übergabe der Daten aus der BW-Query ändern, als auch eine neue Verbindung anlegen, über welche die gewünschte Metrik aus der zugehörigen Konfigurations-App übernommen wird (siehe Tutorial Teil 4: App mit Xcelsius erstellen).

BW-Query als Datenquelle der App erstellen

Sie verwenden die BW-Query aus dem ersten Teil des Tutorials (siehe Tutorial Teil 1: BW-Query erstellen), in der lediglich die Telefonkosten angezeigt werden, und erweitern diese um die Anzeige der Anzahl und der Dauer von Gesprächen. Entscheidend ist dabei, dass die Query alle diese Metriken ausgibt, in der Benutzungsoberfläche der App aber nur die in der Konfigurations-App ausgewählte Metrik angezeigt wird (siehe Tutorial Teil 4: BW-Query erstellen).

Benutzungsoberfläche der Konfigurations-App mit Xcelsius erstellen

In diesem Schritt erweitern Sie die Konfigurations-App aus dem dritten Teil des Tutorials um eine weitere Dropdown-Listbox an der Benutzungsoberfläche, über die der Benutzer die gewünschte anzuzeigende Metrik auswählen kann. Darüber hinaus erstellen Sie eine zugehörige Verbindung, mit welcher der Standard-App die Information übergeben wird, welche Metrik anzuzeigen ist (siehe Tutorial Teil 4: Konfigurations-App mit Xcelsius erstellen).

App und Konfigurations-App am Dashboard-Framework registrieren

Schließlich müssen Sie die beiden neu erstellten Apps beim Dashboard-Framework registrieren, damit Sie die App allen passenden Dashboards hinzufügen können (siehe Tutorial Teil 4: App und Konfigurations-App registrieren).

App in eigenem Dashboard anzeigen

Nachdem Sie Ihre App erstellt und registriert haben, lassen Sie Ihre App in Ihrem persönliches Dashboard anzeigen. Um Ihr persönliches Dashboard aufzurufen, und Ihre selbst erstellte App dort anzeigen zu lassen, gehen Sie wie folgt vor:

Ihr persönliches Dashboard rufen Sie über eine Web-Dynpro-Anwendung mit dem Namen my_dashboard auf. Falls Sie diese Web-Dynpro-Anwendung noch nicht in die Favoriten Ihres SAP Easy Acess Menü aufgenommen haben, erstellen Sie diesen Eintrag wie folgt:
1. Rufen Sie im SAP Easy Acess Menü Favoriten Sonstige Objekte einfügen auf.
2. Wählen Sie im Bild Einschränkungen aus der Liste den Eintrag Web-Dynpro-Anwendung.
3. Geben Sie im Bild WebDynpro-Anwendung im Eingabefeld Web-Dynpro-Anwendung den Namen my_dashboard ein.
4. Geben Sie eine geeignete Beschreibung ein, wie z. B. Mein persönliches Dashboard, und schließen Sie die Erstellung des neuen Eintrags ab.
Starten Sie Ihr persönliches Dashboard, indem Sie den entsprechenden Eintrag in Ihren Favoriten mit Doppelklick wählen.
Um dem Dashboard eine neue App hinzuzufügen, wählen Sie die Drucktaste Konfigurieren, und danach Neue App hinzufügen.
Sie sehen nun eine Liste der verfügbaren Apps, gruppiert nach der Kategorie. Die App, die Sie in diesem Tutorial erstellt haben, ist keiner Kategorie zugeordnet, expandieren Sie also die Kategorie ohne Zuordnung.
Sie sehen Ihre App Z_TUTORIAL_4_APP in der Liste . Markieren Sie diese, und wählen Sie die Drucktaste OK. App und Konfigrations-App werden beide nebeneinander dargestellt; wählen Sie den gewünschten Monat, und wählen Sie die Drucktaste Anwenden, um die App anzuzeigen.
Um das Dashboard mit der soeben hinzugefügten App zu sichern, wählen Sie die Drucktaste Dashboard sichern.

Ergebnis

Sie haben diesen Teil des Tutorials abgeschlossen und die entsprechende App in Ihrem persönlichen Dashboard angezeigt. Falls Sie nicht das gewünschte Ergebnis erzielt haben, vergleichen Sie Ihre Ergebnisse mit den entsprechenden von SAP ausgelieferten Apps.

Erstellte Datei	Entsprechende von SAP ausgelieferte Datei
Xcelsius-Datei der App (`ztut4_metrics_month.xlf`)	`SAP_TUTORIAL_4_APP.xlf` Um diese Datei herunter zu laden, starten Sie das Registrierungswerkzeug, markieren Sie die App Tutorial Samples SAP_TUTORIAL_4_APP , und wählen Sie die Drucktaste Details. Sie können nun die benötigte Datei herunterladen, indem Sie in der Zeile Xcelsius-Datei (XLF) die Drucktaste Xcelsius-Datei zum Bearbeiten herunterladen wählen.
Xcelsius-Datei der Konfigurations-App (`ztut4_config.xlf`)	`SAP_TUTORIAL_4_CONFIG.xlf` Um diese Datei herunter zu laden, starten Sie das Registrierungswerkzeug, markieren Sie die App Tutorial Samples SAP_TUTORIAL_4_CONFIG , und wählen Sie die Drucktaste Details. Sie können nun die benötigte Datei herunterladen, indem Sie in der Zeile Xcelsius-Datei (XLF) die Drucktaste Xcelsius-Datei zum Bearbeiten herunterladen wählen.
BW-Query zur Datenversorgung der App (`ZTUT4_METRICS_MONTH`)	`TUT4_METRICS_MONTH` Um sich die Query anzeigen zu lassen, starten Sie den BEx Query Designer, und geben Sie als System das BW-System bzw. den BW-Mandanten ein, das Ihrem SAP-Solution-Manager-System zugeordnet ist, und öffnen Sie die oben genannte Datei.

Erstellte Datei

Entsprechende von SAP ausgelieferte Datei

Xcelsius-Datei der App

(ztut4_metrics_month.xlf)

SAP_TUTORIAL_4_APP.xlf

Um diese Datei herunter zu laden, starten Sie das Registrierungswerkzeug, markieren Sie die App Tutorial Samples SAP_TUTORIAL_4_APP , und wählen Sie die Drucktaste Details. Sie können nun die benötigte Datei herunterladen, indem Sie in der Zeile Xcelsius-Datei (XLF) die Drucktaste Xcelsius-Datei zum Bearbeiten herunterladen wählen.

Xcelsius-Datei der Konfigurations-App

(ztut4_config.xlf)

SAP_TUTORIAL_4_CONFIG.xlf

Um diese Datei herunter zu laden, starten Sie das Registrierungswerkzeug, markieren Sie die App Tutorial Samples SAP_TUTORIAL_4_CONFIG , und wählen Sie die Drucktaste Details. Sie können nun die benötigte Datei herunterladen, indem Sie in der Zeile Xcelsius-Datei (XLF) die Drucktaste Xcelsius-Datei zum Bearbeiten herunterladen wählen.

BW-Query zur Datenversorgung der App

(ZTUT4_METRICS_MONTH)

TUT4_METRICS_MONTH

Um sich die Query anzeigen zu lassen, starten Sie den BEx Query Designer, und geben Sie als System das BW-System bzw. den BW-Mandanten ein, das Ihrem SAP-Solution-Manager-System zugeordnet ist, und öffnen Sie die oben genannte Datei.