ABAPINSERT_FG - INSERT FG

SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up   RFUMSV00 - Advance Return for Tax on Sales/Purchases  
Diese Dokumentation steht unter dem Copyright der SAP AG.

INSERT - field_group

Kurzreferenz

Syntax

INSERT dobj1 dobj2 ... INTO { header | field_group }.

Wirkung

Diese Anweisung dient zum Aufbau der Struktur einer mit FIELD-GROUPS definierten Feldgruppe desExtraktdatenbestands des Programms. Hinter INSERT kann eine Liste globalerflacherDatenobjekte dobj aufgeführt werden. Die Angabe lokaler Datenobjekte führt zu einerAusnahme. Diese Liste definiert die Komponenten der Feldgruppe header bzw. field_group.Für field_group kann ein frei wählbarer Name direkt angegeben werden, währendheader ein vordefinierter Name einer speziellen Feldgruppe ist, deren Komponenten automatischTeil und Schlüssel aller anderen Feldgruppen sind. Die Komponenten einer Feldgruppe sind alsZeiger auf Datenobjekte zu verstehen, deren Inhalte bei Ausführung der Anweisung EXTRACTals Zeile an den Extraktdatenbestand angehängt werden.

Die Anweisung INSERT kann in jedem Verarbeitungsblock eines Programms stehen und wird bei der Programmausführung zum entsprechendenZeitpunkt ausgeführt. Es kann verschiedene INSERT-Anweisungen für eine Feldgruppegeben. Eine Feldgruppe kann so lange um weitere Komponenten erweitert werden, bis die erste entsprechendeZeile mit EXTRACT an den Extraktdatenbestand angehängt wird. Insbesondere kann die Feldgruppeheader nur so lange erweitert werden, bis eine beliebige Feldgruppe des Programms extrahiertwurde, da sie Teil aller Feldgruppen ist. Eine INSERT-Anweisung für eine Feldgruppe, die bereits extrahiert wurde, führt zu einer unbehandelbaren Ausnahme.

Für dobj können Feldsymbole, aber keine dereferenzierten Datenreferenzen angegebenwerden. Ein Feldsymbol, dem kein Datenobjekt zugewiesen ist, wird ignoriert. Die Angabe einer Datenreferenz führt zu einer unbehandelbaren Ausnahme.

Hinweise

• Eine Feldgruppe field_group, in die explizit keine Felder aufgenommen werden, enthält dennoch die Felder der speziellen Feldgruppe header.
  
• In globalen Klassen können keine Feldgruppen definiert und bearbeitet werden. In Methoden lokalerKlassen anderer Programme als Class-Pools ist die Anweisung INSERT für dort global definierte Feldgruppen möglich.
  
  
  

Beispiel

In diesem Beispiel werden drei Feldgruppen im globalen Deklarationsteil einesausführbarenProgramms deklariert und ihre Komponenten im Ereignisblock START-OF-SELECTION festgelegt.Die Feldgruppe flight_info hat fünf Komponenten: die der Feldgruppe header und ihre eigenen. Die Feldgruppe flight_date enthält nur die Komponenten der Feldgruppe header.

REPORT demo_extract.

NODES: spfli, sflight.

FIELD-GROUPS: header, flight_info, flight_date.

START-OF-SELECTION.

  INSERT: spfli-carrid spfli-connid sflight-fldate
          INTO header,
          spfli-cityfrom spfli-cityto
          INTO flight_info.

Ausnahmen

Unbehandelbare Ausnahmen

• Ursache: In eine Feldgruppe sollten lokale Datenobjekte eingefügt werden.
  Laufzeitfehler: EXTRACT_INSERT_LOCAL_DATA
  
• Ursache: INSERT in Feldgruppe, nachdem bereits Sätze dieser Satzart mit EXTRACT extrahiert wurden.
  Laufzeitfehler: INSERT_INTO_LOCKED_FIELD_GROUP
  
  
  

BAL Application Log Documentation   rdisp/max_wprun_time - Maximum work process run time  
Diese Dokumentation steht unter dem Copyright der SAP AG.


Length: 5046 Date: 20120526 Time: 213306     triton ( 185 ms )