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_4_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 ztut4_metrics__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 ztut4_metrics_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.

Die App benötigt ihre Daten aus einer BW-Query. Markieren Sie also das Kennzeichen Über BW-Query bereitgestellte Daten.

Außerdem übernimmt die App direkt aus der Konfigurations-App die anzuzeigende Metrik. Da dies nicht über die BW-Query abläuft, markieren Sie darum das Kennzeichen Weitere Werte (Text, Zahlen usw.).

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:

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.

Geben Sie in der Tabelle Datengruppenname einen beliebigen technischen Namen für jede dieser Verbindungen an. In diesem Tutorial sei dies METRIC.

Sie verbinden nun diesen technischen Namen mit einer Verbindung der App, also geben Sie in diesem Tutorial im Eingabefeld Eingehende App-Verbindung die Verbindung METRIC ein. Der Wert dieser Verbindung soll konfigurierbar sein, soll also vom Benutzer in der Konfigurations-App geändert werden können. Markieren Sie darum das Kennzeichen Ist per App konfigurierbar.

In der Xcelsius-Datei der App ist der Verbindung METRIC ein Zellenbereich bestehend aus zwei Zeilen und einer Spalte zugewiesen. Die erste Zeile ist dabei für den technischen Namen reserviert, während in der zweiten Zeile die eigentliche Nummer der Metrik steht. Dies bilden Sie hier in der Registrierung nach.

Geben Sie also in der Spalte Field1 in der ersten Spalte den technischen Namen der Verbindung an (METRIC), und in der zweiten Zeile den Standardwert für diese Nummer, z. B. 1.

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_4_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 ztut4_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 ztut4_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.

Da Sie bei der Registrierung der

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_4_APP auswählen.

Die App benötigt ihre Daten aus einer BW-Query. Markieren Sie also das Kennzeichen Über BW-Query bereitgestellte Daten.

Außerdem übernimmt die Partner-App direkt aus dieser Konfigurations-App die anzuzeigende Metrik. Da dies nicht über die BW-Query abläuft, markieren Sie darum das Kennzeichen Weitere Werte (Text, Zahlen usw.).

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.

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.

Geben Sie in der Tabelle Datengruppenname einen technischen Namen für jede dieser Verbindungen an. In diesem Tutorial sei dies METRIC (siehe Registrierung der zugehörigen App).

Sie verbinden nun diesen technischen Namen mit einer Verbindung der App, also geben Sie in diesem Tutorial im Eingabefeld Eingehende App-Verbindung und Ausgehende App-Verbindung die Verbindung SELECTED_METRIC ein (was daran liegt, dass die entsprechende Verbindung über die Zugriffsart Lesen/Schreiben verfügt). Der Wert dieser Verbindung soll konfigurierbar sein, soll also vom Benutzer in der Konfigurations-App geändert werden können. Markieren Sie darum das Kennzeichen Ist per App konfigurierbar.

In der Xcelsius-Datei der App ist der Verbindung SELECTED_METRIC ein Zellenbereich bestehend aus zwei Zeilen und einer Spalte zugewiesen. Die erste Zeile ist dabei für den technischen Namen reserviert, während in der zweiten Zeile die eigentliche Nummer der Metrik steht. Dies bilden Sie hier in der Registrierung nach.

Geben Sie also in der Spalte Field1 in der ersten Spalte den technischen Namen der Datengruppe an (METRIC), und in der zweiten Zeile den Standardwert für diese Nummer, z. B. 1.