Kontakt

Ansicht
Dokumentation

ABAPHANDLER_METH_READ - HANDLER METH READ

ABAPHANDLER_METH_READ - HANDLER METH READ

Fill RESBD Structure from EBP Component Structure   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
Diese Dokumentation steht unter dem Copyright der SAP AG.
SAP E-Book

FOR READ

Definitionen von Behandlermethoden:

METHODS meth $[FINAL$]
   FOR READ
   $[IMPORTING$] ${ REFERENCE(im_par_read) $| im_par_read $}
   FOR ${ READ bdef RESULT ${ REFERENCE(res_read) $| res_read $} $}
     $| ${ READ bdef\_assoc FULL ${ REFERENCE(full_rba) $| full_rba $}
                          RESULT ${ REFERENCE(res_rba) $| res_rba $}
                          LINK ${ REFERENCE(link_rba) $| link_rba $} $}
     $| ${ FUNCTION bdef~function $[REQUEST ${ REFERENCE(req_func) $| req_func $}$]
                                 RESULT ${ REFERENCE(res_func) $| res_func $}  $}
   $[CHANGING ${ $[failed TYPE data$] $[reported TYPE data$] $}$].

Varianten:

1. ... READ bdef ...

2. ... READ bdef\_assoc ...

3. ... FUNCTION bdef~function ...

Wirkung

Behandlermethode, die für RAP-Leseoperationen verwendet wird. Sie muss in einer Behandlerklasse eines ABAP-Behavior-Pools definiert und implementiert werden. Der Methodenname meth ist frei wählbar. bdef ist der Name oder Alias der BDEF, assoc ist der Name der Assoziation und function ist der Name einer Funktion.

Mit Ausnahme der vordefinierten Parameter failed und reported können die Methodenparameter per Referenz übergeben werden (siehe REFERENCE).

Zusätze:

1. ... REQUEST ...

2. ... CHANGING ...

Variante 1

... READ bdef ...


Wirkung

Hiermit werden die Leseanforderungen in RAP-Leseoperationen behandelt. BDEF-Voraussetzung für die Leseoperationen: Die auszulesenden Entitäten müssen hinter der Notation define behavior for deklariert werden.

Methodenparameter:

  • res_read: Obligatorische Parameter, mit dem das Leseergebnis gespeichert wird. Er muss hinter dem ABAP-Wort RESULT angegeben werden und ist eine interne Tabelle vom Typ TYPE TABLE FOR READ RESULT bdef.

  • failed und reported sind weitere Changing-Parameter, die Informationen zurückgeben. Siehe die Details im Abschnitt ... CHANGING ....

Variante 2

... READ bdef\_assoc ...


Wirkung

Hiermit werden die Leseanforderungen in RAP-read-by-association-Operationen behandelt. BDEF-Voraussetzung für read-by-association-Operationen: Die auszulesenden Entitäten müssen hinter der Notation define behavior for deklariert werden.

Methodenparameter:

  • full_rba: Hiermit wird gekennzeichnet, ob der Parameter res_rba, d.h. alle Zielinstanzen, oder nur die Verweise, d.h. der Parameter link_rba, im Kontext von Read-by-Association-Operationen geholt wird. Es ist ein Boolscher Wert vom Typ c mit Länge 1. Die Angabe full_rba mit 'X' berücksichtigt alle Zielinstanzen. Die explizite Angabe des FULL-Parameters mit ist nur bei der dynamischen Form der -READ-Anweisung (READ ENTITIES OPERATIONS) möglich. Bei der Kurzform (READ ENTITY) und Langform (READ ENTITIES) ist die explizite Angabe des Parameters full_rba nicht möglich. In diesen Fällen ist die Angabe irrelevant, da sie ohnehin bei Anforderung der Verweise (Parameter link_rba) oder Daten besteht.

  • failed und reported sind weitere Changing-Parameter, die Informationen hinter CHANGING zurückgeben. Siehe die Details im Abschnitt ... CHANGING ....

Die Parameter müssen in folgender Reihenfolge in der Methodendefinition angegeben werden: ... IMPORTING ... FULL ... RESULT ... LINK ... CHANGING ...

Variante 3

... FUNCTION bdef~function ...


Wirkung

Hiermit werden die Leseanforderungen im Kontext von Funktionen behandelt. Beachten Sie die erforderlichen BDEF-Notationen für Funktionen unter CDS BDL - function.

Methodenparameter:

  • req_func: Zusätzlicher Parameter, dessen Verfügbarkeit von der BDEF-Angabe abhängt. Siehe REQUEST ...

  • failed und reported sind weitere Changing-Parameter, die Informationen hinter dem ABAP-Wort CHANGING zurückgeben. Siehe die Details im Abschnitt ... CHANGING ....

Die Parameter müssen in folgender Reihenfolge in der Methodendefinition angegeben werden: ... IMPORTING ... FULL ... RESULT ... LINK ... CHANGING ...

Zusatz 1

... REQUEST ...

Wirkung

Der Zusatz und der Parameter req_func sind nur im Kontext von Nicht-Entwurfsaktionen verfügbar, die mit der Notation result selective in der BDEF angegeben werden. req_func ist eine Struktur vom Typ TYPE STRUCTURE FOR FUNCTION REQUEST bdef~function.

Zusatz 2

... CHANGING ...

Wirkung

Die CHANGING-Parameter failed und reported sind implizit verfügbar. Mit ihnen werden Informationen über Fehler oder Meldungen zurückgegeben. Die Parameter mit den vordefinierten Namen failed und reported können hinter dem ABAP-Wort CHANGING explizit angegeben werden. In diesem Fall wird der generische Typ DATA verwendet. Zur Laufzeit besitzen die typisierten Parameter den abgeleiteten BDEF-Typ TYPE RESPONSE FOR implizit.

Beispiel

Beispiele für RAP-Behandlermethodendefinitionen Demonstrationen von Methodenimplementierungen sind in den ausführbaren Beispielen weiter unten zu finden.

METHODS read FOR READ
    IMPORTING keys FOR READ bdef RESULT result.

METHODS rba_assoc FOR READ
    IMPORTING keys_rba FOR READ bdef\_assoc
    FULL result_requested RESULT result LINK association_links.

METHODS function1 FOR READ
    IMPORTING keys FOR READ bdef~function1 RESULT result.

METHODS function2 FOR READ
    IMPORTING keys FOR READ bdef~function2
    REQUEST requested_fields RESULT result.

  • Beispiel für RAP-Behandlermethoden: Hiermit wird diese RAP-Behandlermethode innerhalb einer RAP-Behandlerklasse über ein einfaches nicht verwaltetes und entwurfsfähiges RAP-BO demonstriert.





RFUMSV00 - Advance Return for Tax on Sales/Purchases   CPI1466 during Backup  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 14613 Date: 20240428 Time: 091811     sap01-206 ( 237 ms )