Kontakt

Ansicht
Dokumentation

ABENCDS_PATH_EXPRESSION_V1 - CDS PATH EXPRESSION V1

ABENCDS_PATH_EXPRESSION_V1 - CDS PATH EXPRESSION V1

CL_GUI_FRONTEND_SERVICES - Frontend Services   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

- DDIC-basierte View, path_expr

... $[source.$]_assoc1$[ parameters$]$[attributes$]
           $[._assoc2$[ parameters$]$[attributes$] ... $] ...

Wirkung

Gibt einen SQL-Pfadausdruck an, der in einer SELECT-Anweisung einer verwendet werden kann. Ein Pfadausdruck der CDS DDL ist eine Folge von durch Punkte (.) getrennter CDS-Assoziationen, deren Namen mit _assoc1, _assoc2, ... angegeben werden. Vor der ersten CDS-Assoziation kann optional der Name der CDS-Entität source angegeben werden, in dem diese CDS-Assoziation definiert oder exponiert ist. Die erste CDS-Assoziation eines Pfadausdruck muss

  • entweder in der aktuellen CDS-View definiert sein
  • oder in einer CDS-View oder CDS-Hierarchie, die Datenquelle der aktuellen View ist, als Element der SELECT-Liste oder Elementliste exponiert sein.

Alle weiteren CDS-Assoziationen müssen im Assoziationsziel der im Pfadausdruck jeweils direkt vorangehenden CDS-Assoziation exponiert sein. Eine CDS-Assoziation kann nicht in einem Pfadausdruck verwendet werden, der in einer abstrakten CDS-Entität oder CDS-Custom-Entität definiert ist.

attributes kann für die Angabe von Attributen in spitzen Klammern nach jeder CDS-Assoziation verwendet werden. Diese Attribute definieren die folgenden Eigenschaften aus diesem Abschnitt des Pfadausdrucks:

  • Bei Verwendung implementierter Join-Typ

Wenn das Assoziationsziel einer angegebenen CDS-Assoziation eine CDS-Entität mit Eingabeparametern ist, dann müssen Aktualparameter über parameters nach dem Namen _assoc an sie übergeben werden. Für eine als Element einer SELECT-Liste exponierte CDS-Assoziation können keine Parameter angegeben werden.

Verwendung von Pfadausdrücken

Pfadausdrücke können in der CDS DDL von ABAP CDS wie folgt verwendet werden:

  • zur Angabe eines Elements .element des Assoziationsziels der letzten CDS-Assoziation nach GROUP BY. Der Pfadausdruck repräsentiert standardmäßig einen Left-Outer-Join.

Für eine Selbstassoziation, bei der das Assoziationsziel gleich der Assoziationsquelle ist, sind diese Verwendungen nicht in der CDS-Entität möglich, in der sie definiert ist.

Für ein nicht aggregiertes Element einer SELECT-Liste mit Aggregatausdrücken und in einer WHERE- oder HAVING-Bedingung muss das Ergebnis des Pfadausdrucks eindeutig sein. D.h. die Kardinalität aller verwendeten CDS-Assoziationen ist entweder zu 1 oder der Pfadausdruck darf nur Filterbedingungen enthalten, die mit dem Zusatz 1: als eindeutig deklariert sind.

Bei einem Zugriff auf eine CDS-Entität mit einem Pfadausdruck werden ausgewertet:

  • Von links nach rechts die durch die CDS-Assoziationen definierten Joins.
  • Alle sonstigen Bedingungen der beteiligten CDS-Entitäten.

Der Pfadausdruck adressiert das gesamte Ergebnis dieser Auswertung oder ein Einzelelement .element.

Hinweise

  • Der einfachste Pfadausdruck ist der Name einer einzigen CDS-Assoziation.
  • Beachten Sie bei Joins der in Pfadausdrücken verwendeten CDS-Assoziationen, dass ihre linke Seite immer die CDS-Entität ist, die die CDS-Assoziation exponiert. Dies gilt insbesondere für CDS-Assoziationen, die in Datenquellen von CDS-Entitäten exponiert sind und weitergereicht werden.
  • Pfadausdrücke der CDS DDL können auch für die Angabe von Bedingungen der ABAP CDS DCL von ABAP CDS verwendet werden.
  • Auf eine CDS-Assoziation, deren Assoziationsziel keine CDS-Assoziation exponiert, kann in einem Pfadausdruck keine weitere CDS-Assoziation folgen. Genauer gesagt können für CDS-Assoziationen, deren Assoziationsziele DDIC-Datenbanktabellen oder DDIC-Views sind, keine weiteren CDS-Assoziationen in einem Pfadausdruck angegeben werden.
  • Wenn CDS-Assoziationen der Pfadausdrücke einer View als Joins implementiert werden, werden sie auf so wenig Join-Ausdrücken wie möglich abgebildet. Dies kann mit der ABAP-Annotation AbapCatalog.compiler.compareFilter unterstützt werden. In dieser Annotation sorgt der Wert true dafür, dass CDS-Assoziationen mit semantisch gleichen Filterbedingungen nicht zu unterschiedlichen Join-Ausdrücken führen.
  • Pfadausdrücke mit CDS-Assoziationen, deren Assoziationsziel eine nicht-SQL-CDS-Entität ist, können an keiner Stelle verwendet werden, an der es zu einer Ausprägung von Join-Ausdrücken käme.

Beispiel

Die folgende DDIC-basierte View enthält den einfachen Pfadausdruck _scarr[inner].carrname in ihrer SELECT-Liste. Das Attribut INNER steuert den Join-Typ. Das Programm DEMO_FROM_JOIN_TO_ASSOCIATION demonstriert, dass diese View das gleiche Ergebnis wie ein direkt programmierter innerer Join in ABAP CDS oder in liefert.

Beispiel

Das Beispiel zeigt drei CDS-Views sales_order, business_partner und invoice. Die CDS-View invoice verwendet eine eigene CDS-Assoziation und CDS-Assoziationen der anderen beiden Views in Pfadausdrücken:

  • Die CDS-Assoziation sales_order der CDS-View business_partner wird hinter FROM als Datenquelle angegeben. Eine Filterbedingung sorgt dafür, dass nur bestimmte Aufträge als Datenquelle dienen.
  • Die CDS-Assoziation invoice_header, die in der View invoice selbst definiert ist, wird in einem Pfadausdruck als Operand in der WHERE-Bedingung verwendet.
  • Die CDS-Assoziation note_header der CDS-View sales_order wird über den alternativen Namen bpa in business_partner adressiert und als Element der SELECT-Liste definiert. Dadurch ist diese CDS-Assoziation auch in CDS-Views verwendbar, die invoice als Datenquelle verwenden.
@AbapCatalog.sqlViewName: 'SALES_ORDER_VW'
define view sales_order as
  select from snwd_so
         association [0..1] to snwd_text_key as _note_header
           on snwd_so.note_guid = _note_header.node_key
  { * } // Include all fields from snwd_text_key
@AbapCatalog.sqlViewName: 'BPA_VW'
define view business_partner as
  select from snwd_bpa
         association [0..*] to sales_order
           on snwd_bpa.node_key = sales_order.buyer_guid
  { * }
@AbapCatalog.sqlViewName: 'SALESO_INV_VW'
define view invoice as
  select from
         /* Association "sales_order" with filter as data source */
         business_partner.sales_order[
           lifecycle_status <> 'C' and lifecycle_status <> 'X']
           as bpa_so //alias for data source
         /* Association only used in this view definition */
         association [0..1] to snwd_so_inv_head as _invoice_header
           on bpa_so.node_key = _invoice_header.so_guid
        { key bpa_so.node_key, //Field from ON-condition in _invoice_header
              bpa_so.so_id,
              bpa_so.note_guid, //Field from ON-condition in note_header
              bpa_so.lifecycle_status,
              /* Association is not exposed, but its element */
              _invoice_header.dunning_level,
              /* Association from data source is exposed here */
              bpa_so.note_header }
          /* Path expression in WHERE clause */
          where _invoice_header.dunning_level > '0';

Pfadausdrücke, Verwendung in der SELECT-Liste






General Data in Customer Master   BAL_S_LOG - Application Log: Log header data  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 19981 Date: 20240523 Time: 174228     sap01-206 ( 207 ms )