Über BW-Query bereitgestellte Daten: Wenn Daten, die Sie in der App anzeigen lassen möchten, aus einer BW-Query stammen, dann markieren Sie dieses Kennzeichen. In den von SAP ausgelieferten Apps ist dies praktisch immer der Fall, da das Dashboard-Framework darauf aufbaut, Daten aus dem Business Warehouse anzuzeigen.

Über BAdI bereitgestellte Daten: Wenn Daten, die Sie in der App anzeigen lassen möchten, aus einem BAdI stammen, dann markieren Sie dieses Kennzeichen.

Über Dashboard-Kontext bereitgestellte Daten: Markieren Sie dieses Kennzeichen, falls Sie eine Kontext-App registrieren möchten. Eine Kontext-App setzt Randbedingungen nicht nur für eine App (wie bei einer Konfigurations-App), sondern für alle Apps eines Dashboards, die über entsprechende Verbindungen verfügen. Daher wird eine Kontext-App innerhalb eines Dashboards auch ständig angezeigt. Eine typische Kontext-App ist die App zur Datumsauswahl, die im Alert-Management-Dashboard angezeigt wird.

Weitere Werte (Text, Zahlen usw.): Wenn Ihre App über Werte verfügt, die erst während der Registrierung festgelegt werden sollen; über konfigurierbare oder übersetzbare Texte oder über Werte verfügt, die in der Konfigurations-App gesetzt werden (z. B. Schwellenwerte), dann markieren Sie dieses Kennzeichen.

Falls Sie eine Konfigurations-App registrieren, wird zusätzlich das Kennzeichen Datenquellen von Partner-Apps einschließen eingeblendet. Stellen Sie sicher, dass das Kennzeichen markiert ist, damit die Datenquellen der App auch der zugehörigen Konfigurations-App zur Verfügung stehen.

In der obersten Tabelle fügen Sie pro BW-Query, welche Daten für die zu registrierende App liefert, eine Zeile ein. Geben Sie dabei in der Spalte Technischer Name den technischen Namen der BW-Query ein.

Für jede Query können Sie in der Tabelle Filter für BW-Query die Werte setzen, nach denen die Daten der Query gefiltert werden sollen. Dabei geben Sie die technischen Details dieser Filter an:

In der Tabelle Verwendung von BW-Query-Ergebnis in App geben Sie an, wie die Ergebnisse der Query verwendet werden. Dabei existiert in der Spalte Datenquelle bereits eine Zeile mit dem Eintrag RESULT. Geben Sie hier die Verbindung der App an, an welche die von der Query gelieferten Daten weiter geleitet werden.

Daneben können Sie hier auch weitere Verbindungen angeben, über die Sie typischerweise Filterwerte an die Query übergeben können (bei einer Konfigurations-App) bzw. diese zur Anzeige in der App von der BW-Query empfangen. In der Spalte Name App-Verbindung geben Sie dabei den Namen der entsprechenden Xcelsius-Verbindung an; in der Spalte Datenquelle den technischen Namen des InfoObjekts, der als Filter verwendet wird.

Falls Sie Ihre Query-Daten über ein BAdI vor- oder nachbereiten lassen möchten, können Sie dies in der Dropdown-Listbox BAdI für Vor- und Nachbearbeitung angeben. Verwenden Sie dabei den Erweiterungsspot IF_DFWK_BADI_BW_PROCESSING (Paket  AI_SOLMAN_DASHBOARDS Eingebettete Pakete AI_DSH_CORE Erweiterungen Erweiterungsspots IF_DFWK_BADI_BW_PROCESSING ).

Dieser Erweiterungsspot enthält die folgenden Methoden:

Die Werte verschiedener BW-InfoObjekte werden von der Query in einem benutzerabhängigen Format übergeben, wie z. B. 0TIME oder 0CALDAY. Falls die Werte dieser InfoObjekte in der App lediglich angezeigt werden sollen, ist dies kein Problem, falls Sie aber in der Xcelsius-Benutzungsoberfläche auf der Basis der übergebenen Werte Berechnungen durchführen lassen oder Query-Daten über ein BAdI nachbereiten lassen möchten, wird dies zu Fehlern führen, da Sie bei der Erstellung der Xcelsius-Benutzungsoberfläche nicht wissen können, in welchem benutzerabhängigen Format die Werte von der Query übergeben werden.

Um dieses Problem zu lösen, können Sie eine Liste von BW-InfoObjekten angeben, die von der Query unformatiert (und damit unabhängig von den jeweiligen Bernutereinstellungen) übergeben werden sollen. Um diese Liste aufzurufen, folgen Sie dem Link Liste der unformatierten InfoObjekte. Um der Liste ein BW-InfoObjekt hinzuzufügen, wählen Sie die Drucktaste Hinzufügen, geben Sie den technischen Namen des InfoObjekts ein, und wählen Sie die Drucktaste OK.

GET_CONTENT: Verwenden Sie diese Methode, um das BAdI als Datenquelle zu nutzen; in diesem Fall müssen Sie im Registrierungswerkzeug den möglichen Werten des Methodenparameters I_NAME jeweils eine Xcelsius-Verbindung (Eingehende App-Verbindung) mit der Eigenschaft Ist Schreiben zuweisen (die Xcelsius-Verbindungen werden im Teilbild App-Verbindungen des Registrierungswerkzeugs angezeigt).

SET_CONTENT: Verwenden Sie diese Methode, die App als Datenquelle für das BAdI zu nutzen (z. B. bei der Konfigurations-App); in diesem Fall müssen Sie im Registrierungswerkzeug den möglichen Werten des Methodenparameters I_NAME jeweils eine Xcelsius-Verbindung (Ausgehende App-Verbindung) mit der Eigenschaft Ist Lesen zuweisen.

Geben Sie in der Tabelle Im BAdI verwendete Parameter den technischen Namen und den Wert der Parameter ein, die Sie bei der BAdI-Implementierung verwendet haben.

Geben Sie in der Tabelle Datenfluss der BAdI-Ergebnisse und App-Verbindungen die Verbindungen zwischen den Inhaltsnamen in dem BAdI und den zugehörigen App-Verbindungen ein. Die Inhaltsnamen setzen Sie bei der BAdI-Implementierung als mögliche Werte des Methodenparameters I_NAME.

In der Tabelle geben Sie für jede der Verbindungen einen Datengruppenname ein. Dieser Name ist insofern beliebig, da Sie ihn erst bei der Registrierung festlegen, d. h. er kommt nicht in den Verbindungen oder an anderer Stelle in der zugehörigen Xcelsius-Datei vor.

Für jede dieser Datengruppen legen Sie nun fest, ob der zugehörige Text über eine Konfigurations-App festgelegt wird (Kennzeichen Ist per App konfigurierbar), und ob der in der Benutzungsoberfläche angezeigte Text übersetzt werden soll (Kennzeichen Ist übersetzbar).

Sie ordnen der Datengruppe eine Verbindung der App zu; die möglichen Verbindungen sehen Sie im Teilbild App-Verbindungen. Je nachdem, ob es sich um eine Verbindung handelt, die Werte in die App schreibt (Ist Schreiben) und/oder liest (Ist Lesen), geben Sie eine Eingehende App-Verbindung und/oder Ausgehende App-Verbindung an.

Jeder Verbindung ist in der Xcelsius-Datei ein Zellenbereich zugeordnet, wobei die erste Zeile dieses Bereichs für die technischen Namen vorgesehen ist. Diesen Zellenbereich bilden Sie hier bei der Registrierung nach, wobei Sie sich, was die Anzahl der Zeilen und Spalten angeht, an der Verbindung in Xcelsius orientieren.

In der ersten Zeile geben Sie dabei einen beliebigen technischen Namen für das Objekt ein (auf dessen Inhalt Sie in Xcelsius programmieren können), wobei Sie vor allem darauf achten müssen, dass Sie die entsprechenden Zellen im Registrierungswerkzeug nicht leer lassen. In den weiteren Zeilen stehen die Standardwerte für die entsprechenden Objekte.