Analytical List Page / grafisches Reporting: Implementierung auf Basis von CDS-Views (technische Dokumentation und Anleitung)
Auf dieser Seite
- Technische Dokumentation – App für grafisches / analytisches Reporting
- 1. Technische Objekte im Backend
- 2. BW-Konfiguration – InfoObject 0INFOPROV
- 3. Frontend-Komponenten
- Aufgetretenes Problem bei der Implementierung:
- 4. Eigener Frontend-Code
- 5. Offene Punkte für die nächste(n) Version(en)
- 6. Kundensystem – Umgang mit kundeneigenen Feldern
- 7. Generierte Klasse ZCL_ZSTX_C_ANALYTICAL_OV
- 8. Anpassbare Schwellenwerte für künftige Versionen
- 9. Dynamische Texte für Beschriftungen in künftigen Versionen
Technische Dokumentation – App für grafisches / analytisches Reporting
1. Technische Objekte im Backend
1.1 CDS-Views
-
Interface-CDS-Views:
(Basis- / Interface-Views, die Rohdaten und Assoziationen bereitstellen)ZSTX_I_ITEM_TYPE_TEXTZSTX_I_STATUS_TEXTZSTX_I_DPR_PROJECTZSTX_I_OBJ_LINK
-
Cube-CDS-Views:
(Cube-Views mit der Annotation@Analytics.dataCategory: #CUBE, die als analytische Grundlage dienen)ZSTX_CUBE_ANALYTIC


-
Consumption- / analytischer CDS-View
(Consumption-View mit der Annotation@Analytics.query: true)
(Consumption-View auf Basis des Cubes, der für das Reporting und die Nutzung in der Oberfläche bereitgestellt wird)ZSTX_C_ANALYTICAL_OV


1.2 OData-Service
-
Service-Name:
ZSTX_C_ANALYTICAL_OV_CDS -
Service-Registrierung:
/IWFND/MAINT_SERVICE
2. BW-Konfiguration – InfoObject 0INFOPROV
2.1 Voraussetzung
Im System muss das BW-InfoObject 0INFOPROV aktiv sein.
Ist das InfoObject nicht aktiv, schlägt die Aktivierung des analytischen CDS-Views fehl.
2.2 Fehlerszenario
Bei der Aktivierung des CDS-Views gibt das System einen Fehler aus, wie im Screenshot unten zu sehen.
Error reading InfoProvider for CDS view 2CZANAYTC_OVIEW [Analytics]


2.3 Vorabprüfung (seltenes Szenario)
In seltenen Fällen fehlt in manchen Systemen ein Eintrag im aktiven Zustand für das InfoObject 0INFOPROV in den folgenden BW-Tabellen:
RSDCHARSDIOBJRSDIOBJT
Bevor Sie versuchen, das InfoObject zu aktivieren, müssen Sie unbedingt prüfen, ob die aktiven Einträge in diesen Tabellen vorhanden sind.




Fehlen die aktiven Einträge, kann die direkte Aktivierung des InfoObjects fehlschlagen.
2.4 Erforderliche Maßnahme (wenn der aktive Eintrag fehlt)
- Die erforderlichen aktiven Einträge müssen in den oben genannten Tabellen gepflegt werden
- Dieser Schritt muss vor der Aktivierung des InfoObjects
0INFOPROVabgeschlossen sein
2.5 Aktivierungsschritte für das InfoObject 0INFOPROV
Option 1: Über die Transaktion RSD1
- Rufen Sie die Transaktion
RSD1auf - Geben Sie das InfoObject an:
0INFOPROV - Wählen Sie Activate
- Stellen Sie sicher, dass das InfoObject den Status Active hat


Option 2: Über ein Report-Programm
- Führen Sie den Report
RSDG_IOBJ_ACTIVATEaus - Geben Sie den Namen des InfoObjects an:
0INFOPROV - Führen Sie das Programm aus, um das InfoObject zu aktivieren
3. Frontend-Komponenten
3.1 Fiori-Anwendung
-
App-Typ:
Analytical Overview Page (Analytical List Page – ALP) -
Anlageschritte:
- Wählen Sie Analytical List Page als Anwendungstyp
- Wählen Sie das SAP-Zielsystem
- Wählen Sie den passenden OData-Service aus und ordnen Sie ihn zu
- Generieren Sie die Anwendung mit der Standardvorlage von BAS
In einer Analytical List Page von Fiori Elements übernimmt das Framework diese Aufgaben:
-
Lesen der OData-$metadata
-
Interpretieren der CDS-Annotationen
-
Automatische Darstellung von:
- KPIs
- visuellen Filtern
- Diagrammen
- Tabellen
- Selektionsfeldern
3.2 Annotationen im Frontend gegenprüfen:
Um zu prüfen, ob die Oberfläche von den CDS-Annotationen gesteuert wird, sehen Sie sich die lokale Standard-Annotationsdatei (VAN.xml) an, die im Frontend-Projekt generiert wurde.
-
Öffnen Sie die Fiori-Anwendung in BAS
-
Navigieren Sie zur lokalen Annotationsdatei des Services
webapp/localService/...van.xml -
Diese Datei wird von der Standardvorlage von Fiori Elements generiert
-
Sie enthält UI-Annotationen wie:
- KPIs
- visuelle Filter
- Diagramme
- Selektionsfelder
-
Diese Annotationen spiegeln die Definitionen wider, die im Consumption-CDS-View gepflegt sind
Aufgetretenes Problem bei der Implementierung:
Einige in den ABAP-CDS-Views definierte Annotationen wurden nicht in die Annotationsdatei (VAN) des Frontends übernommen. Das betraf vor allem Annotationen zur Wertehilfe und bestimmte Annotationen zu visuellen Filtern.
Die Analyse ergab, dass nicht alle Annotationstypen aus ABAP CDS in die OData-Metadaten für die Nutzung durch Fiori Elements übernommen werden. Laut SAP müssen solche Annotationen als lokale XML-Annotationen gepflegt werden.


Lösung:
Die erforderlichen Annotationen wurden manuell in der lokalen Annotationsdatei webapp/localService/...van.xml gepflegt


Weitere Beobachtung – Web IDE und BAS
In der SAP Web IDE gibt es im Annotation Modeler eine direkte Option, ein Feld auszuwählen und die Wertehilfe einzuschalten; die erforderlichen Annotationen werden dann automatisch generiert.


In SAP Business Application Studio (BAS) habe ich dagegen im Page Editor / Annotation Modeler keine Option gefunden, die Wertehilfe direkt durch Auswahl von Feldern zu konfigurieren.
4. Eigener Frontend-Code
Die Anwendung verwendet Fiori Elements und Annotationen, sodass für KPIs, Filter, Diagramme oder Tabellen normalerweise kein eigener Frontend-Code nötig ist.
In manchen Systemen mit älteren UI5-Versionen sind bestimmte Eigenschaften standardmäßig nicht eingeschaltet. In diesen Fällen muss der Controller erweitert werden, um diese Eigenschaften einzuschalten.
-
Werte in großen Diagrammen anzeigen
- Wertbeschriftungen in Diagrammen sind standardmäßig nicht eingeschaltet
- Um Werte in den Diagrammen anzuzeigen, wurde der Controller erweitert, und die erforderlichen Diagrammeigenschaften wurden programmatisch hinzugefügt


-
Eigene Spalten (z. B. App-Jumper / Navigationsspalte)
- Im ABAP-CDS-View funktionierte die Intent-basierte Navigation nicht. Ein ähnliches Problem hatten wir schon bei der Implementierung der DMK-Anwendung. Zur Lösung haben wir den Controller erweitert, damit er die Cross-Navigation behandelt.
5. Offene Punkte für die nächste(n) Version(en)
- Eine mögliche Verbesserung für eine künftige Version wäre, die App dynamischer zu machen, vor allem beim Umgang mit kundeneigenen Feldern. Nach der ersten Analyse ist das nicht ganz einfach.
- Wie bereits (mit Ihnen und Jag) besprochen, können wir vorhandene Customizing-Tabellen nutzen, um die Konfiguration zu speichern.
- Die größte Herausforderung ist jedoch, die ausgewählten kundeneigenen Felder dynamisch zum Consumption-CDS-View hinzuzufügen. Das muss weiter analysiert werden und kann in einem künftigen Release untersucht werden.
6. Kundensystem – Umgang mit kundeneigenen Feldern
- Damit kundeneigene Felder in der Anwendung verfügbar sind, müssen die Felder nur zum Cube-CDS-View und zum Consumption-CDS-View hinzugefügt und der Metadaten-Cache geleert werden. Danach erscheinen die kundeneigenen Felder automatisch in der Oberfläche.
- Möchte ein Kunde, dass kundeneigene Felder standardmäßig in der Filterleiste oder als visuelle Filter erscheinen, müssen die erforderlichen Annotationen gepflegt werden. Das ist eine kleine Änderung, die sich meist innerhalb einer Stunde umsetzen lässt.
7. Generierte Klasse ZCL_ZSTX_C_ANALYTICAL_OV
- Dies ist eine Standard-Hilfsklasse, die automatisch angelegt wird, wenn ein CDS-View (
ZSTX_C_ANALYTICAL_OV) die Annotation@OData.publish: truehat.


- Sie implementiert
IF_NAT_QUERY_HELPER~GET_QUERY_NAMEund gibt den Query-Namen2CZSTX_SANALYTCzurück. - Sie ermöglicht es, den CDS-View als OData-Service für Fiori-Anwendungen bereitzustellen.
- Es ist keine weitere Geschäftslogik implementiert; die Klasse dient ausschließlich als Brücke zwischen dem CDS-View und dem OData-Service.
- Die Klasse ist indirekt über den aus dem CDS-View generierten OData-Service verknüpft/registriert.
8. Anpassbare Schwellenwerte für künftige Versionen




- Ja, wir können diese Werte anpassbar machen, indem wir sie aus einer Customizing-Tabelle lesen. Die entsprechenden Felder müssten im CDS-View gemappt werden, und der Kunde müsste die Schwellenwerte in der Tabelle pflegen.
- Die Werte wie besprochen aus BRF+ zu lesen, wäre aufwendiger. Diesen Ansatz können wir künftig in Betracht ziehen; bei der Entwicklung der eigentlichen Anwendung im PPP sind dazu weitere Untersuchungen nötig.
9. Dynamische Texte für Beschriftungen in künftigen Versionen


- Nach meiner ersten Analyse lassen sich die Beschriftungen nicht vollständig dynamisch machen. Ein Datenbankfeld lässt sich in einem CDS-View nicht direkt auf
@EndUserText.labelabbilden. Die Annotation@EndUserText.labelakzeptiert nur statischen Text, der zur Designzeit festgelegt wird. - Ich habe jedoch Dokumentation gefunden, nach der es mit der Annotation
@Consumption.dynamicLabelmöglich sein könnte, wobei dieser Ansatz auf Parametern basiert. Das muss ich noch genauer untersuchen und auch prüfen, ob diese Annotation in ABAP-CDS-Views unterstützt wird.



