Eigene Übersichtslisten anlegen
Auf dieser Seite
Problem
Die Übersichtslisten, die das PPP im Standard bereitstellt, reichen für Ihre Anforderungen nicht aus, und Sie möchten eine eigene Übersichtsliste anlegen.
Umgebung
Erweiterungen der PPP-Übersichten
Voraussetzungen
Sie haben in Ihrem eigenen Namensraum eine Klasse angelegt, die als BAdI-Implementierung zur BAdI-Definition /STX/SOL_PPP_BA_OVERVIEW im Erweiterungsspot /STX/SOL_PPP_ES_OVERVIEW dient.
Die angelegte Klasse muss das Interface /STX/SOL_PPP_IF_OVERVIEW_BADI enthalten.
Lösung
Name der eigenen Übersicht:
Bevor Sie mit der Implementierung Ihrer eigenen Übersicht beginnen, sollten Sie einen Namen festlegen. Dieser Name wird bei der Implementierung an verschiedenen Stellen wiederverwendet und muss alle folgenden Regeln erfüllen. Der gewählte Name muss:
- unter allen anderen vorhandenen eigenen Übersichten eindeutig sein
- keine Sonderzeichen (wie „/“, „$“, „=“, „.“ usw.) enthalten. Unterstriche („_“) sind jedoch erlaubt.
- vollständig in Großbuchstaben geschrieben sein
- höchstens 31 Zeichen lang sein
Beispiel: CUSTOM_OVERVIEW_EXAMPLE_WITH_31
Im Folgenden wird er als „Übersichtsname“ bezeichnet.
Anlage der Metadaten:
Jede eigene Übersicht benötigt einen eigenen EntityType. Das PPP generiert ihn; die Generierung lässt sich durch die Implementierung von GET_CUSTOM_OVERVIEW_STRUCTURES() auslösen. In Ihrer Implementierung legen Sie die zu generierenden Metadaten fest, indem Sie den Returning-Parameter OVERVIEW_STRUCTURES füllen. Für jede Zeile dieser Tabelle wird ein EntityType angelegt. Jede Zeile muss je Komponente die folgenden technisch erforderlichen Informationen enthalten:
-
DDIC_STRUCTURE: Name der DDIC-Struktur- Eine Komponente mit dem Namen
GUIDmuss enthalten sein
- Eine Komponente mit dem Namen
-
OVERVIEW_KEY: Der oben festgelegte „Übersichtsname“ -
KEY_PROPERTIES: Eine Liste von Komponentennamen, die im EntityType als Schlüsseleigenschaften angelegt werden.- Mindestens
GUIDmuss angegeben sein - Jeder angegebene Komponentenname muss auch in der DDIC-Struktur aus Schritt 1 vorhanden sein.
- Mindestens
Außerdem können Sie in der Methode CREATE_CUSTOM_ANNOTATION() eigene Annotationen hinzufügen. Diese Methode wird bei der Metadatengenerierung von /STX/SOL_PPP_CL_MPC_EXT für jeden EntityType aufgerufen, der für eigene Übersichten angelegt wird. Dafür erhalten Sie die beiden Importing-Parameter VOCAB_ANNO_MODEL und ENTITY_TYPE. ENTITY_TYPE verweist immer auf den EntityType, der im aktuellen Durchlauf angelegt wird.
Anlage der Fiori-Kachel:
Die Fiori-Kachel legen Sie mit der Transaktion /UI2/FLPD_CUST an. Wählen Sie dort im gewünschten Katalog die Vorlage „App Launcher - Static“. Geben Sie einen Titel und die folgenden Navigationsparameter an:
- Semantic Object:
_STX_SOL_PPP - Action: track
- Parameters:
&/CustomOverview/YOUROVERVIEWNAME→ Ersetzen Sie „YOUROVERVIEWNAME“ durch den von Ihnen gewählten Übersichtsnamen.
Customizing der Registerkarten:
Die Registerkarten passen Sie wie in Customizing der Übersichtslisten beschrieben an. Beachten Sie, dass Sie für die BRF+-Eingabespalte wieder den gewählten „Übersichtsnamen“ verwenden müssen!
Datenbeschaffung der eigenen Übersicht:
Damit Ihre eigene Übersicht Einträge enthält, muss die BAdI-Methode GET_CUSTOM_OVERVIEW_ENTRIES() implementiert sein. Über die beiden Importing-Parameter TAB_KEY und OVERVIEW_KEY können Sie genau unterscheiden, aus welcher Ihrer eigenen Übersichten und von welcher Registerkarte die Datenanforderung ausgelöst wurde. Füllen Sie den Exporting-Parameter ENTIES entsprechend. Stellen Sie sicher, dass die Tabelle für ENTRIES auf derselben DDIC-Struktur basiert wie die Metadaten!
Titel der Übersicht bereitstellen:
Um einen Titel für Ihre eigene Übersicht bereitzustellen, muss die BAdI-Methode GET_CUSTOM_OVERVIEW_INFO() implementiert sein. Als Importing-Parameter OVERVIEW_KEY erhalten Sie den von Ihnen gewählten „Übersichtsnamen“, falls es mehrere eigene Übersichten gibt, die unterschieden werden müssen.
Geben Sie in der Returning-Struktur OVERVIEW_INFO je Komponente die folgenden Informationen an:
OVERVIEW_KEY→ setzen Sie hier denselben Wert wie im Importing-ParameterTITLE→ der Titel, der in der Anwendung angezeigt wird, mit höchstens 255 Zeichen
Berechnete Felder in der Massenverarbeitung:
Haben Sie für eine Entität einer Übersicht (z. B. Projekt) eigene berechnete Felder implementiert, sollten Sie erwägen, die BAdI-Methode PRELOAD_RELATED_DATA() zu implementieren
Hier erhalten Sie eine Menge von GUIDs der aktuellen Entität der Übersicht. Mit ihnen können Sie Daten vorab in einen Puffer laden, auf den Ihr eigenes berechnetes Feld später zugreift.
Der Importing-Parameter RELEVANT_FIELDS liefert eine Liste der Felder, die für die korrekte Ermittlung der Ausgabe der Übersicht benötigt werden. Ist er initial oder enthält er kein eigenes berechnetes Feld, ist in der BAdI-Implementierung nichts zu tun.
Verwenden Sie für eine optimale Performance Hash-Tabellen mit eindeutigem Schlüssel als interne Puffertabellen.
Beispielimplementierung:
Das PPP stellt die Beispielimplementierung /STX/SOL_PPP_CUST_OVERVIEW_ENH mit der implementierenden Klasse /STX/SOL_PPP_CL_CUSTOM_OV_DEMO für das BAdI bereit.
Sie können entweder eine völlig neue Implementierung beginnen oder eine Implementierung durch Kopieren der Beispielklasse anlegen.

