Assoziationen und Zusammensetzungen verwenden

Objective

After completing this lesson, you will be able to assoziationen verwenden, um Beziehungen zwischen Entitäten zu erfassen

Verwaltete To-One-Assoziationen

Assoziationen werden verwendet, um Beziehungen zwischen Entitäten zu definieren.

Im Beispiel in der Abbildung „Verknüpfung von Dokumentenmappen mit Autoren" wird die Verknüpfung zwischen Dokumentenmappen und Autoren über das Autorenelement in der Entität Dokumentenmappen definiert. Dieses Element erstellt einen Link zur Entität Autoren, die eine Beziehung herstellt, in der Sie von einer Dokumentenmappenentität zum zugehörigen Autor navigieren können, um weitere Details wie den Namen des Autors abzurufen.

Hinter den Kulissen

Die Zu-Eins-Assoziation Bücher:Autor im Beispielcode ist eine sogenannte verwaltete Assoziation, bei der Fremdschlüsselfelder und on Bedingungen automatisch hinter den Kulissen hinzugefügt werden.

Basierend auf dem Primärschlüssel des Ziels, d.h. der Authors -Entität, fügt CDS bei der Aktivierung automatisch das Fremdschlüsselfeld author_ID zu einer SQL-Datenbank hinzu (siehe Abbildung Generiertes Fremdschlüsselfeld) und implizit die entsprechende Join-Bedingung.

Neben verwalteten Assoziationen können wir auch nicht verwaltete Assoziationen verwenden. Nicht verwaltete Assoziationen geben explizit beliebige Join-Bedingungen in ihrer on -Klausel an, die sich auf verfügbare Fremdschlüsselfelder beziehen.

Notiz

Aus Gründen der Übersichtlichkeit und Verständlichkeit Ihrer Modelle sollten Sie verwaltete Assoziationen für Zu-eins-Assoziationen immer bevorzugen.

Als Nächstes betrachten wir ein Beispiel für eine Zu-viele-Assoziation.

Zu viele Assoziationen

Ein Autor kann beliebig viele Bücher schreiben, d.h. ein Autor kann mit keinem, einem oder mehreren Büchern verknüpft werden.

Abbildung Assoziation von Autoren zu Dokumentenmappen zeigt, wie solche Zu-n-Assoziationen in einem CDS-Modell definiert sind.

Die Beziehung zwischen der Entität Autoren und der Zielentität Dokumentenmappen wird durch das Dokumentenmappen-Element in der Entität Autoren festgelegt. Die Syntax Association to many Books gibt an, dass ein Autor mit einer beliebigen Anzahl von Dokumentenmappen verknüpft ist.

In der Bedingung on wird die Assoziationsnamensmappe als Alias für die zu verknüpfende Zielentität Dokumentenmappen verwendet. Die Klausel on books.author = $self gibt an, dass das Autorenfeld in der Entität Dokumentenmappen verwendet wird, um die Verknüpfung zur Entität Autoren zu erstellen. $self ist ein Platzhalter, der sich auf die aktuelle Instanz eines Autors bezieht.

In der Regel wird ein Ausdruck nach folgendem Muster in der on -Bedingung für Zu-viele-Assoziationen angegeben:

<assoc>.<backlink> = $self

Der Backlink kann eine beliebige verwaltete Eins-Assoziation auf der vielen Seite sein, die auf die eine Seite zurückzeigt.

Notiz

CDS bietet derzeit keine spezielle Unterstützung für Viele-zu-viele-Assoziationen. Daher müssen Sie Viele-zu-viele-Assoziationen in zwei Eins-zu-n-Assoziationen auflösen, indem Sie eine Verknüpfungsentität verwenden, um die beiden zu verbinden.

Zusammensetzungen

Neben Assoziationen unterstützt CAP auch die Modellierung von Kompositionen.

Assoziationen beziehen sich auf Entitäten, die unabhängig voneinander existieren können, z.B. Autoren und Bücher.

Zusammensetzungen stellen dagegen contained-in-Beziehungen dar und dienen der Modellierung von Dokumentstrukturen. Sie werden häufig in zu vielen Szenarios mit untergeordnetem Kopf angezeigt, z.B. in Aufträgen und Auftragspositionen.

Komposition bedeutet, dass die untergeordnete Entität (Auftragspositionen) Teil eines Ganzen ist und nicht unabhängig von der übergeordneten Entität (Auftrag) vorhanden sein kann. Die Kindentität ist in der Elternentität enthalten und kann nur über die Elternentität aufgerufen werden.

Abbildung Beispiel einer Komposition zeigt, wie Zusammensetzungen in CDS definiert werden. Die gezeigte Zusammensetzung definiert eine Eins-zu-n-Beziehung zwischen Aufträgen und Auftragspositionen. Die Syntax ähnelt der Definition einer Eins-zu-n-Assoziation. Der einzige Unterschied ist die Klausel Composition of anstelle der Klausel Association to auf der einen Seite (vergleichen Sie die Assoziation zwischen Autoren und Büchern oben).

Die CAP Laufzeiten behandeln Zusammensetzungen in mancher Hinsicht anders als Assoziationen. Für Zusammensetzungen gibt es unter anderem folgende Besonderheiten:

  • Kaskadiertes Löschen

    Das Löschen eines Auftrags würde aufgrund der Zusammensetzungsbeziehung auch zum Löschen aller seiner Auftragspositionen führen.

  • Deep Insert

    Im generierten OData-Service können sowohl ein Auftrag als auch die enthaltenen Auftragspositionen über eine einzelne POST-Anfrage angelegt werden.

Schauen wir uns nun an, wie Assoziationen in Service-Interfaces exponiert werden können.

Assoziationen in Service-Interfaces exponieren

Assoziationen in Projektionen veröffentlichen

Sie können Assoziationen wie normale Elemente zur Auswahlliste einer View (as select from ) oder Projektion (as projection on ) hinzufügen. Ein select * umfasst alle Assoziationen.

Abbildung Projektionen exponieren zeigt die beiden Projektionen AdminService.Books und AdminService.Authors aus unserem Szenario, die über den AdminService bereitgestellt werden. Die effektive Signatur der Projektion AdminService.Books enthält eine Autorenassoziation mit denselben Eigenschaften wie die Autorenassoziation der Entität com.sap.learning.Books. Ebenso enthält die Signatur der AdminService.Authors-Projektion eine Mappenassoziation mit denselben Eigenschaften wie die Mappenassoziation der Entität com.sap.learning.Authors.

Automatisch umgeleitete Assoziationen

Der AdminService, der in der Abbildung „Exponieren von Projektionen" dargestellt ist, exponiert die beiden Projektionen auf den Entitäten aus dem zugrunde liegenden Datenmodell.

Beim Exponieren zugehöriger Entitäten werden die Assoziationen automatisch umgeleitet. Dadurch wird sichergestellt, dass Clients wie erwartet zwischen den projizierten Entitäten navigieren können (siehe Abbildung „Umgeleitete Assoziationen"). Das bedeutet, dass AdminService.Authors.books auf AdminService.Books verweist und nicht auf com.sap.learning.Books. In ähnlicher Weise bezieht sich AdminService.Books.author auf AdminService.Authors - und nicht auf com.sap.learning.Authors.

Navigationseigenschaften

Im generierten OData-Service sind die veröffentlichten Assoziationen als Navigationseigenschaften mit demselben Namen verfügbar.

Die Abbildung Generierte Navigationseigenschaften zeigt den entsprechenden Auszug aus dem Service-Metadatendokument. Der Entitätstyp Dokumentenmappen hat eine Navigationseigenschaft Autor, und der Entitätstyp Autoren verfügt über Navigationseigenschaftenbücher.

Demonstration und Übung: Assoziationen zum Domain Model hinzufügen

Notiz

Führen Sie als Übung die Schritt-für-Schritt-Anleitung in der folgenden Demonstration selbst im SAP Business Application Studio durch.

Verwenden Sie als Ausgangspunkt für die Übung das Ergebnis der vorherigen Übung Eine persistente SQLite-Datenbank mit Initialdaten für die Entwicklung einrichten, wenn Sie sie erfolgreich abgeschlossen haben. Alternativ können Sie auch den Branch 4_SQLite_database aus dem folgenden GitHub-Repository als Ausgangspunkt verwenden:

https://github.com/SAP-samples/cap-development-learning-journey

Die vollständige Implementierung der Simulation finden Sie im 5_associations-Branch des GitHub-Repositorys.

Detaillierte Informationen zum Inhalt des Repositorys und dessen Verwendung finden Sie hier.

Sehen Sie sich das Video an, um zu sehen, wie Sie dem Domänenmodell Assoziationen hinzufügen.

Als Nächstes sehen wir uns an, wie Entitätsdefinitionen mit sogenannten Aspekten um neue Elemente erweitert werden können.