Show TOC

VorgehensweiseTutorial Teil 3: Konfigurations-App mit Xcelsius erstellen Dieses Dokument in der Navigationsstruktur finden

 

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 dritten Teil 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.

In diesem Schritt erstellen Sie diese Konfigurations-App, mit der Sie einen beliebigen Monat für die Anzeige der Daten auswählen können. Die App gesteht dabei aus zwei Dropdown-Listboxen, mit denen Sie den gewünschten Kalendermonat und das gewünschte Jahr auswählen können sowie den dazu passenden Verbindungen.

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.

Diese Xcelsius-App erstellen Sie im Rahmen des dritten Teils des Tutorials

Hinweis 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.

Ende des Hinweises.

Vorgehensweise

  1. Erstellen Sie eine neue Xcelsius-Datei. Im Zentrum des Bildes wird das (noch leere) UI angezeigt. Damit Ihre App von den Größenverhältnissen und vom Farbschema her mit den von SAP ausgelieferten Apps harmoniert, setzen Sie die folgenden Eigenschaften:

    • Wählen Sie in der Dropdown-Listbox Themen den Eintrag Phase.

    • Wählen Sie im Menüpunkt   Datei   Dokumenteigenschaften   den Auswahlknopf Benutzerdefinierte Größe, und geben Sie die Größe in Pixel mit 596 (Breite) und 336 (Höhe) an.

      Hinweis Hinweis

      Entscheidend ist das Seitenverhältniss. Sie können auch größere Werte angeben, wenn Sie mehr Platz für die Erstellung der Benutzungsoberfläche benötigen, indem Sie beide Zahlen mit demselben Faktor multiplizieren.

      Ende des Hinweises.

  2. Über die Konfigurations-App soll der gewünschte Monat ausgewählt werden können, sie benötigt also eine Verbindung, die von außen ausgelesen wird. Andererseits soll der gewählte Monat wiederum beim späteren Aufruf der Konfigurations-App als Default-Wert angezeigt werden, wofür eine weitere Verbindung benötigt wird, in die von außen geschrieben wird. Da beide Verbindungen auch mit der BW-Query kommunizieren, müssen Sie das Format entsprechend anpassen, da das BW die übergebenen Werte in einem bestimmten Format fordert.

    • Geben Sie darum für die Verbindung, in die von außen geschrieben werden soll, die folgenden Daten in die Zellen F1:J2 ein:

      SIGN

      OPTION

      LOW

      HIGH

      Monat von Query

      I

      EQ

      201111

    • Geben Sie darum für die Verbindung, aus der von außen gelesen werden soll, die folgenden Daten in die Zellen F10:J11 ein:

      SIGN

      OPTION

      LOW

      HIGH

      Monat zur Query

      I

      EQ

    Hinweis Hinweis

    Informationen über die Bedeutung der einzelnen Spalten finden Sie unter Tutorial Teil 2: App mit Xcelsius erstellen.

    Ende des Hinweises.

  3. Erstellen Sie nun die erwähnten Verbindungen. Wählen Sie hierzu in der Dropdown-Listbox Hinzufügen... den Eintrag Verbindung zu externer Schnittstelle.

  4. Wählen Sie in der Registerkarte Definition die Drucktaste +, und geben Sie für die Verbindung, in die von außen geschrieben wird, die folgenden Daten ein:

    • Geben Sie im Eingabefeld Name des Bereichs den Namen MONTH_IN ein.

      Achtung Achtung

      Verwenden Sie für den Namen von Verbindungen nur Großbuchstaben, Ziffern und das Unterstreichungszeichen ('_').

      Ende der Warnung.

    • Wählen Sie in der Dropdown-Listbox Typ des Bereichs den Eintrag Tabelle.

    • Im Eingabefeld Bereich geben Sie an, in welche Zellen die Verbindung schreiben soll; in diesem Tutorial ist dies G1:J2.

    • Wählen Sie in der Dropdown-Listbox Zugriff den Eintrag Schreiben.

  5. Wählen Sie in der Registerkarte Definition die Drucktaste +, und geben Sie für die Verbindung, aus der von außen gelesen wird, die folgenden Daten ein:

    • Geben Sie im Eingabefeld Name des Bereichs den Namen MONTH_OUT ein.

    • Wählen Sie in der Dropdown-Listbox Typ des Bereichs den Eintrag Tabelle.

    • Im Eingabefeld Bereich geben Sie an, aus welchen Zellen die Verbindung lesen soll; in diesem Tutorial ist dies G10:J11.

    • Wählen Sie in der Dropdown-Listbox Zugriff den Eintrag Lesen.

    Schließen Sie den Daten-Manager.

  6. In die Verbindung MONTH_IN wird von außen geschrieben, d. h. in der Zelle I2 wird dem UI der anzuzeigende Monat übergeben; dabei verwendet das BW das Format JJJJMM. Damit Sie Kalendermonat und Jahr als Default-Wert für die Dropdown-Listboxen verwenden können, müssen Sie diesen Wert auf zwei Zellen verteilen, in denen das Jahr und der Kalendermonat stehen soll. Hierfür verwenden Sie passende Excel-Funktionen. Zur besseren Verständlichkeit setzen Sie in die jeweils davor stehenden Zellen eine Beschreibung.

    Geben Sie also die folgenden Daten in die Zellen F4:G5 ein:

    Jahr:

    =VALUE(LEFT(I2;4))

    Kalendermonat:

    =TEXT(DATE(2000;RIGHT(I2;2);1);"MMMM")

  7. Der Benutzer soll, um den gewünschten Monat auswählen zu können, in zwei Dropdown-Listboxen den Kalendermonat und das Jahr auswählen können. Damit beide Dropdown-Listboxen über die korrekten Eingabemöglichkeiten verfügen, geben Sie die möglichen Einträge dieser Listboxen in die Excel-Tabelle ein:

    • Geben Sie in den Bereich B1:B12 die Monate des Jahres (Januar – Dezember) ein.

    • Geben Sie in den Bereich D1:D12 die möglichen Jahre (2004 – 2015) ein.

  8. Die ausgewählten Werte für die Dropdown-Listboxen soll Xcelsius während der Laufzeit in die Zellen G7 und G8 schreiben. Geben Sie als Beschriftung darum in die Zelle F7 den Text Gewähltes Jahr und in die Zelle F8 den Text Gewählter Kalendermonat ein.

  9. Im UI soll eine Dropdown-Listbox für den Kalendermonat angezeigt werden. Ziehen Sie darum aus dem Teilbild Komponenten die Ikone Kombinationsfeld aus der Kategorie Auswahlelemente an die linke obere Ecke des Grafikbereichs.

  10. Passen Sie die Dropdown-Listbox Ihren Wünschen an. Setzen Sie hierfür im Einzelnen die folgenden Eigenschaften:

    • Geben Sie in   Allgemein   Titel   den Titel der Dropdown-Listbox mit Kalendermonat: ein.

    • Geben Sie in   Allgemein   Beschriftungen   einen Verweis auf die Zellen B1:B12 ein. Dies sind die Eingabemöglichkeiten beim Aufruf der Dropdown-Listbox.

    • Wählen Sie in   Allgemein   Einfügen von Daten   Einfügetyp   den Eintrag Position. Während der Laufzeit fügt Xcelsius also die Position des gewählten Kalendermonats in der Liste ein (also z. B. 1 für Januar).

    • Geben Sie in   Allgemein   Einfügen von Daten   Ziel   einen Verweis auf die Zelle G8 ein. In diese Zelle schreibt Xcelsius also während der Laufzeit die Nummer des gewählten Kalendermonats.

    • Wählen Sie in   Verhalten   Ausgewähltes Element   Typ   den Eintrag Dynamisch. Die Bedeutung wird in der Informations-Drucktaste rechts erklärt.

    • Geben Sie in   Verhalten   Ausgewähltes Element   Element   einen Verweis auf die Zelle G5 ein. Aus dieser Zelle entnimmt Xcelsius den Default-Wert (siehe Punkt 6).

    • Wählen Sie in   Aussehen   Layout   Anzahl von angezeigten Beschriftungen   den Eintrag 5.

  11. Analog soll im UI eine Dropdown-Listbox für das Jahr angezeigt werden. Ziehen Sie darum aus dem Teilbild Komponenten die Ikone Kombinationsfeld aus der Kategorie Auswahlelemente rechts neben die erste Dropdown-Listbox.

  12. Passen Sie die Dropdown-Listbox Ihren Wünschen an. Setzen Sie hierfür im Einzelnen die folgenden Eigenschaften:

    • Geben Sie in   Allgemein   Titel   den Titel der Dropdown-Listbox mit Jahr: ein.

    • Geben Sie in   Allgemein   Beschriftungen   einen Verweis auf die Zellen D1:D12 ein. Dies sind die Eingabemöglichkeiten beim Aufruf der Dropdown-Listbox.

    • Wählen Sie in   Allgemein   Einfügen von Daten   Einfügetyp   den Eintrag Beschriftung. Während der Laufzeit fügt Xcelsius also das gewählte Jahr ein.

    • Geben Sie in   Allgemein   Einfügen von Daten   Ziel   einen Verweis auf die Zelle G7 ein. In diese Zelle schreibt Xcelsius also während der Laufzeit das gewählten Jahr.

    • Wählen Sie in   Verhalten   Ausgewähltes Element   Typ   den Eintrag Dynamisch.

    • Geben Sie in   Verhalten   Ausgewähltes Element   Element   einen Verweis auf die Zelle G4 ein. Aus dieser Zelle entnimmt Xcelsius den Default-Wert (siehe Punkt 6).

    • Wählen Sie in   Aussehen   Layout   Anzahl von angezeigten Beschriftungen   den Eintrag 5.

  13. Die beiden Dropdown-Listboxen schreiben also das gewählte Jahr in die Zelle G7 sowie den gewählten Kalendermonat in die Zelle G8. Damit Sie dieses Datum im Format JJJJMM an die Verbindung MONTH_OUT übergeben können, müssen Sie diese beiden Werte entsprechend formatiert in die Zelle I11 schreiben. Verwenden Sie hierzu ebenfalls eine passende Excel-Funktion.

    Geben Sie in die Zelle I11 die Funktion =CONCATENATE(TEXT(G7;0);IF(G8>9;"";"0");TEXT(G8;0)) ein.

  14. Sichern Sie nun die Xcelsius-Datei lokal auf Ihrem Computer unter dem Namen ztut3_config.

  15. Erzeugen Sie aus Ihrer Xcelsius-Datei eine Flash-Datei (Dateinamenserweiterung swf), indem Sie im Menü   Datei   Exportieren   Flash (SWF)   wählen. Speichern Sie die Flash-Datei unter dem Namen ztut3_config

    Bei der Registrierung der App werden Sie im weiteren Verlauf des Tutorials sowohl die Xcelsius- als auch die Flash-Datei in das MIME-Repository Ihres SAP-Solution-Manager-Systems importieren.

Ergebnis

Sie haben mit der Xcelsius-Datei und der zugehörigen Flash-Datei die Benutzungsoberfläche der zukünftigen Konfigurations-App erstellt.

Fahren Sie in diesem Teil des Tutorial fort, indem Sie nun den nächsten Schritt Tutorial Teil 3: App und Konfigurations-App registrieren durchführen. In diesem Schritt werden Sie die App und die zugehörige Konfigurations-App am Dashboard-Framework registrieren..