Kontakt

Ansicht
Dokumentation

ABAPREAD_ENTITY_ENTITIES_FIELDS - READ ENTITY ENTITIES FIELDS

ABAPREAD_ENTITY_ENTITIES_FIELDS - READ ENTITY ENTITIES FIELDS

CPI1466 during Backup   BAL Application Log Documentation  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

READ ENTITY, ENTITIES, field_spec

...  ${ FROM fields_tab $}
   $| ${ FIELDS ( comp1 comp2 ... ) WITH fields_tab $}
   $| ${ ALL FIELDS WITH fields_tab $} ...


Varianten:

1. ... FROM fields_tab ...

2. ... FIELDS ( comp1 comp2 ... ) WITH fields_tab ...

3. ... ALL FIELDS WITH fields_tab ...

Wirkung

Mit den Feldangabenausdrücken werden Eingabeparameter angegeben, die die Grundlage für Leseoperationen auf RAP-BO-Instanzen bilden. Mit allen Varianten können direkte lesende und read-by-association-Operationen ausgeführt werden. Die Variante FROM ist die einzige Option für Operationen ausführende Funktionen (über das Schlüsselwort EXECUTE).

Die für Leseoperationen berücksichtigten Parameter müssen in einer internen Tabelle angegeben werden (fields_tab). Die interne Tabelle muss unbedingt mit dem benötigten abgeleiteten BDEF-Typ typisiert sein. Abhängig von der Operation und Variante umfassen die Parameter der internen Tabelle spezielle Komponenten.

Folgende Tabelle liefert eine Übersicht der Operationen, zeigt die für die Operationen möglichen Feldangabenausdrücke und gibt die jeweilige Relevanz des Typs und der Komponenten der benötigten internen Tabelle an:

Operation Feldangabenausdruck Typ der internen Tabelle fields_tab Komponenten der internen Tabelle
Direkte Leseoperation (beispielsweise READ ENTITY bdef FROM) FROM \lbr FIELDS (...) WITH \lbr ALL FIELDS WITH TYPE TABLE FOR READ IMPORT bdef %control \lbr %key \lbr %pky \lbr %tky \lbr \lbr Bei FROM muss %control explizit gefüllt werden.
read-by-association-Operation (... BY \_assoc ...) FROM \lbr FIELDS (...) WITH \lbr ALL FIELDS WITH TYPE TABLE FOR READ IMPORT bdef\_assoc %control \lbr %key \lbr %pky \lbr %tky \lbr \lbr Bei FROM muss %control explizit gefüllt werden.
Leseoperation, die eine Funktion ausführt (über das Schlüsselwort EXECUTE) FROM TYPE TABLE FOR FUNCTION IMPORT bdef~function %key \lbr %pky \lbr %tky

bdef ist der Wurzelentitätsname, _assoc ist der Name der in der zugrunde liegenden CDS-View der Wurzelentität definierten Assoziation und function ist der Name einer in der BDEF angegebenen Funktion. Weitere Details über die Komponenten finden Sie in der Dokumentation Komponenten von abgeleiteten BDEF Typen.

Hinweise

  • Die Leseanweisung muss durch die Angabe eines Ergebnisses nach fields_tab ergänzt werden. response_param kann hinter fields_tab optional angegeben werden.
  • Je nach Kontext können die in der Komponenten-Spalte der Übersichtstabelle aufgeführten Komponenten mehr als der angegebene Inhalt umfassen. Beispielsweise ist das Entwurfskennzeichen %is_draft nur bei Entwürfen verfügbar. %pid ist nur in Szenarien der späten Nummerierung verfügbar.
  • In der internen Tabelle (fields_tab) müssen alle Schlüsselfelder angegeben werden, sonst schlägt die Leseoperation fehl. In read-by-association-Operationen werden alle Schlüsselfelder einer zugehörigen Entität standardmäßig zurückgegeben.

Variante 1

... FROM fields_tab ...


Wirkung

Die Leseoperation berücksichtigt in einer internen Tabelle (fields_tab) angegebene Eingabeparameter. Sie darf bei allen Operationen verwendet werden und ist für EXECUTE die einzige Option.

Die %control-Struktur muss in fields_tab explizit gefüllt werden. Mit den im Interface IF_ABAP_BEHV bereitgestellten Konstanten können die Werte der Felder in der %control-Struktur angegeben werden: IF_ABAP_BEHV=>MK-.... Wenn Felder beispielsweise mit dem Wert IF_ABAP_BEHV=>MK-ON gesetzt werden, werden sie für die Operation berücksichtigt. In Kombination mit EXECUTE ist %control nicht verfügbar.

Beispiel

Mit folgendem Quelltextausschnitt aus DEMO_RAP_EML_READ_OP_FIELDS wird die Verwendung von FROM mit einer READ Operation gezeigt. Mit der %control-Struktur wird gezeigt, dass manche Felder angefordert werden und manche nicht.

Variante 2

... FIELDS ( comp1 comp2 ... ) WITH fields_tab ...


Wirkung

Von der Leseoperation zurückzugebende Felder werden in Klammern in einer Feldliste hinter dem Schlüsselwort FIELDS angegeben. Die Eingabeparameter für die Leseoperation werden in einer internen Tabelle (fields_tab) angegeben. Die Felder (comp1, comp2, usw.) können beliebige Felder der Entität sein. Schlüsselwörter können explizit angegeben werden, müssen aber nicht, da sie auch bei Nichtangabe standardmäßig gelesen und zurückgegeben werden. Es muss mindestens ein Feld in der Feldliste angegeben werden. Die Felder sind nicht durch ein Komma getrennt. Die Reihenfolge der Felder spielt hierbei keine Rolle. Die Reihenfolge der Spalten der Leseergebnistabelle aber entspricht der Reihenfolge in der Datenbanktabelle.

Die Variante besteht aus Gründen der Bequemlichkeit und ist eine Kurzform für FORM. Sie darf nicht für EXECUTE verwendet werden. %control wird in fields_tab implizit gefüllt.

Beispiel

Mit folgendem Quelltextausschnitt aus DEMO_RAP_EML_READ_OP_FIELDS wird die Verwendung von FIELDS ... WITH mit einer read-by-association-Operation gezeigt.

Variante 3

... ALL FIELDS WITH fields_tab ...


Wirkung

Alle Felder einer Instanz werden gemäß Eingabeparametern für die Leseoperation gelesen, die in einer internen Tabelle (fields_tab) angegeben werden.

Die Variante besteht aus Gründen der Bequemlichkeit und ist eine Kurzform für FORM. Sie darf nicht für EXECUTE verwendet werden. %control wird in fields_tab implizit gefüllt.

Beispiel

Mit folgendem Quelltextausschnitt aus DEMO_RAP_EML_READ_OP_FIELDS wird die Verwendung von ALL FIELDS WITH mit einer READ-Operation gezeigt.

Variante 4

... SET FIELDS WITH fields_tab


Wirkung

Nur für Operation EXECUTE. Bequemlichkeitsvariante. Kurzbefehl für FROM. %control wird implizit gefüllt.

Dieser Zusatz beeinflusst den Funktionsparameter %param, der wegen parameter selective selbst eine %control-Komponente hat.

  • Mit dem Beispiel READ: Feldangabenausdrücke werden verschiedene Varianten von Feldangabenausdrücken mit einem einfachen verwalteten RAP-BO demonstriert.





SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 11110 Date: 20240523 Time: 140120     sap01-206 ( 170 ms )