Ansicht
Dokumentation
ABENBDL_WITH_DRAFT - BDL WITH DRAFT
BAL_S_LOG - Application Log: Log header data Fill RESBD Structure from EBP Component StructureDiese Dokumentation steht unter dem Copyright der SAP AG.
- with draft
...
with draft;
...
Wirkung
Mit dem Zusatz with draft wird RAP-Entwurfsbehandlung für ein Business-Objekt eingeschaltet. Der Verhaltensdefinitionskopf wird um ihn erweitert, da er das ganze Business-Objekt entwurfsfähig macht. Entwurfsfähigkeiten können für einzelne Entitäten innerhalb eines Business-Objekts nicht implementiert werden.
In allen Szenarien wird die gesamte RAP-Entwurfsbehandlung von der transaktionalen RAP-Engine verwaltet. Wie die Entwurfsdaten auf die dntwurfsdatenbanktabelle geschrieben wird ist keine Aufgabe des Anwendungsentwicklers. Es sind jedoch Implementierungen vorhanden, da das Implementieren von szenarienspezifischen Fähigkeiten ermöglichen.
In Projektions-BOs kann die Entwurfsbearbeitung über den Syntaxzusatz use draft aus dem projizierten BO wiederverwendet werden. Weitere Informationen finden Sie unter CDS BDL - Verwendung, Projektions-BDEF.
Nicht verwaltetes RAP-BO
In nicht verwalteten RAP-BOs gelten folgende Einschränkungen:
- Die späte Nummernvergabe wird nicht unterstützt.
- Assoziationen, die in der Bindungsbedingung NOT verwenden, können nicht entwurfsfähig gemacht werden.
- Folgende RAP-BO-Operationen können auf Entwurfsinstanzen ausgeführt werden:
- Direkte anlegende Operationen auf untergeordnete Instanzen (ohne Syntaxfehler in der BDL, aber mit Kurzdump zur Laufzeit).
Abhängigkeiten
Mit dem Zusatz with draft wird die Entwurfsbehandlung aktiviert. Es gibt mehrere verwandte Syntaxelemente in der Verhaltensdefinition:
- Für die Speicherung der Entwurfsinstanzen ist eine RAP-Entwurfstabelle notwendig. Mit dem Schlüsselwort draft table DraftTableName definiert. Für entwurfsfähige BOs obligatorisch.
- Das ganze ETag ist in einem entwurfsfähigen Business-Objekt ein Feld, das Änderungen zwischen der aktiven Version und der Entwurfsversion kennzeichnet. Das ganze ETag ist für entwurfsfähige Implementierungen obligatorisch.
- Die Entwurfsaktionen Edit, Activate, Discard, Resume und Prepare stehen Entwurfs-Business-Objekten zur Verfügung. Sie sind direkt nach der Entwurfsfähigkeit eines Business-Objekts implizit verfügbar, können aber auch explizit deklariert werden.
- Wenn eine aktive Instanz hinter einer entwurfsfähigen Assoziation steht, holt die Assoziation aktive Daten; wenn eine Entwurfsquelleninstanz dahinter steht, holt sie Entwurfsdaten. Für entwurfsfähige BOs obligatorisch.
Entwicklungsleitfaden für das ABAP-RESTful-Anwendungsprogrammiermodell, Abschnitt Draft
Hinweise
Beim impliziten Einschalten der Entwurfsaktion Edit besitzt sie auch automatisch das
Instanz-Feature-Control und eine Implementierung im
ABAP-Behavior-Pool
ist erforderlich. In folgenden Beispielen wird sie ohne Feature-Control explizit eingeschaltet, damit beide Implementierungsszenarien (verwaltet und nicht verwaltet) durch den
verwalteten RAP-BO-Provider behandelt werden können.
Beispiel - Verwaltet
Im folgenden Beispiel wird eine auf der CDS-Wurzel-View-Entität DEMO_RAP_MANAGED_DRAFT_ROOT basierte verwaltete BDEF gezeigt. Sie ist entwurfsfähig und besitzt alle obligatorischen Syntaxelemente.
Die Behandlung des Entwurfs durch das RAP-Framework ist vollständig und es ist keine Implementierung im ABAP-Behavior-Pool notwendig.
Das Programm DEMO_RAP_MANAGED_DRAFT greift über EML auf das Business-Objekt zu und führt die folgenden Schritte aus:
- Es legt zwei neue Entwurfsinstanzen der übergeordneten Entität sowie zwei neue Entwurfsinstanzen der untergeordneten Entität an und zeigt den Inhalt der Entwurfstabellen an.
- Anschließend aktiviert er die Entwurfsinstanzen. Der Inhalt der Entwurfstabellen wird in die
persistenten Tabellen geschrieben und die Entwurfstabellen werden geleert.
Beispiel - Nicht verwaltet
Im folgenden Beispiel wird eine auf der CDS-Wurzel-View-Entität DEMO_RAP_UNMANAGED_DRAFT_ROOT basierte nicht verwaltete BDEF gezeigt. Sie ist entwurfsfähig und besitzt alle obligatorischen Syntaxelemente.
Der ganze Entwurf wird durch das RAP-Framework behandelt; der ABAP-Behavior-Pool implementiert die Geschäftslogik nur für die aktive Entität.
Das Programm DEMO_RAP_UNMANAGED_DRAFT greift über EML auf das Business-Objekt zu und führt die folgenden Schritte aus:
- Es legt zwei neue Entwurfsinstanzen der übergeordneten Entität sowie zwei neue Entwurfsinstanzen der untergeordneten Entität an und zeigt den Inhalt der Entwurfstabellen an.
- Anschließend aktiviert er die Entwurfsinstanzen. Der Inhalt der Entwurfstabellen wird in die
persistenten Tabellen geschrieben und die Entwurfstabellen werden geleert.
TXBHW - Original Tax Base Amount in Local Currency Fill RESBD Structure from EBP Component Structure
Diese Dokumentation steht unter dem Copyright der SAP AG.
Length: 10132 Date: 20240523 Time: 182350 sap01-206 ( 101 ms )