High Level Syntax CDS Views

DEFINE VIEW 
[<Parameters>]
AS SELECT FROM <Quelle>
[<Joins>]
[<Associations>]
{
  <Fieldlist>
}
[<WHERE Clause>]
[<GROUP BY Clause>]
[<HAVING Clause>]

Ausdrücke

Ein Ausdruck ist in vielen Programmiersprachen ein Konstrukt, das gemäß einer gegebenen Semantik in Bezug auf einen Kontext ausgewertet werden kann, also einen Wert liefert.
In vielen formalen Sprachen sind Ausdrücke eines der wichtigsten Konstrukte, wenn nicht gar das einzige.

Ein Ausdruck in SQL ist etwas, das zur Laufzeit einen Wert liefert.
Zur Designzeit ist der Datentyp, den der Ausdruck zurück geben wird, bekannt.

Ausdrücke in der Feldliste - Beispiele

@AbapCatalog.sqlViewName: 'ZJB_EXPRESSIONS'

@EndUserText.label: 'SQL Expressions'
define view zjb_cds_expressions
  as select from zbc_users as u
  
  left outer join zjb_cds_aggregation as t
  on u.user_id = t.Assignee
{
  key u.user_id       as UserId,
      u.firstname     as Firstname,
      u.lastname      as Lastname,
      u.email         as Email,
      u.gender        as Gender,
      u.date_of_birth as DateOfBirth,
      u.changed_at    as ChangedAt,
      
      'EUR'         as CurrencyCode,      
      $session.user as CurrentUser,      
      concat_with_space( Left(u.firstname, 1) ,  u.lastname , 1 ) as Name,      
      case u.gender when 'F' then 'Frau '
                  when 'M' then 'Herr '
                  else '' end 
                  
                  as Anrede,                  
      concat_with_space( concat_with_space( 'User hat ', 
                                            cast( t.TaskCount as abap.char(11) ) , 
                                            1 ), 
                         ' Aufgaben', 
                         1 ) as CNT
}

SQL-Funktionen

Es kommen mit jedem Release mehr hinzu.

• Datentyp spezifische
  • Zeichenketten
  • Datum und Zeit
  • Numerische Daten
• Konvertierung zwischen den Datentypen

Ersetzen mit Regulären Ausdrücken

Syntax / Parameter

REPLACE_REGEXPR(PCRE => pcre,
                VALUE => arg1,
                WITH => arg2,
                RESULT_LENGTH => res[,
                OCCURRENCE => occ][,
                CASE_SENSITIVE => case][,
                SINGLE_LINE => bool][,
                MULTI_LINE => bool][,
                UNGREEDY => bool]) 

replace_regexpr(
    pcre          => '(.?)(.?)(.?)(.?)(.?)(.?)(.?)(.?)',
    value         => status,
    with          => '\\8\\7\\6\\5\\4\\3\\2\\1',
    result_length => 8)         as mirroredStatus

SQL-Funktionen für Datum und Zeit

Bei vielen SQL-Funktionen muss ein Fehlerverhalten (<on_error>) mit angegeben. Möglich sind die Werte FAIL, INITIAL, NULL , bei ADD-Funktionen auch UNCHANGED .

Bei vielen SQL-Funktion muss die Zeitzone angegeben werden. Diese kann entweder konstant (z.B. CET) sein oder sie wird von den folgenden beiden Funktionen bereitgestellt:

• ABAP_SYSTEM_TIMEZONE(<Client>, <on_error>)
• ABAP_USER_TIMEZONE(<User>, <Client>, <on_error>)

User und Client kann man aus den Sitzungsvariablen beziehen:

• $session.user
• $session.client

Typkonvertierung mit CAST und FLTP_TO_DEC

Typkonvertierung mit

• CAST (<Wert> AS <Datentyp> )
• FLTP_TO_DEC( <Float-Wert> AS <DEC-Datentyp> )

Der Wert kann ein beliebiger Ausdruck sein. Als Datentyp kommt in Frage:

• Ein Datenelement
• Ein eingebauter ABAP Datentyp mittels abap.<datentyp>

CAST-Beispiel

CAST( so.created_at AS abap.char(23))

CASE Ausdrücke - Einfach

Der CASE Ausdruck liefert genau einen Wert:

CASE Wert
        WHEN Vergleichswert1 THEN Ergebniswert1
        WHEN Vergleichswert2 THEN Ergebniswert2
        ...
        ELSE AlternativWert
    END

Überall wo hier Wert steht, kann ein beliebiger Ausdruck sein…

Beispiel für CASE

      CASE WHEN mara.aenam <> '' 
             THEN mara.aenam
             ELSE mara.ernam 
      END                         AS LastChangedByUser

Demo - Ausdrücke in Feldlisten

@AbapCatalog.viewEnhancementCategory: [#NONE]
@AccessControl.authorizationCheck: #NOT_REQUIRED
@EndUserText.label: 'Demo Ausdrücke in der Feldliste'
@ObjectModel.usageType:{
    serviceQuality: #X,
    sizeCategory: #S,
    dataClass: #MIXED
}
define view entity zi_demo_expressions
  as select from zbc_users
{
  key user_id            as UserId,
      concat_with_space( concat(left(firstname, 1), '.'), lastname, 1) as Name,
      lower(email)              as Email,
      case gender when 'F' then 'Frau'
                  when 'M' then 'Herr'
                  else ''
                  end             as Greeting,
      cast(left($session.system_date, 4) as abap.int4) 
        - cast(left(date_of_birth, 4) as abap.int4)      as Age
}

Aggregation

Mit der GROUP BY-Klausel kann die Granularität der Daten verändert werden. Für jede Kombination von Werten aus den Feldern aus dieser Klausel wird eine Zeile in der Ergebnismenge gebildet.

Falls keine GROUP BY-Klausel verwendet wird, besteht die Ergebnismenge aus genau einer Zeile.

Alle Felder in der Feldliste müssen entweder:

• In der GROUP BY Klausel vorkommen oder
• mit einer Aggregatfunktion auf einen Einzelwert reduziert werden.

SELECT FROM <Quelle>
{
  <Gruppierungsfeld1>, 
  <Gruppierungsfeld2>,
  ...
  <Aggregatfunktion>(<Feld3>)
}
GROUP BY <Gruppierungsfeld1>,
         <Gruppierungsfeld2>

WHERE -Klausel

Eingeschränkte Möglichkeiten im Vergleich zu SQLScript

• Vergleichsprädikate (<, <=, …)
• BETWEEN
• IN-Prädikat, zum Vergleich mit einer Menge, z.B. WHERE type IN ('A', 'B', 'C')
• LIKE - Suchen mit Platzhalter: % steht für 0-N beliebige Zeichen, _ steht für genau ein Zeichen.
• IS NULL - Datenbank NULL Werte, z.B aus OUTER JOIN
• IS INITIAL - ABAP Initialwert

Prädikate mit Unterabfragen sind nicht möglich. Diese müssen durch geschickte JOINs simuliert werde:

• EXISTS-Prädikat:
  • WHERE EXISTS durch INNER JOIN
  • WHERE NOT EXISTS durch LEFT OUTER JOIN mit Filter auf IS NULL
• WHERE Feld IN (Sub-Query) durch INNER JOIN

Umgang mit NULL

• In der Feldliste - Um den Feldwert NULL durch einen anderen Wert zu ersetzen, kann die Funktion COALESCE(Wert, Ersatzwert) verwendet werden.
• Beim Filtern - Um Zeilen mit NULL-Werten auszufiltern, muss das IS NULL-Prädikat verwendet werden.

NULL im ABAP

Im ABAP wird NULL durch den passenden Initialwert ersetzt.