Ein CDS-View - 3 Objekte

(2/3) CDS-View

• Das CDS-Objekt aus ABAP Perspektive
• Generiert aus der DDL Datei
• Als Zeilentyp im ABAP nutzbar
• Datenquelle in einer SELECT-Abfrage
• Unterliegt der CDS Zugriffskontrolle
• In SE11 als Quelltext
• In AMDP nicht nutzbar

Die Namen der 3

Name der DDL-Datei normalerweise gleich dem CDS-View. Der CDS-View ist vor dem ersten Aktivieren noch umbenennbar . Bitte nicht machen…

Namen von CDS View (max. 30 Zeichen) und CDS DDIC/SQL View (max. 16 Zeichen) sind im gleichen Namensraum. Sie müssen also unterschiedlich sein.

Empfehlung: Namenskonvention festlege

zum Beispiel:

• ZCDS_<Name> & ZV_<Name>

CDS View Entities (2/2)

Die Annotation @Metadata.ignorePropagatedAnnotations: true sollte immer gelöscht werden, sonst werden die Annotationen aus Quell-Views bzw. Tabellen nicht geerbt.

Verwendung in Frameworks

Wo bei CDS Views der Name des DDIC-Views verwendet wurde, kann bei der CDS View Entity direkt dieser Name verwendet werden:

• Extraktor Views, bei der Anlagen einer DataSource im BW
• Name des CDS InfoProviders bzw. der CDS Query mit dem Präfix 2C
• Bei der Verwendung des Views im AMDP

Demo

@AbapCatalog.sqlViewName: 'ZJB_DEMO'
@AbapCatalog.compiler.compareFilter: true
@AbapCatalog.preserveKey: true
@AccessControl.authorizationCheck: #NOT_REQUIRED
@EndUserText.label: 'Demo CDS View'
define view zjb_cds_demo
  as select from    zbc_tasks as t

    left outer join zbc_users as u 
      on t.assignee = u.user_id
{
  key t.task_key    as TaskKey,
      t.summary     as Summary,
      t.status      as Status,
      t.project     as Project,
      t.description as Description,
      t.assignee    as Assignee,
      u.firstname   as AssigneeFirstname,
      u.lastname    as AssigneeLastname,
      t.type        as Type,
      t.author      as Author,
      t.due_date    as DueDate,
      t.priority    as Priority
}

Syntax in CDS Views

• Schlüsselwörter entweder in
  • GROSSBUCHSTABEN oder
  • kleinbuchstaben oder
  • Ersterbuchstabegroßundderrestklein
• Bezeichner nicht case-sensitiv max. 30 Zeichen lang aus Buchstaben, Zahlen, Unterstrich und Schrägstrich
• Literale
  • Zahlen ohne Punkt als Ganzzahle
  • Mit Punkt als Dezimaltrennzeichen wird ein Float daraus!
  • Zeichenketten mit Hochkomma
• Kommentare
  • Zeilenendkommentare mit //
  • Blockkommentare mit /*…*/

Variante der CDS View Syntax

@AbapCatalog.sqlViewName: 'ZSQL_WHERE'
@AbapCatalog.compiler.compareFilter: true
@AbapCatalog.preserveKey: true
@AccessControl.authorizationCheck: #CHECK
@EndUserText.label: 'Examples for date and time'
define view ZCDS_where
  as select
    so_id,
    pd.product_id
  from              snwd_so as so
    left outer join snwd_pd as pd 
    on so.buy_contact_guid = pd.node_key

  where
    pd.category is null

Feldliste vor FROM-Klausel - genau wie im klassischen SQL

SQL Preview

Im CDS Editor gibt es über das Kontextmenü die Möglichkeit, sich die Definition der CDS-Objektes in SQL anzuschauen.

Annotationen auf unterschiedlichen Ebenen

CDS Views

@EndUserText.label: 'Extractor for SO Data'
@Analytics.dataExtraction.enabled : true

Beispiel für Parameter

@EndUserText.label: 'Beschreibung des Parameters'
@Environment.systemField: #CLIENT`

Beispiel für Felder

@Semantics.amount.currencyCode: 'CURR'
@Semantics.currencyCode: true

Übersicht, was wo verwendet werden kann

Annotationen Syntax (2/2) - Wert

Der <Wert> steht hier für:

• Ein in der Annotation definiertes Symbol, das mit # beginnt, z.B. #CLIENT_HANDLING
• Ein Zeichenkettenliteral in Hochkomma oder ein numerisches Literal
• Die logischen Werte true oder false
• Listen (Arrays) von Dingen werden in Eckigen Klammern dargestellt: ['doc_number', 's_ord_item']

Mit Strg. + <Leertaste> bekommen wir passende Vorschläge

Vererbung von Annotationen

Die Feld-Annotationen werden von einem Quell-View normalerweise 1:1 übernommen. Das gilt nicht für Annotationen auf View- bzw. auf Parameterebene!

Die folgende Annotation unterdrückt diese Vererbung.

@Metadata.ignorePropagatedAnnotations: true

Bei den CDS View-Entities ist diese Annotation standardmäßig eingeschaltet! Für ein "normales" Verhalten muss man sie ausschalten.

Atypische Feld-Annotationen

Manche Annotationen beziehen sich auf den ganzen View, sollen aber vererbbar sein. Diese sind dann im Bereich der Felder definiert, auch wenn sie sich nicht darauf beziehen. Vor welchem Feld sie stehen ist also eigentlich egal.

Ein bekanntes Beispiele hierfür ist

@UI.facet