Ansicht
Dokumentation

ABAPMODIFY_ENTITY_ENTITIES_OP - MODIFY ENTITY ENTITIES OP

Addresses (Business Address Services)   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

MODIFY ENTITY, ENTITIES, operations

... $[CREATE field_spec$]
    $[CREATE BY \_assoc field_spec$]
    $[UPDATE field_spec$]
    $[DELETE field_spec$]
    $[EXECUTE action field_spec $[REQUEST request$] $[ RESULT result_tab$]$] ...

Varianten:

1. ... CREATE field_spec

2. ... CREATE BY \_assoc field_spec

3. ... UPDATE field_spec

4. ... DELETE field_spec

5. ... EXECUTE action field_spec

Wirkung

Die EML-MODIFY-Anweisung unterstützt folgende Operationen:

• CREATE: Neue RAP-BO-Knoteninstanzen für Wurzel- oder Kindentitäten anlegen.

• CREATE BY: Zielinstanzen für zugehörige Entitäten anlegen, bei denen create in der BDEF eingeschaltet sein muss. Das Anlegen ist nicht auf Kompositionen beschränkt.

• UPDATE: Bestehende RAP-BO-Knoteninstanzen aktualisieren.

• DELETE: Bestehende RAP-BO-Knoteninstanzen löschen. Die Löschung betrifft auch Knoteninstanzen entlang der Komposition.

• EXECUTE-Aktionen: Selbstdefinierte modifizierende Operationen ausführen.

In beiden Implementierungsarten, verwaltet und nicht verwaltet, müssen alle modifizierenden Operationen in der CDS-Verhaltensdefinition angegeben. Weitere Details sind in der BDL-Dokumentation Verhalten definieren, Standardoperationen zu finden. Alle Nicht-Standard-Operationen (Aktionen) müssen im ABP selbstimplementiert sein.

Jede modifizierende Operation benötigt eine interne Tabelle (field_spec) mit Instanzen als Eingabeparameter hinter dem jeweiligen Schlüsselwort, um die zu modifizierenden Felder anzugeben.

Hinweise

• Nach dem Schlüsselwort BY für create-by-association-Operationen und vor den durch die Codevervollständigung angezeigten Assoziationen muss ein Rückwärtsschrägstrich (\) eingefügt werden.

• Das Aktualisieren und Löschen von Instanzen über Assoziationen ist nicht möglich.

• In Entwurfsszenarien werden beim Setzen des Entwurfskennzeichens %is_draft auf wahr Entwurfsinstanzen angelegt. Beim Setzen auf falsch werden aktive Instanzen angelegt.
  
  

Variante 1

... CREATE field_spec

Wirkung

Hiermit werden neue Knoteninstanzen einer RAP-BO-Entität angelegt.

Informationen zu Schlüsselwörtern, die auf das Schlüsselwort CREATE folgen müssen, finden Sie in der Dokumentation für field_spec.

Beispiel

Mit folgendem Quelltextausschnitt aus DEMO_RAP_EML_MODIFY_OP_2 wird eine CREATE-Operation demonstriert.

Variante 2

... CREATE BY \_assoc field_spec

Wirkung

Hiermit werden neue Zielinstanzen für zugehörige Entitäten angelegt, bei denen create in der BDEF eingeschaltet sein muss. Das Anlegen ist nicht auf Kompositionen beschränkt. _assoc ist der in der zugrunde liegenden CDS-View angegebenen Name der Assoziation.

Informationen zu Schlüsselwörtern, die auf das Schlüsselwort CREATE folgen müssen, finden Sie in der Dokumentation für field_spec.

Beispiel

Mit folgendem Quelltextausschnitt aus DEMO_RAP_EML_MODIFY_OP_2 wird eine create-by-association-Operation demonstriert.

Variante 3

... UPDATE field_spec

Wirkung

Hiermit werden Knoteninstanzen eines RAP-BOs aktualisiert. Mit der UPDATE-Anweisung können auf der RAP-BO-Consumer-Seite, wo nur Schlüsselfelder und Felder mit neuen Werten bereitgestellt werden müssen, Delta-Aktualisierungen ausgelöst werden. Auf der RAP-BO-Provider-Seite werden die zu überschreibenden und zu haltenden Felder identifiziert.

Informationen zu Schlüsselwörtern, die auf das Schlüsselwort UPDATE folgen müssen, finden Sie in der Dokumentation für field_spec.

Beispiel

Mit folgendem Quelltextausschnitt aus DEMO_RAP_EML_MODIFY_OP_2 wird eine UPDATE-Operation demonstriert.

Variante 4

... DELETE field_spec

Wirkung

Hiermit werden Instanzen eines RAP-BOs gelöscht. Um die zu löschenden Instanzen zu identifizieren, werden nur Schlüsselfeldwerte oder %cid_ref benötigt.

Informationen zu Schlüsselwörtern, die auf das Schlüsselwort DELETE folgen müssen, finden Sie in der Dokumentation für field_spec.

Beispiel

Mit folgendem Quelltextausschnitt aus DEMO_RAP_EML_MODIFY_OP_2 wird eine DELETE-Operation demonstriert.

Variante 5

... EXECUTE action field_spec $[REQUEST request$] $[RESULT result_tab$]

Zusätze:

1. ... REQUEST request

2. ... RESULT result_tab

Wirkung

Hiermit werden benutzerdefinierte Aktionen ausgelöst, die Daten selbstimplementiert modifizieren. Die Syntax zur Ausführung einer action ermöglicht die Angabe angeforderter Daten (REQUEST request) und der Export von Ergebnisdaten (RESULT result_tab), jeweils in Zielvariablen als Aktion angegeben.

Informationen zu Schlüsselwörtern, die auf das Schlüsselwort CREATE folgen müssen, finden Sie in der Dokumentation für field_spec.

Beispiel

Mit folgendem Quelltextausschnitt aus DEMO_CDS_PURCHASE wird eine modifizierende Operation, die eine Aktion ausführt, demonstriert.

Zusatz 1

... REQUEST request

Wirkung

Hiermit wird angegeben, ob das Ergebnis vollständig oder aus Leistungsgründen nur teilweise (beispielsweise nur die Schlüssel) zurückgegeben werden soll. request muss mit dem benötigten abgeleiteten BDEF-Typ TYPE STRUCTURE FOR ACTION REQUEST typisiert sein. Die Komponenten der Struktur sind sämtliche Schlüssel- und Datenfelder der RAP-BO-Entität. Sie sind vom Typ ABP_BEHV_FLAG und das Einbeziehen oder Nichteinbeziehen der jeweiligen Felder kann durch Kennzeichnen der Komponenten angegeben werden.

Dies ist optional und darf nur bei mit dem Zusatz result selective in der BDEF angegebenen Aktionen verwendet werden.

Zusatz 2

... RESULT result_tab

Wirkung

Aktionen können optional ein Ergebnis zurückgegeben. Dies darf nur bei mit dem Zusatz result in der BDEF angegebenen Aktionen verwendet werden. Die interne Tabelle result_tab muss vom Typ TABLE FOR ACTION RESULT bdef~action typisiert sein. Für weitere Details, siehe RESULT result_tab.

• Mit dem Beispiel MODIFY: Standardoperationen (verwaltet) werden diverse Standardoperationen mit MODIFY demonstriert.

• Mit dem Beispiel MODIFY: Nicht-Standard-Operationen wird die Implementierung einer Aktion im Kontext eines verwalteten RAP-BOs demonstriert. Für weitere Aktionsbeispiele, siehe die ABAP-CDS-Dokumentation.

• Mit dem Beispiel MODIFY: Standardoperationen (nicht verwaltet) werden alle Standardoperationen mit MODIFY mit einem einfachen nicht verwalteten RAP-BO demonstriert.

• Das Beispiel Beispiel für RAP Behandlermethoden (nicht verwaltetes BO mit Entwurf) umfasst verschiedene Standard- und Nicht-Standard-ABAP EML-MODIFY-Operationen im RAP-BO-Provider- und Consumer.

• Weitere Beispiele über allgemeine MODIFY-Operationen sind unter Beispiele für ABAP EML MODIFY zu finden.

BAL Application Log Documentation   Addresses (Business Address Services)  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 13630 Date: 20240523 Time: 144424     sap01-206 ( 150 ms )