Ansicht
Dokumentation
ABENCDS_F1_DEFINE_CUSTOM_ENTITY - CDS F1 DEFINE CUSTOM ENTITY
CL_GUI_FRONTEND_SERVICES - Frontend Services BAL_S_LOG - Application Log: Log header dataDiese Dokumentation steht unter dem Copyright der SAP AG.
- DEFINE CUSTOM ENTITY
$[@entity_annot1$]
$[@entity_annot2$]
...
$[@ObjectModel.query.implementedBy : 'class_name'$]
$[DEFINE$] $[ROOT$] CUSTOM ENTITY custom_entity
$[parameter_list$]
element_list$[;$]
Zusätze:
Wirkung
Definiert eine CDS-Custom-Entität custom_entity in der CDS DDL. Bei der Aktivierung einer CDS-Custom-Entität werden deren Metadaten erzeugt, es werden aber keine sonstigen Objekte in der Datenbank oder auf dem AS ABAP ausgeprägt. Der Name custom_entity muss den Namenskonventionen für Dictionary-Typen folgen und darf maximal 30 Zeichen enthalten.
- Mit @entity_annot können optionale Annotationen für die CDS-Custom-Entität angegeben werden.
- Die Annotation @ObjectModel.query.implementedBy bindet eine ABAP-Klasse, die eine ABAP-Query implementiert. Diese Query wird nicht vom ABAP-Laufzeit-Framework aufgerufen, sondern von einem Framework wie die RAP-Query-Engine.
- Mit parameter_list wird eine Liste optionaler Eingabeparameter für die CDS-Custom-Entität deklariert.
- Mit element_list werden Elemente, CDS-Assoziationen, CDS-Kompositionen und CDS-To-Parent-Assoziationen der CDS-Custom-Entität deklariert.
Eine CDS-Custom-Entität kann in ABAP-Programmen als globaler strukturierter Typ verwendet werden. Die Entität befindet sich im Namensraum aller globalen Typen eines AS ABAP. Die Elemente der CDS-Custom-Entität definieren die Komponenten des globalen strukturierten Typs, auf den man sich in ABAP-Programmen mit TYPE beziehen kann. Die Annotationen einer CDS-Custom-Entität können wie für jede CDS-Entität ausgewertet werden.
Hinweise
- Eine CDS-Custom-Entität kann nicht als Datenquelle in anderen CDS-Entitäten oder in ABAP SQL verwendet werden.
- Für eine CDS-Custom-Entität wird keine Struktur des ABAP Dictionary erzeugt, die in einem der Werkzeuge für Strukturen sichtbar wäre.
- CDS-Custom-Entitäten können als Werte für die CDS-Annotationen AssociationRef und ElementRef verwendet werden.
- Im Kontext des ABAP-RESTful-Anwendungsprogrammiermodells werden Custom-Entitäten als eine Grundlage des Datenmodells für
nicht verwaltete RAP-Queries verwendet.
Beispiel
Der folgende DDL-Quelltext zeigt eine CDS-Custom-Entität:
Zusatz 1
... ROOT
Wirkung
Mit dem Schlüsselwort ROOT wird in ABAP CDS die CDS-Custom-Entität custom_entity als Wurzelentität der Hierarchie des Business-Objekts definiert. Für die Wurzel-Entität gilt:
- In der Struktur eines Business-Objekts kann höchstens eine Wurzel-Entität vorhanden sein.
- Eine Wurzelentität kann Kindentitäten haben, die mit dem Schlüsselwort COMPOSITION als CDS-Kompositionen definiert sind, aber dies ist nicht obligatorisch. Eine Wurzelentität kann auch eine Blattentität sein.
- Eine Wurzel-Entität hat keine Eltern-Entität.
To-Parent-Assoziationen sind in Wurzelentitäten nicht erlaubt.
CL_GUI_FRONTEND_SERVICES - Frontend Services ABAP Short Reference
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 7696 Date: 20240523 Time: 153150 sap01-206 ( 72 ms )